From 49f6866a24e7b6ee1f7b461f7c98aa543d192182 Mon Sep 17 00:00:00 2001 From: Alexandre Bobkov Date: Sun, 29 Jun 2025 18:18:50 -0400 Subject: [PATCH] ESP-NOW RC Tutorial --- .../site-packages/_distutils_hack/__init__.py | 239 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 10631 bytes .../__pycache__/override.cpython-312.pyc | Bin 0 -> 319 bytes .../site-packages/_distutils_hack/override.py | 1 + .../site-packages/distutils-precedence.pth | 1 + .../site-packages/pkg_resources/__init__.py | 3713 +++++++++++++ .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 164731 bytes .../site-packages/pkg_resources/api_tests.txt | 424 ++ .../site-packages/pkg_resources/py.typed | 0 .../pkg_resources/tests/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 222 bytes .../test_find_distributions.cpython-312.pyc | Bin 0 -> 3323 bytes ...integration_zope_interface.cpython-312.pyc | Bin 0 -> 2032 bytes .../__pycache__/test_markers.cpython-312.pyc | Bin 0 -> 659 bytes .../test_pkg_resources.cpython-312.pyc | Bin 0 -> 25291 bytes .../test_resources.cpython-312.pyc | Bin 0 -> 47646 bytes .../test_working_set.cpython-312.pyc | Bin 0 -> 10554 bytes .../__pycache__/setup.cpython-312.pyc | Bin 0 -> 396 bytes .../data/my-test-package-source/setup.cfg | 0 .../data/my-test-package-source/setup.py | 7 + .../my-test-package-zip/my-test-package.zip | Bin 0 -> 1809 bytes .../EGG-INFO/PKG-INFO | 10 + .../EGG-INFO/SOURCES.txt | 7 + .../EGG-INFO/dependency_links.txt | 1 + .../EGG-INFO/top_level.txt | 1 + .../EGG-INFO/zip-safe | 1 + .../my_test_package-1.0-py3.7.egg | Bin 0 -> 843 bytes .../tests/test_find_distributions.py | 56 + .../tests/test_integration_zope_interface.py | 54 + .../pkg_resources/tests/test_markers.py | 8 + .../pkg_resources/tests/test_pkg_resources.py | 485 ++ .../pkg_resources/tests/test_resources.py | 869 +++ .../pkg_resources/tests/test_working_set.py | 505 ++ .../setuptools-80.9.0.dist-info/INSTALLER | 1 + .../setuptools-80.9.0.dist-info/METADATA | 141 + .../setuptools-80.9.0.dist-info/RECORD | 869 +++ .../setuptools-80.9.0.dist-info/REQUESTED | 0 .../setuptools-80.9.0.dist-info/WHEEL | 5 + .../entry_points.txt | 51 + .../licenses/LICENSE | 17 + .../setuptools-80.9.0.dist-info/top_level.txt | 3 + .../site-packages/setuptools/__init__.py | 248 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 12099 bytes .../_core_metadata.cpython-312.pyc | Bin 0 -> 14982 bytes .../__pycache__/_discovery.cpython-312.pyc | Bin 0 -> 1745 bytes .../__pycache__/_entry_points.cpython-312.pyc | Bin 0 -> 4874 bytes .../__pycache__/_imp.cpython-312.pyc | Bin 0 -> 3645 bytes .../__pycache__/_importlib.cpython-312.pyc | Bin 0 -> 430 bytes .../__pycache__/_itertools.cpython-312.pyc | Bin 0 -> 1091 bytes .../_normalization.cpython-312.pyc | Bin 0 -> 7447 bytes .../__pycache__/_path.cpython-312.pyc | Bin 0 -> 4646 bytes .../__pycache__/_reqs.cpython-312.pyc | Bin 0 -> 1938 bytes .../__pycache__/_scripts.cpython-312.pyc | Bin 0 -> 16829 bytes .../__pycache__/_shutil.cpython-312.pyc | Bin 0 -> 2618 bytes .../__pycache__/_static.cpython-312.pyc | Bin 0 -> 6092 bytes .../__pycache__/archive_util.cpython-312.pyc | Bin 0 -> 9289 bytes .../__pycache__/build_meta.cpython-312.pyc | Bin 0 -> 24817 bytes .../__pycache__/depends.cpython-312.pyc | Bin 0 -> 7653 bytes .../__pycache__/discovery.cpython-312.pyc | Bin 0 -> 28735 bytes .../__pycache__/dist.cpython-312.pyc | Bin 0 -> 52277 bytes .../__pycache__/errors.cpython-312.pyc | Bin 0 -> 3526 bytes .../__pycache__/extension.cpython-312.pyc | Bin 0 -> 6938 bytes .../__pycache__/glob.cpython-312.pyc | Bin 0 -> 7474 bytes .../__pycache__/installer.cpython-312.pyc | Bin 0 -> 7849 bytes .../__pycache__/launch.cpython-312.pyc | Bin 0 -> 1354 bytes .../__pycache__/logging.cpython-312.pyc | Bin 0 -> 2130 bytes .../__pycache__/modified.cpython-312.pyc | Bin 0 -> 529 bytes .../__pycache__/monkey.cpython-312.pyc | Bin 0 -> 5223 bytes .../__pycache__/msvc.cpython-312.pyc | Bin 0 -> 58817 bytes .../__pycache__/namespaces.cpython-312.pyc | Bin 0 -> 5340 bytes .../__pycache__/unicode_utils.cpython-312.pyc | Bin 0 -> 4362 bytes .../__pycache__/version.cpython-312.pyc | Bin 0 -> 452 bytes .../__pycache__/warnings.cpython-312.pyc | Bin 0 -> 5170 bytes .../__pycache__/wheel.cpython-312.pyc | Bin 0 -> 15249 bytes .../windows_support.cpython-312.pyc | Bin 0 -> 1487 bytes .../setuptools/_core_metadata.py | 337 ++ .../site-packages/setuptools/_discovery.py | 33 + .../setuptools/_distutils/__init__.py | 14 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 560 bytes .../__pycache__/_log.cpython-312.pyc | Bin 0 -> 308 bytes .../__pycache__/_macos_compat.cpython-312.pyc | Bin 0 -> 597 bytes .../__pycache__/_modified.cpython-312.pyc | Bin 0 -> 4822 bytes .../__pycache__/_msvccompiler.cpython-312.pyc | Bin 0 -> 755 bytes .../__pycache__/archive_util.cpython-312.pyc | Bin 0 -> 10872 bytes .../__pycache__/ccompiler.cpython-312.pyc | Bin 0 -> 724 bytes .../__pycache__/cmd.cpython-312.pyc | Bin 0 -> 22631 bytes .../__pycache__/core.cpython-312.pyc | Bin 0 -> 9147 bytes .../cygwinccompiler.cpython-312.pyc | Bin 0 -> 688 bytes .../__pycache__/debug.cpython-312.pyc | Bin 0 -> 351 bytes .../__pycache__/dep_util.cpython-312.pyc | Bin 0 -> 745 bytes .../__pycache__/dir_util.cpython-312.pyc | Bin 0 -> 10394 bytes .../__pycache__/dist.cpython-312.pyc | Bin 0 -> 56340 bytes .../__pycache__/errors.cpython-312.pyc | Bin 0 -> 4560 bytes .../__pycache__/extension.cpython-312.pyc | Bin 0 -> 10283 bytes .../__pycache__/fancy_getopt.cpython-312.pyc | Bin 0 -> 15854 bytes .../__pycache__/file_util.cpython-312.pyc | Bin 0 -> 9524 bytes .../__pycache__/filelist.cpython-312.pyc | Bin 0 -> 17973 bytes .../__pycache__/log.cpython-312.pyc | Bin 0 -> 2646 bytes .../__pycache__/spawn.cpython-312.pyc | Bin 0 -> 5677 bytes .../__pycache__/sysconfig.cpython-312.pyc | Bin 0 -> 23141 bytes .../__pycache__/text_file.cpython-312.pyc | Bin 0 -> 10870 bytes .../__pycache__/unixccompiler.cpython-312.pyc | Bin 0 -> 448 bytes .../__pycache__/util.cpython-312.pyc | Bin 0 -> 19513 bytes .../__pycache__/version.cpython-312.pyc | Bin 0 -> 10663 bytes .../versionpredicate.cpython-312.pyc | Bin 0 -> 6931 bytes .../__pycache__/zosccompiler.cpython-312.pyc | Bin 0 -> 327 bytes .../setuptools/_distutils/_log.py | 3 + .../setuptools/_distutils/_macos_compat.py | 12 + .../setuptools/_distutils/_modified.py | 95 + .../setuptools/_distutils/_msvccompiler.py | 16 + .../setuptools/_distutils/archive_util.py | 294 + .../setuptools/_distutils/ccompiler.py | 26 + .../setuptools/_distutils/cmd.py | 554 ++ .../setuptools/_distutils/command/__init__.py | 23 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 543 bytes .../_framework_compat.cpython-312.pyc | Bin 0 -> 2647 bytes .../command/__pycache__/bdist.cpython-312.pyc | Bin 0 -> 6496 bytes .../__pycache__/bdist_dumb.cpython-312.pyc | Bin 0 -> 5616 bytes .../__pycache__/bdist_rpm.cpython-312.pyc | Bin 0 -> 21688 bytes .../command/__pycache__/build.cpython-312.pyc | Bin 0 -> 6309 bytes .../__pycache__/build_clib.cpython-312.pyc | Bin 0 -> 7649 bytes .../__pycache__/build_ext.cpython-312.pyc | Bin 0 -> 30256 bytes .../__pycache__/build_py.cpython-312.pyc | Bin 0 -> 16325 bytes .../__pycache__/build_scripts.cpython-312.pyc | Bin 0 -> 6838 bytes .../command/__pycache__/check.cpython-312.pyc | Bin 0 -> 7203 bytes .../command/__pycache__/clean.cpython-312.pyc | Bin 0 -> 3170 bytes .../__pycache__/config.cpython-312.pyc | Bin 0 -> 15210 bytes .../__pycache__/install.cpython-312.pyc | Bin 0 -> 27026 bytes .../__pycache__/install_data.cpython-312.pyc | Bin 0 -> 4386 bytes .../install_egg_info.cpython-312.pyc | Bin 0 -> 5201 bytes .../install_headers.cpython-312.pyc | Bin 0 -> 2455 bytes .../__pycache__/install_lib.cpython-312.pyc | Bin 0 -> 8353 bytes .../install_scripts.cpython-312.pyc | Bin 0 -> 3114 bytes .../command/__pycache__/sdist.cpython-312.pyc | Bin 0 -> 22584 bytes .../_distutils/command/_framework_compat.py | 54 + .../setuptools/_distutils/command/bdist.py | 167 + .../_distutils/command/bdist_dumb.py | 141 + .../_distutils/command/bdist_rpm.py | 598 ++ .../setuptools/_distutils/command/build.py | 156 + .../_distutils/command/build_clib.py | 201 + .../_distutils/command/build_ext.py | 812 +++ .../setuptools/_distutils/command/build_py.py | 407 ++ .../_distutils/command/build_scripts.py | 160 + .../setuptools/_distutils/command/check.py | 152 + .../setuptools/_distutils/command/clean.py | 77 + .../setuptools/_distutils/command/config.py | 358 ++ .../setuptools/_distutils/command/install.py | 805 +++ .../_distutils/command/install_data.py | 94 + .../_distutils/command/install_egg_info.py | 91 + .../_distutils/command/install_headers.py | 46 + .../_distutils/command/install_lib.py | 238 + .../_distutils/command/install_scripts.py | 62 + .../setuptools/_distutils/command/sdist.py | 521 ++ .../setuptools/_distutils/compat/__init__.py | 18 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1340 bytes .../compat/__pycache__/numpy.cpython-312.pyc | Bin 0 -> 318 bytes .../compat/__pycache__/py39.cpython-312.pyc | Bin 0 -> 2729 bytes .../setuptools/_distutils/compat/numpy.py | 2 + .../setuptools/_distutils/compat/py39.py | 66 + .../C/__pycache__/base.cpython-312.pyc | Bin 0 -> 52421 bytes .../C/__pycache__/cygwin.cpython-312.pyc | Bin 0 -> 11833 bytes .../C/__pycache__/errors.cpython-312.pyc | Bin 0 -> 1543 bytes .../C/__pycache__/msvc.cpython-312.pyc | Bin 0 -> 24850 bytes .../C/__pycache__/unix.cpython-312.pyc | Bin 0 -> 15983 bytes .../C/__pycache__/zos.cpython-312.pyc | Bin 0 -> 6286 bytes .../setuptools/_distutils/compilers/C/base.py | 1394 +++++ .../_distutils/compilers/C/cygwin.py | 340 ++ .../_distutils/compilers/C/errors.py | 24 + .../setuptools/_distutils/compilers/C/msvc.py | 614 +++ .../__pycache__/test_base.cpython-312.pyc | Bin 0 -> 4077 bytes .../__pycache__/test_cygwin.cpython-312.pyc | Bin 0 -> 4592 bytes .../__pycache__/test_mingw.cpython-312.pyc | Bin 0 -> 3919 bytes .../__pycache__/test_msvc.cpython-312.pyc | Bin 0 -> 7507 bytes .../__pycache__/test_unix.cpython-312.pyc | Bin 0 -> 19581 bytes .../_distutils/compilers/C/tests/test_base.py | 83 + .../compilers/C/tests/test_cygwin.py | 76 + .../compilers/C/tests/test_mingw.py | 48 + .../_distutils/compilers/C/tests/test_msvc.py | 136 + .../_distutils/compilers/C/tests/test_unix.py | 413 ++ .../setuptools/_distutils/compilers/C/unix.py | 422 ++ .../setuptools/_distutils/compilers/C/zos.py | 230 + .../setuptools/_distutils/core.py | 289 + .../setuptools/_distutils/cygwinccompiler.py | 31 + .../setuptools/_distutils/debug.py | 5 + .../setuptools/_distutils/dep_util.py | 14 + .../setuptools/_distutils/dir_util.py | 244 + .../setuptools/_distutils/dist.py | 1386 +++++ .../setuptools/_distutils/errors.py | 108 + .../setuptools/_distutils/extension.py | 258 + .../setuptools/_distutils/fancy_getopt.py | 471 ++ .../setuptools/_distutils/file_util.py | 236 + .../setuptools/_distutils/filelist.py | 431 ++ .../setuptools/_distutils/log.py | 56 + .../setuptools/_distutils/spawn.py | 134 + .../setuptools/_distutils/sysconfig.py | 598 ++ .../setuptools/_distutils/tests/__init__.py | 42 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1944 bytes .../tests/__pycache__/support.cpython-312.pyc | Bin 0 -> 6430 bytes .../test_archive_util.cpython-312.pyc | Bin 0 -> 20794 bytes .../__pycache__/test_bdist.cpython-312.pyc | Bin 0 -> 1929 bytes .../test_bdist_dumb.cpython-312.pyc | Bin 0 -> 3876 bytes .../test_bdist_rpm.cpython-312.pyc | Bin 0 -> 5658 bytes .../__pycache__/test_build.cpython-312.pyc | Bin 0 -> 2814 bytes .../test_build_clib.cpython-312.pyc | Bin 0 -> 6664 bytes .../test_build_ext.cpython-312.pyc | Bin 0 -> 29365 bytes .../__pycache__/test_build_py.cpython-312.pyc | Bin 0 -> 9886 bytes .../test_build_scripts.cpython-312.pyc | Bin 0 -> 4729 bytes .../__pycache__/test_check.cpython-312.pyc | Bin 0 -> 7175 bytes .../__pycache__/test_clean.cpython-312.pyc | Bin 0 -> 1952 bytes .../__pycache__/test_cmd.cpython-312.pyc | Bin 0 -> 6378 bytes .../test_config_cmd.cpython-312.pyc | Bin 0 -> 5163 bytes .../__pycache__/test_core.cpython-312.pyc | Bin 0 -> 6214 bytes .../__pycache__/test_dir_util.cpython-312.pyc | Bin 0 -> 8608 bytes .../__pycache__/test_dist.cpython-312.pyc | Bin 0 -> 26885 bytes .../test_extension.cpython-312.pyc | Bin 0 -> 4225 bytes .../test_file_util.cpython-312.pyc | Bin 0 -> 6958 bytes .../__pycache__/test_filelist.cpython-312.pyc | Bin 0 -> 14354 bytes .../__pycache__/test_install.cpython-312.pyc | Bin 0 -> 14111 bytes .../test_install_data.cpython-312.pyc | Bin 0 -> 4827 bytes .../test_install_headers.cpython-312.pyc | Bin 0 -> 1916 bytes .../test_install_lib.cpython-312.pyc | Bin 0 -> 6151 bytes .../test_install_scripts.cpython-312.pyc | Bin 0 -> 2736 bytes .../__pycache__/test_log.cpython-312.pyc | Bin 0 -> 988 bytes .../__pycache__/test_modified.cpython-312.pyc | Bin 0 -> 7242 bytes .../__pycache__/test_sdist.cpython-312.pyc | Bin 0 -> 20624 bytes .../__pycache__/test_spawn.cpython-312.pyc | Bin 0 -> 6817 bytes .../test_sysconfig.cpython-312.pyc | Bin 0 -> 18209 bytes .../test_text_file.cpython-312.pyc | Bin 0 -> 3367 bytes .../__pycache__/test_util.cpython-312.pyc | Bin 0 -> 13501 bytes .../__pycache__/test_version.cpython-312.pyc | Bin 0 -> 3881 bytes .../test_versionpredicate.cpython-312.pyc | Bin 0 -> 243 bytes .../__pycache__/unix_compat.cpython-312.pyc | Bin 0 -> 821 bytes .../_distutils/tests/compat/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 237 bytes .../compat/__pycache__/py39.cpython-312.pyc | Bin 0 -> 721 bytes .../_distutils/tests/compat/py39.py | 40 + .../setuptools/_distutils/tests/support.py | 134 + .../_distutils/tests/test_archive_util.py | 353 ++ .../setuptools/_distutils/tests/test_bdist.py | 47 + .../_distutils/tests/test_bdist_dumb.py | 78 + .../_distutils/tests/test_bdist_rpm.py | 127 + .../setuptools/_distutils/tests/test_build.py | 49 + .../_distutils/tests/test_build_clib.py | 134 + .../_distutils/tests/test_build_ext.py | 628 +++ .../_distutils/tests/test_build_py.py | 196 + .../_distutils/tests/test_build_scripts.py | 96 + .../setuptools/_distutils/tests/test_check.py | 194 + .../setuptools/_distutils/tests/test_clean.py | 45 + .../setuptools/_distutils/tests/test_cmd.py | 107 + .../_distutils/tests/test_config_cmd.py | 87 + .../setuptools/_distutils/tests/test_core.py | 130 + .../_distutils/tests/test_dir_util.py | 139 + .../setuptools/_distutils/tests/test_dist.py | 552 ++ .../_distutils/tests/test_extension.py | 117 + .../_distutils/tests/test_file_util.py | 95 + .../_distutils/tests/test_filelist.py | 336 ++ .../_distutils/tests/test_install.py | 245 + .../_distutils/tests/test_install_data.py | 74 + .../_distutils/tests/test_install_headers.py | 33 + .../_distutils/tests/test_install_lib.py | 110 + .../_distutils/tests/test_install_scripts.py | 52 + .../setuptools/_distutils/tests/test_log.py | 12 + .../_distutils/tests/test_modified.py | 126 + .../setuptools/_distutils/tests/test_sdist.py | 470 ++ .../setuptools/_distutils/tests/test_spawn.py | 141 + .../_distutils/tests/test_sysconfig.py | 319 ++ .../_distutils/tests/test_text_file.py | 127 + .../setuptools/_distutils/tests/test_util.py | 243 + .../_distutils/tests/test_version.py | 80 + .../_distutils/tests/test_versionpredicate.py | 0 .../_distutils/tests/unix_compat.py | 17 + .../setuptools/_distutils/text_file.py | 286 + .../setuptools/_distutils/unixccompiler.py | 9 + .../setuptools/_distutils/util.py | 518 ++ .../setuptools/_distutils/version.py | 348 ++ .../setuptools/_distutils/versionpredicate.py | 175 + .../setuptools/_distutils/zosccompiler.py | 3 + .../site-packages/setuptools/_entry_points.py | 94 + .../site-packages/setuptools/_imp.py | 87 + .../site-packages/setuptools/_importlib.py | 9 + .../site-packages/setuptools/_itertools.py | 23 + .../setuptools/_normalization.py | 177 + .../site-packages/setuptools/_path.py | 93 + .../site-packages/setuptools/_reqs.py | 42 + .../site-packages/setuptools/_scripts.py | 361 ++ .../site-packages/setuptools/_shutil.py | 59 + .../site-packages/setuptools/_static.py | 188 + .../typing_extensions.cpython-312.pyc | Bin 0 -> 139535 bytes .../autocommand-2.2.2.dist-info/INSTALLER | 1 + .../autocommand-2.2.2.dist-info/LICENSE | 166 + .../autocommand-2.2.2.dist-info/METADATA | 420 ++ .../autocommand-2.2.2.dist-info/RECORD | 18 + .../_vendor/autocommand-2.2.2.dist-info/WHEEL | 5 + .../autocommand-2.2.2.dist-info/top_level.txt | 1 + .../_vendor/autocommand/__init__.py | 27 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 463 bytes .../__pycache__/autoasync.cpython-312.pyc | Bin 0 -> 5044 bytes .../__pycache__/autocommand.cpython-312.pyc | Bin 0 -> 1325 bytes .../__pycache__/automain.cpython-312.pyc | Bin 0 -> 1897 bytes .../__pycache__/autoparse.cpython-312.pyc | Bin 0 -> 11086 bytes .../__pycache__/errors.cpython-312.pyc | Bin 0 -> 479 bytes .../_vendor/autocommand/autoasync.py | 142 + .../_vendor/autocommand/autocommand.py | 70 + .../_vendor/autocommand/automain.py | 59 + .../_vendor/autocommand/autoparse.py | 333 ++ .../setuptools/_vendor/autocommand/errors.py | 23 + .../INSTALLER | 1 + .../backports.tarfile-1.2.0.dist-info/LICENSE | 17 + .../METADATA | 46 + .../backports.tarfile-1.2.0.dist-info/RECORD | 17 + .../REQUESTED | 0 .../backports.tarfile-1.2.0.dist-info/WHEEL | 5 + .../top_level.txt | 1 + .../setuptools/_vendor/backports/__init__.py | 1 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 353 bytes .../_vendor/backports/tarfile/__init__.py | 2937 ++++++++++ .../_vendor/backports/tarfile/__main__.py | 5 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 121298 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 337 bytes .../backports/tarfile/compat/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 246 bytes .../compat/__pycache__/py38.cpython-312.pyc | Bin 0 -> 1092 bytes .../_vendor/backports/tarfile/compat/py38.py | 24 + .../INSTALLER | 1 + .../LICENSE | 202 + .../METADATA | 129 + .../importlib_metadata-8.0.0.dist-info/RECORD | 32 + .../REQUESTED | 0 .../importlib_metadata-8.0.0.dist-info/WHEEL | 5 + .../top_level.txt | 1 + .../_vendor/importlib_metadata/__init__.py | 1083 ++++ .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 53275 bytes .../__pycache__/_adapters.cpython-312.pyc | Bin 0 -> 3819 bytes .../__pycache__/_collections.cpython-312.pyc | Bin 0 -> 1976 bytes .../__pycache__/_compat.cpython-312.pyc | Bin 0 -> 2315 bytes .../__pycache__/_functools.cpython-312.pyc | Bin 0 -> 3534 bytes .../__pycache__/_itertools.cpython-312.pyc | Bin 0 -> 2458 bytes .../__pycache__/_meta.cpython-312.pyc | Bin 0 -> 3682 bytes .../__pycache__/_text.cpython-312.pyc | Bin 0 -> 3935 bytes .../__pycache__/diagnose.cpython-312.pyc | Bin 0 -> 1243 bytes .../_vendor/importlib_metadata/_adapters.py | 83 + .../importlib_metadata/_collections.py | 30 + .../_vendor/importlib_metadata/_compat.py | 57 + .../_vendor/importlib_metadata/_functools.py | 104 + .../_vendor/importlib_metadata/_itertools.py | 73 + .../_vendor/importlib_metadata/_meta.py | 67 + .../_vendor/importlib_metadata/_text.py | 99 + .../importlib_metadata/compat/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 247 bytes .../compat/__pycache__/py311.cpython-312.pyc | Bin 0 -> 1316 bytes .../compat/__pycache__/py39.cpython-312.pyc | Bin 0 -> 1690 bytes .../importlib_metadata/compat/py311.py | 22 + .../_vendor/importlib_metadata/compat/py39.py | 36 + .../_vendor/importlib_metadata/diagnose.py | 21 + .../_vendor/importlib_metadata/py.typed | 0 .../_vendor/inflect-7.3.1.dist-info/INSTALLER | 1 + .../_vendor/inflect-7.3.1.dist-info/LICENSE | 17 + .../_vendor/inflect-7.3.1.dist-info/METADATA | 591 ++ .../_vendor/inflect-7.3.1.dist-info/RECORD | 13 + .../_vendor/inflect-7.3.1.dist-info/WHEEL | 5 + .../inflect-7.3.1.dist-info/top_level.txt | 1 + .../setuptools/_vendor/inflect/__init__.py | 3986 ++++++++++++++ .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 113113 bytes .../_vendor/inflect/compat/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 236 bytes .../compat/__pycache__/py38.cpython-312.pyc | Bin 0 -> 399 bytes .../setuptools/_vendor/inflect/compat/py38.py | 7 + .../setuptools/_vendor/inflect/py.typed | 0 .../INSTALLER | 1 + .../LICENSE | 17 + .../METADATA | 85 + .../jaraco.collections-5.1.0.dist-info/RECORD | 10 + .../REQUESTED | 0 .../jaraco.collections-5.1.0.dist-info/WHEEL | 5 + .../top_level.txt | 1 + .../jaraco.context-5.3.0.dist-info/INSTALLER | 1 + .../jaraco.context-5.3.0.dist-info/LICENSE | 17 + .../jaraco.context-5.3.0.dist-info/METADATA | 75 + .../jaraco.context-5.3.0.dist-info/RECORD | 8 + .../jaraco.context-5.3.0.dist-info/WHEEL | 5 + .../top_level.txt | 1 + .../INSTALLER | 1 + .../jaraco.functools-4.0.1.dist-info/LICENSE | 17 + .../jaraco.functools-4.0.1.dist-info/METADATA | 64 + .../jaraco.functools-4.0.1.dist-info/RECORD | 10 + .../jaraco.functools-4.0.1.dist-info/WHEEL | 5 + .../top_level.txt | 1 + .../jaraco.text-3.12.1.dist-info/INSTALLER | 1 + .../jaraco.text-3.12.1.dist-info/LICENSE | 17 + .../jaraco.text-3.12.1.dist-info/METADATA | 95 + .../jaraco.text-3.12.1.dist-info/RECORD | 20 + .../jaraco.text-3.12.1.dist-info/REQUESTED | 0 .../jaraco.text-3.12.1.dist-info/WHEEL | 5 + .../top_level.txt | 1 + .../__pycache__/context.cpython-312.pyc | Bin 0 -> 14373 bytes .../_vendor/jaraco/collections/__init__.py | 1091 ++++ .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 39859 bytes .../_vendor/jaraco/collections/py.typed | 0 .../setuptools/_vendor/jaraco/context.py | 361 ++ .../_vendor/jaraco/functools/__init__.py | 633 +++ .../_vendor/jaraco/functools/__init__.pyi | 125 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 22950 bytes .../_vendor/jaraco/functools/py.typed | 0 .../_vendor/jaraco/text/Lorem ipsum.txt | 2 + .../_vendor/jaraco/text/__init__.py | 624 +++ .../text/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 25533 bytes .../text/__pycache__/layouts.cpython-312.pyc | Bin 0 -> 1151 bytes .../__pycache__/show-newlines.cpython-312.pyc | Bin 0 -> 1523 bytes .../__pycache__/strip-prefix.cpython-312.pyc | Bin 0 -> 947 bytes .../__pycache__/to-dvorak.cpython-312.pyc | Bin 0 -> 487 bytes .../__pycache__/to-qwerty.cpython-312.pyc | Bin 0 -> 487 bytes .../setuptools/_vendor/jaraco/text/layouts.py | 25 + .../_vendor/jaraco/text/show-newlines.py | 33 + .../_vendor/jaraco/text/strip-prefix.py | 21 + .../_vendor/jaraco/text/to-dvorak.py | 6 + .../_vendor/jaraco/text/to-qwerty.py | 6 + .../more_itertools-10.3.0.dist-info/INSTALLER | 1 + .../more_itertools-10.3.0.dist-info/LICENSE | 19 + .../more_itertools-10.3.0.dist-info/METADATA | 266 + .../more_itertools-10.3.0.dist-info/RECORD | 16 + .../more_itertools-10.3.0.dist-info/REQUESTED | 0 .../more_itertools-10.3.0.dist-info/WHEEL | 4 + .../_vendor/more_itertools/__init__.py | 6 + .../_vendor/more_itertools/__init__.pyi | 2 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 390 bytes .../__pycache__/more.cpython-312.pyc | Bin 0 -> 174238 bytes .../__pycache__/recipes.cpython-312.pyc | Bin 0 -> 36367 bytes .../setuptools/_vendor/more_itertools/more.py | 4806 +++++++++++++++++ .../_vendor/more_itertools/more.pyi | 709 +++ .../_vendor/more_itertools/py.typed | 0 .../_vendor/more_itertools/recipes.py | 1046 ++++ .../_vendor/more_itertools/recipes.pyi | 136 + .../packaging-24.2.dist-info/INSTALLER | 1 + .../_vendor/packaging-24.2.dist-info/LICENSE | 3 + .../packaging-24.2.dist-info/LICENSE.APACHE | 177 + .../packaging-24.2.dist-info/LICENSE.BSD | 23 + .../_vendor/packaging-24.2.dist-info/METADATA | 102 + .../_vendor/packaging-24.2.dist-info/RECORD | 25 + .../packaging-24.2.dist-info/REQUESTED | 0 .../_vendor/packaging-24.2.dist-info/WHEEL | 4 + .../setuptools/_vendor/packaging/__init__.py | 15 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 596 bytes .../__pycache__/_elffile.cpython-312.pyc | Bin 0 -> 5068 bytes .../__pycache__/_manylinux.cpython-312.pyc | Bin 0 -> 9794 bytes .../__pycache__/_musllinux.cpython-312.pyc | Bin 0 -> 4607 bytes .../__pycache__/_parser.cpython-312.pyc | Bin 0 -> 14038 bytes .../__pycache__/_structures.cpython-312.pyc | Bin 0 -> 3279 bytes .../__pycache__/_tokenizer.cpython-312.pyc | Bin 0 -> 7949 bytes .../__pycache__/markers.cpython-312.pyc | Bin 0 -> 11414 bytes .../__pycache__/metadata.cpython-312.pyc | Bin 0 -> 27292 bytes .../__pycache__/requirements.cpython-312.pyc | Bin 0 -> 4448 bytes .../__pycache__/specifiers.cpython-312.pyc | Bin 0 -> 39081 bytes .../__pycache__/tags.cpython-312.pyc | Bin 0 -> 23181 bytes .../__pycache__/utils.cpython-312.pyc | Bin 0 -> 6673 bytes .../__pycache__/version.cpython-312.pyc | Bin 0 -> 20506 bytes .../setuptools/_vendor/packaging/_elffile.py | 110 + .../_vendor/packaging/_manylinux.py | 263 + .../_vendor/packaging/_musllinux.py | 85 + .../setuptools/_vendor/packaging/_parser.py | 354 ++ .../_vendor/packaging/_structures.py | 61 + .../_vendor/packaging/_tokenizer.py | 194 + .../_vendor/packaging/licenses/__init__.py | 145 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 4155 bytes .../__pycache__/_spdx.cpython-312.pyc | Bin 0 -> 47402 bytes .../_vendor/packaging/licenses/_spdx.py | 759 +++ .../setuptools/_vendor/packaging/markers.py | 331 ++ .../setuptools/_vendor/packaging/metadata.py | 863 +++ .../setuptools/_vendor/packaging/py.typed | 0 .../_vendor/packaging/requirements.py | 91 + .../_vendor/packaging/specifiers.py | 1020 ++++ .../setuptools/_vendor/packaging/tags.py | 617 +++ .../setuptools/_vendor/packaging/utils.py | 163 + .../setuptools/_vendor/packaging/version.py | 582 ++ .../platformdirs-4.2.2.dist-info/INSTALLER | 1 + .../platformdirs-4.2.2.dist-info/METADATA | 319 ++ .../platformdirs-4.2.2.dist-info/RECORD | 23 + .../platformdirs-4.2.2.dist-info/REQUESTED | 0 .../platformdirs-4.2.2.dist-info/WHEEL | 4 + .../licenses/LICENSE | 21 + .../_vendor/platformdirs/__init__.py | 627 +++ .../_vendor/platformdirs/__main__.py | 55 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 19819 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 1994 bytes .../__pycache__/android.cpython-312.pyc | Bin 0 -> 10745 bytes .../__pycache__/api.cpython-312.pyc | Bin 0 -> 12969 bytes .../__pycache__/macos.cpython-312.pyc | Bin 0 -> 8045 bytes .../__pycache__/unix.cpython-312.pyc | Bin 0 -> 15070 bytes .../__pycache__/version.cpython-312.pyc | Bin 0 -> 635 bytes .../__pycache__/windows.cpython-312.pyc | Bin 0 -> 13711 bytes .../_vendor/platformdirs/android.py | 249 + .../setuptools/_vendor/platformdirs/api.py | 292 + .../setuptools/_vendor/platformdirs/macos.py | 130 + .../setuptools/_vendor/platformdirs/py.typed | 0 .../setuptools/_vendor/platformdirs/unix.py | 275 + .../_vendor/platformdirs/version.py | 16 + .../_vendor/platformdirs/windows.py | 272 + .../_vendor/tomli-2.0.1.dist-info/INSTALLER | 1 + .../_vendor/tomli-2.0.1.dist-info/LICENSE | 21 + .../_vendor/tomli-2.0.1.dist-info/METADATA | 206 + .../_vendor/tomli-2.0.1.dist-info/RECORD | 15 + .../_vendor/tomli-2.0.1.dist-info/REQUESTED | 0 .../_vendor/tomli-2.0.1.dist-info/WHEEL | 4 + .../setuptools/_vendor/tomli/__init__.py | 11 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 423 bytes .../tomli/__pycache__/_parser.cpython-312.pyc | Bin 0 -> 26966 bytes .../tomli/__pycache__/_re.cpython-312.pyc | Bin 0 -> 3947 bytes .../tomli/__pycache__/_types.cpython-312.pyc | Bin 0 -> 405 bytes .../setuptools/_vendor/tomli/_parser.py | 691 +++ .../setuptools/_vendor/tomli/_re.py | 107 + .../setuptools/_vendor/tomli/_types.py | 10 + .../setuptools/_vendor/tomli/py.typed | 1 + .../typeguard-4.3.0.dist-info/INSTALLER | 1 + .../_vendor/typeguard-4.3.0.dist-info/LICENSE | 19 + .../typeguard-4.3.0.dist-info/METADATA | 81 + .../_vendor/typeguard-4.3.0.dist-info/RECORD | 34 + .../_vendor/typeguard-4.3.0.dist-info/WHEEL | 5 + .../entry_points.txt | 2 + .../typeguard-4.3.0.dist-info/top_level.txt | 1 + .../setuptools/_vendor/typeguard/__init__.py | 48 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 2118 bytes .../__pycache__/_checkers.cpython-312.pyc | Bin 0 -> 34998 bytes .../__pycache__/_config.cpython-312.pyc | Bin 0 -> 3892 bytes .../__pycache__/_decorators.cpython-312.pyc | Bin 0 -> 10621 bytes .../__pycache__/_exceptions.cpython-312.pyc | Bin 0 -> 2799 bytes .../__pycache__/_functions.cpython-312.pyc | Bin 0 -> 12305 bytes .../__pycache__/_importhook.cpython-312.pyc | Bin 0 -> 9198 bytes .../__pycache__/_memo.cpython-312.pyc | Bin 0 -> 1786 bytes .../_pytest_plugin.cpython-312.pyc | Bin 0 -> 5580 bytes .../__pycache__/_suppression.cpython-312.pyc | Bin 0 -> 3484 bytes .../__pycache__/_transformer.cpython-312.pyc | Bin 0 -> 51987 bytes .../_union_transformer.cpython-312.pyc | Bin 0 -> 2444 bytes .../__pycache__/_utils.cpython-312.pyc | Bin 0 -> 7731 bytes .../setuptools/_vendor/typeguard/_checkers.py | 993 ++++ .../setuptools/_vendor/typeguard/_config.py | 108 + .../_vendor/typeguard/_decorators.py | 235 + .../_vendor/typeguard/_exceptions.py | 42 + .../_vendor/typeguard/_functions.py | 308 ++ .../_vendor/typeguard/_importhook.py | 213 + .../setuptools/_vendor/typeguard/_memo.py | 48 + .../_vendor/typeguard/_pytest_plugin.py | 127 + .../_vendor/typeguard/_suppression.py | 86 + .../_vendor/typeguard/_transformer.py | 1229 +++++ .../_vendor/typeguard/_union_transformer.py | 55 + .../setuptools/_vendor/typeguard/_utils.py | 173 + .../setuptools/_vendor/typeguard/py.typed | 0 .../INSTALLER | 1 + .../LICENSE | 279 + .../METADATA | 67 + .../typing_extensions-4.12.2.dist-info/RECORD | 7 + .../typing_extensions-4.12.2.dist-info/WHEEL | 4 + .../setuptools/_vendor/typing_extensions.py | 3641 +++++++++++++ .../_vendor/wheel-0.45.1.dist-info/INSTALLER | 1 + .../wheel-0.45.1.dist-info/LICENSE.txt | 21 + .../_vendor/wheel-0.45.1.dist-info/METADATA | 66 + .../_vendor/wheel-0.45.1.dist-info/RECORD | 68 + .../_vendor/wheel-0.45.1.dist-info/REQUESTED | 0 .../_vendor/wheel-0.45.1.dist-info/WHEEL | 4 + .../wheel-0.45.1.dist-info/entry_points.txt | 6 + .../setuptools/_vendor/wheel/__init__.py | 3 + .../setuptools/_vendor/wheel/__main__.py | 23 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 306 bytes .../__pycache__/__main__.cpython-312.pyc | Bin 0 -> 1041 bytes .../__pycache__/_bdist_wheel.cpython-312.pyc | Bin 0 -> 26086 bytes .../_setuptools_logging.cpython-312.pyc | Bin 0 -> 1452 bytes .../__pycache__/bdist_wheel.cpython-312.pyc | Bin 0 -> 818 bytes .../macosx_libfile.cpython-312.pyc | Bin 0 -> 16282 bytes .../__pycache__/metadata.cpython-312.pyc | Bin 0 -> 8718 bytes .../wheel/__pycache__/util.cpython-312.pyc | Bin 0 -> 994 bytes .../__pycache__/wheelfile.cpython-312.pyc | Bin 0 -> 11535 bytes .../setuptools/_vendor/wheel/_bdist_wheel.py | 613 +++ .../_vendor/wheel/_setuptools_logging.py | 26 + .../setuptools/_vendor/wheel/bdist_wheel.py | 26 + .../setuptools/_vendor/wheel/cli/__init__.py | 155 + .../cli/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 6974 bytes .../cli/__pycache__/convert.cpython-312.pyc | Bin 0 -> 16211 bytes .../cli/__pycache__/pack.cpython-312.pyc | Bin 0 -> 4502 bytes .../cli/__pycache__/tags.cpython-312.pyc | Bin 0 -> 6792 bytes .../cli/__pycache__/unpack.cpython-312.pyc | Bin 0 -> 1576 bytes .../setuptools/_vendor/wheel/cli/convert.py | 332 ++ .../setuptools/_vendor/wheel/cli/pack.py | 85 + .../setuptools/_vendor/wheel/cli/tags.py | 139 + .../setuptools/_vendor/wheel/cli/unpack.py | 30 + .../_vendor/wheel/macosx_libfile.py | 482 ++ .../setuptools/_vendor/wheel/metadata.py | 183 + .../setuptools/_vendor/wheel/util.py | 17 + .../_vendor/wheel/vendored/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 236 bytes .../_vendor/wheel/vendored/packaging/LICENSE | 3 + .../wheel/vendored/packaging/LICENSE.APACHE | 177 + .../wheel/vendored/packaging/LICENSE.BSD | 23 + .../wheel/vendored/packaging/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 246 bytes .../__pycache__/_elffile.cpython-312.pyc | Bin 0 -> 5079 bytes .../__pycache__/_manylinux.cpython-312.pyc | Bin 0 -> 9944 bytes .../__pycache__/_musllinux.cpython-312.pyc | Bin 0 -> 4627 bytes .../__pycache__/_parser.cpython-312.pyc | Bin 0 -> 14117 bytes .../__pycache__/_structures.cpython-312.pyc | Bin 0 -> 3294 bytes .../__pycache__/_tokenizer.cpython-312.pyc | Bin 0 -> 7990 bytes .../__pycache__/markers.cpython-312.pyc | Bin 0 -> 10567 bytes .../__pycache__/requirements.cpython-312.pyc | Bin 0 -> 4507 bytes .../__pycache__/specifiers.cpython-312.pyc | Bin 0 -> 39602 bytes .../__pycache__/tags.cpython-312.pyc | Bin 0 -> 21814 bytes .../__pycache__/utils.cpython-312.pyc | Bin 0 -> 7337 bytes .../__pycache__/version.cpython-312.pyc | Bin 0 -> 20050 bytes .../wheel/vendored/packaging/_elffile.py | 108 + .../wheel/vendored/packaging/_manylinux.py | 260 + .../wheel/vendored/packaging/_musllinux.py | 83 + .../wheel/vendored/packaging/_parser.py | 356 ++ .../wheel/vendored/packaging/_structures.py | 61 + .../wheel/vendored/packaging/_tokenizer.py | 192 + .../wheel/vendored/packaging/markers.py | 253 + .../wheel/vendored/packaging/requirements.py | 90 + .../wheel/vendored/packaging/specifiers.py | 1011 ++++ .../_vendor/wheel/vendored/packaging/tags.py | 571 ++ .../_vendor/wheel/vendored/packaging/utils.py | 172 + .../wheel/vendored/packaging/version.py | 561 ++ .../_vendor/wheel/vendored/vendor.txt | 1 + .../setuptools/_vendor/wheel/wheelfile.py | 227 + .../_vendor/zipp-3.19.2.dist-info/INSTALLER | 1 + .../_vendor/zipp-3.19.2.dist-info/LICENSE | 17 + .../_vendor/zipp-3.19.2.dist-info/METADATA | 102 + .../_vendor/zipp-3.19.2.dist-info/RECORD | 15 + .../_vendor/zipp-3.19.2.dist-info/REQUESTED | 0 .../_vendor/zipp-3.19.2.dist-info/WHEEL | 5 + .../zipp-3.19.2.dist-info/top_level.txt | 1 + .../setuptools/_vendor/zipp/__init__.py | 501 ++ .../zipp/__pycache__/__init__.cpython-312.pyc | Bin 0 -> 22799 bytes .../zipp/__pycache__/glob.cpython-312.pyc | Bin 0 -> 5296 bytes .../_vendor/zipp/compat/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 233 bytes .../compat/__pycache__/py310.cpython-312.pyc | Bin 0 -> 544 bytes .../setuptools/_vendor/zipp/compat/py310.py | 11 + .../setuptools/_vendor/zipp/glob.py | 106 + .../site-packages/setuptools/archive_util.py | 219 + .../site-packages/setuptools/build_meta.py | 548 ++ .../site-packages/setuptools/cli-32.exe | Bin 0 -> 11776 bytes .../site-packages/setuptools/cli-64.exe | Bin 0 -> 14336 bytes .../site-packages/setuptools/cli-arm64.exe | Bin 0 -> 13824 bytes .../site-packages/setuptools/cli.exe | Bin 0 -> 11776 bytes .../setuptools/command/__init__.py | 21 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 685 bytes .../__pycache__/_requirestxt.cpython-312.pyc | Bin 0 -> 6623 bytes .../command/__pycache__/alias.cpython-312.pyc | Bin 0 -> 3579 bytes .../__pycache__/bdist_egg.cpython-312.pyc | Bin 0 -> 24463 bytes .../__pycache__/bdist_rpm.cpython-312.pyc | Bin 0 -> 2124 bytes .../__pycache__/bdist_wheel.cpython-312.pyc | Bin 0 -> 26247 bytes .../command/__pycache__/build.cpython-312.pyc | Bin 0 -> 5471 bytes .../__pycache__/build_clib.cpython-312.pyc | Bin 0 -> 3866 bytes .../__pycache__/build_ext.cpython-312.pyc | Bin 0 -> 23390 bytes .../__pycache__/build_py.cpython-312.pyc | Bin 0 -> 21981 bytes .../__pycache__/develop.cpython-312.pyc | Bin 0 -> 2728 bytes .../__pycache__/dist_info.cpython-312.pyc | Bin 0 -> 5198 bytes .../__pycache__/easy_install.cpython-312.pyc | Bin 0 -> 1558 bytes .../editable_wheel.cpython-312.pyc | Bin 0 -> 48217 bytes .../__pycache__/egg_info.cpython-312.pyc | Bin 0 -> 34439 bytes .../__pycache__/install.cpython-312.pyc | Bin 0 -> 5933 bytes .../install_egg_info.cpython-312.pyc | Bin 0 -> 3796 bytes .../__pycache__/install_lib.cpython-312.pyc | Bin 0 -> 6145 bytes .../install_scripts.cpython-312.pyc | Bin 0 -> 3851 bytes .../__pycache__/rotate.cpython-312.pyc | Bin 0 -> 3758 bytes .../__pycache__/saveopts.cpython-312.pyc | Bin 0 -> 1305 bytes .../command/__pycache__/sdist.cpython-312.pyc | Bin 0 -> 12111 bytes .../__pycache__/setopt.cpython-312.pyc | Bin 0 -> 7092 bytes .../command/__pycache__/test.cpython-312.pyc | Bin 0 -> 1922 bytes .../setuptools/command/_requirestxt.py | 131 + .../site-packages/setuptools/command/alias.py | 77 + .../setuptools/command/bdist_egg.py | 477 ++ .../setuptools/command/bdist_rpm.py | 42 + .../setuptools/command/bdist_wheel.py | 604 +++ .../site-packages/setuptools/command/build.py | 135 + .../setuptools/command/build_clib.py | 103 + .../setuptools/command/build_ext.py | 470 ++ .../setuptools/command/build_py.py | 400 ++ .../setuptools/command/develop.py | 55 + .../setuptools/command/dist_info.py | 103 + .../setuptools/command/easy_install.py | 30 + .../setuptools/command/editable_wheel.py | 908 ++++ .../setuptools/command/egg_info.py | 718 +++ .../setuptools/command/install.py | 131 + .../setuptools/command/install_egg_info.py | 58 + .../setuptools/command/install_lib.py | 137 + .../setuptools/command/install_scripts.py | 67 + .../setuptools/command/launcher manifest.xml | 15 + .../setuptools/command/rotate.py | 65 + .../setuptools/command/saveopts.py | 21 + .../site-packages/setuptools/command/sdist.py | 217 + .../setuptools/command/setopt.py | 141 + .../site-packages/setuptools/command/test.py | 45 + .../setuptools/compat/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 220 bytes .../compat/__pycache__/py310.cpython-312.pyc | Bin 0 -> 820 bytes .../compat/__pycache__/py311.cpython-312.pyc | Bin 0 -> 1463 bytes .../compat/__pycache__/py312.cpython-312.pyc | Bin 0 -> 503 bytes .../compat/__pycache__/py39.cpython-312.pyc | Bin 0 -> 349 bytes .../site-packages/setuptools/compat/py310.py | 20 + .../site-packages/setuptools/compat/py311.py | 27 + .../site-packages/setuptools/compat/py312.py | 13 + .../site-packages/setuptools/compat/py39.py | 9 + .../site-packages/setuptools/config/NOTICE | 10 + .../setuptools/config/__init__.py | 43 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 2045 bytes .../_apply_pyprojecttoml.cpython-312.pyc | Bin 0 -> 25342 bytes .../config/__pycache__/expand.cpython-312.pyc | Bin 0 -> 24599 bytes .../__pycache__/pyprojecttoml.cpython-312.pyc | Bin 0 -> 23396 bytes .../__pycache__/setupcfg.cpython-312.pyc | Bin 0 -> 33190 bytes .../setuptools/config/_apply_pyprojecttoml.py | 526 ++ .../config/_validate_pyproject/NOTICE | 438 ++ .../config/_validate_pyproject/__init__.py | 34 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 1902 bytes .../error_reporting.cpython-312.pyc | Bin 0 -> 18406 bytes .../extra_validations.cpython-312.pyc | Bin 0 -> 3176 bytes .../fastjsonschema_exceptions.cpython-312.pyc | Bin 0 -> 2874 bytes ...fastjsonschema_validations.cpython-312.pyc | Bin 0 -> 233706 bytes .../__pycache__/formats.cpython-312.pyc | Bin 0 -> 18502 bytes .../_validate_pyproject/error_reporting.py | 336 ++ .../_validate_pyproject/extra_validations.py | 82 + .../fastjsonschema_exceptions.py | 51 + .../fastjsonschema_validations.py | 1412 +++++ .../config/_validate_pyproject/formats.py | 402 ++ .../setuptools/config/distutils.schema.json | 26 + .../site-packages/setuptools/config/expand.py | 452 ++ .../setuptools/config/pyprojecttoml.py | 468 ++ .../setuptools/config/setupcfg.py | 780 +++ .../setuptools/config/setuptools.schema.json | 433 ++ .../site-packages/setuptools/depends.py | 185 + .../site-packages/setuptools/discovery.py | 614 +++ .../site-packages/setuptools/dist.py | 1119 ++++ .../site-packages/setuptools/errors.py | 67 + .../site-packages/setuptools/extension.py | 177 + .../site-packages/setuptools/glob.py | 185 + .../site-packages/setuptools/gui-32.exe | Bin 0 -> 11776 bytes .../site-packages/setuptools/gui-64.exe | Bin 0 -> 14336 bytes .../site-packages/setuptools/gui-arm64.exe | Bin 0 -> 13824 bytes .../site-packages/setuptools/gui.exe | Bin 0 -> 11776 bytes .../site-packages/setuptools/installer.py | 155 + .../site-packages/setuptools/launch.py | 36 + .../site-packages/setuptools/logging.py | 40 + .../site-packages/setuptools/modified.py | 18 + .../site-packages/setuptools/monkey.py | 126 + .../site-packages/setuptools/msvc.py | 1536 ++++++ .../site-packages/setuptools/namespaces.py | 106 + .../setuptools/script (dev).tmpl | 6 + .../site-packages/setuptools/script.tmpl | 3 + .../setuptools/tests/__init__.py | 13 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 728 bytes .../__pycache__/contexts.cpython-312.pyc | Bin 0 -> 6636 bytes .../__pycache__/environment.cpython-312.pyc | Bin 0 -> 3585 bytes .../__pycache__/fixtures.cpython-312.pyc | Bin 0 -> 15449 bytes .../mod_with_constant.cpython-312.pyc | Bin 0 -> 254 bytes .../__pycache__/namespaces.cpython-312.pyc | Bin 0 -> 4244 bytes .../script-with-bom.cpython-312.pyc | Bin 0 -> 248 bytes .../test_archive_util.cpython-312.pyc | Bin 0 -> 1916 bytes .../test_bdist_deprecations.cpython-312.pyc | Bin 0 -> 1610 bytes .../test_bdist_egg.cpython-312.pyc | Bin 0 -> 4197 bytes .../test_bdist_wheel.cpython-312.pyc | Bin 0 -> 33593 bytes .../__pycache__/test_build.cpython-312.pyc | Bin 0 -> 1633 bytes .../test_build_clib.cpython-312.pyc | Bin 0 -> 4206 bytes .../test_build_ext.cpython-312.pyc | Bin 0 -> 13434 bytes .../test_build_meta.cpython-312.pyc | Bin 0 -> 43329 bytes .../__pycache__/test_build_py.cpython-312.pyc | Bin 0 -> 17052 bytes .../test_config_discovery.cpython-312.pyc | Bin 0 -> 30667 bytes .../test_core_metadata.cpython-312.pyc | Bin 0 -> 23196 bytes .../__pycache__/test_depends.cpython-312.pyc | Bin 0 -> 961 bytes .../__pycache__/test_develop.cpython-312.pyc | Bin 0 -> 5427 bytes .../__pycache__/test_dist.cpython-312.pyc | Bin 0 -> 10995 bytes .../test_dist_info.cpython-312.pyc | Bin 0 -> 7804 bytes .../test_distutils_adoption.cpython-312.pyc | Bin 0 -> 8259 bytes .../test_editable_install.cpython-312.pyc | Bin 0 -> 57331 bytes .../__pycache__/test_egg_info.cpython-312.pyc | Bin 0 -> 48175 bytes .../__pycache__/test_extern.cpython-312.pyc | Bin 0 -> 876 bytes .../test_find_packages.cpython-312.pyc | Bin 0 -> 12218 bytes .../test_find_py_modules.cpython-312.pyc | Bin 0 -> 3834 bytes .../__pycache__/test_glob.cpython-312.pyc | Bin 0 -> 1289 bytes .../test_install_scripts.cpython-312.pyc | Bin 0 -> 6243 bytes .../__pycache__/test_logging.cpython-312.pyc | Bin 0 -> 3220 bytes .../__pycache__/test_manifest.cpython-312.pyc | Bin 0 -> 26796 bytes .../test_namespaces.cpython-312.pyc | Bin 0 -> 5591 bytes .../__pycache__/test_scripts.cpython-312.pyc | Bin 0 -> 1036 bytes .../__pycache__/test_sdist.cpython-312.pyc | Bin 0 -> 46444 bytes .../__pycache__/test_setopt.cpython-312.pyc | Bin 0 -> 2910 bytes .../test_setuptools.cpython-312.pyc | Bin 0 -> 17719 bytes .../test_shutil_wrapper.cpython-312.pyc | Bin 0 -> 1383 bytes .../test_unicode_utils.cpython-312.pyc | Bin 0 -> 837 bytes .../test_virtualenv.cpython-312.pyc | Bin 0 -> 4486 bytes .../__pycache__/test_warnings.cpython-312.pyc | Bin 0 -> 4180 bytes .../__pycache__/test_wheel.cpython-312.pyc | Bin 0 -> 18372 bytes .../test_windows_wrappers.cpython-312.pyc | Bin 0 -> 10566 bytes .../tests/__pycache__/text.cpython-312.pyc | Bin 0 -> 555 bytes .../__pycache__/textwrap.cpython-312.pyc | Bin 0 -> 471 bytes .../setuptools/tests/compat/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 226 bytes .../compat/__pycache__/py39.cpython-312.pyc | Bin 0 -> 393 bytes .../setuptools/tests/compat/py39.py | 3 + .../setuptools/tests/config/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 226 bytes .../test_apply_pyprojecttoml.cpython-312.pyc | Bin 0 -> 40273 bytes .../__pycache__/test_expand.cpython-312.pyc | Bin 0 -> 11728 bytes .../test_pyprojecttoml.cpython-312.pyc | Bin 0 -> 15895 bytes ...pyprojecttoml_dynamic_deps.cpython-312.pyc | Bin 0 -> 4291 bytes .../__pycache__/test_setupcfg.cpython-312.pyc | Bin 0 -> 43709 bytes .../tests/config/downloads/__init__.py | 59 + .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 3154 bytes .../__pycache__/preload.cpython-312.pyc | Bin 0 -> 824 bytes .../tests/config/downloads/preload.py | 18 + .../tests/config/setupcfg_examples.txt | 22 + .../tests/config/test_apply_pyprojecttoml.py | 772 +++ .../setuptools/tests/config/test_expand.py | 247 + .../tests/config/test_pyprojecttoml.py | 396 ++ .../config/test_pyprojecttoml_dynamic_deps.py | 109 + .../setuptools/tests/config/test_setupcfg.py | 980 ++++ .../setuptools/tests/contexts.py | 131 + .../setuptools/tests/environment.py | 95 + .../setuptools/tests/fixtures.py | 392 ++ .../indexes/test_links_priority/external.html | 3 + .../simple/foobar/index.html | 4 + .../setuptools/tests/integration/__init__.py | 0 .../__pycache__/__init__.cpython-312.pyc | Bin 0 -> 231 bytes .../__pycache__/helpers.cpython-312.pyc | Bin 0 -> 4674 bytes .../__pycache__/test_pbr.cpython-312.pyc | Bin 0 -> 881 bytes .../test_pip_install_sdist.cpython-312.pyc | Bin 0 -> 9162 bytes .../setuptools/tests/integration/helpers.py | 77 + .../setuptools/tests/integration/test_pbr.py | 20 + .../integration/test_pip_install_sdist.py | 223 + .../setuptools/tests/mod_with_constant.py | 1 + .../setuptools/tests/namespaces.py | 90 + .../setuptools/tests/script-with-bom.py | 1 + .../setuptools/tests/test_archive_util.py | 36 + .../tests/test_bdist_deprecations.py | 28 + .../setuptools/tests/test_bdist_egg.py | 73 + .../setuptools/tests/test_bdist_wheel.py | 708 +++ .../setuptools/tests/test_build.py | 33 + .../setuptools/tests/test_build_clib.py | 84 + .../setuptools/tests/test_build_ext.py | 293 + .../setuptools/tests/test_build_meta.py | 959 ++++ .../setuptools/tests/test_build_py.py | 480 ++ .../setuptools/tests/test_config_discovery.py | 647 +++ .../setuptools/tests/test_core_metadata.py | 622 +++ .../setuptools/tests/test_depends.py | 15 + .../setuptools/tests/test_develop.py | 112 + .../setuptools/tests/test_dist.py | 278 + .../setuptools/tests/test_dist_info.py | 147 + .../tests/test_distutils_adoption.py | 198 + .../setuptools/tests/test_editable_install.py | 1263 +++++ .../setuptools/tests/test_egg_info.py | 1306 +++++ .../setuptools/tests/test_extern.py | 15 + .../setuptools/tests/test_find_packages.py | 218 + .../setuptools/tests/test_find_py_modules.py | 73 + .../setuptools/tests/test_glob.py | 45 + .../setuptools/tests/test_install_scripts.py | 89 + .../setuptools/tests/test_logging.py | 76 + .../setuptools/tests/test_manifest.py | 622 +++ .../setuptools/tests/test_namespaces.py | 138 + .../setuptools/tests/test_scripts.py | 12 + .../setuptools/tests/test_sdist.py | 984 ++++ .../setuptools/tests/test_setopt.py | 40 + .../setuptools/tests/test_setuptools.py | 290 + .../setuptools/tests/test_shutil_wrapper.py | 23 + .../setuptools/tests/test_unicode_utils.py | 10 + .../setuptools/tests/test_virtualenv.py | 113 + .../setuptools/tests/test_warnings.py | 106 + .../setuptools/tests/test_wheel.py | 690 +++ .../setuptools/tests/test_windows_wrappers.py | 258 + .../site-packages/setuptools/tests/text.py | 4 + .../setuptools/tests/textwrap.py | 6 + .../site-packages/setuptools/unicode_utils.py | 102 + .../site-packages/setuptools/version.py | 6 + .../site-packages/setuptools/warnings.py | 110 + .../site-packages/setuptools/wheel.py | 261 + .../setuptools/windows_support.py | 30 + 869 files changed, 107490 insertions(+) create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/_distutils_hack/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/_distutils_hack/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/_distutils_hack/__pycache__/override.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/_distutils_hack/override.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/distutils-precedence.pth create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/api_tests.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/py.typed create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_find_distributions.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_integration_zope_interface.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_markers.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_pkg_resources.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_resources.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_working_set.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package-source/__pycache__/setup.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package-source/setup.cfg create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package-source/setup.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package-zip/my-test-package.zip create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/PKG-INFO create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/SOURCES.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/dependency_links.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/top_level.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/zip-safe create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/data/my-test-package_zipped-egg/my_test_package-1.0-py3.7.egg create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_find_distributions.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_integration_zope_interface.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_markers.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_pkg_resources.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_resources.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_working_set.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/REQUESTED create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/entry_points.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/licenses/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/top_level.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_core_metadata.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_discovery.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_entry_points.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_imp.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_importlib.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_itertools.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_normalization.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_path.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_reqs.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_scripts.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_shutil.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_static.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/archive_util.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/build_meta.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/depends.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/discovery.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/dist.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/errors.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/extension.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/glob.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/installer.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/launch.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/logging.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/modified.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/monkey.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/msvc.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/namespaces.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/unicode_utils.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/version.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/warnings.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/wheel.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/windows_support.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_core_metadata.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_discovery.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/_log.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/_macos_compat.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/_modified.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/_msvccompiler.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/archive_util.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/ccompiler.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/cmd.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/core.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/cygwinccompiler.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/debug.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/dep_util.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/dir_util.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/dist.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/errors.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/extension.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/fancy_getopt.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/file_util.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/filelist.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/log.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/spawn.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/sysconfig.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/text_file.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/unixccompiler.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/util.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/version.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/versionpredicate.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/zosccompiler.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_log.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_macos_compat.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_modified.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_msvccompiler.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/archive_util.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/ccompiler.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/cmd.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/_framework_compat.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/bdist.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/bdist_dumb.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/bdist_rpm.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/build.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/build_clib.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/build_ext.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/build_py.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/build_scripts.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/check.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/clean.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/config.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/install.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/install_data.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/install_egg_info.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/install_headers.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/install_lib.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/install_scripts.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/sdist.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/_framework_compat.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/bdist.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/bdist_dumb.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/bdist_rpm.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_clib.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_ext.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_py.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_scripts.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/check.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/clean.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/config.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_data.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_egg_info.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_headers.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_lib.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_scripts.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/sdist.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compat/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compat/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compat/__pycache__/numpy.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compat/__pycache__/py39.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compat/numpy.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compat/py39.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/__pycache__/base.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/__pycache__/cygwin.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/__pycache__/errors.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/__pycache__/msvc.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/__pycache__/unix.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/__pycache__/zos.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/base.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/cygwin.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/errors.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/msvc.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/__pycache__/test_base.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/__pycache__/test_cygwin.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/__pycache__/test_mingw.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/__pycache__/test_msvc.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/__pycache__/test_unix.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_base.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_cygwin.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_mingw.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_msvc.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_unix.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/unix.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/zos.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/core.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/cygwinccompiler.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/debug.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/dep_util.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/dir_util.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/dist.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/errors.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/extension.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/fancy_getopt.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/file_util.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/filelist.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/log.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/spawn.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/sysconfig.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/support.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_archive_util.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_bdist.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_bdist_dumb.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_bdist_rpm.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_build.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_build_clib.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_build_ext.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_build_py.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_build_scripts.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_check.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_clean.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_cmd.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_config_cmd.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_core.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_dir_util.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_dist.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_extension.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_file_util.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_filelist.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_install.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_install_data.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_install_headers.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_install_lib.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_install_scripts.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_log.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_modified.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_sdist.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_spawn.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_sysconfig.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_text_file.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_util.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_version.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_versionpredicate.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/unix_compat.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/compat/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/compat/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/compat/__pycache__/py39.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/compat/py39.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/support.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_archive_util.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist_dumb.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist_rpm.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_clib.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_ext.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_py.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_scripts.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_check.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_clean.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_cmd.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_config_cmd.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_core.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_dir_util.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_dist.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_extension.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_file_util.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_filelist.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_data.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_headers.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_lib.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_scripts.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_log.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_modified.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_sdist.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_spawn.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_sysconfig.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_text_file.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_util.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_version.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_versionpredicate.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/unix_compat.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/text_file.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/unixccompiler.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/util.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/version.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/versionpredicate.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/zosccompiler.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_entry_points.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_imp.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_importlib.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_itertools.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_normalization.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_path.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_reqs.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_scripts.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_shutil.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_static.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/__pycache__/typing_extensions.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/top_level.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__pycache__/autoasync.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__pycache__/autocommand.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__pycache__/automain.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__pycache__/autoparse.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__pycache__/errors.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autoasync.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autocommand.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/automain.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autoparse.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/errors.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/REQUESTED create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/top_level.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__main__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__pycache__/__main__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/compat/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/compat/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/compat/__pycache__/py38.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/compat/py38.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/REQUESTED create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/top_level.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_adapters.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_collections.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_compat.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_functools.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_itertools.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_meta.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_text.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/diagnose.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_adapters.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_collections.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_compat.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_functools.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_itertools.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_meta.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_text.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/__pycache__/py311.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/__pycache__/py39.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/py311.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/py39.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/diagnose.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/py.typed create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/top_level.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/compat/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/compat/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/compat/__pycache__/py38.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/compat/py38.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/py.typed create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/REQUESTED create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/top_level.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/top_level.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/top_level.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/REQUESTED create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/top_level.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/__pycache__/context.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/py.typed create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/context.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__init__.pyi create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/py.typed create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/Lorem ipsum.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/__pycache__/layouts.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/__pycache__/show-newlines.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/__pycache__/strip-prefix.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/__pycache__/to-dvorak.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/__pycache__/to-qwerty.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/layouts.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/show-newlines.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/strip-prefix.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/to-dvorak.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/to-qwerty.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/REQUESTED create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__init__.pyi create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__pycache__/more.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__pycache__/recipes.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/more.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/more.pyi create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/py.typed create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/recipes.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/recipes.pyi create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE.APACHE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE.BSD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/REQUESTED create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/_elffile.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/_manylinux.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/_parser.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/_structures.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/_tokenizer.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/markers.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/metadata.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/requirements.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/tags.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/utils.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/version.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_elffile.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_manylinux.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_musllinux.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_parser.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_structures.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_tokenizer.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/__pycache__/_spdx.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/_spdx.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/markers.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/metadata.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/py.typed create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/requirements.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/specifiers.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/tags.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/utils.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/version.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/REQUESTED create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/licenses/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__main__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__pycache__/__main__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__pycache__/android.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__pycache__/api.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__pycache__/macos.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__pycache__/unix.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__pycache__/version.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__pycache__/windows.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/android.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/api.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/macos.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/py.typed create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/unix.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/version.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/windows.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/REQUESTED create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/__pycache__/_parser.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/__pycache__/_re.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/__pycache__/_types.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/_parser.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/_re.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/_types.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/py.typed create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/entry_points.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/top_level.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_checkers.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_config.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_decorators.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_exceptions.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_functions.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_importhook.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_memo.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_pytest_plugin.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_suppression.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_transformer.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_union_transformer.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_utils.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_checkers.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_config.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_decorators.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_exceptions.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_functions.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_importhook.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_memo.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_pytest_plugin.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_suppression.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_transformer.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_union_transformer.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_utils.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/py.typed create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/LICENSE.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/REQUESTED create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/entry_points.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__main__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/__main__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/_bdist_wheel.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/_setuptools_logging.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/bdist_wheel.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/macosx_libfile.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/metadata.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/util.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/wheelfile.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/_bdist_wheel.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/_setuptools_logging.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/bdist_wheel.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__pycache__/convert.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__pycache__/pack.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__pycache__/tags.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__pycache__/unpack.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/convert.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/pack.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/tags.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/unpack.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/macosx_libfile.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/metadata.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/util.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE.APACHE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE.BSD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/_elffile.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/_manylinux.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/_musllinux.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/_parser.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/_structures.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/_tokenizer.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/markers.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/requirements.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/specifiers.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/tags.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/utils.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/version.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_elffile.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_manylinux.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_musllinux.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_parser.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_structures.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_tokenizer.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/markers.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/requirements.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/specifiers.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/tags.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/utils.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/version.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/vendor.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/wheelfile.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/INSTALLER create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/LICENSE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/METADATA create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/RECORD create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/REQUESTED create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/WHEEL create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/top_level.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/__pycache__/glob.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/__pycache__/py310.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/py310.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/glob.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/archive_util.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/build_meta.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/cli-32.exe create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/cli-64.exe create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/cli-arm64.exe create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/cli.exe create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/_requirestxt.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/alias.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/bdist_egg.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/bdist_rpm.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/bdist_wheel.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/build.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/build_clib.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/build_ext.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/build_py.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/develop.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/dist_info.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/easy_install.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/editable_wheel.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/egg_info.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/install.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/install_egg_info.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/install_lib.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/install_scripts.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/rotate.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/saveopts.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/sdist.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/setopt.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/test.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/_requirestxt.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/alias.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/bdist_egg.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/bdist_rpm.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/bdist_wheel.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build_clib.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build_ext.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build_py.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/develop.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/dist_info.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/easy_install.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/editable_wheel.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/egg_info.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install_egg_info.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install_lib.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install_scripts.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/launcher manifest.xml create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/rotate.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/saveopts.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/sdist.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/setopt.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/test.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/py310.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/py311.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/py312.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/py39.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/py310.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/py311.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/py312.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/py39.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/NOTICE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__pycache__/_apply_pyprojecttoml.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__pycache__/expand.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__pycache__/pyprojecttoml.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__pycache__/setupcfg.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_apply_pyprojecttoml.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/NOTICE create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__pycache__/error_reporting.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__pycache__/extra_validations.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__pycache__/fastjsonschema_exceptions.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__pycache__/fastjsonschema_validations.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__pycache__/formats.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/error_reporting.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/extra_validations.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_exceptions.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_validations.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/formats.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/distutils.schema.json create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/expand.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/pyprojecttoml.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/setupcfg.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/setuptools.schema.json create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/depends.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/discovery.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/dist.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/errors.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/extension.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/glob.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/gui-32.exe create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/gui-64.exe create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/gui-arm64.exe create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/gui.exe create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/installer.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/launch.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/logging.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/modified.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/monkey.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/msvc.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/namespaces.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/script (dev).tmpl create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/script.tmpl create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/contexts.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/environment.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/fixtures.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/mod_with_constant.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/namespaces.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/script-with-bom.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_archive_util.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_bdist_deprecations.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_bdist_egg.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_bdist_wheel.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_build.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_build_clib.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_build_ext.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_build_meta.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_build_py.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_config_discovery.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_core_metadata.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_depends.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_develop.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_dist.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_dist_info.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_distutils_adoption.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_editable_install.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_egg_info.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_extern.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_find_packages.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_find_py_modules.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_glob.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_install_scripts.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_logging.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_manifest.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_namespaces.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_scripts.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_sdist.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_setopt.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_setuptools.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_shutil_wrapper.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_unicode_utils.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_virtualenv.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_warnings.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_wheel.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_windows_wrappers.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/text.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/textwrap.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/compat/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/compat/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/compat/__pycache__/py39.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/compat/py39.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/__pycache__/test_apply_pyprojecttoml.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/__pycache__/test_expand.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/__pycache__/test_pyprojecttoml.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/__pycache__/test_pyprojecttoml_dynamic_deps.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/__pycache__/test_setupcfg.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/downloads/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/downloads/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/downloads/__pycache__/preload.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/downloads/preload.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/setupcfg_examples.txt create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_apply_pyprojecttoml.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_expand.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_pyprojecttoml.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_pyprojecttoml_dynamic_deps.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_setupcfg.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/contexts.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/environment.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/fixtures.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/indexes/test_links_priority/external.html create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/indexes/test_links_priority/simple/foobar/index.html create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/__init__.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/__pycache__/__init__.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/__pycache__/helpers.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/__pycache__/test_pbr.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/__pycache__/test_pip_install_sdist.cpython-312.pyc create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/helpers.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/test_pbr.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/test_pip_install_sdist.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/mod_with_constant.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/namespaces.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/script-with-bom.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_archive_util.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_bdist_deprecations.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_bdist_egg.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_bdist_wheel.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_clib.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_ext.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_meta.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_py.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_config_discovery.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_core_metadata.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_depends.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_develop.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_dist.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_dist_info.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_distutils_adoption.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_editable_install.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_egg_info.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_extern.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_find_packages.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_find_py_modules.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_glob.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_install_scripts.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_logging.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_manifest.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_namespaces.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_scripts.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_sdist.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_setopt.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_setuptools.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_shutil_wrapper.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_unicode_utils.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_virtualenv.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_warnings.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_wheel.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_windows_wrappers.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/text.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/textwrap.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/unicode_utils.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/version.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/warnings.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/wheel.py create mode 100644 ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/windows_support.py diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/_distutils_hack/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/_distutils_hack/__init__.py new file mode 100644 index 000000000..94f71b99e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/_distutils_hack/__init__.py @@ -0,0 +1,239 @@ +# don't import any costly modules +import os +import sys + +report_url = ( + "https://github.com/pypa/setuptools/issues/new?template=distutils-deprecation.yml" +) + + +def warn_distutils_present(): + if 'distutils' not in sys.modules: + return + import warnings + + warnings.warn( + "Distutils was imported before Setuptools, but importing Setuptools " + "also replaces the `distutils` module in `sys.modules`. This may lead " + "to undesirable behaviors or errors. To avoid these issues, avoid " + "using distutils directly, ensure that setuptools is installed in the " + "traditional way (e.g. not an editable install), and/or make sure " + "that setuptools is always imported before distutils." + ) + + +def clear_distutils(): + if 'distutils' not in sys.modules: + return + import warnings + + warnings.warn( + "Setuptools is replacing distutils. Support for replacing " + "an already imported distutils is deprecated. In the future, " + "this condition will fail. " + f"Register concerns at {report_url}" + ) + mods = [ + name + for name in sys.modules + if name == "distutils" or name.startswith("distutils.") + ] + for name in mods: + del sys.modules[name] + + +def enabled(): + """ + Allow selection of distutils by environment variable. + """ + which = os.environ.get('SETUPTOOLS_USE_DISTUTILS', 'local') + if which == 'stdlib': + import warnings + + warnings.warn( + "Reliance on distutils from stdlib is deprecated. Users " + "must rely on setuptools to provide the distutils module. " + "Avoid importing distutils or import setuptools first, " + "and avoid setting SETUPTOOLS_USE_DISTUTILS=stdlib. " + f"Register concerns at {report_url}" + ) + return which == 'local' + + +def ensure_local_distutils(): + import importlib + + clear_distutils() + + # With the DistutilsMetaFinder in place, + # perform an import to cause distutils to be + # loaded from setuptools._distutils. Ref #2906. + with shim(): + importlib.import_module('distutils') + + # check that submodules load as expected + core = importlib.import_module('distutils.core') + assert '_distutils' in core.__file__, core.__file__ + assert 'setuptools._distutils.log' not in sys.modules + + +def do_override(): + """ + Ensure that the local copy of distutils is preferred over stdlib. + + See https://github.com/pypa/setuptools/issues/417#issuecomment-392298401 + for more motivation. + """ + if enabled(): + warn_distutils_present() + ensure_local_distutils() + + +class _TrivialRe: + def __init__(self, *patterns) -> None: + self._patterns = patterns + + def match(self, string): + return all(pat in string for pat in self._patterns) + + +class DistutilsMetaFinder: + def find_spec(self, fullname, path, target=None): + # optimization: only consider top level modules and those + # found in the CPython test suite. + if path is not None and not fullname.startswith('test.'): + return None + + method_name = 'spec_for_{fullname}'.format(**locals()) + method = getattr(self, method_name, lambda: None) + return method() + + def spec_for_distutils(self): + if self.is_cpython(): + return None + + import importlib + import importlib.abc + import importlib.util + + try: + mod = importlib.import_module('setuptools._distutils') + except Exception: + # There are a couple of cases where setuptools._distutils + # may not be present: + # - An older Setuptools without a local distutils is + # taking precedence. Ref #2957. + # - Path manipulation during sitecustomize removes + # setuptools from the path but only after the hook + # has been loaded. Ref #2980. + # In either case, fall back to stdlib behavior. + return None + + class DistutilsLoader(importlib.abc.Loader): + def create_module(self, spec): + mod.__name__ = 'distutils' + return mod + + def exec_module(self, module): + pass + + return importlib.util.spec_from_loader( + 'distutils', DistutilsLoader(), origin=mod.__file__ + ) + + @staticmethod + def is_cpython(): + """ + Suppress supplying distutils for CPython (build and tests). + Ref #2965 and #3007. + """ + return os.path.isfile('pybuilddir.txt') + + def spec_for_pip(self): + """ + Ensure stdlib distutils when running under pip. + See pypa/pip#8761 for rationale. + """ + if sys.version_info >= (3, 12) or self.pip_imported_during_build(): + return + clear_distutils() + self.spec_for_distutils = lambda: None + + @classmethod + def pip_imported_during_build(cls): + """ + Detect if pip is being imported in a build script. Ref #2355. + """ + import traceback + + return any( + cls.frame_file_is_setup(frame) for frame, line in traceback.walk_stack(None) + ) + + @staticmethod + def frame_file_is_setup(frame): + """ + Return True if the indicated frame suggests a setup.py file. + """ + # some frames may not have __file__ (#2940) + return frame.f_globals.get('__file__', '').endswith('setup.py') + + def spec_for_sensitive_tests(self): + """ + Ensure stdlib distutils when running select tests under CPython. + + python/cpython#91169 + """ + clear_distutils() + self.spec_for_distutils = lambda: None + + sensitive_tests = ( + [ + 'test.test_distutils', + 'test.test_peg_generator', + 'test.test_importlib', + ] + if sys.version_info < (3, 10) + else [ + 'test.test_distutils', + ] + ) + + +for name in DistutilsMetaFinder.sensitive_tests: + setattr( + DistutilsMetaFinder, + f'spec_for_{name}', + DistutilsMetaFinder.spec_for_sensitive_tests, + ) + + +DISTUTILS_FINDER = DistutilsMetaFinder() + + +def add_shim(): + DISTUTILS_FINDER in sys.meta_path or insert_shim() + + +class shim: + def __enter__(self) -> None: + insert_shim() + + def __exit__(self, exc: object, value: object, tb: object) -> None: + _remove_shim() + + +def insert_shim(): + sys.meta_path.insert(0, DISTUTILS_FINDER) + + +def _remove_shim(): + try: + sys.meta_path.remove(DISTUTILS_FINDER) + except ValueError: + pass + + +if sys.version_info < (3, 12): + # DistutilsMetaFinder can only be disabled in Python < 3.12 (PEP 632) + remove_shim = _remove_shim diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/_distutils_hack/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/_distutils_hack/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c65ede16b71d9046072cf30cc9e6abab5a3e3c29 GIT binary patch literal 10631 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 z zim#g%`AV0XA3eZ6IuLj)r2I=zLcT=MNl@rnd<5Aa7iFm^V3NzykTB4(n&^o?Y)21SK+Qm$6ajgZh7N6dbGW7nQt4~W{0JGXD&U9BuN z7K)-Pg4S{SqzxD#$lwQ&IsS}AzF?iMWI%o6H{8^RvkoQE_Shik3Y1Fh>OC2vznl%Nc!qh1?{1y^>DU}e#8i$5U63>cM zlw)emu9y9|a!AOiK(9VFXy$Z2lA{Q@xHI5-AycSsCOK~6Vg{ufAKblbhZ_yEIgD0o+8}9Zeoi4tA+)xnuBzkEpBK^<{(S68iB+C<`G2SkVSL zVfcC$fB^1Mf8JS*o=F!mOe1NGkS~!Gd?G>z{7=y3vLt}Oy&Q1GK3qFF;rE{t6XZGLCd?AE8Iw?1`s>(g`LmTTIotJ>;MHpC~?kG1u;vW{oz z9>HL5VBaWgiMWweb>oH3g}DL4VHt)&kh5$Kb$hmXr350WmY(xOvfH!~sMIt4boLZ4 z>@$fSDw{?3IVs#&ku+Lqo+;QAog)d{`M?8J4sauqOB`J~@tt@UpFmdQ`@uW<4rJrB zbXtb>QfsxL9i>yA`Cj%7?^@y;!aZ*7=j1Snzz$?om@dHa?da_IM4h8%Gda^y(pk$Q zLVz2te&R$@>5=7*^0quu!*dmf^D;)U?m_1Ik_$|34Ste%=$(-djfux+!yBi=8!sK4 z4R5`!prY(scHAw&r48U_EN%ATMhH48S9F47sqBd)Lip(u(DVh-WKN$z^%ei%1HN?D07Ai13W{qkIH6ll>wT4R77RI}m60Sxq1AbZI#@$dI=~vh2N|cSS zjeBtsexC-<=kQOp!1a|X5 zeAOJE(|)^QOWVE)5r0R+QlL(#{Xly?YJ&#akuT_WD5l(O6@dWCs=?#Zs%l}u97qy^ z@D#3+OEs-MW0rpxBZ;s;ELv}MAEGMKR8AOhVQ12=A1>?{o}uzkI-9braxsC1U}IjS zFVYgcpISxhcDmjk+D9!ZGw@iiAfu3y=4)SAvECP)e@tTjmg}<5w|!B;7p|gx+ZP%& zUt)d*^EY2d!yr{O&(jx`iN;S!UhAi%g~kRn@2INCfh(bVaPb!iURRiJ1&rLthIvJ9 z3|^1orw|uGkQ4BZbqOPS;zPbht*K>GjYva;V|8hios_IFZeAKH6;*L7GWuT+_as!O z$-9Y5K5?k0``{7R$OvGoQxvKlbVB%71``*ubO%wlp^la^5Urt#aZL2@c*>^aHFd?$ zmA4}oBU9=VLH8&v2HLS2_|HLXFxvslm7 z%SAJn)v%IHmZV4(O)UO{Np^!i*gJs=ub~B;Bf-G@Rs5)5nmB*T{u7V23K>pTZJ_@| znN{1T)%FX`SJ!U)Sna%(b-hIlq1Sm9_#^J@YZg(~ezXY0wJKu4ZjEcXg6sMM++Cl` zG-7>D@I_+7gY@4}^=o|-baKl63y(zt2c<46zQ{E#MAyKx+S+Mt?bUUiA8YZiu7$)u zGDJSn!t=QCi`*0u_}4aWW`7yzQhp_MDZCFO#M)dhRO~i|LEK9!p}y!QiEp5c%t<$% zFA(?@`WZ#$G{A2ntNlm!uv^?gf196<^#1jCYlp`%&qSlAMk)-G&nlpb2x5RmTvvfU@`yUvh(*$Jv m0`g|DIFR_j%*e=ilY#33x6EY*+3O6N7a26KGH4gE0p$Ro9#;qe literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/_distutils_hack/override.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/_distutils_hack/override.py new file mode 100644 index 000000000..2cc433a4a --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/_distutils_hack/override.py @@ -0,0 +1 @@ +__import__('_distutils_hack').do_override() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/distutils-precedence.pth b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/distutils-precedence.pth new file mode 100644 index 000000000..7f009fe9b --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/distutils-precedence.pth @@ -0,0 +1 @@ +import os; var = 'SETUPTOOLS_USE_DISTUTILS'; enabled = os.environ.get(var, 'local') == 'local'; enabled and __import__('_distutils_hack').add_shim(); diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/__init__.py new file mode 100644 index 000000000..926765b88 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/__init__.py @@ -0,0 +1,3713 @@ +""" +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, 9): # noqa: UP036 # Check for unsupported versions + raise RuntimeError("Python 3.9 or later is required") + +import _imp +import collections +import email.parser +import errno +import functools +import importlib +import importlib.abc +import importlib.machinery +import inspect +import io +import ntpath +import operator +import os +import pkgutil +import platform +import plistlib +import posixpath +import re +import stat +import tempfile +import textwrap +import time +import types +import warnings +import zipfile +import zipimport +from collections.abc import Iterable, Iterator, Mapping, MutableSequence +from pkgutil import get_importer +from typing import ( + TYPE_CHECKING, + Any, + BinaryIO, + Callable, + Literal, + NamedTuple, + NoReturn, + Protocol, + TypeVar, + Union, + overload, +) + +sys.path.extend(((vendor_path := os.path.join(os.path.dirname(os.path.dirname(__file__)), 'setuptools', '_vendor')) not in sys.path) * [vendor_path]) # fmt: skip +# workaround for #4476 +sys.modules.pop('backports', None) + +# capture these to bypass sandboxing +from os import open as os_open, utime # isort: skip +from os.path import isdir, split # isort: skip + +try: + from os import mkdir, rename, unlink + + WRITE_SUPPORT = True +except ImportError: + # no write support, probably under GAE + WRITE_SUPPORT = False + +import packaging.markers +import packaging.requirements +import packaging.specifiers +import packaging.utils +import packaging.version +from jaraco.text import drop_comment, join_continuation, yield_lines +from platformdirs import user_cache_dir as _user_cache_dir + +if TYPE_CHECKING: + from _typeshed import BytesPath, StrOrBytesPath, StrPath + from _typeshed.importlib import LoaderProtocol + from typing_extensions import Self, TypeAlias + +warnings.warn( + "pkg_resources is deprecated as an API. " + "See https://setuptools.pypa.io/en/latest/pkg_resources.html. " + "The pkg_resources package is slated for removal as early as " + "2025-11-30. Refrain from using this package or pin to " + "Setuptools<81.", + UserWarning, + stacklevel=2, +) + +_T = TypeVar("_T") +_DistributionT = TypeVar("_DistributionT", bound="Distribution") +# Type aliases +_NestedStr: TypeAlias = Union[str, Iterable[Union[str, Iterable["_NestedStr"]]]] +_StrictInstallerType: TypeAlias = Callable[["Requirement"], "_DistributionT"] +_InstallerType: TypeAlias = Callable[["Requirement"], Union["Distribution", None]] +_PkgReqType: TypeAlias = Union[str, "Requirement"] +_EPDistType: TypeAlias = Union["Distribution", _PkgReqType] +_MetadataType: TypeAlias = Union["IResourceProvider", None] +_ResolvedEntryPoint: TypeAlias = Any # Can be any attribute in the module +_ResourceStream: TypeAlias = 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: TypeAlias = Union[object, types.ModuleType] +# Any: Should be _ModuleLike but we end up with issues where _ModuleLike doesn't have _ZipLoaderModule's __loader__ +_ProviderFactoryType: TypeAlias = Callable[[Any], "IResourceProvider"] +_DistFinderType: TypeAlias = Callable[[_T, str, bool], Iterable["Distribution"]] +_NSHandlerType: TypeAlias = Callable[[_T, str, str, types.ModuleType], Union[str, None]] +_AdapterT = TypeVar( + "_AdapterT", _DistFinderType[Any], _ProviderFactoryType, _NSHandlerType[Any] +) + + +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) -> None: + ob.clear() + ob.update(state) + + +def _sget_object(val): + return val.__getstate__() + + +def _sset_object(key, ob, state) -> None: + 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: + major_minor = '.'.join(_macos_vers()[:2]) + build = m.group(3) + plat = f'macosx-{major_minor}-{build}' + 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) -> str: + 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] + ) -> Self | ContextualVersionConflict: + """ + 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) -> str: + 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 = f'{sys.version_info.major}.{sys.version_info.minor}' +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 +) -> None: + """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.cache +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""" + from sysconfig import get_platform + + plat = get_platform() + if sys.platform == "darwin" and not plat.startswith('macosx-'): + try: + version = _macos_vers() + machine = _macos_arch(os.uname()[4].replace(" ", "_")) + return f"macosx-{version[0]}.{version[1]}-{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) -> bool: + """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 = f"{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): + dist = get_provider(dist) + 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) -> EntryPoint | None: + """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) -> None: + """Create working set from list of path entries (default=sys.path)""" + self.entries: list[str] = [] + self.entry_keys: dict[str | None, list[str]] = {} + self.by_key: dict[str, Distribution] = {} + self.normalized_to_canonical_keys: dict[str, str] = {} + self.callbacks: list[Callable[[Distribution], object]] = [] + + 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) -> None: + """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: Distribution | None = None + + candidates = ( + req.key, + self.normalized_to_canonical_keys.get(req.key), + safe_name(req.key).replace(".", "-"), + ) + + for candidate in filter(None, candidates): + dist = self.by_key.get(candidate) + if dist: + req.key = candidate + break + + 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 + ) -> Iterator[EntryPoint]: + """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) -> None: + """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, + ) -> None: + """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: _StrictInstallerType[_DistributionT], + replace_conflicting: bool = False, + extras: tuple[str, ...] | None = None, + ) -> list[_DistributionT]: ... + @overload + def resolve( + self, + requirements: Iterable[Requirement], + env: Environment | None = None, + *, + installer: _StrictInstallerType[_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 | _StrictInstallerType[_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: dict[str, Distribution] = {} + to_activate: list[Distribution] = [] + + req_extras = _ReqExtras() + + # Mapping of requirement to set of distributions that required it; + # useful for reporting info about conflicts. + required_by = collections.defaultdict[Requirement, set[str]](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: _StrictInstallerType[_DistributionT], + fallback: bool = True, + ) -> tuple[list[_DistributionT], dict[Distribution, Exception]]: ... + @overload + def find_plugins( + self, + plugin_env: Environment, + full_env: Environment | None = None, + *, + installer: _StrictInstallerType[_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 | _StrictInstallerType[_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) -> list[Distribution]: + """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 + ) -> None: + """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) -> None: + for callback in self.callbacks: + callback(dist) + + def __getstate__( + self, + ) -> tuple[ + list[str], + dict[str | None, list[str]], + dict[str, Distribution], + dict[str, str], + list[Callable[[Distribution], object]], + ]: + 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) -> None: + 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. + """ + return not req.marker or any( + req.marker.evaluate({'extra': extra}) + for extra in self.get(req, ()) + (extras or ("",)) + ) + + +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, + ) -> None: + """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: dict[str, list[Distribution]] = {} + self.platform = platform + self.python = python + self.scan(search_path) + + def can_add(self, dist: Distribution) -> bool: + """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) -> None: + """Remove `dist` from the environment""" + self._distmap[dist.key].remove(dist) + + def scan(self, search_path: Iterable[str] | None = 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) -> None: + """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: _StrictInstallerType[_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 | _StrictInstallerType[_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: _StrictInstallerType[_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 + | _StrictInstallerType[_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) -> Self: + """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(f"Can't add {other!r} to environment") + return self + + def __add__(self, other: Distribution | Environment) -> Self: + """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) -> None: + # acts like a set + self.cached_files: dict[str, Literal[True]] = {} + + def resource_exists( + self, package_or_requirement: _PkgReqType, resource_name: str + ) -> bool: + """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 + ) -> bool: + """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 + ) -> 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 + ) -> _ResourceStream: + """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[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] = ()) -> str: + """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) -> None: + """ + 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) -> None: + """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) -> None: + """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) -> 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) -> 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) -> str: + """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) -> 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) -> 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) -> SyntaxError | Literal[False]: + """ + 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) -> None: + 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 + ) -> str: + return self._fn(self.module_path, resource_name) + + def get_resource_stream( + self, manager: ResourceManager, resource_name: str + ) -> BinaryIO: + 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) -> bool: + 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) -> 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 += f' in {name} file at path: {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) -> bool: + 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) -> list[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]) -> None: + 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) -> None: + """ + 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) -> None: + 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) -> None: + 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 + ) -> io.BufferedReader: + 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) -> None: + 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) -> None: + 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) -> dict[str, zipfile.ZipInfo]: + """ + 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) -> None: + 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(f"{fspath} is not a subpath of {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(f"{fspath} is not a subpath of {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 + ) -> 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) -> None: + 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) -> 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) -> None: + 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) -> None: + self.module_path = path + self.egg_info = egg_info + + +class EggMetadata(ZipProvider): + """Metadata provider for .egg files""" + + def __init__(self, importer: zipimport.zipimporter) -> None: + """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] +) -> None: + """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) -> Iterable[Distribution]: + """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) -> Literal[False]: + return False + + def __call__(self, fullpath: object): + 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] +) -> None: + """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) -> None: + """ + 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) -> None: + """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) -> 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, +) -> 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) -> str | bytes: + """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.cache + 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) -> None: + 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, + ) -> 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) -> str: + s = f"{self.name} = {self.module_name}" + if self.attrs: + s += ':' + '.'.join(self.attrs) + if self.extras: + extras = ','.join(self.extras) + s += f' [{extras}]' + return s + + def __repr__(self) -> str: + return f"EntryPoint.parse({str(self)!r})" + + @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[arg-type] + 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, + ) -> 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) -> Self: + """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, + ) -> dict[str, Self]: + """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, + ) -> dict[str, dict[str, Self]]: + """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, + ) -> None: + 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) -> int: + return hash(self.hashcmp) + + def __lt__(self, other: Distribution) -> bool: + return self.hashcmp < other.hashcmp + + def __le__(self, other: Distribution) -> bool: + return self.hashcmp <= other.hashcmp + + def __gt__(self, other: Distribution) -> bool: + return self.hashcmp > other.hashcmp + + def __ge__(self, other: Distribution) -> bool: + return self.hashcmp >= other.hashcmp + + def __eq__(self, other: object) -> bool: + 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) -> bool: + 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 = f"Missing 'Version:' header and/or {self.PKG_INFO} file at path: {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]], + ) -> 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[Requirement]: + """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(f"{self} has no such extra feature {ext!r}") 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) -> None: + """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 = f"{to_filename(self.project_name)}-{to_filename(self.version)}-py{self.py_version or PY_MAJOR}" + + if self.platform: + filename += '-' + self.platform + return filename + + def __repr__(self) -> str: + if self.location: + return f"{self} ({self.location})" + else: + return str(self) + + def __str__(self) -> str: + try: + version = getattr(self, 'version', None) + except ValueError: + version = None + version = version or "[unknown version]" + return f"{self.project_name} {version}" + + def __getattr__(self, attr: str): + """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 + ) -> Distribution: + 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 = f"{self.project_name}=={self.parsed_version}" + else: + spec = f"{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(f"Entry point {(group, name)!r} not found") + 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) -> EntryPoint | None: + """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, + ) -> None: + """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( + f"Module {modname} was already imported from {fn}, " + f"but {self.location} is being added to sys.path", + ) + + def has_version(self) -> bool: + 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) -> Self: + """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) -> map[Requirement]: + """ + 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): + # prefer variable length tuple to set (as found in + # packaging.requirements.Requirement) + extras: tuple[str, ...] # type: ignore[assignment] + + def __init__(self, requirement_string: str) -> None: + """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] + self.extras = 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) -> bool: + return isinstance(other, Requirement) and self.hashCmp == other.hashCmp + + def __ne__(self, other: object) -> bool: + return not self == other + + def __contains__( + self, item: Distribution | packaging.specifiers.UnparsedVersion + ) -> bool: + if isinstance(item, Distribution): + if item.key != self.key: + return False + + version = item.version + else: + version = item + + # 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( + version, + prereleases=True, + ) + + def __hash__(self) -> int: + return self.__hash + + def __repr__(self) -> str: + return f"Requirement.parse({str(self)!r})" + + @staticmethod + def parse(s: str | Iterable[str]) -> Requirement: + (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) -> None: + """Ensure that the parent directory of `path` exists""" + dirname = os.path.dirname(path) + os.makedirs(dirname, exist_ok=True) + + +def _bypass_ensure_directory(path) -> None: + """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: list[str] = [] + 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 + + +# This must go before calls to `_call_aside`. See https://github.com/pypa/setuptools/pull/4422 +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()) -> None: + "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() -> None: + """ + 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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..031471901c9ceeaf4d798d9440addfaaa50aa184 GIT binary patch literal 164731 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

bp-E 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 import sys, pkg_resources + >>> from pkg_resources import Distribution + >>> Distribution(project_name="Foo", version="1.2") + Foo 1.2 + +Distributions have a location, which can be a filename, URL, or really anything +else you care to use:: + + >>> dist = Distribution( + ... location="http://example.com/something", + ... project_name="Bar", version="0.9" + ... ) + + >>> dist + Bar 0.9 (http://example.com/something) + + +Distributions have various introspectable attributes:: + + >>> dist.location + 'http://example.com/something' + + >>> dist.project_name + 'Bar' + + >>> dist.version + '0.9' + + >>> dist.py_version == '{}.{}'.format(*sys.version_info) + True + + >>> print(dist.platform) + None + +Including various computed attributes:: + + >>> from pkg_resources import parse_version + >>> dist.parsed_version == parse_version(dist.version) + True + + >>> dist.key # case-insensitive form of the project name + 'bar' + +Distributions are compared (and hashed) by version first:: + + >>> Distribution(version='1.0') == Distribution(version='1.0') + True + >>> Distribution(version='1.0') == Distribution(version='1.1') + False + >>> Distribution(version='1.0') < Distribution(version='1.1') + True + +but also by project name (case-insensitive), platform, Python version, +location, etc.:: + + >>> Distribution(project_name="Foo",version="1.0") == \ + ... Distribution(project_name="Foo",version="1.0") + True + + >>> Distribution(project_name="Foo",version="1.0") == \ + ... Distribution(project_name="foo",version="1.0") + True + + >>> Distribution(project_name="Foo",version="1.0") == \ + ... Distribution(project_name="Foo",version="1.1") + False + + >>> Distribution(project_name="Foo",py_version="2.3",version="1.0") == \ + ... Distribution(project_name="Foo",py_version="2.4",version="1.0") + False + + >>> Distribution(location="spam",version="1.0") == \ + ... Distribution(location="spam",version="1.0") + True + + >>> Distribution(location="spam",version="1.0") == \ + ... Distribution(location="baz",version="1.0") + False + + + +Hash and compare distribution by prio/plat + +Get version from metadata +provider capabilities +egg_name() +as_requirement() +from_location, from_filename (w/path normalization) + +Releases may have zero or more "Requirements", which indicate +what releases of another project the release requires in order to +function. A Requirement names the other project, expresses some criteria +as to what releases of that project are acceptable, and lists any "Extras" +that the requiring release may need from that project. (An Extra is an +optional feature of a Release, that can only be used if its additional +Requirements are satisfied.) + + + +The Working Set +--------------- + +A collection of active distributions is called a Working Set. Note that a +Working Set can contain any importable distribution, not just pluggable ones. +For example, the Python standard library is an importable distribution that +will usually be part of the Working Set, even though it is not pluggable. +Similarly, when you are doing development work on a project, the files you are +editing are also a Distribution. (And, with a little attention to the +directory names used, and including some additional metadata, such a +"development distribution" can be made pluggable as well.) + + >>> from pkg_resources import WorkingSet + +A working set's entries are the sys.path entries that correspond to the active +distributions. By default, the working set's entries are the items on +``sys.path``:: + + >>> ws = WorkingSet() + >>> ws.entries == sys.path + True + +But you can also create an empty working set explicitly, and add distributions +to it:: + + >>> ws = WorkingSet([]) + >>> ws.add(dist) + >>> ws.entries + ['http://example.com/something'] + >>> dist in ws + True + >>> Distribution('foo',version="") in ws + False + +And you can iterate over its distributions:: + + >>> list(ws) + [Bar 0.9 (http://example.com/something)] + +Adding the same distribution more than once is a no-op:: + + >>> ws.add(dist) + >>> list(ws) + [Bar 0.9 (http://example.com/something)] + +For that matter, adding multiple distributions for the same project also does +nothing, because a working set can only hold one active distribution per +project -- the first one added to it:: + + >>> ws.add( + ... Distribution( + ... 'http://example.com/something', project_name="Bar", + ... version="7.2" + ... ) + ... ) + >>> list(ws) + [Bar 0.9 (http://example.com/something)] + +You can append a path entry to a working set using ``add_entry()``:: + + >>> ws.entries + ['http://example.com/something'] + >>> ws.add_entry(pkg_resources.__file__) + >>> ws.entries + ['http://example.com/something', '...pkg_resources...'] + +Multiple additions result in multiple entries, even if the entry is already in +the working set (because ``sys.path`` can contain the same entry more than +once):: + + >>> ws.add_entry(pkg_resources.__file__) + >>> ws.entries + ['...example.com...', '...pkg_resources...', '...pkg_resources...'] + +And you can specify the path entry a distribution was found under, using the +optional second parameter to ``add()``:: + + >>> ws = WorkingSet([]) + >>> ws.add(dist,"foo") + >>> ws.entries + ['foo'] + +But even if a distribution is found under multiple path entries, it still only +shows up once when iterating the working set: + + >>> ws.add_entry(ws.entries[0]) + >>> list(ws) + [Bar 0.9 (http://example.com/something)] + +You can ask a WorkingSet to ``find()`` a distribution matching a requirement:: + + >>> from pkg_resources import Requirement + >>> print(ws.find(Requirement.parse("Foo==1.0"))) # no match, return None + None + + >>> ws.find(Requirement.parse("Bar==0.9")) # match, return distribution + Bar 0.9 (http://example.com/something) + +Note that asking for a conflicting version of a distribution already in a +working set triggers a ``pkg_resources.VersionConflict`` error: + + >>> try: + ... ws.find(Requirement.parse("Bar==1.0")) + ... except pkg_resources.VersionConflict as exc: + ... print(str(exc)) + ... else: + ... raise AssertionError("VersionConflict was not raised") + (Bar 0.9 (http://example.com/something), Requirement.parse('Bar==1.0')) + +You can subscribe a callback function to receive notifications whenever a new +distribution is added to a working set. The callback is immediately invoked +once for each existing distribution in the working set, and then is called +again for new distributions added thereafter:: + + >>> def added(dist): print("Added %s" % dist) + >>> ws.subscribe(added) + Added Bar 0.9 + >>> foo12 = Distribution(project_name="Foo", version="1.2", location="f12") + >>> ws.add(foo12) + Added Foo 1.2 + +Note, however, that only the first distribution added for a given project name +will trigger a callback, even during the initial ``subscribe()`` callback:: + + >>> foo14 = Distribution(project_name="Foo", version="1.4", location="f14") + >>> ws.add(foo14) # no callback, because Foo 1.2 is already active + + >>> ws = WorkingSet([]) + >>> ws.add(foo12) + >>> ws.add(foo14) + >>> ws.subscribe(added) + Added Foo 1.2 + +And adding a callback more than once has no effect, either:: + + >>> ws.subscribe(added) # no callbacks + + # and no double-callbacks on subsequent additions, either + >>> just_a_test = Distribution(project_name="JustATest", version="0.99") + >>> ws.add(just_a_test) + Added JustATest 0.99 + + +Finding Plugins +--------------- + +``WorkingSet`` objects can be used to figure out what plugins in an +``Environment`` can be loaded without any resolution errors:: + + >>> from pkg_resources import Environment + + >>> plugins = Environment([]) # normally, a list of plugin directories + >>> plugins.add(foo12) + >>> plugins.add(foo14) + >>> plugins.add(just_a_test) + +In the simplest case, we just get the newest version of each distribution in +the plugin environment:: + + >>> ws = WorkingSet([]) + >>> ws.find_plugins(plugins) + ([JustATest 0.99, Foo 1.4 (f14)], {}) + +But if there's a problem with a version conflict or missing requirements, the +method falls back to older versions, and the error info dict will contain an +exception instance for each unloadable plugin:: + + >>> ws.add(foo12) # this will conflict with Foo 1.4 + >>> ws.find_plugins(plugins) + ([JustATest 0.99, Foo 1.2 (f12)], {Foo 1.4 (f14): VersionConflict(...)}) + +But if you disallow fallbacks, the failed plugin will be skipped instead of +trying older versions:: + + >>> ws.find_plugins(plugins, fallback=False) + ([JustATest 0.99], {Foo 1.4 (f14): VersionConflict(...)}) + + + +Platform Compatibility Rules +---------------------------- + +On the Mac, there are potential compatibility issues for modules compiled +on newer versions of macOS than what the user is running. Additionally, +macOS will soon have two platforms to contend with: Intel and PowerPC. + +Basic equality works as on other platforms:: + + >>> from pkg_resources import compatible_platforms as cp + >>> reqd = 'macosx-10.4-ppc' + >>> cp(reqd, reqd) + True + >>> cp("win32", reqd) + False + +Distributions made on other machine types are not compatible:: + + >>> cp("macosx-10.4-i386", reqd) + False + +Distributions made on earlier versions of the OS are compatible, as +long as they are from the same top-level version. The patchlevel version +number does not matter:: + + >>> cp("macosx-10.4-ppc", reqd) + True + >>> cp("macosx-10.3-ppc", reqd) + True + >>> cp("macosx-10.5-ppc", reqd) + False + >>> cp("macosx-9.5-ppc", reqd) + False + +Backwards compatibility for packages made via earlier versions of +setuptools is provided as well:: + + >>> cp("darwin-8.2.0-Power_Macintosh", reqd) + True + >>> cp("darwin-7.2.0-Power_Macintosh", reqd) + True + >>> cp("darwin-8.2.0-Power_Macintosh", "macosx-10.3-ppc") + False + + +Environment Markers +------------------- + + >>> from pkg_resources import invalid_marker as im, evaluate_marker as em + >>> import os + + >>> print(im("sys_platform")) + Expected marker operator, one of <=, <, !=, ==, >=, >, ~=, ===, in, not in + sys_platform + ^ + + >>> print(im("sys_platform==")) + Expected a marker variable or quoted string + sys_platform== + ^ + + >>> print(im("sys_platform=='win32'")) + False + + >>> print(im("sys=='x'")) + Expected a marker variable or quoted string + sys=='x' + ^ + + >>> print(im("(extra)")) + Expected marker operator, one of <=, <, !=, ==, >=, >, ~=, ===, in, not in + (extra) + ^ + + >>> print(im("(extra")) + Expected marker operator, one of <=, <, !=, ==, >=, >, ~=, ===, in, not in + (extra + ^ + + >>> print(im("os.open('foo')=='y'")) + Expected a marker variable or quoted string + os.open('foo')=='y' + ^ + + >>> print(im("'x'=='y' and os.open('foo')=='y'")) # no short-circuit! + Expected a marker variable or quoted string + 'x'=='y' and os.open('foo')=='y' + ^ + + >>> print(im("'x'=='x' or os.open('foo')=='y'")) # no short-circuit! + Expected a marker variable or quoted string + 'x'=='x' or os.open('foo')=='y' + ^ + + >>> print(im("r'x'=='x'")) + Expected a marker variable or quoted string + r'x'=='x' + ^ + + >>> print(im("'''x'''=='x'")) + Expected marker operator, one of <=, <, !=, ==, >=, >, ~=, ===, in, not in + '''x'''=='x' + ^ + + >>> print(im('"""x"""=="x"')) + Expected marker operator, one of <=, <, !=, ==, >=, >, ~=, ===, in, not in + """x"""=="x" + ^ + + >>> print(im(r"x\n=='x'")) + Expected a marker variable or quoted string + x\n=='x' + ^ + + >>> print(im("os.open=='y'")) + Expected a marker variable or quoted string + os.open=='y' + ^ + + >>> em("sys_platform=='win32'") == (sys.platform=='win32') + True + + >>> em("python_version >= '2.7'") + True + + >>> em("python_version > '2.6'") + True + + >>> im("implementation_name=='cpython'") + False + + >>> im("platform_python_implementation=='CPython'") + False + + >>> im("implementation_version=='3.5.1'") + False diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/py.typed b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/py.typed new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..326e0cc29f3009f671e8651d886a6a6f4649e7b4 GIT binary patch literal 222 zcmX@j%ge<81jlwKW`O9&AOanHW&w&!XQ*V*Wb|9fP{ah}eFmxdRjZ$opPQ8XTbOm!FafVR^c^#Rugl<(KG}l$PWdWhUn6>%mz$nMwKul_eSZ zdB%E%M*78>C8@dviOJcC=|J5D+3E2`sm1xFMae*3Noq0B?D+W1yv&mLc)fzkUmP~M d`6;D2sdh!IK-Vw=aWRPTk(rT^v4|PS0suMuK5PI0 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_find_distributions.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_find_distributions.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4cf097ae65765c922602131abc07f8ba8e949d0b GIT binary patch literal 3323 zcmeHJOKclO7@mE4lCNE8m0=mCifTo4i$yQxUD1gWSeZXs@kniK!*dYw3rz79Pxl0VPv z{4?{<|9|t%{O0$25tLtklqT+a5PC=&ZegpH$~aW!k&I+YMG5jxt5k+g(3JCyNicRF zn_y|A&-xP{Ko__mRxbAemdFo!*3yr^5W-q!ABO7JE)ICoEQ$ zOewiJ9HFW;s(b)n=aGUEl#CLz!b}QV&78VS&7j5V=L9FyGbq8!44{Xsoe*RWup!Tf zJyz?OVwh*rnmm*?Oq{-yGt;_eB;Do6Buw>J8HUO{DpHfxjgn5c$dtSNX}U=7YC*de z6e`lAD9pqy-jr}kF$-QzH=~jkRZ=O40hgJQ(>Tmntf8pmV3f&1+wwZbBGe7yQ%_IN z#`V~Qo>5|ws$7YEls|{{NhN6-vD2gHB5_?-oZ8u;Gvayul5WP#oT=lqq{gDPnwq{8 z%jV4qUF(m&)fY3;rV`0Y$tfuXqq9>f5i5qC!%1kF5Gn`7aflc=vL$5EY#x)u7kYM$ zXmrzgVr3i!xP~6IzBYg1=7rnGmRjGK^*#`qmWB4R(0=RSeW74(t7+%H zEe3*Mu`0wO%wTe?>@ZjyiH_kW3j3kM>L3vmHC+=S(Ik(eCS??vv|>tx~AqA1dBH&KxtGzr+yF_`3jf!$;qZXq_TO*xV(kcJ+Ia-BBi3{%o%N!2yQWgf_cj`M~7 zr?76XLHl6=<0`;4v??^-2z(h>^>vgw2g|;}6<^y*N7rKy+u(iVMWL=8tXzrq{~kDT zTb^T=gNK%ahwcSVlm>=N?~L3FjFg0tQeb2omwz(v2S41-<|peM3cg+8!H1ve=2JfQ ze`Z4{pu8-zJGL=ZETps9Dz7ogH$Fh1gTO%ohX9OvrUh)KIRkA)d;KZg+B7>%X4=W7 zfwFJlm9hyR1xM<5MCfH-G|^Y8kTOdY*1e?MfAXq$VV&e&PABU<08a7lW9_-s(i1N< zZ{t)1az190X-8KSx}Jk!N47G|AYvyHMN^f_iVDw^jDA^>3j@z)-5x_Dgo)n()azPb z+1Gbx_*eNcLxZaEHC0>n1?Ie^&c1T6Z^_qRVd#)|mRsXd?8NgbT>T6`9DU@>0c*6h zZ@IgltT%w#8MfMS&8M2!c-U(RqJ0yHqU9CEj4tO?1?oOg{3Iu-h3nIqhQJK@jrWZ^{*uS`tN5+?K6cN^Kkc-r=w&q`R) zOx#WS?B%1RMxHFTOB=$w&JN$heejJu_>3698beXkAISeFYJZ6Q4^hisq1L&Huez2) Zz2#8vw{7K6>{{c$e1z&=M*#MO{{e3u?lu4b literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_integration_zope_interface.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_integration_zope_interface.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6cb571b6083e5e71732193f639d6d053ca68b462 GIT binary patch literal 2032 zcmZ`4OKclOboS#<>^dnpAEF>Mn25w8w$(Ne8WAp~kWxq^a!WwgW_N6_v%9m*jFZ?T zl7o;!Pt5@dgg8XpPl5BZVmfAFBQ4Q`QixCp3UJAue_G<45 z9%75}3wYBZ$H^`uf~x%|=MdZLAcnFsg^;1%kL<~9k`et5g|~~zx|EIm>tD=eB`>a9 zL~{(Pdy&sfr?%dBhdNdr8^op#7fchxz=GnEW?Gm!IN-sigWsCGcKtfYM;XyLb@Yy< zz+MEP0^iY70FWt3NC6#yA@6nYQ#2){8R{>xDQ(K)rM7CA^-uxq)!3;+2i=f2&`G=! zDkCHMtF)oHjBr|GI^lU!5LP6PVD+L)O-FD)hdN}ITBOKzX1an03OFG)_YZF5DGHqD$ByCA_S$@$7Whm9O7r5Wsk5 z-rvASY?g4H)*xCZlkF1FD$pZc)WAJXM9meHS`c>Iw}3K%OQvHKT}@xn%7k~j7jTVt z>GWOeqz|h0bps8E{}G>fbkKCjQWIeFpc z!hCLy8l;Wg`sm~07j&75f~X0~OwB6fUt*TITyX0!FV406m8%5~ZJrBTsBmVG3ovJb z2e9Z*Vi_Jrn6{$dC;=fDO~{-#;d8c06k<938Wg+6h`k2U_Tk(>oGUFxMSHVS; zub8e`@}j)X1+jyue?x2-RInic$MFwrYSb+9AsdCG|AXLP0%$3cBt1cWf1}r*p;w=v z)IX{8y`{TL2dUBh)Mzu&>P2#Vdt__mKuYgR=|eT$oZY^&b?1>f@YB$~iVu_Tw<1XH TKSGKuKaY<}<3~Lq7Fhoen5qXy literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_markers.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_markers.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2241ffb7af7000b34a865dd3f59faa0c0e9b1343 GIT binary patch literal 659 zcmY*W&ubGw6rR~l)@TwGEJ`Cn5Txv(yZvzxs^-!vDj0(Gl*=;RnI_xJW|o=RVsdIl z=%3KPp~Qnn!MhhP5j`zeT3+bLg{%wl+ zDdb?%0&t8dqL`x?w=p)@;#O?8ZHz3$@Lp+7`k$#y3m=OkYu2I82QT)fM1YB-5#c z2{2iRbA6NS{7xPKI7a$%M)4@e)Jl=EUZMARfLyydyq~YxO*x=yyfTe8Sl~|Mj3H#U2Z_@}F(DmYagI8G5<(Ja{8^g!Xl+g^URI zy-UQS9e<|3?yau*D$;B@Az_bnfSvR@fn-XgGK5Mq1==R&hAHqVt4NE^B|=4I6@>txaNiV4wScdB}V zWEooWI)wAmlUUG{vxd9{r7=VK5Ke83@h`Oa7rCbnvML7)N43M+xbpDRi=X)EnT7Ed Mp4iB0%-~e;0RemC2<(L2!sJiP$WUm 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 F{}1JV=r{lX literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_resources.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_resources.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..36629aa6278dad837751739076927e3eb0474d08 GIT binary patch literal 47646 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 JsVr~*{{YGiMkfFO literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_working_set.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/__pycache__/test_working_set.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f54b2082a9cc57eb50465095e5da08a64c7b97f0 GIT binary patch literal 10554 zcmd5iTW}jkaQtt*nEhj9+pJXIg6GoOJZCnms3Ychg)Hn5-1SB z?JmW~0TJU;>c~1(B$Y2m`7TvQ*STz6`eDecTZ1u&&>X_-!BkIzx{jZ%Fmk#`5a$ZsIMCNahVXy3h+~*)CiR`{X zWY2wvIl{0Yd!ePmL6i#FCkt|gEXsblQVz&faWTy!SW2VW)gM?(bblI^POKR)Z?PaMW zj24Ygb3fzeIgZ>s%#$hZ@0=4{*zuTa9SS=Pm!_++lp$!kr0Uv4Ouqt^j?VoCACDyz z4d*2kdiRPcb)}~CE6GG}XLnDR7SolEloY)xT?Xvb)yol8(URk86y9`2gT673OeEE- zvBc$wrs$oismH#)%Su9-OsNCY&6Ms)G&we=By_E_FP@A_ac!Wp08$C0YX>0vPx3!A zay|_8t-FZNzvcwM-)lHmZyoCg zK^gpLGL`^ArQ$Iibcxe6oc56Fhuo;#NQa6Fi4EF5$Yux*cVzC!8Xdj1ZvNz*lXnN- zKD+LMLGpwb-K&ImK?%|ZRYBEkgj4Y1Q=d%%`*55lywh-NjsQgMIDolt2+o$-7=3)&Gj023)Bqrv}4rAFp5vv z#c)R}inXjHyNhF90L{xdGkn^i_UI^3nnrO_OVZOuVk2f;dNo6pJ!#iSfsc$k;gG!< zw;p8eqs-#53V5cSX+G`#(0AXGbHW2!Tcu{h@ajO(gepOetl+e%xJC{C2FquNgEkEbdsWm|gGWs<+#@Jo z&EQcl)CO$uGCI}m6b{u(^Fk5jjmfl7!4xWD#IAgrx);Fe;HUi)WYj>e?jb(mmS@iM z6W`2tR;p^|y?4BKpSxF`t$N`RsdNQr`A-7DoLHNyuAAR+XUE;ah30H^+pIemsQT&g zyY9D7KMb@jbblOZTlBUq(R?w`mTP$Km%=;3LiaEH%MI;I4ej^NJ!sB09GLUZ^0Sve zsi?BA56bH{h;|*nQZ;R*;k=<;kgG5i=m_0`eSpiepcTIb%CbkKzJz- z&TZehF!52ty3G4R!=G-mFKY@-k^dR8b7v8vcZsGh4p`r-$utH#|89W3SDz2J1Jk@pph4DM!q4pv! z5*zwKLGI=_Ps-h_A3zNB=P=qzAh;q{{d8NlVgG}+<(^YZJ*TqOuVuy4|M*58HFA|W ze1b`e16IER_A)U9iUpI4D>o7`gh*s8DUXA8L<}(!`Qf+}H(S&$7(#s!vmVS)n3O^_ zj3vyD!cRl_-XM7g=Q@ygJ6+~zw0VQlqj=D1=l>O$ohO$e%7mXIO$Nzr?jrD%al*vg z)MFHdQj*e6HudF#g!>lsXdyT#qT2(AVtjl7lq|z%Tp4%9lksMJIvP%zbflN2bRkG! zV}t812j^z(>GNNA3Kt|EFmm~;RM79*w7QK-*>!=De z72Bb&oyA)HIaX%)+BOW&Y;r2fU1apIC-CYh$E)7VdL3_Fb&84yq){-n1jl6$3CZLBd88gu~(T&JRJxqUMVrjtp0{ zf-rq(A4^i{lvt77E{N<1Mt0PQfeAs|Z@A+$>W5bp9(B`pORi#+I(-=YF06Qn_@28K@cjDI+n`vWPn?D6)traqB-{SNOpH)?_JBh#XZuc)=eCNeq99mRZ-v6U6{Ru84ZVED+%(#8C64&88v1^ zVudf}kZviJQW7$iFO8;D^woxIOwyxQ49{fTUFFV^<~UZD(Z10!3P^o z*zGEEcd^)m>_*fs_upvQ&5Eqdou7oUI#NcLCU1 zz~d8gu-_FMbK=gN*pL(J;D22pjk_N1>Ur=|cGvOjj=|Z$N>k`z^MS>KC$h~avrVrq zdbh9CH~!7p<)*%+roN9ZWSd^g)}NjgKl4}LK6p30D7NMN)r+;yFZrLpH~0YF`&M1f zUf~f5`YM;i&e`LO)olw`R=va@ymfZ&?A_Lf;&UtYyBDr}ka#zd-E$~ge;8xA>RXd@ zlXpD}4G#m)uQay2*Z*K&w(;0)?@E31!oCkrJ*+>pSaoQz{?PA$+EDL!bAucl|`rX z^>2(w##4lvUp#@cHoZ(sw&aV=4k#9b|Nq0|e{JN^u9JBBSyak``(!*6c`n1Ctsgpo zxeg98+^@|4o94OCam$6Xex7*+9;8%EuWjVkw(98q^qbA*#rrC@kH<5+LOr6E)6MGsI812cf(@8xV~DXo2dyvV+UkM9Y!RN6Vj_W3>MP0%K1F~%HS@!Nkl4&94kXcC z5DSt7$4XGww}nW}+fo4PDT6q`5Y2udS~R_?_1eAJR_I$4`t*NTlV+W3n6n>Az}>SH zheJx)yrC$p$VgO5BolCx9A_F)Xrdi~%5>trac}3L5&*h*t-&_xSO*~V!-+!ygDKEv zJ+k&K6wFQs&SbQ3xdq2*cr$^=z4^Zajk8~dmAmb@T=-@NZX61|*gk!5jpFrMNh*F= zaUaIO1UCSMQ}xlp8NJztdD>O}Lx$o93hBbPMQP`U+&>}0Z%3f!A-`uO*t8sMTMD-2yuvMEPRMy{S88@GhPtygJ-Mc?b)T!&J#%JV zB;LS}um8pM#rmFyp57HWWxY6eak24G)_-`7aK6S*#D<$gUpk?*im&T#Qnl?){Ov?G zu=~Spi~CP!!)HDYoLTgqSqhx_(!;eVP_coc7* z?4umb396**qloBNTl9Md^Yoq`^oJ1;&$OvDN-i|v%GbOC9Z;_V2(B9K0c5LAj^jQh zRiBc|Pl@kS68N0>KPR>SPTC&1U7Y(-RSOsV@-@!G32OwhN45Jo_u2^P@19kM-{oCx zs)nqs2C_X>khK(FX{iqC+Jlhoqor~gZLJ58{f&^l2x$2!A>nd3*1lg6wJxFy8^yIRrxla|vI9Orbn zchEi-9igd?w2&V2sryU5*P&so`(m`^Ha4m9G%l73EAb`tJ#6 zE}=7TZWvFCJAvSlkGpc&*d!*^x+$MFA>Qt-#nFi!t0AdwCnp#)4OE7jTz7~^SAlTG(bAA8AyDPR;f4!dkX8HNea$EmA zwK}WtMDnKS#3`EQP;!goS%>XQ>Q?o zm|3%DM}%Z96?pah?Q{8e$DdA|KbtFL*1Rr(A|2h6C-j}3zh3rCE$x|tORdr5;LlwX zx9nUZrY@c;Hl^Wh6DQjfm1#?!ia%9yVL&9U4{oU0ffE=l#i=Ew1$xP8>0qa`%*2{J z5upMy;`CJ|oe*G%WB@S-+=zloxC!NRF%tOcGrA}AwE{K#bTxG~PM$xn`OL}S>j58L zJywMipb!W>g&G2(ml#h^T`DG;{_OcpEy-7s4y~(|Jj5D;Ma>j94s5Nm*O1WXqEz}f>TdjX9DWiPC$3=%$=nG4y~L2%*?dE<9UVG zTUYDcne&^246YbI_~d=YcWcmzwO4dKb@eXldib34^YMS`6etukYxeAjkj$k5ub#hs zF8}WM(~0wEbA`;B*CkM-qkHm%zSHy9%buyFJyUS0HJTj!xohH&~mV7-!xlG;;_T+IdotQYo{ zdscNMxpHZVUROLaU%=<_fu5xwzcf|f-Fr0ogxjs30UtHBu5OoL>{fg&CcQwgsq5zY z{)cy0Y^(lyJ^9V@^PAE-|c literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_find_distributions.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_find_distributions.py new file mode 100644 index 000000000..301b36d6c --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_find_distributions.py @@ -0,0 +1,56 @@ +import shutil +from pathlib import Path + +import pytest + +import pkg_resources + +TESTS_DATA_DIR = Path(__file__).parent / 'data' + + +class TestFindDistributions: + @pytest.fixture + def target_dir(self, tmpdir): + target_dir = tmpdir.mkdir('target') + # place a .egg named directory in the target that is not an egg: + target_dir.mkdir('not.an.egg') + return target_dir + + def test_non_egg_dir_named_egg(self, target_dir): + dists = pkg_resources.find_distributions(str(target_dir)) + assert not list(dists) + + def test_standalone_egg_directory(self, target_dir): + shutil.copytree( + TESTS_DATA_DIR / 'my-test-package_unpacked-egg', + target_dir, + dirs_exist_ok=True, + ) + dists = pkg_resources.find_distributions(str(target_dir)) + assert [dist.project_name for dist in dists] == ['my-test-package'] + dists = pkg_resources.find_distributions(str(target_dir), only=True) + assert not list(dists) + + def test_zipped_egg(self, target_dir): + shutil.copytree( + TESTS_DATA_DIR / 'my-test-package_zipped-egg', + target_dir, + dirs_exist_ok=True, + ) + dists = pkg_resources.find_distributions(str(target_dir)) + assert [dist.project_name for dist in dists] == ['my-test-package'] + dists = pkg_resources.find_distributions(str(target_dir), only=True) + assert not list(dists) + + def test_zipped_sdist_one_level_removed(self, target_dir): + shutil.copytree( + TESTS_DATA_DIR / 'my-test-package-zip', target_dir, dirs_exist_ok=True + ) + dists = pkg_resources.find_distributions( + str(target_dir / "my-test-package.zip") + ) + assert [dist.project_name for dist in dists] == ['my-test-package'] + dists = pkg_resources.find_distributions( + str(target_dir / "my-test-package.zip"), only=True + ) + assert not list(dists) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_integration_zope_interface.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_integration_zope_interface.py new file mode 100644 index 000000000..4e37c3401 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_integration_zope_interface.py @@ -0,0 +1,54 @@ +import platform +from inspect import cleandoc + +import jaraco.path +import pytest + +pytestmark = pytest.mark.integration + + +# For the sake of simplicity this test uses fixtures defined in +# `setuptools.test.fixtures`, +# and it also exercise conditions considered deprecated... +# So if needed this test can be deleted. +@pytest.mark.skipif( + platform.system() != "Linux", + reason="only demonstrated to fail on Linux in #4399", +) +def test_interop_pkg_resources_iter_entry_points(tmp_path, venv): + """ + Importing pkg_resources.iter_entry_points on console_scripts + seems to cause trouble with zope-interface, when deprecates installation method + is used. See #4399. + """ + project = { + "pkg": { + "foo.py": cleandoc( + """ + from pkg_resources import iter_entry_points + + def bar(): + print("Print me if you can") + """ + ), + "setup.py": cleandoc( + """ + from setuptools import setup, find_packages + + setup( + install_requires=["zope-interface==6.4.post2"], + entry_points={ + "console_scripts": [ + "foo=foo:bar", + ], + }, + ) + """ + ), + } + } + jaraco.path.build(project, prefix=tmp_path) + cmd = ["pip", "install", "-e", ".", "--no-use-pep517"] + venv.run(cmd, cwd=tmp_path / "pkg") # Needs this version of pkg_resources installed + out = venv.run(["foo"]) + assert "Print me if you can" in out diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_markers.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_markers.py new file mode 100644 index 000000000..9306d5b34 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_markers.py @@ -0,0 +1,8 @@ +from unittest import mock + +from pkg_resources import evaluate_marker + + +@mock.patch('platform.python_version', return_value='2.7.10') +def test_ordering(python_version_mock): + assert evaluate_marker("python_full_version > '2.7.3'") is True diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_pkg_resources.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_pkg_resources.py new file mode 100644 index 000000000..cfc9b16c0 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_pkg_resources.py @@ -0,0 +1,485 @@ +from __future__ import annotations + +import builtins +import datetime +import inspect +import os +import plistlib +import stat +import subprocess +import sys +import tempfile +import zipfile +from unittest import mock + +import pytest + +import pkg_resources +from pkg_resources import DistInfoDistribution, Distribution, EggInfoDistribution + +import distutils.command.install_egg_info +import distutils.dist + + +class EggRemover(str): + def __call__(self): + if self in sys.path: + sys.path.remove(self) + if os.path.exists(self): + os.remove(self) + + +class TestZipProvider: + finalizers: list[EggRemover] = [] + + ref_time = datetime.datetime(2013, 5, 12, 13, 25, 0) + "A reference time for a file modification" + + @classmethod + def setup_class(cls): + "create a zip egg and add it to sys.path" + egg = tempfile.NamedTemporaryFile(suffix='.egg', delete=False) + zip_egg = zipfile.ZipFile(egg, 'w') + zip_info = zipfile.ZipInfo() + zip_info.filename = 'mod.py' + zip_info.date_time = cls.ref_time.timetuple() + zip_egg.writestr(zip_info, 'x = 3\n') + zip_info = zipfile.ZipInfo() + zip_info.filename = 'data.dat' + zip_info.date_time = cls.ref_time.timetuple() + zip_egg.writestr(zip_info, 'hello, world!') + zip_info = zipfile.ZipInfo() + zip_info.filename = 'subdir/mod2.py' + zip_info.date_time = cls.ref_time.timetuple() + zip_egg.writestr(zip_info, 'x = 6\n') + zip_info = zipfile.ZipInfo() + zip_info.filename = 'subdir/data2.dat' + zip_info.date_time = cls.ref_time.timetuple() + zip_egg.writestr(zip_info, 'goodbye, world!') + zip_egg.close() + egg.close() + + sys.path.append(egg.name) + subdir = os.path.join(egg.name, 'subdir') + sys.path.append(subdir) + cls.finalizers.append(EggRemover(subdir)) + cls.finalizers.append(EggRemover(egg.name)) + + @classmethod + def teardown_class(cls): + for finalizer in cls.finalizers: + finalizer() + + def test_resource_listdir(self): + import mod # pyright: ignore[reportMissingImports] # Temporary package for test + + zp = pkg_resources.ZipProvider(mod) + + expected_root = ['data.dat', 'mod.py', 'subdir'] + assert sorted(zp.resource_listdir('')) == expected_root + + expected_subdir = ['data2.dat', 'mod2.py'] + assert sorted(zp.resource_listdir('subdir')) == expected_subdir + assert sorted(zp.resource_listdir('subdir/')) == expected_subdir + + assert zp.resource_listdir('nonexistent') == [] + assert zp.resource_listdir('nonexistent/') == [] + + import mod2 # pyright: ignore[reportMissingImports] # Temporary package for test + + zp2 = pkg_resources.ZipProvider(mod2) + + assert sorted(zp2.resource_listdir('')) == expected_subdir + + assert zp2.resource_listdir('subdir') == [] + assert zp2.resource_listdir('subdir/') == [] + + def test_resource_filename_rewrites_on_change(self): + """ + If a previous call to get_resource_filename has saved the file, but + the file has been subsequently mutated with different file of the + same size and modification time, it should not be overwritten on a + subsequent call to get_resource_filename. + """ + import mod # pyright: ignore[reportMissingImports] # Temporary package for test + + manager = pkg_resources.ResourceManager() + zp = pkg_resources.ZipProvider(mod) + filename = zp.get_resource_filename(manager, 'data.dat') + actual = datetime.datetime.fromtimestamp(os.stat(filename).st_mtime) + assert actual == self.ref_time + f = open(filename, 'w', encoding="utf-8") + f.write('hello, world?') + f.close() + ts = self.ref_time.timestamp() + os.utime(filename, (ts, ts)) + filename = zp.get_resource_filename(manager, 'data.dat') + with open(filename, encoding="utf-8") as f: + assert f.read() == 'hello, world!' + manager.cleanup_resources() + + +class TestResourceManager: + def test_get_cache_path(self): + mgr = pkg_resources.ResourceManager() + path = mgr.get_cache_path('foo') + type_ = str(type(path)) + message = "Unexpected type from get_cache_path: " + type_ + assert isinstance(path, str), message + + def test_get_cache_path_race(self, tmpdir): + # Patch to os.path.isdir to create a race condition + def patched_isdir(dirname, unpatched_isdir=pkg_resources.isdir): + patched_isdir.dirnames.append(dirname) + + was_dir = unpatched_isdir(dirname) + if not was_dir: + os.makedirs(dirname) + return was_dir + + patched_isdir.dirnames = [] + + # Get a cache path with a "race condition" + mgr = pkg_resources.ResourceManager() + mgr.set_extraction_path(str(tmpdir)) + + archive_name = os.sep.join(('foo', 'bar', 'baz')) + with mock.patch.object(pkg_resources, 'isdir', new=patched_isdir): + mgr.get_cache_path(archive_name) + + # Because this test relies on the implementation details of this + # function, these assertions are a sentinel to ensure that the + # test suite will not fail silently if the implementation changes. + called_dirnames = patched_isdir.dirnames + assert len(called_dirnames) == 2 + assert called_dirnames[0].split(os.sep)[-2:] == ['foo', 'bar'] + assert called_dirnames[1].split(os.sep)[-1:] == ['foo'] + + """ + Tests to ensure that pkg_resources runs independently from setuptools. + """ + + def test_setuptools_not_imported(self): + """ + In a separate Python environment, import pkg_resources and assert + that action doesn't cause setuptools to be imported. + """ + lines = ( + 'import pkg_resources', + 'import sys', + ('assert "setuptools" not in sys.modules, "setuptools was imported"'), + ) + cmd = [sys.executable, '-c', '; '.join(lines)] + subprocess.check_call(cmd) + + +def make_test_distribution(metadata_path, metadata): + """ + Make a test Distribution object, and return it. + + :param metadata_path: the path to the metadata file that should be + created. This should be inside a distribution directory that should + also be created. For example, an argument value might end with + ".dist-info/METADATA". + :param metadata: the desired contents of the metadata file, as bytes. + """ + dist_dir = os.path.dirname(metadata_path) + os.mkdir(dist_dir) + with open(metadata_path, 'wb') as f: + f.write(metadata) + dists = list(pkg_resources.distributions_from_metadata(dist_dir)) + (dist,) = dists + + return dist + + +def test_get_metadata__bad_utf8(tmpdir): + """ + Test a metadata file with bytes that can't be decoded as utf-8. + """ + filename = 'METADATA' + # Convert the tmpdir LocalPath object to a string before joining. + metadata_path = os.path.join(str(tmpdir), 'foo.dist-info', filename) + # Encode a non-ascii string with the wrong encoding (not utf-8). + metadata = 'née'.encode('iso-8859-1') + dist = make_test_distribution(metadata_path, metadata=metadata) + + with pytest.raises(UnicodeDecodeError) as excinfo: + dist.get_metadata(filename) + + exc = excinfo.value + actual = str(exc) + expected = ( + # The error message starts with "'utf-8' codec ..." However, the + # spelling of "utf-8" can vary (e.g. "utf8") so we don't include it + "codec can't decode byte 0xe9 in position 1: " + 'invalid continuation byte in METADATA file at path: ' + ) + assert expected in actual, f'actual: {actual}' + assert actual.endswith(metadata_path), f'actual: {actual}' + + +def make_distribution_no_version(tmpdir, basename): + """ + Create a distribution directory with no file containing the version. + """ + dist_dir = tmpdir / basename + dist_dir.ensure_dir() + # Make the directory non-empty so distributions_from_metadata() + # will detect it and yield it. + dist_dir.join('temp.txt').ensure() + + dists = list(pkg_resources.distributions_from_metadata(dist_dir)) + assert len(dists) == 1 + (dist,) = dists + + return dist, dist_dir + + +@pytest.mark.parametrize( + ("suffix", "expected_filename", "expected_dist_type"), + [ + ('egg-info', 'PKG-INFO', EggInfoDistribution), + ('dist-info', 'METADATA', DistInfoDistribution), + ], +) +@pytest.mark.xfail( + sys.version_info[:2] == (3, 12) and sys.version_info.releaselevel != 'final', + reason="https://github.com/python/cpython/issues/103632", +) +def test_distribution_version_missing( + tmpdir, suffix, expected_filename, expected_dist_type +): + """ + Test Distribution.version when the "Version" header is missing. + """ + basename = f'foo.{suffix}' + dist, dist_dir = make_distribution_no_version(tmpdir, basename) + + expected_text = ( + f"Missing 'Version:' header and/or {expected_filename} file at path: " + ) + metadata_path = os.path.join(dist_dir, expected_filename) + + # Now check the exception raised when the "version" attribute is accessed. + with pytest.raises(ValueError) as excinfo: + dist.version + + err = str(excinfo.value) + # Include a string expression after the assert so the full strings + # will be visible for inspection on failure. + assert expected_text in err, str((expected_text, err)) + + # Also check the args passed to the ValueError. + msg, dist = excinfo.value.args + assert expected_text in msg + # Check that the message portion contains the path. + assert metadata_path in msg, str((metadata_path, msg)) + assert type(dist) is expected_dist_type + + +@pytest.mark.xfail( + sys.version_info[:2] == (3, 12) and sys.version_info.releaselevel != 'final', + reason="https://github.com/python/cpython/issues/103632", +) +def test_distribution_version_missing_undetected_path(): + """ + Test Distribution.version when the "Version" header is missing and + the path can't be detected. + """ + # Create a Distribution object with no metadata argument, which results + # in an empty metadata provider. + dist = Distribution('/foo') + with pytest.raises(ValueError) as excinfo: + dist.version + + msg, dist = excinfo.value.args + expected = ( + "Missing 'Version:' header and/or PKG-INFO file at path: [could not detect]" + ) + assert msg == expected + + +@pytest.mark.parametrize('only', [False, True]) +def test_dist_info_is_not_dir(tmp_path, only): + """Test path containing a file with dist-info extension.""" + dist_info = tmp_path / 'foobar.dist-info' + dist_info.touch() + assert not pkg_resources.dist_factory(str(tmp_path), str(dist_info), only) + + +def test_macos_vers_fallback(monkeypatch, tmp_path): + """Regression test for pkg_resources._macos_vers""" + orig_open = builtins.open + + # Pretend we need to use the plist file + monkeypatch.setattr('platform.mac_ver', mock.Mock(return_value=('', (), ''))) + + # Create fake content for the fake plist file + with open(tmp_path / 'fake.plist', 'wb') as fake_file: + plistlib.dump({"ProductVersion": "11.4"}, fake_file) + + # Pretend the fake file exists + monkeypatch.setattr('os.path.exists', mock.Mock(return_value=True)) + + def fake_open(file, *args, **kwargs): + return orig_open(tmp_path / 'fake.plist', *args, **kwargs) + + # Ensure that the _macos_vers works correctly + with mock.patch('builtins.open', mock.Mock(side_effect=fake_open)) as m: + pkg_resources._macos_vers.cache_clear() + assert pkg_resources._macos_vers() == ["11", "4"] + pkg_resources._macos_vers.cache_clear() + + m.assert_called() + + +class TestDeepVersionLookupDistutils: + @pytest.fixture + def env(self, tmpdir): + """ + Create a package environment, similar to a virtualenv, + in which packages are installed. + """ + + class Environment(str): + pass + + env = Environment(tmpdir) + tmpdir.chmod(stat.S_IRWXU) + subs = 'home', 'lib', 'scripts', 'data', 'egg-base' + env.paths = dict((dirname, str(tmpdir / dirname)) for dirname in subs) + list(map(os.mkdir, env.paths.values())) + return env + + def create_foo_pkg(self, env, version): + """ + Create a foo package installed (distutils-style) to env.paths['lib'] + as version. + """ + ld = "This package has unicode metadata! ❄" + attrs = dict(name='foo', version=version, long_description=ld) + dist = distutils.dist.Distribution(attrs) + iei_cmd = distutils.command.install_egg_info.install_egg_info(dist) + iei_cmd.initialize_options() + iei_cmd.install_dir = env.paths['lib'] + iei_cmd.finalize_options() + iei_cmd.run() + + def test_version_resolved_from_egg_info(self, env): + version = '1.11.0.dev0+2329eae' + self.create_foo_pkg(env, version) + + # this requirement parsing will raise a VersionConflict unless the + # .egg-info file is parsed (see #419 on BitBucket) + req = pkg_resources.Requirement.parse('foo>=1.9') + dist = pkg_resources.WorkingSet([env.paths['lib']]).find(req) + assert dist.version == version + + @pytest.mark.parametrize( + ("unnormalized", "normalized"), + [ + ('foo', 'foo'), + ('foo/', 'foo'), + ('foo/bar', 'foo/bar'), + ('foo/bar/', 'foo/bar'), + ], + ) + def test_normalize_path_trailing_sep(self, unnormalized, normalized): + """Ensure the trailing slash is cleaned for path comparison. + + See pypa/setuptools#1519. + """ + result_from_unnormalized = pkg_resources.normalize_path(unnormalized) + result_from_normalized = pkg_resources.normalize_path(normalized) + assert result_from_unnormalized == result_from_normalized + + @pytest.mark.skipif( + os.path.normcase('A') != os.path.normcase('a'), + reason='Testing case-insensitive filesystems.', + ) + @pytest.mark.parametrize( + ("unnormalized", "normalized"), + [ + ('MiXeD/CasE', 'mixed/case'), + ], + ) + def test_normalize_path_normcase(self, unnormalized, normalized): + """Ensure mixed case is normalized on case-insensitive filesystems.""" + result_from_unnormalized = pkg_resources.normalize_path(unnormalized) + result_from_normalized = pkg_resources.normalize_path(normalized) + assert result_from_unnormalized == result_from_normalized + + @pytest.mark.skipif( + os.path.sep != '\\', + reason='Testing systems using backslashes as path separators.', + ) + @pytest.mark.parametrize( + ("unnormalized", "expected"), + [ + ('forward/slash', 'forward\\slash'), + ('forward/slash/', 'forward\\slash'), + ('backward\\slash\\', 'backward\\slash'), + ], + ) + def test_normalize_path_backslash_sep(self, unnormalized, expected): + """Ensure path seps are cleaned on backslash path sep systems.""" + result = pkg_resources.normalize_path(unnormalized) + assert result.endswith(expected) + + +class TestWorkdirRequire: + def fake_site_packages(self, tmp_path, monkeypatch, dist_files): + site_packages = tmp_path / "site-packages" + site_packages.mkdir() + for file, content in self.FILES.items(): + path = site_packages / file + path.parent.mkdir(exist_ok=True, parents=True) + path.write_text(inspect.cleandoc(content), encoding="utf-8") + + monkeypatch.setattr(sys, "path", [site_packages]) + return os.fspath(site_packages) + + FILES = { + "pkg1_mod-1.2.3.dist-info/METADATA": """ + Metadata-Version: 2.4 + Name: pkg1.mod + Version: 1.2.3 + """, + "pkg2.mod-0.42.dist-info/METADATA": """ + Metadata-Version: 2.1 + Name: pkg2.mod + Version: 0.42 + """, + "pkg3_mod.egg-info/PKG-INFO": """ + Name: pkg3.mod + Version: 1.2.3.4 + """, + "pkg4.mod.egg-info/PKG-INFO": """ + Name: pkg4.mod + Version: 0.42.1 + """, + } + + @pytest.mark.parametrize( + ("version", "requirement"), + [ + ("1.2.3", "pkg1.mod>=1"), + ("0.42", "pkg2.mod>=0.4"), + ("1.2.3.4", "pkg3.mod<=2"), + ("0.42.1", "pkg4.mod>0.2,<1"), + ], + ) + def test_require_non_normalised_name( + self, tmp_path, monkeypatch, version, requirement + ): + # https://github.com/pypa/setuptools/issues/4853 + site_packages = self.fake_site_packages(tmp_path, monkeypatch, self.FILES) + ws = pkg_resources.WorkingSet([site_packages]) + + for req in [requirement, requirement.replace(".", "-")]: + [dist] = ws.require(req) + assert dist.version == version + assert os.path.samefile( + os.path.commonpath([dist.location, site_packages]), site_packages + ) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_resources.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_resources.py new file mode 100644 index 000000000..70436c088 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_resources.py @@ -0,0 +1,869 @@ +import itertools +import os +import platform +import string +import sys + +import pytest +from packaging.specifiers import SpecifierSet + +import pkg_resources +from pkg_resources import ( + Distribution, + EntryPoint, + Requirement, + VersionConflict, + WorkingSet, + parse_requirements, + parse_version, + safe_name, + safe_version, +) + + +# from Python 3.6 docs. Available from itertools on Python 3.10 +def pairwise(iterable): + "s -> (s0,s1), (s1,s2), (s2, s3), ..." + a, b = itertools.tee(iterable) + next(b, None) + return zip(a, b) + + +class Metadata(pkg_resources.EmptyProvider): + """Mock object to return metadata as if from an on-disk distribution""" + + def __init__(self, *pairs) -> None: + self.metadata = dict(pairs) + + def has_metadata(self, name) -> bool: + return name in self.metadata + + def get_metadata(self, name): + return self.metadata[name] + + def get_metadata_lines(self, name): + return pkg_resources.yield_lines(self.get_metadata(name)) + + +dist_from_fn = pkg_resources.Distribution.from_filename + + +class TestDistro: + def testCollection(self): + # empty path should produce no distributions + ad = pkg_resources.Environment([], platform=None, python=None) + assert list(ad) == [] + assert ad['FooPkg'] == [] + ad.add(dist_from_fn("FooPkg-1.3_1.egg")) + ad.add(dist_from_fn("FooPkg-1.4-py2.4-win32.egg")) + ad.add(dist_from_fn("FooPkg-1.2-py2.4.egg")) + + # Name is in there now + assert ad['FooPkg'] + # But only 1 package + assert list(ad) == ['foopkg'] + + # Distributions sort by version + expected = ['1.4', '1.3-1', '1.2'] + assert [dist.version for dist in ad['FooPkg']] == expected + + # Removing a distribution leaves sequence alone + ad.remove(ad['FooPkg'][1]) + assert [dist.version for dist in ad['FooPkg']] == ['1.4', '1.2'] + + # And inserting adds them in order + ad.add(dist_from_fn("FooPkg-1.9.egg")) + assert [dist.version for dist in ad['FooPkg']] == ['1.9', '1.4', '1.2'] + + ws = WorkingSet([]) + foo12 = dist_from_fn("FooPkg-1.2-py2.4.egg") + foo14 = dist_from_fn("FooPkg-1.4-py2.4-win32.egg") + (req,) = parse_requirements("FooPkg>=1.3") + + # Nominal case: no distros on path, should yield all applicable + assert ad.best_match(req, ws).version == '1.9' + # If a matching distro is already installed, should return only that + ws.add(foo14) + assert ad.best_match(req, ws).version == '1.4' + + # If the first matching distro is unsuitable, it's a version conflict + ws = WorkingSet([]) + ws.add(foo12) + ws.add(foo14) + with pytest.raises(VersionConflict): + ad.best_match(req, ws) + + # If more than one match on the path, the first one takes precedence + ws = WorkingSet([]) + ws.add(foo14) + ws.add(foo12) + ws.add(foo14) + assert ad.best_match(req, ws).version == '1.4' + + def checkFooPkg(self, d): + assert d.project_name == "FooPkg" + assert d.key == "foopkg" + assert d.version == "1.3.post1" + assert d.py_version == "2.4" + assert d.platform == "win32" + assert d.parsed_version == parse_version("1.3-1") + + def testDistroBasics(self): + d = Distribution( + "/some/path", + project_name="FooPkg", + version="1.3-1", + py_version="2.4", + platform="win32", + ) + self.checkFooPkg(d) + + d = Distribution("/some/path") + assert d.py_version == f'{sys.version_info.major}.{sys.version_info.minor}' + assert d.platform is None + + def testDistroParse(self): + d = dist_from_fn("FooPkg-1.3.post1-py2.4-win32.egg") + self.checkFooPkg(d) + d = dist_from_fn("FooPkg-1.3.post1-py2.4-win32.egg-info") + self.checkFooPkg(d) + + def testDistroMetadata(self): + d = Distribution( + "/some/path", + project_name="FooPkg", + py_version="2.4", + platform="win32", + metadata=Metadata(('PKG-INFO', "Metadata-Version: 1.0\nVersion: 1.3-1\n")), + ) + self.checkFooPkg(d) + + def distRequires(self, txt): + return Distribution("/foo", metadata=Metadata(('depends.txt', txt))) + + def checkRequires(self, dist, txt, extras=()): + assert list(dist.requires(extras)) == list(parse_requirements(txt)) + + def testDistroDependsSimple(self): + for v in "Twisted>=1.5", "Twisted>=1.5\nZConfig>=2.0": + self.checkRequires(self.distRequires(v), v) + + needs_object_dir = pytest.mark.skipif( + not hasattr(object, '__dir__'), + reason='object.__dir__ necessary for self.__dir__ implementation', + ) + + def test_distribution_dir(self): + d = pkg_resources.Distribution() + dir(d) + + @needs_object_dir + def test_distribution_dir_includes_provider_dir(self): + d = pkg_resources.Distribution() + before = d.__dir__() + assert 'test_attr' not in before + d._provider.test_attr = None + after = d.__dir__() + assert len(after) == len(before) + 1 + assert 'test_attr' in after + + @needs_object_dir + def test_distribution_dir_ignores_provider_dir_leading_underscore(self): + d = pkg_resources.Distribution() + before = d.__dir__() + assert '_test_attr' not in before + d._provider._test_attr = None + after = d.__dir__() + assert len(after) == len(before) + assert '_test_attr' not in after + + def testResolve(self): + ad = pkg_resources.Environment([]) + ws = WorkingSet([]) + # Resolving no requirements -> nothing to install + assert list(ws.resolve([], ad)) == [] + # Request something not in the collection -> DistributionNotFound + with pytest.raises(pkg_resources.DistributionNotFound): + ws.resolve(parse_requirements("Foo"), ad) + + Foo = Distribution.from_filename( + "/foo_dir/Foo-1.2.egg", + metadata=Metadata(('depends.txt', "[bar]\nBaz>=2.0")), + ) + ad.add(Foo) + ad.add(Distribution.from_filename("Foo-0.9.egg")) + + # Request thing(s) that are available -> list to activate + for i in range(3): + targets = list(ws.resolve(parse_requirements("Foo"), ad)) + assert targets == [Foo] + list(map(ws.add, targets)) + with pytest.raises(VersionConflict): + ws.resolve(parse_requirements("Foo==0.9"), ad) + ws = WorkingSet([]) # reset + + # Request an extra that causes an unresolved dependency for "Baz" + with pytest.raises(pkg_resources.DistributionNotFound): + ws.resolve(parse_requirements("Foo[bar]"), ad) + Baz = Distribution.from_filename( + "/foo_dir/Baz-2.1.egg", metadata=Metadata(('depends.txt', "Foo")) + ) + ad.add(Baz) + + # Activation list now includes resolved dependency + assert list(ws.resolve(parse_requirements("Foo[bar]"), ad)) == [Foo, Baz] + # Requests for conflicting versions produce VersionConflict + with pytest.raises(VersionConflict) as vc: + ws.resolve(parse_requirements("Foo==1.2\nFoo!=1.2"), ad) + + msg = 'Foo 0.9 is installed but Foo==1.2 is required' + assert vc.value.report() == msg + + def test_environment_marker_evaluation_negative(self): + """Environment markers are evaluated at resolution time.""" + ad = pkg_resources.Environment([]) + ws = WorkingSet([]) + res = ws.resolve(parse_requirements("Foo;python_version<'2'"), ad) + assert list(res) == [] + + def test_environment_marker_evaluation_positive(self): + ad = pkg_resources.Environment([]) + ws = WorkingSet([]) + Foo = Distribution.from_filename("/foo_dir/Foo-1.2.dist-info") + ad.add(Foo) + res = ws.resolve(parse_requirements("Foo;python_version>='2'"), ad) + assert list(res) == [Foo] + + def test_environment_marker_evaluation_called(self): + """ + If one package foo requires bar without any extras, + markers should pass for bar without extras. + """ + (parent_req,) = parse_requirements("foo") + (req,) = parse_requirements("bar;python_version>='2'") + req_extras = pkg_resources._ReqExtras({req: parent_req.extras}) + assert req_extras.markers_pass(req) + + (parent_req,) = parse_requirements("foo[]") + (req,) = parse_requirements("bar;python_version>='2'") + req_extras = pkg_resources._ReqExtras({req: parent_req.extras}) + assert req_extras.markers_pass(req) + + def test_marker_evaluation_with_extras(self): + """Extras are also evaluated as markers at resolution time.""" + ad = pkg_resources.Environment([]) + ws = WorkingSet([]) + Foo = Distribution.from_filename( + "/foo_dir/Foo-1.2.dist-info", + metadata=Metadata(( + "METADATA", + "Provides-Extra: baz\nRequires-Dist: quux; extra=='baz'", + )), + ) + ad.add(Foo) + assert list(ws.resolve(parse_requirements("Foo"), ad)) == [Foo] + quux = Distribution.from_filename("/foo_dir/quux-1.0.dist-info") + ad.add(quux) + res = list(ws.resolve(parse_requirements("Foo[baz]"), ad)) + assert res == [Foo, quux] + + def test_marker_evaluation_with_extras_normlized(self): + """Extras are also evaluated as markers at resolution time.""" + ad = pkg_resources.Environment([]) + ws = WorkingSet([]) + Foo = Distribution.from_filename( + "/foo_dir/Foo-1.2.dist-info", + metadata=Metadata(( + "METADATA", + "Provides-Extra: baz-lightyear\n" + "Requires-Dist: quux; extra=='baz-lightyear'", + )), + ) + ad.add(Foo) + assert list(ws.resolve(parse_requirements("Foo"), ad)) == [Foo] + quux = Distribution.from_filename("/foo_dir/quux-1.0.dist-info") + ad.add(quux) + res = list(ws.resolve(parse_requirements("Foo[baz-lightyear]"), ad)) + assert res == [Foo, quux] + + def test_marker_evaluation_with_multiple_extras(self): + ad = pkg_resources.Environment([]) + ws = WorkingSet([]) + Foo = Distribution.from_filename( + "/foo_dir/Foo-1.2.dist-info", + metadata=Metadata(( + "METADATA", + "Provides-Extra: baz\n" + "Requires-Dist: quux; extra=='baz'\n" + "Provides-Extra: bar\n" + "Requires-Dist: fred; extra=='bar'\n", + )), + ) + ad.add(Foo) + quux = Distribution.from_filename("/foo_dir/quux-1.0.dist-info") + ad.add(quux) + fred = Distribution.from_filename("/foo_dir/fred-0.1.dist-info") + ad.add(fred) + res = list(ws.resolve(parse_requirements("Foo[baz,bar]"), ad)) + assert sorted(res) == [fred, quux, Foo] + + def test_marker_evaluation_with_extras_loop(self): + ad = pkg_resources.Environment([]) + ws = WorkingSet([]) + a = Distribution.from_filename( + "/foo_dir/a-0.2.dist-info", + metadata=Metadata(("METADATA", "Requires-Dist: c[a]")), + ) + b = Distribution.from_filename( + "/foo_dir/b-0.3.dist-info", + metadata=Metadata(("METADATA", "Requires-Dist: c[b]")), + ) + c = Distribution.from_filename( + "/foo_dir/c-1.0.dist-info", + metadata=Metadata(( + "METADATA", + "Provides-Extra: a\n" + "Requires-Dist: b;extra=='a'\n" + "Provides-Extra: b\n" + "Requires-Dist: foo;extra=='b'", + )), + ) + foo = Distribution.from_filename("/foo_dir/foo-0.1.dist-info") + for dist in (a, b, c, foo): + ad.add(dist) + res = list(ws.resolve(parse_requirements("a"), ad)) + assert res == [a, c, b, foo] + + @pytest.mark.xfail( + sys.version_info[:2] == (3, 12) and sys.version_info.releaselevel != 'final', + reason="https://github.com/python/cpython/issues/103632", + ) + def testDistroDependsOptions(self): + d = self.distRequires( + """ + Twisted>=1.5 + [docgen] + ZConfig>=2.0 + docutils>=0.3 + [fastcgi] + fcgiapp>=0.1""" + ) + self.checkRequires(d, "Twisted>=1.5") + self.checkRequires( + d, "Twisted>=1.5 ZConfig>=2.0 docutils>=0.3".split(), ["docgen"] + ) + self.checkRequires(d, "Twisted>=1.5 fcgiapp>=0.1".split(), ["fastcgi"]) + self.checkRequires( + d, + "Twisted>=1.5 ZConfig>=2.0 docutils>=0.3 fcgiapp>=0.1".split(), + ["docgen", "fastcgi"], + ) + self.checkRequires( + d, + "Twisted>=1.5 fcgiapp>=0.1 ZConfig>=2.0 docutils>=0.3".split(), + ["fastcgi", "docgen"], + ) + with pytest.raises(pkg_resources.UnknownExtra): + d.requires(["foo"]) + + +class TestWorkingSet: + def test_find_conflicting(self): + ws = WorkingSet([]) + Foo = Distribution.from_filename("/foo_dir/Foo-1.2.egg") + ws.add(Foo) + + # create a requirement that conflicts with Foo 1.2 + req = next(parse_requirements("Foo<1.2")) + + with pytest.raises(VersionConflict) as vc: + ws.find(req) + + msg = 'Foo 1.2 is installed but Foo<1.2 is required' + assert vc.value.report() == msg + + def test_resolve_conflicts_with_prior(self): + """ + A ContextualVersionConflict should be raised when a requirement + conflicts with a prior requirement for a different package. + """ + # Create installation where Foo depends on Baz 1.0 and Bar depends on + # Baz 2.0. + ws = WorkingSet([]) + md = Metadata(('depends.txt', "Baz==1.0")) + Foo = Distribution.from_filename("/foo_dir/Foo-1.0.egg", metadata=md) + ws.add(Foo) + md = Metadata(('depends.txt', "Baz==2.0")) + Bar = Distribution.from_filename("/foo_dir/Bar-1.0.egg", metadata=md) + ws.add(Bar) + Baz = Distribution.from_filename("/foo_dir/Baz-1.0.egg") + ws.add(Baz) + Baz = Distribution.from_filename("/foo_dir/Baz-2.0.egg") + ws.add(Baz) + + with pytest.raises(VersionConflict) as vc: + ws.resolve(parse_requirements("Foo\nBar\n")) + + msg = "Baz 1.0 is installed but Baz==2.0 is required by " + msg += repr(set(['Bar'])) + assert vc.value.report() == msg + + +class TestEntryPoints: + def assertfields(self, ep): + assert ep.name == "foo" + assert ep.module_name == "pkg_resources.tests.test_resources" + assert ep.attrs == ("TestEntryPoints",) + assert ep.extras == ("x",) + assert ep.load() is TestEntryPoints + expect = "foo = pkg_resources.tests.test_resources:TestEntryPoints [x]" + assert str(ep) == expect + + def setup_method(self, method): + self.dist = Distribution.from_filename( + "FooPkg-1.2-py2.4.egg", metadata=Metadata(('requires.txt', '[x]')) + ) + + def testBasics(self): + ep = EntryPoint( + "foo", + "pkg_resources.tests.test_resources", + ["TestEntryPoints"], + ["x"], + self.dist, + ) + self.assertfields(ep) + + def testParse(self): + s = "foo = pkg_resources.tests.test_resources:TestEntryPoints [x]" + ep = EntryPoint.parse(s, self.dist) + self.assertfields(ep) + + ep = EntryPoint.parse("bar baz= spammity[PING]") + assert ep.name == "bar baz" + assert ep.module_name == "spammity" + assert ep.attrs == () + assert ep.extras == ("ping",) + + ep = EntryPoint.parse(" fizzly = wocka:foo") + assert ep.name == "fizzly" + assert ep.module_name == "wocka" + assert ep.attrs == ("foo",) + assert ep.extras == () + + # plus in the name + spec = "html+mako = mako.ext.pygmentplugin:MakoHtmlLexer" + ep = EntryPoint.parse(spec) + assert ep.name == 'html+mako' + + reject_specs = "foo", "x=a:b:c", "q=x/na", "fez=pish:tush-z", "x=f[a]>2" + + @pytest.mark.parametrize("reject_spec", reject_specs) + def test_reject_spec(self, reject_spec): + with pytest.raises(ValueError): + EntryPoint.parse(reject_spec) + + def test_printable_name(self): + """ + Allow any printable character in the name. + """ + # Create a name with all printable characters; strip the whitespace. + name = string.printable.strip() + spec = "{name} = module:attr".format(**locals()) + ep = EntryPoint.parse(spec) + assert ep.name == name + + def checkSubMap(self, m): + assert len(m) == len(self.submap_expect) + for key, ep in self.submap_expect.items(): + assert m.get(key).name == ep.name + assert m.get(key).module_name == ep.module_name + assert sorted(m.get(key).attrs) == sorted(ep.attrs) + assert sorted(m.get(key).extras) == sorted(ep.extras) + + submap_expect = dict( + feature1=EntryPoint('feature1', 'somemodule', ['somefunction']), + feature2=EntryPoint( + 'feature2', 'another.module', ['SomeClass'], ['extra1', 'extra2'] + ), + feature3=EntryPoint('feature3', 'this.module', extras=['something']), + ) + submap_str = """ + # define features for blah blah + feature1 = somemodule:somefunction + feature2 = another.module:SomeClass [extra1,extra2] + feature3 = this.module [something] + """ + + def testParseList(self): + self.checkSubMap(EntryPoint.parse_group("xyz", self.submap_str)) + with pytest.raises(ValueError): + EntryPoint.parse_group("x a", "foo=bar") + with pytest.raises(ValueError): + EntryPoint.parse_group("x", ["foo=baz", "foo=bar"]) + + def testParseMap(self): + m = EntryPoint.parse_map({'xyz': self.submap_str}) + self.checkSubMap(m['xyz']) + assert list(m.keys()) == ['xyz'] + m = EntryPoint.parse_map("[xyz]\n" + self.submap_str) + self.checkSubMap(m['xyz']) + assert list(m.keys()) == ['xyz'] + with pytest.raises(ValueError): + EntryPoint.parse_map(["[xyz]", "[xyz]"]) + with pytest.raises(ValueError): + EntryPoint.parse_map(self.submap_str) + + def testDeprecationWarnings(self): + ep = EntryPoint( + "foo", "pkg_resources.tests.test_resources", ["TestEntryPoints"], ["x"] + ) + with pytest.warns(pkg_resources.PkgResourcesDeprecationWarning): + ep.load(require=False) + + +class TestRequirements: + def testBasics(self): + r = Requirement.parse("Twisted>=1.2") + assert str(r) == "Twisted>=1.2" + assert repr(r) == "Requirement.parse('Twisted>=1.2')" + assert r == Requirement("Twisted>=1.2") + assert r == Requirement("twisTed>=1.2") + assert r != Requirement("Twisted>=2.0") + assert r != Requirement("Zope>=1.2") + assert r != Requirement("Zope>=3.0") + assert r != Requirement("Twisted[extras]>=1.2") + + def testOrdering(self): + r1 = Requirement("Twisted==1.2c1,>=1.2") + r2 = Requirement("Twisted>=1.2,==1.2c1") + assert r1 == r2 + assert str(r1) == str(r2) + assert str(r2) == "Twisted==1.2c1,>=1.2" + assert Requirement("Twisted") != Requirement( + "Twisted @ https://localhost/twisted.zip" + ) + + def testBasicContains(self): + r = Requirement("Twisted>=1.2") + foo_dist = Distribution.from_filename("FooPkg-1.3_1.egg") + twist11 = Distribution.from_filename("Twisted-1.1.egg") + twist12 = Distribution.from_filename("Twisted-1.2.egg") + assert parse_version('1.2') in r + assert parse_version('1.1') not in r + assert '1.2' in r + assert '1.1' not in r + assert foo_dist not in r + assert twist11 not in r + assert twist12 in r + + def testOptionsAndHashing(self): + r1 = Requirement.parse("Twisted[foo,bar]>=1.2") + r2 = Requirement.parse("Twisted[bar,FOO]>=1.2") + assert r1 == r2 + assert set(r1.extras) == set(("foo", "bar")) + assert set(r2.extras) == set(("foo", "bar")) + assert hash(r1) == hash(r2) + assert hash(r1) == hash(( + "twisted", + None, + SpecifierSet(">=1.2"), + frozenset(["foo", "bar"]), + None, + )) + assert hash( + Requirement.parse("Twisted @ https://localhost/twisted.zip") + ) == hash(( + "twisted", + "https://localhost/twisted.zip", + SpecifierSet(), + frozenset(), + None, + )) + + def testVersionEquality(self): + r1 = Requirement.parse("foo==0.3a2") + r2 = Requirement.parse("foo!=0.3a4") + d = Distribution.from_filename + + assert d("foo-0.3a4.egg") not in r1 + assert d("foo-0.3a1.egg") not in r1 + assert d("foo-0.3a4.egg") not in r2 + + assert d("foo-0.3a2.egg") in r1 + assert d("foo-0.3a2.egg") in r2 + assert d("foo-0.3a3.egg") in r2 + assert d("foo-0.3a5.egg") in r2 + + def testSetuptoolsProjectName(self): + """ + The setuptools project should implement the setuptools package. + """ + + assert Requirement.parse('setuptools').project_name == 'setuptools' + # setuptools 0.7 and higher means setuptools. + assert Requirement.parse('setuptools == 0.7').project_name == 'setuptools' + assert Requirement.parse('setuptools == 0.7a1').project_name == 'setuptools' + assert Requirement.parse('setuptools >= 0.7').project_name == 'setuptools' + + +class TestParsing: + def testEmptyParse(self): + assert list(parse_requirements('')) == [] + + def testYielding(self): + for inp, out in [ + ([], []), + ('x', ['x']), + ([[]], []), + (' x\n y', ['x', 'y']), + (['x\n\n', 'y'], ['x', 'y']), + ]: + assert list(pkg_resources.yield_lines(inp)) == out + + def testSplitting(self): + sample = """ + x + [Y] + z + + a + [b ] + # foo + c + [ d] + [q] + v + """ + assert list(pkg_resources.split_sections(sample)) == [ + (None, ["x"]), + ("Y", ["z", "a"]), + ("b", ["c"]), + ("d", []), + ("q", ["v"]), + ] + with pytest.raises(ValueError): + list(pkg_resources.split_sections("[foo")) + + def testSafeName(self): + assert safe_name("adns-python") == "adns-python" + assert safe_name("WSGI Utils") == "WSGI-Utils" + assert safe_name("WSGI Utils") == "WSGI-Utils" + assert safe_name("Money$$$Maker") == "Money-Maker" + assert safe_name("peak.web") != "peak-web" + + def testSafeVersion(self): + assert safe_version("1.2-1") == "1.2.post1" + assert safe_version("1.2 alpha") == "1.2.alpha" + assert safe_version("2.3.4 20050521") == "2.3.4.20050521" + assert safe_version("Money$$$Maker") == "Money-Maker" + assert safe_version("peak.web") == "peak.web" + + def testSimpleRequirements(self): + assert list(parse_requirements('Twis-Ted>=1.2-1')) == [ + Requirement('Twis-Ted>=1.2-1') + ] + assert list(parse_requirements('Twisted >=1.2, \\ # more\n<2.0')) == [ + Requirement('Twisted>=1.2,<2.0') + ] + assert Requirement.parse("FooBar==1.99a3") == Requirement("FooBar==1.99a3") + with pytest.raises(ValueError): + Requirement.parse(">=2.3") + with pytest.raises(ValueError): + Requirement.parse("x\\") + with pytest.raises(ValueError): + Requirement.parse("x==2 q") + with pytest.raises(ValueError): + Requirement.parse("X==1\nY==2") + with pytest.raises(ValueError): + Requirement.parse("#") + + def test_requirements_with_markers(self): + assert Requirement.parse("foobar;os_name=='a'") == Requirement.parse( + "foobar;os_name=='a'" + ) + assert Requirement.parse( + "name==1.1;python_version=='2.7'" + ) != Requirement.parse("name==1.1;python_version=='3.6'") + assert Requirement.parse( + "name==1.0;python_version=='2.7'" + ) != Requirement.parse("name==1.2;python_version=='2.7'") + assert Requirement.parse( + "name[foo]==1.0;python_version=='3.6'" + ) != Requirement.parse("name[foo,bar]==1.0;python_version=='3.6'") + + def test_local_version(self): + parse_requirements('foo==1.0+org1') + + def test_spaces_between_multiple_versions(self): + parse_requirements('foo>=1.0, <3') + parse_requirements('foo >= 1.0, < 3') + + @pytest.mark.parametrize( + ("lower", "upper"), + [ + ('1.2-rc1', '1.2rc1'), + ('0.4', '0.4.0'), + ('0.4.0.0', '0.4.0'), + ('0.4.0-0', '0.4-0'), + ('0post1', '0.0post1'), + ('0pre1', '0.0c1'), + ('0.0.0preview1', '0c1'), + ('0.0c1', '0-rc1'), + ('1.2a1', '1.2.a.1'), + ('1.2.a', '1.2a'), + ], + ) + def testVersionEquality(self, lower, upper): + assert parse_version(lower) == parse_version(upper) + + torture = """ + 0.80.1-3 0.80.1-2 0.80.1-1 0.79.9999+0.80.0pre4-1 + 0.79.9999+0.80.0pre2-3 0.79.9999+0.80.0pre2-2 + 0.77.2-1 0.77.1-1 0.77.0-1 + """ + + @pytest.mark.parametrize( + ("lower", "upper"), + [ + ('2.1', '2.1.1'), + ('2a1', '2b0'), + ('2a1', '2.1'), + ('2.3a1', '2.3'), + ('2.1-1', '2.1-2'), + ('2.1-1', '2.1.1'), + ('2.1', '2.1post4'), + ('2.1a0-20040501', '2.1'), + ('1.1', '02.1'), + ('3.2', '3.2.post0'), + ('3.2post1', '3.2post2'), + ('0.4', '4.0'), + ('0.0.4', '0.4.0'), + ('0post1', '0.4post1'), + ('2.1.0-rc1', '2.1.0'), + ('2.1dev', '2.1a0'), + ] + + list(pairwise(reversed(torture.split()))), + ) + def testVersionOrdering(self, lower, upper): + assert parse_version(lower) < parse_version(upper) + + def testVersionHashable(self): + """ + Ensure that our versions stay hashable even though we've subclassed + them and added some shim code to them. + """ + assert hash(parse_version("1.0")) == hash(parse_version("1.0")) + + +class TestNamespaces: + ns_str = "__import__('pkg_resources').declare_namespace(__name__)\n" + + @pytest.fixture + def symlinked_tmpdir(self, tmpdir): + """ + Where available, return the tempdir as a symlink, + which as revealed in #231 is more fragile than + a natural tempdir. + """ + if not hasattr(os, 'symlink'): + yield str(tmpdir) + return + + link_name = str(tmpdir) + '-linked' + os.symlink(str(tmpdir), link_name) + try: + yield type(tmpdir)(link_name) + finally: + os.unlink(link_name) + + @pytest.fixture(autouse=True) + def patched_path(self, tmpdir): + """ + Patch sys.path to include the 'site-pkgs' dir. Also + restore pkg_resources._namespace_packages to its + former state. + """ + saved_ns_pkgs = pkg_resources._namespace_packages.copy() + saved_sys_path = sys.path[:] + site_pkgs = tmpdir.mkdir('site-pkgs') + sys.path.append(str(site_pkgs)) + try: + yield + finally: + pkg_resources._namespace_packages = saved_ns_pkgs + sys.path = saved_sys_path + + issue591 = pytest.mark.xfail(platform.system() == 'Windows', reason="#591") + + @issue591 + def test_two_levels_deep(self, symlinked_tmpdir): + """ + Test nested namespace packages + Create namespace packages in the following tree : + site-packages-1/pkg1/pkg2 + site-packages-2/pkg1/pkg2 + Check both are in the _namespace_packages dict and that their __path__ + is correct + """ + real_tmpdir = symlinked_tmpdir.realpath() + tmpdir = symlinked_tmpdir + sys.path.append(str(tmpdir / 'site-pkgs2')) + site_dirs = tmpdir / 'site-pkgs', tmpdir / 'site-pkgs2' + for site in site_dirs: + pkg1 = site / 'pkg1' + pkg2 = pkg1 / 'pkg2' + pkg2.ensure_dir() + (pkg1 / '__init__.py').write_text(self.ns_str, encoding='utf-8') + (pkg2 / '__init__.py').write_text(self.ns_str, encoding='utf-8') + with pytest.warns(DeprecationWarning, match="pkg_resources.declare_namespace"): + import pkg1 # pyright: ignore[reportMissingImports] # Temporary package for test + assert "pkg1" in pkg_resources._namespace_packages + # attempt to import pkg2 from site-pkgs2 + with pytest.warns(DeprecationWarning, match="pkg_resources.declare_namespace"): + import pkg1.pkg2 # pyright: ignore[reportMissingImports] # Temporary package for test + # check the _namespace_packages dict + assert "pkg1.pkg2" in pkg_resources._namespace_packages + assert pkg_resources._namespace_packages["pkg1"] == ["pkg1.pkg2"] + # check the __path__ attribute contains both paths + expected = [ + str(real_tmpdir / "site-pkgs" / "pkg1" / "pkg2"), + str(real_tmpdir / "site-pkgs2" / "pkg1" / "pkg2"), + ] + assert pkg1.pkg2.__path__ == expected + + @issue591 + def test_path_order(self, symlinked_tmpdir): + """ + Test that if multiple versions of the same namespace package subpackage + are on different sys.path entries, that only the one earliest on + sys.path is imported, and that the namespace package's __path__ is in + the correct order. + + Regression test for https://github.com/pypa/setuptools/issues/207 + """ + + tmpdir = symlinked_tmpdir + site_dirs = ( + tmpdir / "site-pkgs", + tmpdir / "site-pkgs2", + tmpdir / "site-pkgs3", + ) + + vers_str = "__version__ = %r" + + for number, site in enumerate(site_dirs, 1): + if number > 1: + sys.path.append(str(site)) + nspkg = site / 'nspkg' + subpkg = nspkg / 'subpkg' + subpkg.ensure_dir() + (nspkg / '__init__.py').write_text(self.ns_str, encoding='utf-8') + (subpkg / '__init__.py').write_text(vers_str % number, encoding='utf-8') + + with pytest.warns(DeprecationWarning, match="pkg_resources.declare_namespace"): + import nspkg # pyright: ignore[reportMissingImports] # Temporary package for test + import nspkg.subpkg # pyright: ignore[reportMissingImports] # Temporary package for test + expected = [str(site.realpath() / 'nspkg') for site in site_dirs] + assert nspkg.__path__ == expected + assert nspkg.subpkg.__version__ == 1 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_working_set.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_working_set.py new file mode 100644 index 000000000..ed20c59dd --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/pkg_resources/tests/test_working_set.py @@ -0,0 +1,505 @@ +import functools +import inspect +import re +import textwrap + +import pytest + +import pkg_resources + +from .test_resources import Metadata + + +def strip_comments(s): + return '\n'.join( + line + for line in s.split('\n') + if line.strip() and not line.strip().startswith('#') + ) + + +def parse_distributions(s): + """ + Parse a series of distribution specs of the form: + {project_name}-{version} + [optional, indented requirements specification] + + Example: + + foo-0.2 + bar-1.0 + foo>=3.0 + [feature] + baz + + yield 2 distributions: + - project_name=foo, version=0.2 + - project_name=bar, version=1.0, + requires=['foo>=3.0', 'baz; extra=="feature"'] + """ + s = s.strip() + for spec in re.split(r'\n(?=[^\s])', s): + if not spec: + continue + fields = spec.split('\n', 1) + assert 1 <= len(fields) <= 2 + name, version = fields.pop(0).rsplit('-', 1) + if fields: + requires = textwrap.dedent(fields.pop(0)) + metadata = Metadata(('requires.txt', requires)) + else: + metadata = None + dist = pkg_resources.Distribution( + project_name=name, version=version, metadata=metadata + ) + yield dist + + +class FakeInstaller: + def __init__(self, installable_dists) -> None: + self._installable_dists = installable_dists + + def __call__(self, req): + return next( + iter(filter(lambda dist: dist in req, self._installable_dists)), None + ) + + +def parametrize_test_working_set_resolve(*test_list): + idlist = [] + argvalues = [] + for test in test_list: + ( + name, + installed_dists, + installable_dists, + requirements, + expected1, + expected2, + ) = ( + strip_comments(s.lstrip()) + for s in textwrap.dedent(test).lstrip().split('\n\n', 5) + ) + installed_dists = list(parse_distributions(installed_dists)) + installable_dists = list(parse_distributions(installable_dists)) + requirements = list(pkg_resources.parse_requirements(requirements)) + for id_, replace_conflicting, expected in ( + (name, False, expected1), + (name + '_replace_conflicting', True, expected2), + ): + idlist.append(id_) + expected = strip_comments(expected.strip()) + if re.match(r'\w+$', expected): + expected = getattr(pkg_resources, expected) + assert issubclass(expected, Exception) + else: + expected = list(parse_distributions(expected)) + argvalues.append( + pytest.param( + installed_dists, + installable_dists, + requirements, + replace_conflicting, + expected, + ) + ) + return pytest.mark.parametrize( + ( + "installed_dists", + "installable_dists", + "requirements", + "replace_conflicting", + "resolved_dists_or_exception", + ), + argvalues, + ids=idlist, + ) + + +@parametrize_test_working_set_resolve( + """ + # id + noop + + # installed + + # installable + + # wanted + + # resolved + + # resolved [replace conflicting] + """, + """ + # id + already_installed + + # installed + foo-3.0 + + # installable + + # wanted + foo>=2.1,!=3.1,<4 + + # resolved + foo-3.0 + + # resolved [replace conflicting] + foo-3.0 + """, + """ + # id + installable_not_installed + + # installed + + # installable + foo-3.0 + foo-4.0 + + # wanted + foo>=2.1,!=3.1,<4 + + # resolved + foo-3.0 + + # resolved [replace conflicting] + foo-3.0 + """, + """ + # id + not_installable + + # installed + + # installable + + # wanted + foo>=2.1,!=3.1,<4 + + # resolved + DistributionNotFound + + # resolved [replace conflicting] + DistributionNotFound + """, + """ + # id + no_matching_version + + # installed + + # installable + foo-3.1 + + # wanted + foo>=2.1,!=3.1,<4 + + # resolved + DistributionNotFound + + # resolved [replace conflicting] + DistributionNotFound + """, + """ + # id + installable_with_installed_conflict + + # installed + foo-3.1 + + # installable + foo-3.5 + + # wanted + foo>=2.1,!=3.1,<4 + + # resolved + VersionConflict + + # resolved [replace conflicting] + foo-3.5 + """, + """ + # id + not_installable_with_installed_conflict + + # installed + foo-3.1 + + # installable + + # wanted + foo>=2.1,!=3.1,<4 + + # resolved + VersionConflict + + # resolved [replace conflicting] + DistributionNotFound + """, + """ + # id + installed_with_installed_require + + # installed + foo-3.9 + baz-0.1 + foo>=2.1,!=3.1,<4 + + # installable + + # wanted + baz + + # resolved + foo-3.9 + baz-0.1 + + # resolved [replace conflicting] + foo-3.9 + baz-0.1 + """, + """ + # id + installed_with_conflicting_installed_require + + # installed + foo-5 + baz-0.1 + foo>=2.1,!=3.1,<4 + + # installable + + # wanted + baz + + # resolved + VersionConflict + + # resolved [replace conflicting] + DistributionNotFound + """, + """ + # id + installed_with_installable_conflicting_require + + # installed + foo-5 + baz-0.1 + foo>=2.1,!=3.1,<4 + + # installable + foo-2.9 + + # wanted + baz + + # resolved + VersionConflict + + # resolved [replace conflicting] + baz-0.1 + foo-2.9 + """, + """ + # id + installed_with_installable_require + + # installed + baz-0.1 + foo>=2.1,!=3.1,<4 + + # installable + foo-3.9 + + # wanted + baz + + # resolved + foo-3.9 + baz-0.1 + + # resolved [replace conflicting] + foo-3.9 + baz-0.1 + """, + """ + # id + installable_with_installed_require + + # installed + foo-3.9 + + # installable + baz-0.1 + foo>=2.1,!=3.1,<4 + + # wanted + baz + + # resolved + foo-3.9 + baz-0.1 + + # resolved [replace conflicting] + foo-3.9 + baz-0.1 + """, + """ + # id + installable_with_installable_require + + # installed + + # installable + foo-3.9 + baz-0.1 + foo>=2.1,!=3.1,<4 + + # wanted + baz + + # resolved + foo-3.9 + baz-0.1 + + # resolved [replace conflicting] + foo-3.9 + baz-0.1 + """, + """ + # id + installable_with_conflicting_installable_require + + # installed + foo-5 + + # installable + foo-2.9 + baz-0.1 + foo>=2.1,!=3.1,<4 + + # wanted + baz + + # resolved + VersionConflict + + # resolved [replace conflicting] + baz-0.1 + foo-2.9 + """, + """ + # id + conflicting_installables + + # installed + + # installable + foo-2.9 + foo-5.0 + + # wanted + foo>=2.1,!=3.1,<4 + foo>=4 + + # resolved + VersionConflict + + # resolved [replace conflicting] + VersionConflict + """, + """ + # id + installables_with_conflicting_requires + + # installed + + # installable + foo-2.9 + dep==1.0 + baz-5.0 + dep==2.0 + dep-1.0 + dep-2.0 + + # wanted + foo + baz + + # resolved + VersionConflict + + # resolved [replace conflicting] + VersionConflict + """, + """ + # id + installables_with_conflicting_nested_requires + + # installed + + # installable + foo-2.9 + dep1 + dep1-1.0 + subdep<1.0 + baz-5.0 + dep2 + dep2-1.0 + subdep>1.0 + subdep-0.9 + subdep-1.1 + + # wanted + foo + baz + + # resolved + VersionConflict + + # resolved [replace conflicting] + VersionConflict + """, + """ + # id + wanted_normalized_name_installed_canonical + + # installed + foo.bar-3.6 + + # installable + + # wanted + foo-bar==3.6 + + # resolved + foo.bar-3.6 + + # resolved [replace conflicting] + foo.bar-3.6 + """, +) +def test_working_set_resolve( + installed_dists, + installable_dists, + requirements, + replace_conflicting, + resolved_dists_or_exception, +): + ws = pkg_resources.WorkingSet([]) + list(map(ws.add, installed_dists)) + resolve_call = functools.partial( + ws.resolve, + requirements, + installer=FakeInstaller(installable_dists), + replace_conflicting=replace_conflicting, + ) + if inspect.isclass(resolved_dists_or_exception): + with pytest.raises(resolved_dists_or_exception): + resolve_call() + else: + assert sorted(resolve_call()) == sorted(resolved_dists_or_exception) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/INSTALLER new file mode 100644 index 000000000..a1b589e38 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/METADATA new file mode 100644 index 000000000..f12537096 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/METADATA @@ -0,0 +1,141 @@ +Metadata-Version: 2.4 +Name: setuptools +Version: 80.9.0 +Summary: Easily download, build, install, upgrade, and uninstall Python packages +Author-email: Python Packaging Authority +License-Expression: MIT +Project-URL: Source, https://github.com/pypa/setuptools +Project-URL: Documentation, https://setuptools.pypa.io/ +Project-URL: Changelog, https://setuptools.pypa.io/en/stable/history.html +Keywords: CPAN PyPI distutils eggs package management +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Classifier: Topic :: System :: Archiving :: Packaging +Classifier: Topic :: System :: Systems Administration +Classifier: Topic :: Utilities +Requires-Python: >=3.9 +Description-Content-Type: text/x-rst +License-File: LICENSE +Provides-Extra: test +Requires-Dist: pytest!=8.1.*,>=6; extra == "test" +Requires-Dist: virtualenv>=13.0.0; extra == "test" +Requires-Dist: wheel>=0.44.0; extra == "test" +Requires-Dist: pip>=19.1; extra == "test" +Requires-Dist: packaging>=24.2; extra == "test" +Requires-Dist: jaraco.envs>=2.2; extra == "test" +Requires-Dist: pytest-xdist>=3; extra == "test" +Requires-Dist: jaraco.path>=3.7.2; extra == "test" +Requires-Dist: build[virtualenv]>=1.0.3; extra == "test" +Requires-Dist: filelock>=3.4.0; extra == "test" +Requires-Dist: ini2toml[lite]>=0.14; extra == "test" +Requires-Dist: tomli-w>=1.0.0; extra == "test" +Requires-Dist: pytest-timeout; extra == "test" +Requires-Dist: pytest-perf; sys_platform != "cygwin" and extra == "test" +Requires-Dist: jaraco.develop>=7.21; (python_version >= "3.9" and sys_platform != "cygwin") and extra == "test" +Requires-Dist: pytest-home>=0.5; extra == "test" +Requires-Dist: pytest-subprocess; extra == "test" +Requires-Dist: pyproject-hooks!=1.1; extra == "test" +Requires-Dist: jaraco.test>=5.5; extra == "test" +Provides-Extra: doc +Requires-Dist: sphinx>=3.5; extra == "doc" +Requires-Dist: jaraco.packaging>=9.3; extra == "doc" +Requires-Dist: rst.linker>=1.9; extra == "doc" +Requires-Dist: furo; extra == "doc" +Requires-Dist: sphinx-lint; extra == "doc" +Requires-Dist: jaraco.tidelift>=1.4; extra == "doc" +Requires-Dist: pygments-github-lexers==0.0.5; extra == "doc" +Requires-Dist: sphinx-favicon; extra == "doc" +Requires-Dist: sphinx-inline-tabs; extra == "doc" +Requires-Dist: sphinx-reredirects; extra == "doc" +Requires-Dist: sphinxcontrib-towncrier; extra == "doc" +Requires-Dist: sphinx-notfound-page<2,>=1; extra == "doc" +Requires-Dist: pyproject-hooks!=1.1; extra == "doc" +Requires-Dist: towncrier<24.7; extra == "doc" +Provides-Extra: ssl +Provides-Extra: certs +Provides-Extra: core +Requires-Dist: packaging>=24.2; extra == "core" +Requires-Dist: more_itertools>=8.8; extra == "core" +Requires-Dist: jaraco.text>=3.7; extra == "core" +Requires-Dist: importlib_metadata>=6; python_version < "3.10" and extra == "core" +Requires-Dist: tomli>=2.0.1; python_version < "3.11" and extra == "core" +Requires-Dist: wheel>=0.43.0; extra == "core" +Requires-Dist: platformdirs>=4.2.2; extra == "core" +Requires-Dist: jaraco.functools>=4; extra == "core" +Requires-Dist: more_itertools; extra == "core" +Provides-Extra: check +Requires-Dist: pytest-checkdocs>=2.4; extra == "check" +Requires-Dist: pytest-ruff>=0.2.1; sys_platform != "cygwin" and extra == "check" +Requires-Dist: ruff>=0.8.0; sys_platform != "cygwin" and extra == "check" +Provides-Extra: cover +Requires-Dist: pytest-cov; extra == "cover" +Provides-Extra: enabler +Requires-Dist: pytest-enabler>=2.2; extra == "enabler" +Provides-Extra: type +Requires-Dist: pytest-mypy; extra == "type" +Requires-Dist: mypy==1.14.*; extra == "type" +Requires-Dist: importlib_metadata>=7.0.2; python_version < "3.10" and extra == "type" +Requires-Dist: jaraco.develop>=7.21; sys_platform != "cygwin" and extra == "type" +Dynamic: license-file + +.. |pypi-version| image:: https://img.shields.io/pypi/v/setuptools.svg + :target: https://pypi.org/project/setuptools + +.. |py-version| image:: https://img.shields.io/pypi/pyversions/setuptools.svg + +.. |test-badge| image:: https://github.com/pypa/setuptools/actions/workflows/main.yml/badge.svg + :target: https://github.com/pypa/setuptools/actions?query=workflow%3A%22tests%22 + :alt: tests + +.. |ruff-badge| image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json + :target: https://github.com/astral-sh/ruff + :alt: Ruff + +.. |docs-badge| image:: https://img.shields.io/readthedocs/setuptools/latest.svg + :target: https://setuptools.pypa.io + +.. |skeleton-badge| image:: https://img.shields.io/badge/skeleton-2025-informational + :target: https://blog.jaraco.com/skeleton + +.. |codecov-badge| image:: https://img.shields.io/codecov/c/github/pypa/setuptools/master.svg?logo=codecov&logoColor=white + :target: https://codecov.io/gh/pypa/setuptools + +.. |tidelift-badge| image:: https://tidelift.com/badges/github/pypa/setuptools?style=flat + :target: https://tidelift.com/subscription/pkg/pypi-setuptools?utm_source=pypi-setuptools&utm_medium=readme + +.. |discord-badge| image:: https://img.shields.io/discord/803025117553754132 + :target: https://discord.com/channels/803025117553754132/815945031150993468 + :alt: Discord + +|pypi-version| |py-version| |test-badge| |ruff-badge| |docs-badge| |skeleton-badge| |codecov-badge| |discord-badge| + +See the `Quickstart `_ +and the `User's Guide `_ for +instructions on how to use Setuptools. + +Questions and comments should be directed to `GitHub Discussions +`_. +Bug reports and especially tested patches may be +submitted directly to the `bug tracker +`_. + + +Code of Conduct +=============== + +Everyone interacting in the setuptools project's codebases, issue trackers, +chat rooms, and fora is expected to follow the +`PSF Code of Conduct `_. + + +For Enterprise +============== + +Available as part of the Tidelift Subscription. + +Setuptools and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. + +`Learn more `_. diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/RECORD new file mode 100644 index 000000000..2dce21ebf --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/RECORD @@ -0,0 +1,869 @@ +_distutils_hack/__init__.py,sha256=34HmvLo07j45Uvd2VR-2aRQ7lJD91sTK6zJgn5fphbQ,6755 +_distutils_hack/__pycache__/__init__.cpython-312.pyc,, +_distutils_hack/__pycache__/override.cpython-312.pyc,, +_distutils_hack/override.py,sha256=Eu_s-NF6VIZ4Cqd0tbbA5wtWky2IZPNd8et6GLt1mzo,44 +distutils-precedence.pth,sha256=JjjOniUA5XKl4N5_rtZmHrVp0baW_LoHsN0iPaX10iQ,151 +pkg_resources/__init__.py,sha256=uxrWmKF3lxsG4q6ojHlu4tB8j8Kw9jqx_SNMyDKP5q4,126219 +pkg_resources/__pycache__/__init__.cpython-312.pyc,, +pkg_resources/api_tests.txt,sha256=XEdvy4igHHrq2qNHNMHnlfO6XSQKNqOyLHbl6QcpfAI,12595 +pkg_resources/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pkg_resources/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pkg_resources/tests/__pycache__/__init__.cpython-312.pyc,, +pkg_resources/tests/__pycache__/test_find_distributions.cpython-312.pyc,, +pkg_resources/tests/__pycache__/test_integration_zope_interface.cpython-312.pyc,, +pkg_resources/tests/__pycache__/test_markers.cpython-312.pyc,, +pkg_resources/tests/__pycache__/test_pkg_resources.cpython-312.pyc,, +pkg_resources/tests/__pycache__/test_resources.cpython-312.pyc,, +pkg_resources/tests/__pycache__/test_working_set.cpython-312.pyc,, +pkg_resources/tests/data/my-test-package-source/__pycache__/setup.cpython-312.pyc,, +pkg_resources/tests/data/my-test-package-source/setup.cfg,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +pkg_resources/tests/data/my-test-package-source/setup.py,sha256=1VobhAZbMb7M9mfhb_NE8PwDsvukoWLs9aUAS0pYhe8,105 +pkg_resources/tests/data/my-test-package-zip/my-test-package.zip,sha256=AYRcQ39GVePPnMT8TknP1gdDHyJnXhthESmpAjnzSCI,1809 +pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/PKG-INFO,sha256=JvWv9Io2PAuYwEEw2fBW4Qc5YvdbkscpKX1kmLzsoHk,187 +pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/SOURCES.txt,sha256=4ClkH8eTovZrdVrJFsVuxdbMEF--lBVSuKonDAPE5Jc,208 +pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/dependency_links.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1 +pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/top_level.txt,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1 +pkg_resources/tests/data/my-test-package_unpacked-egg/my_test_package-1.0-py3.7.egg/EGG-INFO/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1 +pkg_resources/tests/data/my-test-package_zipped-egg/my_test_package-1.0-py3.7.egg,sha256=ZTlMGxjRGiKDNkiA2c75jbQH2TWIteP00irF9gvczbo,843 +pkg_resources/tests/test_find_distributions.py,sha256=U91cov5L1COAIWLNq3Xy4plU7_MnOE1WtXMu6iV2waM,1972 +pkg_resources/tests/test_integration_zope_interface.py,sha256=nzVoK557KZQN0V3DIQ1sVeaCOgt4Kpl-CODAWsO7pmc,1652 +pkg_resources/tests/test_markers.py,sha256=0orKg7UMDf7fnuNQvRMOc-EF9EAP_JTQnk4mtGgbW50,241 +pkg_resources/tests/test_pkg_resources.py,sha256=5Mt4bJQhLCL8j8cC46Uv32Np2Xc1TTxLGawIfET55Fk,17111 +pkg_resources/tests/test_resources.py,sha256=K0LqMAUGpRQ9pUb9K0vyI7GesvtlQvTH074m-E2VQlo,31252 +pkg_resources/tests/test_working_set.py,sha256=lRtGJWIixSwSMSbjHgRxeJEQiLMRXcz3xzJL2qL7eXY,8602 +setuptools-80.9.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools-80.9.0.dist-info/METADATA,sha256=f4kMqNvBa2O1aMiTEu1qf58KedCyt_PIO_eWrD2TBhU,6572 +setuptools-80.9.0.dist-info/RECORD,, +setuptools-80.9.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools-80.9.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91 +setuptools-80.9.0.dist-info/entry_points.txt,sha256=zkgthpf_Fa9NVE9p6FKT3Xk9DR1faAcRU4coggsV7jA,2449 +setuptools-80.9.0.dist-info/licenses/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 +setuptools-80.9.0.dist-info/top_level.txt,sha256=d9yL39v_W7qmKDDSH6sT4bE0j_Ls1M3P161OGgdsm4g,41 +setuptools/__init__.py,sha256=7duacBaImxzrUa0OghIz8lVgaJ1fIw7-uL2v16vY_SE,9004 +setuptools/__pycache__/__init__.cpython-312.pyc,, +setuptools/__pycache__/_core_metadata.cpython-312.pyc,, +setuptools/__pycache__/_discovery.cpython-312.pyc,, +setuptools/__pycache__/_entry_points.cpython-312.pyc,, +setuptools/__pycache__/_imp.cpython-312.pyc,, +setuptools/__pycache__/_importlib.cpython-312.pyc,, +setuptools/__pycache__/_itertools.cpython-312.pyc,, +setuptools/__pycache__/_normalization.cpython-312.pyc,, +setuptools/__pycache__/_path.cpython-312.pyc,, +setuptools/__pycache__/_reqs.cpython-312.pyc,, +setuptools/__pycache__/_scripts.cpython-312.pyc,, +setuptools/__pycache__/_shutil.cpython-312.pyc,, +setuptools/__pycache__/_static.cpython-312.pyc,, +setuptools/__pycache__/archive_util.cpython-312.pyc,, +setuptools/__pycache__/build_meta.cpython-312.pyc,, +setuptools/__pycache__/depends.cpython-312.pyc,, +setuptools/__pycache__/discovery.cpython-312.pyc,, +setuptools/__pycache__/dist.cpython-312.pyc,, +setuptools/__pycache__/errors.cpython-312.pyc,, +setuptools/__pycache__/extension.cpython-312.pyc,, +setuptools/__pycache__/glob.cpython-312.pyc,, +setuptools/__pycache__/installer.cpython-312.pyc,, +setuptools/__pycache__/launch.cpython-312.pyc,, +setuptools/__pycache__/logging.cpython-312.pyc,, +setuptools/__pycache__/modified.cpython-312.pyc,, +setuptools/__pycache__/monkey.cpython-312.pyc,, +setuptools/__pycache__/msvc.cpython-312.pyc,, +setuptools/__pycache__/namespaces.cpython-312.pyc,, +setuptools/__pycache__/unicode_utils.cpython-312.pyc,, +setuptools/__pycache__/version.cpython-312.pyc,, +setuptools/__pycache__/warnings.cpython-312.pyc,, +setuptools/__pycache__/wheel.cpython-312.pyc,, +setuptools/__pycache__/windows_support.cpython-312.pyc,, +setuptools/_core_metadata.py,sha256=T7Tjp-WSoN881adev3R1wzXCPnkDHqbC2MgylN1yjS8,11978 +setuptools/_discovery.py,sha256=HxEpgYQ8zUaLOOSp8JIA4y2Mdvn9ysVxspPT-ppfzM4,836 +setuptools/_distutils/__init__.py,sha256=xGYuhWwLG07J0Q49BVnEjPy6wyDcd6veJMDJX7ljlyM,359 +setuptools/_distutils/__pycache__/__init__.cpython-312.pyc,, +setuptools/_distutils/__pycache__/_log.cpython-312.pyc,, +setuptools/_distutils/__pycache__/_macos_compat.cpython-312.pyc,, +setuptools/_distutils/__pycache__/_modified.cpython-312.pyc,, +setuptools/_distutils/__pycache__/_msvccompiler.cpython-312.pyc,, +setuptools/_distutils/__pycache__/archive_util.cpython-312.pyc,, +setuptools/_distutils/__pycache__/ccompiler.cpython-312.pyc,, +setuptools/_distutils/__pycache__/cmd.cpython-312.pyc,, +setuptools/_distutils/__pycache__/core.cpython-312.pyc,, +setuptools/_distutils/__pycache__/cygwinccompiler.cpython-312.pyc,, +setuptools/_distutils/__pycache__/debug.cpython-312.pyc,, +setuptools/_distutils/__pycache__/dep_util.cpython-312.pyc,, +setuptools/_distutils/__pycache__/dir_util.cpython-312.pyc,, +setuptools/_distutils/__pycache__/dist.cpython-312.pyc,, +setuptools/_distutils/__pycache__/errors.cpython-312.pyc,, +setuptools/_distutils/__pycache__/extension.cpython-312.pyc,, +setuptools/_distutils/__pycache__/fancy_getopt.cpython-312.pyc,, +setuptools/_distutils/__pycache__/file_util.cpython-312.pyc,, +setuptools/_distutils/__pycache__/filelist.cpython-312.pyc,, +setuptools/_distutils/__pycache__/log.cpython-312.pyc,, +setuptools/_distutils/__pycache__/spawn.cpython-312.pyc,, +setuptools/_distutils/__pycache__/sysconfig.cpython-312.pyc,, +setuptools/_distutils/__pycache__/text_file.cpython-312.pyc,, +setuptools/_distutils/__pycache__/unixccompiler.cpython-312.pyc,, +setuptools/_distutils/__pycache__/util.cpython-312.pyc,, +setuptools/_distutils/__pycache__/version.cpython-312.pyc,, +setuptools/_distutils/__pycache__/versionpredicate.cpython-312.pyc,, +setuptools/_distutils/__pycache__/zosccompiler.cpython-312.pyc,, +setuptools/_distutils/_log.py,sha256=i-lNTTcXS8TmWITJ6DODGvtW5z5tMattJQ76h8rZxQU,42 +setuptools/_distutils/_macos_compat.py,sha256=JzUGhF4E5yIITHbUaPobZEWjGHdrrcNV63z86S4RjBc,239 +setuptools/_distutils/_modified.py,sha256=RF1n1CexyDYV3lvGbeXS0s-XCJVboDOIUbA8wEQqYTY,3211 +setuptools/_distutils/_msvccompiler.py,sha256=9PSfSHxvJnHnQL6Sqz4Xcz7iaBIT62p6BheQzGsSlwo,335 +setuptools/_distutils/archive_util.py,sha256=Qw2z-Pt-NV8lNUQrzjs3XDGWCWHMPnqHLyt8TiD2XEA,8884 +setuptools/_distutils/ccompiler.py,sha256=FKVjqzGJ7c-FtouNjhLiaMPm5LKMZHHAruXf8LU216c,524 +setuptools/_distutils/cmd.py,sha256=hXtaRaH7QBnfNOIqEvCt47iwZzD9MVvBdhhdQctHsxM,22186 +setuptools/_distutils/command/__init__.py,sha256=GfFAzbBqk1qxSH4BdaKioKS4hRRnD44BAmwEN85C4u8,386 +setuptools/_distutils/command/__pycache__/__init__.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/_framework_compat.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/bdist.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/bdist_dumb.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/bdist_rpm.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/build.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/build_clib.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/build_ext.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/build_py.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/build_scripts.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/check.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/clean.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/config.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/install.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/install_data.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/install_egg_info.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/install_headers.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/install_lib.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/install_scripts.cpython-312.pyc,, +setuptools/_distutils/command/__pycache__/sdist.cpython-312.pyc,, +setuptools/_distutils/command/_framework_compat.py,sha256=0iZdSJYzGRWCCvzRDKE-R0-_yaAYvFMd1ylXb2eYXug,1609 +setuptools/_distutils/command/bdist.py,sha256=jWtk61R7fWNUUNxJV0thTZzU5n80L3Ay1waSiP9kiLA,5854 +setuptools/_distutils/command/bdist_dumb.py,sha256=Hx1jAqoZNxYIy4N5TLzUp6J5fi8Ls18py7UlLNFhO2E,4631 +setuptools/_distutils/command/bdist_rpm.py,sha256=nxcXXv5a7B-1ntWu4DbGmCtES4EBINrJaBQcRNAYCJI,21785 +setuptools/_distutils/command/build.py,sha256=SpHlagf0iNaKVyIhxDfhPFZ8X1-LAWOCQACy-yt2K0w,5923 +setuptools/_distutils/command/build_clib.py,sha256=aMqZcUfCbOAu_xr-A9iW-Q9YZHzpDGLRTezOgMQJmSQ,7777 +setuptools/_distutils/command/build_ext.py,sha256=zrrsu9HXnzV6bXYbJuZCK4SwVZMjKnl4pG1o3bNcxtc,32710 +setuptools/_distutils/command/build_py.py,sha256=Vfq-INemoMbg6f003BTy_Ufp8bjOZhmFIhpKMcfXLgs,16696 +setuptools/_distutils/command/build_scripts.py,sha256=emMEOONkNLPC-AMjKy45UksUlY1wk06esOGThpwidIM,5135 +setuptools/_distutils/command/check.py,sha256=yoNe2MPY4JcTM7rwoIQdfZ75q5Ri058I2coi-Gq9CjM,4946 +setuptools/_distutils/command/clean.py,sha256=dQAacOabwBXU9JoZ-1GFusq3eFltDaeXJFSYncqGbvE,2644 +setuptools/_distutils/command/config.py,sha256=qrrfz6NEQORmbqiY2XlvCDWYhsbLyxZXJsURKfYN_kw,12724 +setuptools/_distutils/command/install.py,sha256=-JenB-mua4hc2RI_-W8F9PnP_J-OaFO7E0PJGKxLo1o,30072 +setuptools/_distutils/command/install_data.py,sha256=GzBlUWWKubTYJlP-L0auUriq9cL-5RKOcoyHTttKj0Q,2875 +setuptools/_distutils/command/install_egg_info.py,sha256=ffiLoU1ivQJ8q2_WL7ZygZbUcOsgdFLKL7otEIJWWkI,2868 +setuptools/_distutils/command/install_headers.py,sha256=5ciKCj8c3XKsYNKdkdMvnypaUCKcoWCDeeZij3fD-Z4,1272 +setuptools/_distutils/command/install_lib.py,sha256=2s9-m5-b1qKm51F28lB5L39Z6vv_GHMlv9dNBSupok0,8588 +setuptools/_distutils/command/install_scripts.py,sha256=M0pPdiaqB7TGmqTMujpGGeiL0Iq_CTeGjMFtrmDmwzM,2002 +setuptools/_distutils/command/sdist.py,sha256=cRIF6Ht1hJ6ayOOFVycMFBUNxjo94e_rFYPx4Hi8Ahc,19151 +setuptools/_distutils/compat/__init__.py,sha256=J20aXGjJ86Rg41xFLIWlcWCgZ9edMdJ9vvdNEQ87vPQ,522 +setuptools/_distutils/compat/__pycache__/__init__.cpython-312.pyc,, +setuptools/_distutils/compat/__pycache__/numpy.cpython-312.pyc,, +setuptools/_distutils/compat/__pycache__/py39.cpython-312.pyc,, +setuptools/_distutils/compat/numpy.py,sha256=UFgneZw9w97g4c-yGoAIOyLxUOWQ-fPRIhhfMs7_Ouc,167 +setuptools/_distutils/compat/py39.py,sha256=hOsD6lwZLqZoMnacNJ3P6nUA-LJQhEpVtYTzVH0o96M,1964 +setuptools/_distutils/compilers/C/__pycache__/base.cpython-312.pyc,, +setuptools/_distutils/compilers/C/__pycache__/cygwin.cpython-312.pyc,, +setuptools/_distutils/compilers/C/__pycache__/errors.cpython-312.pyc,, +setuptools/_distutils/compilers/C/__pycache__/msvc.cpython-312.pyc,, +setuptools/_distutils/compilers/C/__pycache__/unix.cpython-312.pyc,, +setuptools/_distutils/compilers/C/__pycache__/zos.cpython-312.pyc,, +setuptools/_distutils/compilers/C/base.py,sha256=XR1rBCStCquqm7QOYXD41-LfvsFcPpGxrwxeXzJyn_w,54876 +setuptools/_distutils/compilers/C/cygwin.py,sha256=DUlwQSb55aj7OdcmcddrmCmVEjEaxIiJ5hHUO3GBPNs,11844 +setuptools/_distutils/compilers/C/errors.py,sha256=sKOVzJajMUmNdfywo9UM_QQGsKFcclDhtI5TlCiXMLc,573 +setuptools/_distutils/compilers/C/msvc.py,sha256=elzG8v9jN5QytLMwLCdUdSuZ3eZ3R98VUvnm9Y2PBCA,21404 +setuptools/_distutils/compilers/C/tests/__pycache__/test_base.cpython-312.pyc,, +setuptools/_distutils/compilers/C/tests/__pycache__/test_cygwin.cpython-312.pyc,, +setuptools/_distutils/compilers/C/tests/__pycache__/test_mingw.cpython-312.pyc,, +setuptools/_distutils/compilers/C/tests/__pycache__/test_msvc.cpython-312.pyc,, +setuptools/_distutils/compilers/C/tests/__pycache__/test_unix.cpython-312.pyc,, +setuptools/_distutils/compilers/C/tests/test_base.py,sha256=rdhHc56bhXtm5NnN9BSHwr6c69UqzMItZQzlw2AsdMc,2706 +setuptools/_distutils/compilers/C/tests/test_cygwin.py,sha256=UgV2VgUXj3VulcbDc0UBWfEyJDx42tgSwS4LzHix3mY,2701 +setuptools/_distutils/compilers/C/tests/test_mingw.py,sha256=hCmwyywISpRoyOySbFHBL4TprWRV0mUWDKmOLO8XBXE,1900 +setuptools/_distutils/compilers/C/tests/test_msvc.py,sha256=DlGjmZ1mBSMXIgmlu80BKc7V-EJOZuYucwJwFh5dn28,4151 +setuptools/_distutils/compilers/C/tests/test_unix.py,sha256=AyadWw1fR-UeDl2TvIbYBzOJVHkpE_oRRQ3JTJWqaEA,14642 +setuptools/_distutils/compilers/C/unix.py,sha256=YH-y9g_pjBFjaJyHJQkDEBQ7q4D20I2-cWJNdgw-Yho,16531 +setuptools/_distutils/compilers/C/zos.py,sha256=vnNeWLRZkdIkdZ-YyBnL8idTUfcCOn0tLMW5OBJ0ScU,6586 +setuptools/_distutils/core.py,sha256=GEHKaFC48T3o-_SmH4864GvKyx1IgbVC6ISIPVlx7a4,9364 +setuptools/_distutils/cygwinccompiler.py,sha256=mG_cU8SVZ4amD_VtF5vH6BXP0-kghGsDPbDSXrQ963c,594 +setuptools/_distutils/debug.py,sha256=N6MrTAqK6l9SVk6tWweR108PM8Ol7qNlfyV-nHcLhsY,139 +setuptools/_distutils/dep_util.py,sha256=xN75p6ZpHhMiHEc-rpL2XilJQynHnDNiafHteaZ4tjU,349 +setuptools/_distutils/dir_util.py,sha256=DXPUlfVVGsg9B-Jgg4At_j9T7vM60OgwNXkQHqTo7-I,7236 +setuptools/_distutils/dist.py,sha256=gW598UE0WMkzXQQ31Nr-8L7MPw0oIOz5OSSRzYZlwrM,55794 +setuptools/_distutils/errors.py,sha256=PPE2oDRh5y9Q1beKK9rhdvDaCzQhi4HCXs4KcqfqgZY,3092 +setuptools/_distutils/extension.py,sha256=Foyu4gULcPqm1_U9zrYYHxNk4NqglXv1rbsOk_QrSds,11155 +setuptools/_distutils/fancy_getopt.py,sha256=PjdO-bWCW0imV_UN-MGEw9R2GP2OiE8pHjITgmTAY3Q,17895 +setuptools/_distutils/file_util.py,sha256=YFQL_pD3hLuER9II_H6-hDC_YIGEookdd4wedLuiTW0,7978 +setuptools/_distutils/filelist.py,sha256=MBeSRJmPcKmDv8ooZgSU4BiQPZ0Khwv8l_jhD50XycI,15337 +setuptools/_distutils/log.py,sha256=VyBs5j7z4-K6XTEEBThUc9HyMpoPLGtQpERqbz5ylww,1200 +setuptools/_distutils/spawn.py,sha256=zseCh9sEifyp0I5Vg719JNIASlROJ2ehXqQnHlpt89Q,4086 +setuptools/_distutils/sysconfig.py,sha256=KeI8OHbMuEzHJ8Q0cBez9KZny8iRy6Z6Y0AkMz1jlsU,19728 +setuptools/_distutils/tests/__init__.py,sha256=j-IoPZEtQv3EOPuqNTwalr6GLyRjzCC-OOaNvZzmHsI,1485 +setuptools/_distutils/tests/__pycache__/__init__.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/support.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_archive_util.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_bdist.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_bdist_dumb.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_bdist_rpm.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_build.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_build_clib.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_build_ext.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_build_py.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_build_scripts.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_check.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_clean.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_cmd.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_config_cmd.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_core.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_dir_util.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_dist.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_extension.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_file_util.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_filelist.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_install.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_install_data.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_install_headers.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_install_lib.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_install_scripts.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_log.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_modified.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_sdist.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_spawn.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_sysconfig.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_text_file.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_util.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_version.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/test_versionpredicate.cpython-312.pyc,, +setuptools/_distutils/tests/__pycache__/unix_compat.cpython-312.pyc,, +setuptools/_distutils/tests/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_distutils/tests/compat/__pycache__/__init__.cpython-312.pyc,, +setuptools/_distutils/tests/compat/__pycache__/py39.cpython-312.pyc,, +setuptools/_distutils/tests/compat/py39.py,sha256=t0GBTM-30jX-9zCfkwlNBFtzzabemx6065mJ0d9_VRw,1026 +setuptools/_distutils/tests/support.py,sha256=tjsYsyxvpTK4NrkCseh2ujvDIGV0Mf_b5SI5fP2T0yM,4099 +setuptools/_distutils/tests/test_archive_util.py,sha256=jozimSwPBF-JoJfN_vDaiVGZp66BNcWZGh34FlW57DQ,11787 +setuptools/_distutils/tests/test_bdist.py,sha256=xNHxUsLlHsZQRwkzLb_iSD24s-9Mk-NX2ffBWwOyPyc,1396 +setuptools/_distutils/tests/test_bdist_dumb.py,sha256=QF05MHNhPOdZyh88Xpw8KsO64s7pRFkl8KL-RoV4XK0,2247 +setuptools/_distutils/tests/test_bdist_rpm.py,sha256=Hdm-pwWgyaoGdGbEcGZa8cRhGU45y8gHK8umOanTjik,3932 +setuptools/_distutils/tests/test_build.py,sha256=JJY5XpOZco25ZY0pstxl-iI8mHsWP0ujf5o8aOtuZYY,1742 +setuptools/_distutils/tests/test_build_clib.py,sha256=Mo1ZFb4C1VXBYOGvnallwN7YCnTtr24akLDO8Zi4CsY,4331 +setuptools/_distutils/tests/test_build_ext.py,sha256=QFO9qYVhWWdJu17HXc4x9RMnLZlhk0lAHi9HVppbuX4,22545 +setuptools/_distutils/tests/test_build_py.py,sha256=NsfmRrojOHBXNMqWR_mp5g4PLTgjhD7iZFUffGZFIdw,6882 +setuptools/_distutils/tests/test_build_scripts.py,sha256=cD-FRy-oX55sXRX5Ez5xQCaeHrWajyKc4Xuwv2fe48w,2880 +setuptools/_distutils/tests/test_check.py,sha256=hHSV07qf7YoSxGsTbbsUQ9tssZz5RRNdbrY1s2SwaFI,6226 +setuptools/_distutils/tests/test_clean.py,sha256=hPH6jfIpGFUrvWbF1txkiNVSNaAxt2wq5XjV499zO4E,1240 +setuptools/_distutils/tests/test_cmd.py,sha256=bgRB79mitoOKR1OiyZHnCogvGxt3pWkxeTqIC04lQWQ,3254 +setuptools/_distutils/tests/test_config_cmd.py,sha256=Zs6WX0IfxDvmuC19XzuVNnYCnTr9Y-hl73TAmDSBN4Y,2664 +setuptools/_distutils/tests/test_core.py,sha256=L7XKVAxa-MGoAZeANopnuK9fRKneYhkSQpgw8XQvcF8,3829 +setuptools/_distutils/tests/test_dir_util.py,sha256=E84lC-k4riVUwURyWaQ0Jqx2ui2-io-0RuJa3M7qkJs,4500 +setuptools/_distutils/tests/test_dist.py,sha256=a6wlc5fQJd5qQ6HOndzcupNhjTxvj6-_JLtpuYvaP1M,18793 +setuptools/_distutils/tests/test_extension.py,sha256=-YejLgZCuycFrOBd64pVH0JvwMc9NwhzHvQxvvjXHqk,3670 +setuptools/_distutils/tests/test_file_util.py,sha256=livjnl3FkilQlrB2rFdFQq9nvjEVZHynNya0bfzv_b4,3522 +setuptools/_distutils/tests/test_filelist.py,sha256=rJwkqCUfkGDgWlD22TozsT8ycbupMHB8DXqThzwT1T4,10766 +setuptools/_distutils/tests/test_install.py,sha256=TfCB0ykhIxydIC2Q4SuTAZzSHvteMHgrBL9whoSgK9Q,8618 +setuptools/_distutils/tests/test_install_data.py,sha256=vKq3K97k0hBAnOg38nmwEdf7cEDVr9rTVyCeJolgb4A,2464 +setuptools/_distutils/tests/test_install_headers.py,sha256=PVAYpo_tYl980Qf64DPOmmSvyefIHdU06f7VsJeZykE,936 +setuptools/_distutils/tests/test_install_lib.py,sha256=qri6Rl-maNTQrNDV8DbeXNl0hjsfRIKiI4rfZLrmWBI,3612 +setuptools/_distutils/tests/test_install_scripts.py,sha256=KE3v0cDkFW-90IOID-OmZZGM2mhy-ZkEuuW7UXS2SHw,1600 +setuptools/_distutils/tests/test_log.py,sha256=isFtOufloCyEdZaQOV7cVUr46GwtdVMj43mGBB5XH7k,323 +setuptools/_distutils/tests/test_modified.py,sha256=h1--bOWmtJo1bpVV6uRhdnS9br71CBiNDM1MDwSGpug,4221 +setuptools/_distutils/tests/test_sdist.py,sha256=cfzUhlCA418-1vH9ta3IBs26c_jUBbkJoFOK5GnAyNk,15062 +setuptools/_distutils/tests/test_spawn.py,sha256=eS8w9D7bTxyFLSyRahJWeuh8Kc1F8RWWiY_dSG5B5Bc,4803 +setuptools/_distutils/tests/test_sysconfig.py,sha256=lxM8LsUi1TomjDV4HoYK8u5nUoBkeNL60Uq8PY1DcwU,11986 +setuptools/_distutils/tests/test_text_file.py,sha256=WQWSB5AfdBDZaMA8BFgipJPnsJb_2SKMfL90fSkRVtw,3460 +setuptools/_distutils/tests/test_util.py,sha256=H9zlZ4z4Vh4TfjNYDBsxP7wguQLpxCfJYyOcm1yZU3c,7988 +setuptools/_distutils/tests/test_version.py,sha256=ahfg_mP8wRy1sgwY-_Px5hrjgf6_upTIpnCgpR4yWRk,2750 +setuptools/_distutils/tests/test_versionpredicate.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_distutils/tests/unix_compat.py,sha256=z-op6C2iVdX1aq5BIBR7cqOxijKE97alNwJqHNdLpoI,386 +setuptools/_distutils/text_file.py,sha256=z4dkOJBr9Bo2LG0TNqm8sD63LEEaKSSP0J0bWBrFG3c,12101 +setuptools/_distutils/unixccompiler.py,sha256=1bXJWH4fiu_A2WfriHzf88xjllQTXnnjUkZdRKs9cWU,212 +setuptools/_distutils/util.py,sha256=Njfnqk60zMdkiAjRnGcTWX3t49-obHapOlbNvyIl02I,18094 +setuptools/_distutils/version.py,sha256=vImT5-ECXkQ21oKL0XYFiTqK6NyM09cpzBNoA_34CQU,12619 +setuptools/_distutils/versionpredicate.py,sha256=qBWQ6wTj12ODytoTmIydefIY2jb4uY1sdbgbuLn-IJM,5205 +setuptools/_distutils/zosccompiler.py,sha256=svdiXZ2kdcwKrJKfhUhib03y8gz7aGZKukXH3I7YkBc,58 +setuptools/_entry_points.py,sha256=10TjbzfGdqWGH06lQuPPGDDci-OnXoIzrfpIWba5AZw,2468 +setuptools/_imp.py,sha256=YY1EjZEN-0zYci1cxO10B_adAEOr7i8eK8JoCc9Ierc,2435 +setuptools/_importlib.py,sha256=aKIjcK0HKXNz2D-XTrxaixGn_juTkONwmu3dcheMOF0,223 +setuptools/_itertools.py,sha256=jWRfsIrpC7myooz3hDURj9GtvpswZeKXg2HakmEhNjo,657 +setuptools/_normalization.py,sha256=-SxdhisW3W1JKzqKYxd3XeHyRjIj3J9EVRkt3aL8nKY,5747 +setuptools/_path.py,sha256=2Bv1q9_Hrd4oizKwcH3pv_05YVR6meovQE6ZtyD45yI,2976 +setuptools/_reqs.py,sha256=RRX-qYsz_fy6K66XchCHcIszK3bSAtU6aO1s3ZaLV14,1380 +setuptools/_scripts.py,sha256=5TrIWDVOuO3cRcfzcZAUBKPRH7K4svQRdQLZKKiD1bQ,11247 +setuptools/_shutil.py,sha256=IQQ1gcPX4X_wPilYGJGxChyMCqG43VOejoQZTIrCTY8,1578 +setuptools/_static.py,sha256=GTR79gESF1_JaK4trLkpDrEuCeEtPlwQW0MRv7VNQX4,4855 +setuptools/_vendor/__pycache__/typing_extensions.cpython-312.pyc,, +setuptools/_vendor/autocommand-2.2.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/autocommand-2.2.2.dist-info/LICENSE,sha256=reeNBJgtaZctREqOFKlPh6IzTdOFXMgDSOqOJAqg3y0,7634 +setuptools/_vendor/autocommand-2.2.2.dist-info/METADATA,sha256=OADZuR3O6iBlpu1ieTgzYul6w4uOVrk0P0BO5TGGAJk,15006 +setuptools/_vendor/autocommand-2.2.2.dist-info/RECORD,sha256=giu6ZrQVJvpUcYa4AiH4XaUNZSvuVJPb_l0UCFES8MM,1308 +setuptools/_vendor/autocommand-2.2.2.dist-info/WHEEL,sha256=2wepM1nk4DS4eFpYrW1TTqPcoGNfHhhO_i5m4cOimbo,92 +setuptools/_vendor/autocommand-2.2.2.dist-info/top_level.txt,sha256=AzfhgKKS8EdAwWUTSF8mgeVQbXOY9kokHB6kSqwwqu0,12 +setuptools/_vendor/autocommand/__init__.py,sha256=zko5Rnvolvb-UXjCx_2ArPTGBWwUK5QY4LIQIKYR7As,1037 +setuptools/_vendor/autocommand/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/autocommand/__pycache__/autoasync.cpython-312.pyc,, +setuptools/_vendor/autocommand/__pycache__/autocommand.cpython-312.pyc,, +setuptools/_vendor/autocommand/__pycache__/automain.cpython-312.pyc,, +setuptools/_vendor/autocommand/__pycache__/autoparse.cpython-312.pyc,, +setuptools/_vendor/autocommand/__pycache__/errors.cpython-312.pyc,, +setuptools/_vendor/autocommand/autoasync.py,sha256=AMdyrxNS4pqWJfP_xuoOcImOHWD-qT7x06wmKN1Vp-U,5680 +setuptools/_vendor/autocommand/autocommand.py,sha256=hmkEmQ72HtL55gnURVjDOnsfYlGd5lLXbvT4KG496Qw,2505 +setuptools/_vendor/autocommand/automain.py,sha256=A2b8i754Mxc_DjU9WFr6vqYDWlhz0cn8miu8d8EsxV8,2076 +setuptools/_vendor/autocommand/autoparse.py,sha256=WVWmZJPcbzUKXP40raQw_0HD8qPJ2V9VG1eFFmmnFxw,11642 +setuptools/_vendor/autocommand/errors.py,sha256=7aa3roh9Herd6nIKpQHNWEslWE8oq7GiHYVUuRqORnA,886 +setuptools/_vendor/backports.tarfile-1.2.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/backports.tarfile-1.2.0.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 +setuptools/_vendor/backports.tarfile-1.2.0.dist-info/METADATA,sha256=ghXFTq132dxaEIolxr3HK1mZqm9iyUmaRANZQSr6WlE,2020 +setuptools/_vendor/backports.tarfile-1.2.0.dist-info/RECORD,sha256=JYofHISeEXUGmlWl1s41ev3QTjTNXeJwk-Ss7HqdLOE,1360 +setuptools/_vendor/backports.tarfile-1.2.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/backports.tarfile-1.2.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 +setuptools/_vendor/backports.tarfile-1.2.0.dist-info/top_level.txt,sha256=cGjaLMOoBR1FK0ApojtzWVmViTtJ7JGIK_HwXiEsvtU,10 +setuptools/_vendor/backports/__init__.py,sha256=iOEMwnlORWezdO8-2vxBIPSR37D7JGjluZ8f55vzxls,81 +setuptools/_vendor/backports/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/backports/tarfile/__init__.py,sha256=Pwf2qUIfB0SolJPCKcx3vz3UEu_aids4g4sAfxy94qg,108491 +setuptools/_vendor/backports/tarfile/__main__.py,sha256=Yw2oGT1afrz2eBskzdPYL8ReB_3liApmhFkN2EbDmc4,59 +setuptools/_vendor/backports/tarfile/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/backports/tarfile/__pycache__/__main__.cpython-312.pyc,, +setuptools/_vendor/backports/tarfile/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/backports/tarfile/compat/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/backports/tarfile/compat/__pycache__/py38.cpython-312.pyc,, +setuptools/_vendor/backports/tarfile/compat/py38.py,sha256=iYkyt_gvWjLzGUTJD9TuTfMMjOk-ersXZmRlvQYN2qE,568 +setuptools/_vendor/importlib_metadata-8.0.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/importlib_metadata-8.0.0.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358 +setuptools/_vendor/importlib_metadata-8.0.0.dist-info/METADATA,sha256=anuQ7_7h4J1bSEzfcjIBakPi2cyVQ7y7jklLHsBeH1k,4648 +setuptools/_vendor/importlib_metadata-8.0.0.dist-info/RECORD,sha256=DY08buueu-hsrH1ghhVSQzwynanqUSSLYdAr4uXmQDA,2518 +setuptools/_vendor/importlib_metadata-8.0.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/importlib_metadata-8.0.0.dist-info/WHEEL,sha256=mguMlWGMX-VHnMpKOjjQidIo1ssRlCFu4a4mBpz1s2M,91 +setuptools/_vendor/importlib_metadata-8.0.0.dist-info/top_level.txt,sha256=CO3fD9yylANiXkrMo4qHLV_mqXL2sC5JFKgt1yWAT-A,19 +setuptools/_vendor/importlib_metadata/__init__.py,sha256=tZNB-23h8Bixi9uCrQqj9Yf0aeC--Josdy3IZRIQeB0,33798 +setuptools/_vendor/importlib_metadata/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/importlib_metadata/__pycache__/_adapters.cpython-312.pyc,, +setuptools/_vendor/importlib_metadata/__pycache__/_collections.cpython-312.pyc,, +setuptools/_vendor/importlib_metadata/__pycache__/_compat.cpython-312.pyc,, +setuptools/_vendor/importlib_metadata/__pycache__/_functools.cpython-312.pyc,, +setuptools/_vendor/importlib_metadata/__pycache__/_itertools.cpython-312.pyc,, +setuptools/_vendor/importlib_metadata/__pycache__/_meta.cpython-312.pyc,, +setuptools/_vendor/importlib_metadata/__pycache__/_text.cpython-312.pyc,, +setuptools/_vendor/importlib_metadata/__pycache__/diagnose.cpython-312.pyc,, +setuptools/_vendor/importlib_metadata/_adapters.py,sha256=rIhWTwBvYA1bV7i-5FfVX38qEXDTXFeS5cb5xJtP3ks,2317 +setuptools/_vendor/importlib_metadata/_collections.py,sha256=CJ0OTCHIjWA0ZIVS4voORAsn2R4R2cQBEtPsZEJpASY,743 +setuptools/_vendor/importlib_metadata/_compat.py,sha256=73QKrN9KNoaZzhbX5yPCCZa-FaALwXe8TPlDR72JgBU,1314 +setuptools/_vendor/importlib_metadata/_functools.py,sha256=PsY2-4rrKX4RVeRC1oGp1lB1pmC9eKN88_f-bD9uOoA,2895 +setuptools/_vendor/importlib_metadata/_itertools.py,sha256=cvr_2v8BRbxcIl5x5ldfqdHjhI8Yi8s8yk50G_nm6jQ,2068 +setuptools/_vendor/importlib_metadata/_meta.py,sha256=nxZ7C8GVlcBFAKWyVOn_dn7ot_twBcbm1NmvjIetBHI,1801 +setuptools/_vendor/importlib_metadata/_text.py,sha256=HCsFksZpJLeTP3NEk_ngrAeXVRRtTrtyh9eOABoRP4A,2166 +setuptools/_vendor/importlib_metadata/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/importlib_metadata/compat/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/importlib_metadata/compat/__pycache__/py311.cpython-312.pyc,, +setuptools/_vendor/importlib_metadata/compat/__pycache__/py39.cpython-312.pyc,, +setuptools/_vendor/importlib_metadata/compat/py311.py,sha256=uqm-K-uohyj1042TH4a9Er_I5o7667DvulcD-gC_fSA,608 +setuptools/_vendor/importlib_metadata/compat/py39.py,sha256=cPkMv6-0ilK-0Jw_Tkn0xYbOKJZc4WJKQHow0c2T44w,1102 +setuptools/_vendor/importlib_metadata/diagnose.py,sha256=nkSRMiowlmkhLYhKhvCg9glmt_11Cox-EmLzEbqYTa8,379 +setuptools/_vendor/importlib_metadata/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/inflect-7.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/inflect-7.3.1.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 +setuptools/_vendor/inflect-7.3.1.dist-info/METADATA,sha256=ZgMNY0WAZRs-U8wZiV2SMfjSKqBrMngXyDMs_CAwMwg,21079 +setuptools/_vendor/inflect-7.3.1.dist-info/RECORD,sha256=XXg0rBuiYSxoAQUP3lenuYsPNqz4jDwtTzdv2JEbMJE,943 +setuptools/_vendor/inflect-7.3.1.dist-info/WHEEL,sha256=y4mX-SOX4fYIkonsAGA5N0Oy-8_gI4FXw5HNI1xqvWg,91 +setuptools/_vendor/inflect-7.3.1.dist-info/top_level.txt,sha256=m52ujdp10CqT6jh1XQxZT6kEntcnv-7Tl7UiGNTzWZA,8 +setuptools/_vendor/inflect/__init__.py,sha256=Jxy1HJXZiZ85kHeLAhkmvz6EMTdFqBe-duvt34R6IOc,103796 +setuptools/_vendor/inflect/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/inflect/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/inflect/compat/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/inflect/compat/__pycache__/py38.cpython-312.pyc,, +setuptools/_vendor/inflect/compat/py38.py,sha256=oObVfVnWX9_OpnOuEJn1mFbJxVhwyR5epbiTNXDDaso,160 +setuptools/_vendor/inflect/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/jaraco.collections-5.1.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/jaraco.collections-5.1.0.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 +setuptools/_vendor/jaraco.collections-5.1.0.dist-info/METADATA,sha256=IMUaliNsA5X1Ox9MXUWOagch5R4Wwb_3M7erp29dBtg,3933 +setuptools/_vendor/jaraco.collections-5.1.0.dist-info/RECORD,sha256=HptivXDkpfom6VlMu4CGD_7KPev-6Hc9rvp3TNJZygY,873 +setuptools/_vendor/jaraco.collections-5.1.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/jaraco.collections-5.1.0.dist-info/WHEEL,sha256=Mdi9PDNwEZptOjTlUcAth7XJDFtKrHYaQMPulZeBCiQ,91 +setuptools/_vendor/jaraco.collections-5.1.0.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7 +setuptools/_vendor/jaraco.context-5.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/jaraco.context-5.3.0.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 +setuptools/_vendor/jaraco.context-5.3.0.dist-info/METADATA,sha256=xDtguJej0tN9iEXCUvxEJh2a7xceIRVBEakBLSr__tY,4020 +setuptools/_vendor/jaraco.context-5.3.0.dist-info/RECORD,sha256=VRl7iKeEQyl7stgnp1uq50CzOJYlHYcoNdS0x17C9X4,641 +setuptools/_vendor/jaraco.context-5.3.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 +setuptools/_vendor/jaraco.context-5.3.0.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7 +setuptools/_vendor/jaraco.functools-4.0.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/jaraco.functools-4.0.1.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 +setuptools/_vendor/jaraco.functools-4.0.1.dist-info/METADATA,sha256=i4aUaQDX-jjdEQK5wevhegyx8JyLfin2HyvaSk3FHso,2891 +setuptools/_vendor/jaraco.functools-4.0.1.dist-info/RECORD,sha256=YyqnwE98S8wBwCevW5vHb-iVj0oYEDW5V6O9MBS6JIs,843 +setuptools/_vendor/jaraco.functools-4.0.1.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 +setuptools/_vendor/jaraco.functools-4.0.1.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7 +setuptools/_vendor/jaraco.text-3.12.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/jaraco.text-3.12.1.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 +setuptools/_vendor/jaraco.text-3.12.1.dist-info/METADATA,sha256=AzWdm6ViMfDOPoQMfLWn2zgBQSGJScyqeN29TcuWXVI,3658 +setuptools/_vendor/jaraco.text-3.12.1.dist-info/RECORD,sha256=gW2UV0HcokYJk4jKPu10_AZnrLqjb3C1WbJJTDl5sfY,1500 +setuptools/_vendor/jaraco.text-3.12.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/jaraco.text-3.12.1.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 +setuptools/_vendor/jaraco.text-3.12.1.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7 +setuptools/_vendor/jaraco/__pycache__/context.cpython-312.pyc,, +setuptools/_vendor/jaraco/collections/__init__.py,sha256=Pc1-SqjWm81ad1P0-GttpkwO_LWlnaY6gUq8gcKh2v0,26640 +setuptools/_vendor/jaraco/collections/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/jaraco/collections/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/jaraco/context.py,sha256=REoLIxDkO5MfEYowt_WoupNCRoxBS5v7YX2PbW8lIcs,9552 +setuptools/_vendor/jaraco/functools/__init__.py,sha256=hEAJaS2uSZRuF_JY4CxCHIYh79ZpxaPp9OiHyr9EJ1w,16642 +setuptools/_vendor/jaraco/functools/__init__.pyi,sha256=gk3dsgHzo5F_U74HzAvpNivFAPCkPJ1b2-yCd62dfnw,3878 +setuptools/_vendor/jaraco/functools/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/jaraco/functools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/jaraco/text/Lorem ipsum.txt,sha256=N_7c_79zxOufBY9HZ3yzMgOkNv-TkOTTio4BydrSjgs,1335 +setuptools/_vendor/jaraco/text/__init__.py,sha256=Y2YUqXR_orUoDaY4SkPRe6ZZhb5HUHB_Ah9RCNsVyho,16250 +setuptools/_vendor/jaraco/text/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/jaraco/text/__pycache__/layouts.cpython-312.pyc,, +setuptools/_vendor/jaraco/text/__pycache__/show-newlines.cpython-312.pyc,, +setuptools/_vendor/jaraco/text/__pycache__/strip-prefix.cpython-312.pyc,, +setuptools/_vendor/jaraco/text/__pycache__/to-dvorak.cpython-312.pyc,, +setuptools/_vendor/jaraco/text/__pycache__/to-qwerty.cpython-312.pyc,, +setuptools/_vendor/jaraco/text/layouts.py,sha256=HTC8aSTLZ7uXipyOXapRMC158juecjK6RVwitfmZ9_w,643 +setuptools/_vendor/jaraco/text/show-newlines.py,sha256=WGQa65e8lyhb92LUOLqVn6KaCtoeVgVws6WtSRmLk6w,904 +setuptools/_vendor/jaraco/text/strip-prefix.py,sha256=NfVXV8JVNo6nqcuYASfMV7_y4Eo8zMQqlCOGvAnRIVw,412 +setuptools/_vendor/jaraco/text/to-dvorak.py,sha256=1SNcbSsvISpXXg-LnybIHHY-RUFOQr36zcHkY1pWFqw,119 +setuptools/_vendor/jaraco/text/to-qwerty.py,sha256=s4UMQUnPwFn_dB5uZC27BurHOQcYondBfzIpVL5pEzw,119 +setuptools/_vendor/more_itertools-10.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/more_itertools-10.3.0.dist-info/LICENSE,sha256=CfHIyelBrz5YTVlkHqm4fYPAyw_QB-te85Gn4mQ8GkY,1053 +setuptools/_vendor/more_itertools-10.3.0.dist-info/METADATA,sha256=BFO90O-fLNiVQMpj7oIS5ztzgJUUQZ3TA32P5HH3N-A,36293 +setuptools/_vendor/more_itertools-10.3.0.dist-info/RECORD,sha256=d8jnPgGNwP1-ntbICwWkQEVF9kH7CFIgzkKzaLWao9M,1259 +setuptools/_vendor/more_itertools-10.3.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/more_itertools-10.3.0.dist-info/WHEEL,sha256=rSgq_JpHF9fHR1lx53qwg_1-2LypZE_qmcuXbVUq948,81 +setuptools/_vendor/more_itertools/__init__.py,sha256=dtAbGjTDmn_ghiU5YXfhyDy0phAlXVdt5klZA5fUa-Q,149 +setuptools/_vendor/more_itertools/__init__.pyi,sha256=5B3eTzON1BBuOLob1vCflyEb2lSd6usXQQ-Cv-hXkeA,43 +setuptools/_vendor/more_itertools/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/more_itertools/__pycache__/more.cpython-312.pyc,, +setuptools/_vendor/more_itertools/__pycache__/recipes.cpython-312.pyc,, +setuptools/_vendor/more_itertools/more.py,sha256=1E5kzFncRKTDw0cYv1yRXMgDdunstLQd1QStcnL6U90,148370 +setuptools/_vendor/more_itertools/more.pyi,sha256=iXXeqt48Nxe8VGmIWpkVXuKpR2FYNuu2DU8nQLWCCu0,21484 +setuptools/_vendor/more_itertools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/more_itertools/recipes.py,sha256=WedhhfhGVgr6zii8fIbGJVmRTw0ZKRiLKnYBDGJv4nY,28591 +setuptools/_vendor/more_itertools/recipes.pyi,sha256=T_mdGpcFdfrP3JSWbwzYP9JyNV-Go-7RPfpxfftAWlA,4617 +setuptools/_vendor/packaging-24.2.dist-info/INSTALLER,sha256=5hhM4Q4mYTT9z6QB6PGpUAW81PGNFrYrdXMj4oM_6ak,2 +setuptools/_vendor/packaging-24.2.dist-info/LICENSE,sha256=ytHvW9NA1z4HS6YU0m996spceUDD2MNIUuZcSQlobEg,197 +setuptools/_vendor/packaging-24.2.dist-info/LICENSE.APACHE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174 +setuptools/_vendor/packaging-24.2.dist-info/LICENSE.BSD,sha256=tw5-m3QvHMb5SLNMFqo5_-zpQZY2S8iP8NIYDwAo-sU,1344 +setuptools/_vendor/packaging-24.2.dist-info/METADATA,sha256=ohH86s6k5mIfQxY2TS0LcSfADeOFa4BiCC-bxZV-pNs,3204 +setuptools/_vendor/packaging-24.2.dist-info/RECORD,sha256=Y4DrXM0KY0ArfzhbAEa1LYFPwW3WEgEeL4iCqXe-A-M,2009 +setuptools/_vendor/packaging-24.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/packaging-24.2.dist-info/WHEEL,sha256=CpUCUxeHQbRN5UGRQHYRJorO5Af-Qy_fHMctcQ8DSGI,82 +setuptools/_vendor/packaging/__init__.py,sha256=dk4Ta_vmdVJxYHDcfyhvQNw8V3PgSBomKNXqg-D2JDY,494 +setuptools/_vendor/packaging/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/packaging/__pycache__/_elffile.cpython-312.pyc,, +setuptools/_vendor/packaging/__pycache__/_manylinux.cpython-312.pyc,, +setuptools/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc,, +setuptools/_vendor/packaging/__pycache__/_parser.cpython-312.pyc,, +setuptools/_vendor/packaging/__pycache__/_structures.cpython-312.pyc,, +setuptools/_vendor/packaging/__pycache__/_tokenizer.cpython-312.pyc,, +setuptools/_vendor/packaging/__pycache__/markers.cpython-312.pyc,, +setuptools/_vendor/packaging/__pycache__/metadata.cpython-312.pyc,, +setuptools/_vendor/packaging/__pycache__/requirements.cpython-312.pyc,, +setuptools/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc,, +setuptools/_vendor/packaging/__pycache__/tags.cpython-312.pyc,, +setuptools/_vendor/packaging/__pycache__/utils.cpython-312.pyc,, +setuptools/_vendor/packaging/__pycache__/version.cpython-312.pyc,, +setuptools/_vendor/packaging/_elffile.py,sha256=cflAQAkE25tzhYmq_aCi72QfbT_tn891tPzfpbeHOwE,3306 +setuptools/_vendor/packaging/_manylinux.py,sha256=vl5OCoz4kx80H5rwXKeXWjl9WNISGmr4ZgTpTP9lU9c,9612 +setuptools/_vendor/packaging/_musllinux.py,sha256=p9ZqNYiOItGee8KcZFeHF_YcdhVwGHdK6r-8lgixvGQ,2694 +setuptools/_vendor/packaging/_parser.py,sha256=s_TvTvDNK0NrM2QB3VKThdWFM4Nc0P6JnkObkl3MjpM,10236 +setuptools/_vendor/packaging/_structures.py,sha256=q3eVNmbWJGG_S0Dit_S3Ao8qQqz_5PYTXFAKBZe5yr4,1431 +setuptools/_vendor/packaging/_tokenizer.py,sha256=J6v5H7Jzvb-g81xp_2QACKwO7LxHQA6ikryMU7zXwN8,5273 +setuptools/_vendor/packaging/licenses/__init__.py,sha256=1x5M1nEYjcgwEbLt0dXwz2ukjr18DiCzC0sraQqJ-Ww,5715 +setuptools/_vendor/packaging/licenses/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/packaging/licenses/__pycache__/_spdx.cpython-312.pyc,, +setuptools/_vendor/packaging/licenses/_spdx.py,sha256=oAm1ztPFwlsmCKe7lAAsv_OIOfS1cWDu9bNBkeu-2ns,48398 +setuptools/_vendor/packaging/markers.py,sha256=c89TNzB7ZdGYhkovm6PYmqGyHxXlYVaLW591PHUNKD8,10561 +setuptools/_vendor/packaging/metadata.py,sha256=YJibM7GYe4re8-0a3OlXmGS-XDgTEoO4tlBt2q25Bng,34762 +setuptools/_vendor/packaging/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/packaging/requirements.py,sha256=gYyRSAdbrIyKDY66ugIDUQjRMvxkH2ALioTmX3tnL6o,2947 +setuptools/_vendor/packaging/specifiers.py,sha256=GG1wPNMcL0fMJO68vF53wKMdwnfehDcaI-r9NpTfilA,40074 +setuptools/_vendor/packaging/tags.py,sha256=CFqrJzAzc2XNGexerH__T-Y5Iwq7WbsYXsiLERLWxY0,21014 +setuptools/_vendor/packaging/utils.py,sha256=0F3Hh9OFuRgrhTgGZUl5K22Fv1YP2tZl1z_2gO6kJiA,5050 +setuptools/_vendor/packaging/version.py,sha256=olfyuk_DPbflNkJ4wBWetXQ17c74x3DB501degUv7DY,16676 +setuptools/_vendor/platformdirs-4.2.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/platformdirs-4.2.2.dist-info/METADATA,sha256=zmsie01G1MtXR0wgIv5XpVeTO7idr0WWvfmxKsKWuGk,11429 +setuptools/_vendor/platformdirs-4.2.2.dist-info/RECORD,sha256=TCEddtQu1A78Os_Mhm2JEqcYr7yit-UYSUQjZtbpn-g,1642 +setuptools/_vendor/platformdirs-4.2.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/platformdirs-4.2.2.dist-info/WHEEL,sha256=zEMcRr9Kr03x1ozGwg5v9NQBKn3kndp6LSoSlVg-jhU,87 +setuptools/_vendor/platformdirs-4.2.2.dist-info/licenses/LICENSE,sha256=KeD9YukphQ6G6yjD_czwzv30-pSHkBHP-z0NS-1tTbY,1089 +setuptools/_vendor/platformdirs/__init__.py,sha256=EMGE8qeHRR9CzDFr8kL3tA8hdZZniYjXBVZd0UGTWK0,22225 +setuptools/_vendor/platformdirs/__main__.py,sha256=HnsUQHpiBaiTxwcmwVw-nFaPdVNZtQIdi1eWDtI-MzI,1493 +setuptools/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/platformdirs/__pycache__/__main__.cpython-312.pyc,, +setuptools/_vendor/platformdirs/__pycache__/android.cpython-312.pyc,, +setuptools/_vendor/platformdirs/__pycache__/api.cpython-312.pyc,, +setuptools/_vendor/platformdirs/__pycache__/macos.cpython-312.pyc,, +setuptools/_vendor/platformdirs/__pycache__/unix.cpython-312.pyc,, +setuptools/_vendor/platformdirs/__pycache__/version.cpython-312.pyc,, +setuptools/_vendor/platformdirs/__pycache__/windows.cpython-312.pyc,, +setuptools/_vendor/platformdirs/android.py,sha256=xZXY9Jd46WOsxT2U6-5HsNtDZ-IQqxcEUrBLl3hYk4o,9016 +setuptools/_vendor/platformdirs/api.py,sha256=QBYdUac2eC521ek_y53uD1Dcq-lJX8IgSRVd4InC6uc,8996 +setuptools/_vendor/platformdirs/macos.py,sha256=wftsbsvq6nZ0WORXSiCrZNkRHz_WKuktl0a6mC7MFkI,5580 +setuptools/_vendor/platformdirs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/platformdirs/unix.py,sha256=Cci9Wqt35dAMsg6HT9nRGHSBW5obb0pR3AE1JJnsCXg,10643 +setuptools/_vendor/platformdirs/version.py,sha256=r7F76tZRjgQKzrpx_I0_ZMQOMU-PS7eGnHD7zEK3KB0,411 +setuptools/_vendor/platformdirs/windows.py,sha256=IFpiohUBwxPtCzlyKwNtxyW4Jk8haa6W8o59mfrDXVo,10125 +setuptools/_vendor/tomli-2.0.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/tomli-2.0.1.dist-info/LICENSE,sha256=uAgWsNUwuKzLTCIReDeQmEpuO2GSLCte6S8zcqsnQv4,1072 +setuptools/_vendor/tomli-2.0.1.dist-info/METADATA,sha256=zPDceKmPwJGLWtZykrHixL7WVXWmJGzZ1jyRT5lCoPI,8875 +setuptools/_vendor/tomli-2.0.1.dist-info/RECORD,sha256=DLn5pFGh42WsVLTIhmLh2gy1SnLRalJY-wq_-dPhwCI,999 +setuptools/_vendor/tomli-2.0.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/tomli-2.0.1.dist-info/WHEEL,sha256=jPMR_Dzkc4X4icQtmz81lnNY_kAsfog7ry7qoRvYLXw,81 +setuptools/_vendor/tomli/__init__.py,sha256=JhUwV66DB1g4Hvt1UQCVMdfCu-IgAV8FXmvDU9onxd4,396 +setuptools/_vendor/tomli/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/tomli/__pycache__/_parser.cpython-312.pyc,, +setuptools/_vendor/tomli/__pycache__/_re.cpython-312.pyc,, +setuptools/_vendor/tomli/__pycache__/_types.cpython-312.pyc,, +setuptools/_vendor/tomli/_parser.py,sha256=g9-ENaALS-B8dokYpCuzUFalWlog7T-SIYMjLZSWrtM,22633 +setuptools/_vendor/tomli/_re.py,sha256=dbjg5ChZT23Ka9z9DHOXfdtSpPwUfdgMXnj8NOoly-w,2943 +setuptools/_vendor/tomli/_types.py,sha256=-GTG2VUqkpxwMqzmVO4F7ybKddIbAnuAHXfmWQcTi3Q,254 +setuptools/_vendor/tomli/py.typed,sha256=8PjyZ1aVoQpRVvt71muvuq5qE-jTFZkK-GLHkhdebmc,26 +setuptools/_vendor/typeguard-4.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/typeguard-4.3.0.dist-info/LICENSE,sha256=YWP3mH37ONa8MgzitwsvArhivEESZRbVUu8c1DJH51g,1130 +setuptools/_vendor/typeguard-4.3.0.dist-info/METADATA,sha256=z2dcHAp0TwhYCFU5Deh8x31nazElgujUz9tbuP0pjSE,3717 +setuptools/_vendor/typeguard-4.3.0.dist-info/RECORD,sha256=SKUZWVgkeDUidUKM7s1473fXmsna55bjmi6vJUAoJVI,2402 +setuptools/_vendor/typeguard-4.3.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 +setuptools/_vendor/typeguard-4.3.0.dist-info/entry_points.txt,sha256=qp7NQ1aLtiSgMQqo6gWlfGpy0IIXzoMJmeQTLpzqFZQ,48 +setuptools/_vendor/typeguard-4.3.0.dist-info/top_level.txt,sha256=4z28AhuDodwRS_c1J_l8H51t5QuwfTseskYzlxp6grs,10 +setuptools/_vendor/typeguard/__init__.py,sha256=Onh4w38elPCjtlcU3JY9k3h70NjsxXIkAflmQn-Z0FY,2071 +setuptools/_vendor/typeguard/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/typeguard/__pycache__/_checkers.cpython-312.pyc,, +setuptools/_vendor/typeguard/__pycache__/_config.cpython-312.pyc,, +setuptools/_vendor/typeguard/__pycache__/_decorators.cpython-312.pyc,, +setuptools/_vendor/typeguard/__pycache__/_exceptions.cpython-312.pyc,, +setuptools/_vendor/typeguard/__pycache__/_functions.cpython-312.pyc,, +setuptools/_vendor/typeguard/__pycache__/_importhook.cpython-312.pyc,, +setuptools/_vendor/typeguard/__pycache__/_memo.cpython-312.pyc,, +setuptools/_vendor/typeguard/__pycache__/_pytest_plugin.cpython-312.pyc,, +setuptools/_vendor/typeguard/__pycache__/_suppression.cpython-312.pyc,, +setuptools/_vendor/typeguard/__pycache__/_transformer.cpython-312.pyc,, +setuptools/_vendor/typeguard/__pycache__/_union_transformer.cpython-312.pyc,, +setuptools/_vendor/typeguard/__pycache__/_utils.cpython-312.pyc,, +setuptools/_vendor/typeguard/_checkers.py,sha256=JRrgKicdOEfIBoNEtegYCEIlhpad-a1u1Em7GCj0WCI,31360 +setuptools/_vendor/typeguard/_config.py,sha256=nIz8QwDa-oFO3L9O8_6srzlmd99pSby2wOM4Wb7F_B0,2846 +setuptools/_vendor/typeguard/_decorators.py,sha256=v6dsIeWvPhExGLP_wXF-RmDUyjZf_Ak28g7gBJ_v0-0,9033 +setuptools/_vendor/typeguard/_exceptions.py,sha256=ZIPeiV-FBd5Emw2EaWd2Fvlsrwi4ocwT2fVGBIAtHcQ,1121 +setuptools/_vendor/typeguard/_functions.py,sha256=ibgSAKa5ptIm1eR9ARG0BSozAFJPFNASZqhPVyQeqig,10393 +setuptools/_vendor/typeguard/_importhook.py,sha256=ugjCDvFcdWMU7UugqlJG91IpVNpEIxtRr-99s0h1k7M,6389 +setuptools/_vendor/typeguard/_memo.py,sha256=1juQV_vxnD2JYKbSrebiQuj4oKHz6n67v9pYA-CCISg,1303 +setuptools/_vendor/typeguard/_pytest_plugin.py,sha256=-fcSqkv54rIfIF8pDavY5YQPkj4OX8GMt_lL7CQSD4I,4416 +setuptools/_vendor/typeguard/_suppression.py,sha256=VQfzxcwIbu3if0f7VBkKM7hkYOA7tNFw9a7jMBsmMg4,2266 +setuptools/_vendor/typeguard/_transformer.py,sha256=9Ha7_QhdwoUni_6hvdY-hZbuEergowHrNL2vzHIakFY,44937 +setuptools/_vendor/typeguard/_union_transformer.py,sha256=v_42r7-6HuRX2SoFwnyJ-E5PlxXpVeUJPJR1-HU9qSo,1354 +setuptools/_vendor/typeguard/_utils.py,sha256=5HhO1rPn5f1M6ymkVAEv7Xmlz1cX-j0OnTMlyHqqrR8,5270 +setuptools/_vendor/typeguard/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/typing_extensions-4.12.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/typing_extensions-4.12.2.dist-info/LICENSE,sha256=Oy-B_iHRgcSZxZolbI4ZaEVdZonSaaqFNzv7avQdo78,13936 +setuptools/_vendor/typing_extensions-4.12.2.dist-info/METADATA,sha256=BeUQIa8cnYbrjWx-N8TOznM9UGW5Gm2DicVpDtRA8W0,3018 +setuptools/_vendor/typing_extensions-4.12.2.dist-info/RECORD,sha256=dxAALYGXHmMqpqL8M9xddKr118quIgQKZdPjFQOwXuk,571 +setuptools/_vendor/typing_extensions-4.12.2.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81 +setuptools/_vendor/typing_extensions.py,sha256=gwekpyG9DVG3lxWKX4ni8u7nk3We5slG98mA9F3DJQw,134451 +setuptools/_vendor/wheel-0.45.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/wheel-0.45.1.dist-info/LICENSE.txt,sha256=MMI2GGeRCPPo6h0qZYx8pBe9_IkcmO8aifpP8MmChlQ,1107 +setuptools/_vendor/wheel-0.45.1.dist-info/METADATA,sha256=mKz84H7m7jsxJyzeIcTVORiTb0NPMV39KvOIYhGgmjA,2313 +setuptools/_vendor/wheel-0.45.1.dist-info/RECORD,sha256=1jnxrHyZPDcVvULyfGFhiba4Z5L9_RsXr9dxcNbhaYQ,4900 +setuptools/_vendor/wheel-0.45.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/wheel-0.45.1.dist-info/WHEEL,sha256=CpUCUxeHQbRN5UGRQHYRJorO5Af-Qy_fHMctcQ8DSGI,82 +setuptools/_vendor/wheel-0.45.1.dist-info/entry_points.txt,sha256=rTY1BbkPHhkGMm4Q3F0pIzJBzW2kMxoG1oriffvGdA0,104 +setuptools/_vendor/wheel/__init__.py,sha256=mrxMnvdXACur_LWegbUfh5g5ysWZrd63UJn890wvGNk,59 +setuptools/_vendor/wheel/__main__.py,sha256=NkMUnuTCGcOkgY0IBLgBCVC_BGGcWORx2K8jYGS12UE,455 +setuptools/_vendor/wheel/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/wheel/__pycache__/__main__.cpython-312.pyc,, +setuptools/_vendor/wheel/__pycache__/_bdist_wheel.cpython-312.pyc,, +setuptools/_vendor/wheel/__pycache__/_setuptools_logging.cpython-312.pyc,, +setuptools/_vendor/wheel/__pycache__/bdist_wheel.cpython-312.pyc,, +setuptools/_vendor/wheel/__pycache__/macosx_libfile.cpython-312.pyc,, +setuptools/_vendor/wheel/__pycache__/metadata.cpython-312.pyc,, +setuptools/_vendor/wheel/__pycache__/util.cpython-312.pyc,, +setuptools/_vendor/wheel/__pycache__/wheelfile.cpython-312.pyc,, +setuptools/_vendor/wheel/_bdist_wheel.py,sha256=UghCQjSH_pVfcZh6oRjzSw_TQhcf3anSx1OkiLSL82M,21694 +setuptools/_vendor/wheel/_setuptools_logging.py,sha256=-5KC-lne0ilOUWIDfOkqapUWGMFZhuKYDIavIZiB5kM,781 +setuptools/_vendor/wheel/bdist_wheel.py,sha256=tpf9WufiSO1RuEMg5oPhIfSG8DMziCZ_4muCKF69Cqo,1107 +setuptools/_vendor/wheel/cli/__init__.py,sha256=Npq6_jKi03dhIcRnmbuFhwviVJxwO0tYEnEhWMv9cJo,4402 +setuptools/_vendor/wheel/cli/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/wheel/cli/__pycache__/convert.cpython-312.pyc,, +setuptools/_vendor/wheel/cli/__pycache__/pack.cpython-312.pyc,, +setuptools/_vendor/wheel/cli/__pycache__/tags.cpython-312.pyc,, +setuptools/_vendor/wheel/cli/__pycache__/unpack.cpython-312.pyc,, +setuptools/_vendor/wheel/cli/convert.py,sha256=Bi0ntEXb9nTllCxWeTRQ4j-nPs3szWSEKipG_GgnMkQ,12634 +setuptools/_vendor/wheel/cli/pack.py,sha256=CAFcHdBVulvsHYJlndKVO7KMI9JqBTZz5ii0PKxxCOs,3103 +setuptools/_vendor/wheel/cli/tags.py,sha256=lHw-LaWrkS5Jy_qWcw-6pSjeNM6yAjDnqKI3E5JTTCU,4760 +setuptools/_vendor/wheel/cli/unpack.py,sha256=Y_J7ynxPSoFFTT7H0fMgbBlVErwyDGcObgme5MBuz58,1021 +setuptools/_vendor/wheel/macosx_libfile.py,sha256=k1x7CE3LPtOVGqj6NXQ1nTGYVPaeRrhVzUG_KPq3zDs,16572 +setuptools/_vendor/wheel/metadata.py,sha256=JC4p7jlQZu2bUTAQ2fevkqLjg_X6gnNyRhLn6OUO1tc,6171 +setuptools/_vendor/wheel/util.py,sha256=aL7aibHwYUgfc8WlolL5tXdkV4DatbJxZHb1kwHFJAU,423 +setuptools/_vendor/wheel/vendored/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/wheel/vendored/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/wheel/vendored/packaging/LICENSE,sha256=ytHvW9NA1z4HS6YU0m996spceUDD2MNIUuZcSQlobEg,197 +setuptools/_vendor/wheel/vendored/packaging/LICENSE.APACHE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174 +setuptools/_vendor/wheel/vendored/packaging/LICENSE.BSD,sha256=tw5-m3QvHMb5SLNMFqo5_-zpQZY2S8iP8NIYDwAo-sU,1344 +setuptools/_vendor/wheel/vendored/packaging/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/wheel/vendored/packaging/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/wheel/vendored/packaging/__pycache__/_elffile.cpython-312.pyc,, +setuptools/_vendor/wheel/vendored/packaging/__pycache__/_manylinux.cpython-312.pyc,, +setuptools/_vendor/wheel/vendored/packaging/__pycache__/_musllinux.cpython-312.pyc,, +setuptools/_vendor/wheel/vendored/packaging/__pycache__/_parser.cpython-312.pyc,, +setuptools/_vendor/wheel/vendored/packaging/__pycache__/_structures.cpython-312.pyc,, +setuptools/_vendor/wheel/vendored/packaging/__pycache__/_tokenizer.cpython-312.pyc,, +setuptools/_vendor/wheel/vendored/packaging/__pycache__/markers.cpython-312.pyc,, +setuptools/_vendor/wheel/vendored/packaging/__pycache__/requirements.cpython-312.pyc,, +setuptools/_vendor/wheel/vendored/packaging/__pycache__/specifiers.cpython-312.pyc,, +setuptools/_vendor/wheel/vendored/packaging/__pycache__/tags.cpython-312.pyc,, +setuptools/_vendor/wheel/vendored/packaging/__pycache__/utils.cpython-312.pyc,, +setuptools/_vendor/wheel/vendored/packaging/__pycache__/version.cpython-312.pyc,, +setuptools/_vendor/wheel/vendored/packaging/_elffile.py,sha256=hbmK8OD6Z7fY6hwinHEUcD1by7czkGiNYu7ShnFEk2k,3266 +setuptools/_vendor/wheel/vendored/packaging/_manylinux.py,sha256=P7sdR5_7XBY09LVYYPhHmydMJIIwPXWsh4olk74Uuj4,9588 +setuptools/_vendor/wheel/vendored/packaging/_musllinux.py,sha256=z1s8To2hQ0vpn_d-O2i5qxGwEK8WmGlLt3d_26V7NeY,2674 +setuptools/_vendor/wheel/vendored/packaging/_parser.py,sha256=4tT4emSl2qTaU7VTQE1Xa9o1jMPCsBezsYBxyNMUN-s,10347 +setuptools/_vendor/wheel/vendored/packaging/_structures.py,sha256=q3eVNmbWJGG_S0Dit_S3Ao8qQqz_5PYTXFAKBZe5yr4,1431 +setuptools/_vendor/wheel/vendored/packaging/_tokenizer.py,sha256=alCtbwXhOFAmFGZ6BQ-wCTSFoRAJ2z-ysIf7__MTJ_k,5292 +setuptools/_vendor/wheel/vendored/packaging/markers.py,sha256=_TSPI1BhJYO7Bp9AzTmHQxIqHEVXaTjmDh9G-w8qzPA,8232 +setuptools/_vendor/wheel/vendored/packaging/requirements.py,sha256=dgoBeVprPu2YE6Q8nGfwOPTjATHbRa_ZGLyXhFEln6Q,2933 +setuptools/_vendor/wheel/vendored/packaging/specifiers.py,sha256=IWSt0SrLSP72heWhAC8UL0eGvas7XIQHjqiViVfmPKE,39778 +setuptools/_vendor/wheel/vendored/packaging/tags.py,sha256=fedHXiOHkBxNZTXotXv8uXPmMFU9ae-TKBujgYHigcA,18950 +setuptools/_vendor/wheel/vendored/packaging/utils.py,sha256=XgdmP3yx9-wQEFjO7OvMj9RjEf5JlR5HFFR69v7SQ9E,5268 +setuptools/_vendor/wheel/vendored/packaging/version.py,sha256=PFJaYZDxBgyxkfYhH3SQw4qfE9ICCWrTmitvq14y3bs,16234 +setuptools/_vendor/wheel/vendored/vendor.txt,sha256=Z2ENjB1i5prfez8CdM1Sdr3c6Zxv2rRRolMpLmBncAE,16 +setuptools/_vendor/wheel/wheelfile.py,sha256=USCttNlJwafxt51YYFFKG7jnxz8dfhbyqAZL6jMTA9s,8411 +setuptools/_vendor/zipp-3.19.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +setuptools/_vendor/zipp-3.19.2.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 +setuptools/_vendor/zipp-3.19.2.dist-info/METADATA,sha256=UIrk_kMIHGSwsKKChYizqMw0MMZpPRZ2ZiVpQAsN_bE,3575 +setuptools/_vendor/zipp-3.19.2.dist-info/RECORD,sha256=8xby4D_ZrefrvAsVRwaEjiu4_VaLkJNRCfDY484rm_4,1039 +setuptools/_vendor/zipp-3.19.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/zipp-3.19.2.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 +setuptools/_vendor/zipp-3.19.2.dist-info/top_level.txt,sha256=iAbdoSHfaGqBfVb2XuR9JqSQHCoOsOtG6y9C_LSpqFw,5 +setuptools/_vendor/zipp/__init__.py,sha256=QuI1g00G4fRAcGt-HqbV0oWIkmSgedCGGYsHHYzNa8A,13412 +setuptools/_vendor/zipp/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/zipp/__pycache__/glob.cpython-312.pyc,, +setuptools/_vendor/zipp/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/_vendor/zipp/compat/__pycache__/__init__.cpython-312.pyc,, +setuptools/_vendor/zipp/compat/__pycache__/py310.cpython-312.pyc,, +setuptools/_vendor/zipp/compat/py310.py,sha256=eZpkW0zRtunkhEh8jjX3gCGe22emoKCBJw72Zt4RkhA,219 +setuptools/_vendor/zipp/glob.py,sha256=etWpnfEoRyfUvrUsi6sTiGmErvPwe6HzY6pT8jg_lUI,3082 +setuptools/archive_util.py,sha256=Tl_64hSTtc4y8x7xa98rFVUbG24oArpjzLAYGYP2_sI,7356 +setuptools/build_meta.py,sha256=3cHAWucJaLA9DU5OfCbKkkteTDiQ5bB4LokfTRMgJT4,19968 +setuptools/cli-32.exe,sha256=MqzBvFQxFsviz_EMuGd3LfLyVP8mNMhwrvC0bEtpb9s,11776 +setuptools/cli-64.exe,sha256=u7PeVwdinmpgoMI4zUd7KPB_AGaYL9qVP6b87DkHOko,14336 +setuptools/cli-arm64.exe,sha256=uafQjaiA36yLz1SOuksG-1m28JsX0zFIoPZhgyiSbGE,13824 +setuptools/cli.exe,sha256=MqzBvFQxFsviz_EMuGd3LfLyVP8mNMhwrvC0bEtpb9s,11776 +setuptools/command/__init__.py,sha256=wdSrlNR0P6nCz9_oFtCAiAkeFJMsZa1jPcpXT53f0SM,803 +setuptools/command/__pycache__/__init__.cpython-312.pyc,, +setuptools/command/__pycache__/_requirestxt.cpython-312.pyc,, +setuptools/command/__pycache__/alias.cpython-312.pyc,, +setuptools/command/__pycache__/bdist_egg.cpython-312.pyc,, +setuptools/command/__pycache__/bdist_rpm.cpython-312.pyc,, +setuptools/command/__pycache__/bdist_wheel.cpython-312.pyc,, +setuptools/command/__pycache__/build.cpython-312.pyc,, +setuptools/command/__pycache__/build_clib.cpython-312.pyc,, +setuptools/command/__pycache__/build_ext.cpython-312.pyc,, +setuptools/command/__pycache__/build_py.cpython-312.pyc,, +setuptools/command/__pycache__/develop.cpython-312.pyc,, +setuptools/command/__pycache__/dist_info.cpython-312.pyc,, +setuptools/command/__pycache__/easy_install.cpython-312.pyc,, +setuptools/command/__pycache__/editable_wheel.cpython-312.pyc,, +setuptools/command/__pycache__/egg_info.cpython-312.pyc,, +setuptools/command/__pycache__/install.cpython-312.pyc,, +setuptools/command/__pycache__/install_egg_info.cpython-312.pyc,, +setuptools/command/__pycache__/install_lib.cpython-312.pyc,, +setuptools/command/__pycache__/install_scripts.cpython-312.pyc,, +setuptools/command/__pycache__/rotate.cpython-312.pyc,, +setuptools/command/__pycache__/saveopts.cpython-312.pyc,, +setuptools/command/__pycache__/sdist.cpython-312.pyc,, +setuptools/command/__pycache__/setopt.cpython-312.pyc,, +setuptools/command/__pycache__/test.cpython-312.pyc,, +setuptools/command/_requirestxt.py,sha256=ItYMTJGh_i5TlQstX_nFopqEhkC4PJFadBL2Zd3V670,4228 +setuptools/command/alias.py,sha256=rDdrMt32DS6qf3K7tjZZyHD_dMKrm77AXcAtx-nBQ0I,2380 +setuptools/command/bdist_egg.py,sha256=JmtKoIbiwgEHcJBkbc7zyXCZcAF851t6ek18gme-60Q,16948 +setuptools/command/bdist_rpm.py,sha256=LyqI49w48SKk0FmuHsE9MLzX1SuXjL7YMNbZMFZqFII,1435 +setuptools/command/bdist_wheel.py,sha256=SknYPVwhrRPfXudmO_gvqNHHHhzSfU8cEmFtQomQ9xI,22247 +setuptools/command/build.py,sha256=eI7STMERGGZEpzk1tvJN8p9IOjAAXMcGLzljv2mwI3M,6052 +setuptools/command/build_clib.py,sha256=AbgpPIF_3qL8fZr3JIebI-WHTMTBiMfrFkVQz8K40G4,4528 +setuptools/command/build_ext.py,sha256=Wddi6ho4MnVh84qqZUNqTvjKLqeoWe6cbwdJOUitXCc,18465 +setuptools/command/build_py.py,sha256=DCbjvB18kkL-xUK5rvlzm0C6twTeOxNhyvJDxxa7fII,15539 +setuptools/command/develop.py,sha256=1dsb2lkjcPQQAlQNVVlfPIJUBZ9di0l5bs4l83g9-9Y,1610 +setuptools/command/dist_info.py,sha256=HU752iLLmmYMHbsDBgz2ubRjkgJobugOp8H71LzzDys,3450 +setuptools/command/easy_install.py,sha256=XrN5cV51mfzbCDoapZ6iT8nCzaLpumdwJYRKeMHEjCQ,780 +setuptools/command/editable_wheel.py,sha256=MXyQx41gwu3d1raYSZGgzCVp5kkVtlCKftZKvTma3wY,34836 +setuptools/command/egg_info.py,sha256=GXyvq5E8huO4g-FDoNzf3MHjeXfxzPoS0Hkvbta_zc8,25878 +setuptools/command/install.py,sha256=4x2hiNgBGQrFEXKuPBQMrb8ecSwIfYF4TYHZQLjPVAg,5066 +setuptools/command/install_egg_info.py,sha256=3I9IPCH7D59Sh-6aVYz-h6wwyxq-wkxrKwKg3nDdJqs,2075 +setuptools/command/install_lib.py,sha256=9n1_U83eHcERL_a_rv_LhHCkhXlLdqyZ4SdBow-9qcE,4319 +setuptools/command/install_scripts.py,sha256=JmDGngHzCO2Y1j4maFNdHB_ILhGPhk-b5KhxsZwUwiQ,2490 +setuptools/command/launcher manifest.xml,sha256=xlLbjWrB01tKC0-hlVkOKkiSPbzMml2eOPtJ_ucCnbE,628 +setuptools/command/rotate.py,sha256=XNd_BEEOWAJHW1FcLTMUWWl4QB6zAuk7b8VWQg3FHos,2187 +setuptools/command/saveopts.py,sha256=Np0PVb7SD7oTbu9Z9sosS7D-CkkIkU7x4glu5Es1tjA,692 +setuptools/command/sdist.py,sha256=5ZiA8yfdNfl-kLTnfPAht1yKnS1o_HrSFphsJd-9foU,7369 +setuptools/command/setopt.py,sha256=xZF2RCc4ABvE9eHHAzF50-fkQg3au8fcRUVVGd58k3U,5100 +setuptools/command/test.py,sha256=k7xcq7D7bEehgxarbw-dW3AtmGZORqz8HjKR6FGJ3jk,1343 +setuptools/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/compat/__pycache__/__init__.cpython-312.pyc,, +setuptools/compat/__pycache__/py310.cpython-312.pyc,, +setuptools/compat/__pycache__/py311.cpython-312.pyc,, +setuptools/compat/__pycache__/py312.cpython-312.pyc,, +setuptools/compat/__pycache__/py39.cpython-312.pyc,, +setuptools/compat/py310.py,sha256=JwjQZ3cNTizfpDLNl9GLsUGzBr-tVlMPxmMYVDTlhiI,344 +setuptools/compat/py311.py,sha256=e6tJAFwZEP82hmMBl10HYeSypelo_Ti2wTjKZVKLwOE,790 +setuptools/compat/py312.py,sha256=vYKVtdrdOTsO_R90dJkEXsFwfMJFuIFJflhIgHrjJ-Y,366 +setuptools/compat/py39.py,sha256=BJMtnkfcqyTfccqjYQxfoRtU2nTnWaEESBVkshTiXqY,493 +setuptools/config/NOTICE,sha256=Ld3wiBgpejuJ1D2V_2WdjahXQRCMkTbfo6TYVsBiO9g,493 +setuptools/config/__init__.py,sha256=aiPnL9BJn1O6MfmuNXyn8W2Lp8u9qizRVqwPiOdPIjY,1499 +setuptools/config/__pycache__/__init__.cpython-312.pyc,, +setuptools/config/__pycache__/_apply_pyprojecttoml.cpython-312.pyc,, +setuptools/config/__pycache__/expand.cpython-312.pyc,, +setuptools/config/__pycache__/pyprojecttoml.cpython-312.pyc,, +setuptools/config/__pycache__/setupcfg.cpython-312.pyc,, +setuptools/config/_apply_pyprojecttoml.py,sha256=SUyTw7A2btZ1lBuWKN5o42-Diyv95eGTiYJ3rZOnGSc,19120 +setuptools/config/_validate_pyproject/NOTICE,sha256=XTANv6ZDE4sBO3WsnK7uWR-VG4sO4kKIw0zNkmxHgMg,18737 +setuptools/config/_validate_pyproject/__init__.py,sha256=dnp6T7ePP1R5z4OuC7Fd2dkFlIrtIfizUfvpGJP6nz0,1042 +setuptools/config/_validate_pyproject/__pycache__/__init__.cpython-312.pyc,, +setuptools/config/_validate_pyproject/__pycache__/error_reporting.cpython-312.pyc,, +setuptools/config/_validate_pyproject/__pycache__/extra_validations.cpython-312.pyc,, +setuptools/config/_validate_pyproject/__pycache__/fastjsonschema_exceptions.cpython-312.pyc,, +setuptools/config/_validate_pyproject/__pycache__/fastjsonschema_validations.cpython-312.pyc,, +setuptools/config/_validate_pyproject/__pycache__/formats.cpython-312.pyc,, +setuptools/config/_validate_pyproject/error_reporting.py,sha256=meldD7nBQdolQhvG-43r1Ue-gU1n7ORAJR86vh3Rrvk,11813 +setuptools/config/_validate_pyproject/extra_validations.py,sha256=-GUG5S--ijY8WfXbdXPoHl6ywGsyEF9dtDpenSoJPHg,2858 +setuptools/config/_validate_pyproject/fastjsonschema_exceptions.py,sha256=w749JgqKi8clBFcObdcbZVqsmF4oJ_QByhZ1SGbUFNw,1612 +setuptools/config/_validate_pyproject/fastjsonschema_validations.py,sha256=FihD5ZcM6p77BPZ04CGqh3BEwVNoPMKJZJAyuJpkAU0,354682 +setuptools/config/_validate_pyproject/formats.py,sha256=TETokJBK9hjl-cVg1olsojkJwLxfP7_chgJQNmzAB98,13564 +setuptools/config/distutils.schema.json,sha256=Tcp32kRnhwORGw_9p6GEi08lj2h15tQRzOYBbzGmcBU,972 +setuptools/config/expand.py,sha256=JNAktRCsyyRB-rQodbPnCucmLWqcYvzCDC8Ebn2Z7xM,16041 +setuptools/config/pyprojecttoml.py,sha256=YMu5PdbJJI5azp6kR_boM1mflf5nqOA-InF4s6LnLgw,18320 +setuptools/config/setupcfg.py,sha256=VZDkwE7DYv45SbadJD8CwKrDtiXvjgllL8PYSvoRCyg,26575 +setuptools/config/setuptools.schema.json,sha256=dZBRuSEnZkatoVlt1kVwG8ocTeRdO7BD0xvOWKH54PY,16071 +setuptools/depends.py,sha256=jKYfjmt_2ZQYVghb8L9bU7LJ6erHJ5ze-K_fKV1BMXk,5965 +setuptools/discovery.py,sha256=-42c3XhwzkfodDKKP50C2YBzr11fncAgmUzBdBRb0-Q,21258 +setuptools/dist.py,sha256=jrLGf-4udZjoZyULuGrXEPzgFDVq1CHCfGsqjTq52Gg,44887 +setuptools/errors.py,sha256=gY2x2PIaIgy01yRANRC-zcCwxDCqCScgJoCOZFe0yio,3024 +setuptools/extension.py,sha256=KCnv9p3tgm0ZVqtgE451fyILsm4hCyvOiUtOu787D-4,6683 +setuptools/glob.py,sha256=AC_B33DY8g-CHELxDsJrtwFrpiucSAZsakPFdSOQzhc,6062 +setuptools/gui-32.exe,sha256=hdrh6V13hF8stZvKw9Sv50u-TJGpvMW_SnHNQxBNvnw,11776 +setuptools/gui-64.exe,sha256=NHG2FA6txkEid9u-_j_vjDRaDxpZd2CGuAo2GMOoPjs,14336 +setuptools/gui-arm64.exe,sha256=5pT0dDQFyLWSb_RX22_n8aEt7HwWqcOGR4TT9OB64Jc,13824 +setuptools/gui.exe,sha256=hdrh6V13hF8stZvKw9Sv50u-TJGpvMW_SnHNQxBNvnw,11776 +setuptools/installer.py,sha256=veio-PDCseWN0J1E_1gjvVLkcIhPpQLlEKpSaA03WWk,5093 +setuptools/launch.py,sha256=IBb5lEv69CyuZ9ewIrmKlXh154kdLmP29LKfTMkximE,820 +setuptools/logging.py,sha256=W16iHJ1HcCXYQ0RxyrEfJ83FT4175tCtoYg-E6uSpVI,1261 +setuptools/modified.py,sha256=ZwbfBfCFP88ltvbv_dJDz-t1LsQjnM-JUpgZnnQZjjM,568 +setuptools/monkey.py,sha256=FwMWl2n1v2bHbeqBy-o9g8yUNaAkYFbszCbXe9d5Za8,3717 +setuptools/msvc.py,sha256=vmM0qL4rIzrtD9pia9ZEwtqZ4LbbrgL0dU0EANVYRm8,41631 +setuptools/namespaces.py,sha256=2GGqYY1BNDEhMtBc1rHTv7klgmNVRdksJeW-L1f--ys,3171 +setuptools/script (dev).tmpl,sha256=RUzQzCQUaXtwdLtYHWYbIQmOaES5Brqq1FvUA_tu-5I,218 +setuptools/script.tmpl,sha256=WGTt5piezO27c-Dbx6l5Q4T3Ff20A5z7872hv3aAhYY,138 +setuptools/tests/__init__.py,sha256=AnBfls2iJbTDQzmMKeLRt-9lxhaOHUVOZEgXv89Uwvs,335 +setuptools/tests/__pycache__/__init__.cpython-312.pyc,, +setuptools/tests/__pycache__/contexts.cpython-312.pyc,, +setuptools/tests/__pycache__/environment.cpython-312.pyc,, +setuptools/tests/__pycache__/fixtures.cpython-312.pyc,, +setuptools/tests/__pycache__/mod_with_constant.cpython-312.pyc,, +setuptools/tests/__pycache__/namespaces.cpython-312.pyc,, +setuptools/tests/__pycache__/script-with-bom.cpython-312.pyc,, +setuptools/tests/__pycache__/test_archive_util.cpython-312.pyc,, +setuptools/tests/__pycache__/test_bdist_deprecations.cpython-312.pyc,, +setuptools/tests/__pycache__/test_bdist_egg.cpython-312.pyc,, +setuptools/tests/__pycache__/test_bdist_wheel.cpython-312.pyc,, +setuptools/tests/__pycache__/test_build.cpython-312.pyc,, +setuptools/tests/__pycache__/test_build_clib.cpython-312.pyc,, +setuptools/tests/__pycache__/test_build_ext.cpython-312.pyc,, +setuptools/tests/__pycache__/test_build_meta.cpython-312.pyc,, +setuptools/tests/__pycache__/test_build_py.cpython-312.pyc,, +setuptools/tests/__pycache__/test_config_discovery.cpython-312.pyc,, +setuptools/tests/__pycache__/test_core_metadata.cpython-312.pyc,, +setuptools/tests/__pycache__/test_depends.cpython-312.pyc,, +setuptools/tests/__pycache__/test_develop.cpython-312.pyc,, +setuptools/tests/__pycache__/test_dist.cpython-312.pyc,, +setuptools/tests/__pycache__/test_dist_info.cpython-312.pyc,, +setuptools/tests/__pycache__/test_distutils_adoption.cpython-312.pyc,, +setuptools/tests/__pycache__/test_editable_install.cpython-312.pyc,, +setuptools/tests/__pycache__/test_egg_info.cpython-312.pyc,, +setuptools/tests/__pycache__/test_extern.cpython-312.pyc,, +setuptools/tests/__pycache__/test_find_packages.cpython-312.pyc,, +setuptools/tests/__pycache__/test_find_py_modules.cpython-312.pyc,, +setuptools/tests/__pycache__/test_glob.cpython-312.pyc,, +setuptools/tests/__pycache__/test_install_scripts.cpython-312.pyc,, +setuptools/tests/__pycache__/test_logging.cpython-312.pyc,, +setuptools/tests/__pycache__/test_manifest.cpython-312.pyc,, +setuptools/tests/__pycache__/test_namespaces.cpython-312.pyc,, +setuptools/tests/__pycache__/test_scripts.cpython-312.pyc,, +setuptools/tests/__pycache__/test_sdist.cpython-312.pyc,, +setuptools/tests/__pycache__/test_setopt.cpython-312.pyc,, +setuptools/tests/__pycache__/test_setuptools.cpython-312.pyc,, +setuptools/tests/__pycache__/test_shutil_wrapper.cpython-312.pyc,, +setuptools/tests/__pycache__/test_unicode_utils.cpython-312.pyc,, +setuptools/tests/__pycache__/test_virtualenv.cpython-312.pyc,, +setuptools/tests/__pycache__/test_warnings.cpython-312.pyc,, +setuptools/tests/__pycache__/test_wheel.cpython-312.pyc,, +setuptools/tests/__pycache__/test_windows_wrappers.cpython-312.pyc,, +setuptools/tests/__pycache__/text.cpython-312.pyc,, +setuptools/tests/__pycache__/textwrap.cpython-312.pyc,, +setuptools/tests/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/tests/compat/__pycache__/__init__.cpython-312.pyc,, +setuptools/tests/compat/__pycache__/py39.cpython-312.pyc,, +setuptools/tests/compat/py39.py,sha256=eUy7_F-6KRTOIKl-veshUu6I0EdTSdBZMh0EV0lZ1-g,135 +setuptools/tests/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/tests/config/__pycache__/__init__.cpython-312.pyc,, +setuptools/tests/config/__pycache__/test_apply_pyprojecttoml.cpython-312.pyc,, +setuptools/tests/config/__pycache__/test_expand.cpython-312.pyc,, +setuptools/tests/config/__pycache__/test_pyprojecttoml.cpython-312.pyc,, +setuptools/tests/config/__pycache__/test_pyprojecttoml_dynamic_deps.cpython-312.pyc,, +setuptools/tests/config/__pycache__/test_setupcfg.cpython-312.pyc,, +setuptools/tests/config/downloads/__init__.py,sha256=9ixnDEdyL_arKbUzfuiJftAj9bGxKz8M9alOFZMjx9Y,1827 +setuptools/tests/config/downloads/__pycache__/__init__.cpython-312.pyc,, +setuptools/tests/config/downloads/__pycache__/preload.cpython-312.pyc,, +setuptools/tests/config/downloads/preload.py,sha256=sIGGZpY3cmMpMwiJYYYYHG2ifZJkvJgEotRFtiulV1I,450 +setuptools/tests/config/setupcfg_examples.txt,sha256=cAbVvCbkFZuTUL6xRRzRgqyB0rLvJTfvw3D30glo2OE,1912 +setuptools/tests/config/test_apply_pyprojecttoml.py,sha256=l6nE4d8WLU_eSWRic7VSoqeKv9Bi7CZGHcEuB2ehk2w,28807 +setuptools/tests/config/test_expand.py,sha256=S0oT6JvgA_oujR4YS4RUuf5gmOt1CTQV66RQDzV8xd4,8933 +setuptools/tests/config/test_pyprojecttoml.py,sha256=0LefSljUhA6MqtJ5AVzLhomqZcYiFKdu_1ckDeMT1LY,12406 +setuptools/tests/config/test_pyprojecttoml_dynamic_deps.py,sha256=9W73-yLhZJmvCiO4rTiQoBpZT5wNA90Xbd5n2HCshd4,3271 +setuptools/tests/config/test_setupcfg.py,sha256=ZvN-O-2Dgon1adp6oM6il8JWdgT9y196fRvqESU5ELI,33427 +setuptools/tests/contexts.py,sha256=Ozdfc2KydF9x9wODUsdun800myLuP27uxoeT06Gbk7M,3166 +setuptools/tests/environment.py,sha256=95_UtTaRiuvwYC9eXKEHbn02kDtZysvZq3UZJmPUj1I,3102 +setuptools/tests/fixtures.py,sha256=aPewdPHlKHRAsMo9H828c3ZC8l3OJqgyfRYwpLBvgCk,11705 +setuptools/tests/indexes/test_links_priority/external.html,sha256=eL9euOuE93JKZdqlXxBOlHbKwIuNuIdq7GBRpsaPMcU,92 +setuptools/tests/indexes/test_links_priority/simple/foobar/index.html,sha256=DD-TKr7UU4zAjHHz4VexYDNSAzR27levSh1c-k3ZdLE,174 +setuptools/tests/integration/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +setuptools/tests/integration/__pycache__/__init__.cpython-312.pyc,, +setuptools/tests/integration/__pycache__/helpers.cpython-312.pyc,, +setuptools/tests/integration/__pycache__/test_pbr.cpython-312.pyc,, +setuptools/tests/integration/__pycache__/test_pip_install_sdist.cpython-312.pyc,, +setuptools/tests/integration/helpers.py,sha256=3PHcS9SCA-fwVJmUP2ad5NQOttJAETI5Nnoc_xroO5k,2522 +setuptools/tests/integration/test_pbr.py,sha256=2eKuklFNmpnBgA_eEhYPBr6rLLG2Xm4MY6PlcmzZgGU,432 +setuptools/tests/integration/test_pip_install_sdist.py,sha256=SFbvuYF_hDzt6OtsQ5GjFNnxmoJ_eElfvpYsiyyGJ-g,8256 +setuptools/tests/mod_with_constant.py,sha256=X_Kj80M55w1tmQ4f7uZY91ZTALo4hKVT6EHxgYocUMQ,22 +setuptools/tests/namespaces.py,sha256=HPcI3nR5MCFWXpaADIJ1fwKxymcQgBkuw87Ic5PUSAQ,2774 +setuptools/tests/script-with-bom.py,sha256=hRRgIizEULGiG_ZTNoMY46HhKhxpWfy5FGcD6Qbh5fc,18 +setuptools/tests/test_archive_util.py,sha256=buuKdY8XkW26Pe3IKAoBRGHG0MDumnuNoPg2WsAQzIg,845 +setuptools/tests/test_bdist_deprecations.py,sha256=75Xq3gYn79LIIyusEltbHan0bEgAt2e_CaL7KLS8-KQ,775 +setuptools/tests/test_bdist_egg.py,sha256=6PaYN1F3JDbIh1uK0urv7yJFcx98z5dn9SOJ8Mv91l8,1957 +setuptools/tests/test_bdist_wheel.py,sha256=dZ9a7OT_UyRvLnoCi2KGEIbtzhEQjM3YutYMA6ZCezs,23083 +setuptools/tests/test_build.py,sha256=wJgMz2hwHADcLFg-nXrwRVhus7hjmAeEGgrpIQwCGnA,798 +setuptools/tests/test_build_clib.py,sha256=bX51XRAf4uO7IuHFpjePnoK8mE74N2gsoeEqF-ofgws,3123 +setuptools/tests/test_build_ext.py,sha256=e4ZSxsYPB5zq1KSqGEuATZ0t0PJQzMhjjkKJ-hIjcgc,10099 +setuptools/tests/test_build_meta.py,sha256=kvi0Bn4p9DBVme3zyWQsn3QgB9oPdq8S15agj1m69L0,33289 +setuptools/tests/test_build_py.py,sha256=gobME_Cvzf6Ugxq70iWfXekb_xyyT61khwjFq8zkwfw,14186 +setuptools/tests/test_config_discovery.py,sha256=FqV-lOtkqaI-ayzU2zocSdD5TaRAgCZnixNDilKA6FQ,22580 +setuptools/tests/test_core_metadata.py,sha256=vbVJ5_Lsx_hsO_GdB6nQEXJRjA2ydx6_qSbr5LpheAA,20881 +setuptools/tests/test_depends.py,sha256=yQBXoQbNQlJit6mbRVoz6Bb553f3sNrq02lZimNz5XY,424 +setuptools/tests/test_develop.py,sha256=MHYL_YDqNMU5jhKkjsBUGKMGCkrva8CFR8dRc6kkYKE,3072 +setuptools/tests/test_dist.py,sha256=_IYleHR9YVqzV-nLq_JqSup6DNeUdPzuQ0EXhp009Uk,8893 +setuptools/tests/test_dist_info.py,sha256=F_xTXc5TGhjiujtGukFt6wNstqpTW7sVQtUnL1IX7yo,4988 +setuptools/tests/test_distutils_adoption.py,sha256=_eynrOfyEqXFEmjUJhzpe8GXPyTUPvNSObs4qAAmBy8,5987 +setuptools/tests/test_editable_install.py,sha256=Tg4kunvwYoDLYsfvSkggneUgpKQferUDx3EEvvdfmwE,42619 +setuptools/tests/test_egg_info.py,sha256=R7nT27YhVz9oSuDyimAGerWglkbRWiMSPBs5FzcSnBM,44941 +setuptools/tests/test_extern.py,sha256=rpKU6oCcksumLwf5TeKlDluFQ0TUfbPwTLQbpxcFrCU,296 +setuptools/tests/test_find_packages.py,sha256=CTLAcTzWGWBLCcd2aAsUVkvO3ibrlqexFBdDKOWPoq8,7819 +setuptools/tests/test_find_py_modules.py,sha256=zQjuhIG5TQN2SJPix9ARo4DL_w84Ln8QsHDUjjbrtAQ,2404 +setuptools/tests/test_glob.py,sha256=P3JvpH-kXQ4BZ3zvRF-zKxOgwyWzwIaQIz0WHdxS0kk,887 +setuptools/tests/test_install_scripts.py,sha256=scIrJ6a_ssKqg4vIBNaUjmAKHEYLUUZ9WKnPeKnE6gc,3433 +setuptools/tests/test_logging.py,sha256=zlE5DlldukC7Jc54FNvDV_7ux3ErAkrfrN5CSsnNOUQ,2099 +setuptools/tests/test_manifest.py,sha256=eMg65pIA52DizB6mpktSU-b8CjwaNCS5MSgL_V1LrFI,18562 +setuptools/tests/test_namespaces.py,sha256=Y6utoe5PHHqL_DlgawqB9F8XpsUDPvvw1sQMenK04e0,4515 +setuptools/tests/test_scripts.py,sha256=_ra506yQF7n72ROUDcz2r3CTsGsawO1m-1oqA9EQCfw,379 +setuptools/tests/test_sdist.py,sha256=RYLvPa_nfyC1ZmoinzqMzJynTDG4RtPYC19_0LU6pvs,32872 +setuptools/tests/test_setopt.py,sha256=3VxxM4ATfP-P4AGnDjoWCnHr5-i9CSEQTFYU1-FTnvI,1365 +setuptools/tests/test_setuptools.py,sha256=_eIhqKf45-OtHqxRf20KndOZJlJdS0PuFLXBO3M-LN8,9008 +setuptools/tests/test_shutil_wrapper.py,sha256=g15E11PtZxG-InB2BWNFyH-svObXx2XcMhgMLJPuFnc,641 +setuptools/tests/test_unicode_utils.py,sha256=xWfEEl8jkQCt9othUTXJfFmdyATAFggJs2tTxjbumbw,316 +setuptools/tests/test_virtualenv.py,sha256=g-njC_9JTAs1YVx_1dGJ_Q6RlInO4qKVu9-XAgNb6TY,3730 +setuptools/tests/test_warnings.py,sha256=zwR2zcnCeCeDqILZlJOPAcuyPHoDvGu1OtOVYiLMk74,3347 +setuptools/tests/test_wheel.py,sha256=I709mQO4YCztxI2L8x7bu_rE818vC9SXHR8qtZPwZW8,18752 +setuptools/tests/test_windows_wrappers.py,sha256=wBjXN3iGldkzRGTgKTrx99xqUqwPJ0V-ldyiB1pWD-g,7868 +setuptools/tests/text.py,sha256=a12197pMVTvB6FAWQ0ujT8fIQiLIWJlFAl1UCaDUDfg,123 +setuptools/tests/textwrap.py,sha256=FNNNq_MiaEJx88PnsbJQIRxmj1qmgcAOCXXRsODPJN4,98 +setuptools/unicode_utils.py,sha256=ukMGh8pEAw6F_Ezb-K5D3c-078RgA_GcF0oW6lg4lSs,3189 +setuptools/version.py,sha256=WJCeUuyq74Aok2TeK9-OexZOu8XrlQy7-y0BEuWNovQ,161 +setuptools/warnings.py,sha256=oY0Se5eOqje_FEyjTgonUc0XGwgsrI5cgm1kkwulz_w,3796 +setuptools/wheel.py,sha256=_JuhinWmlQwBHJrdIh1yfhrDS7GFMacCiJiOY3H5gwA,9477 +setuptools/windows_support.py,sha256=wW4IYLM1Bv7Z1MaauP2xmPjyy-wkmQnXdyvXscAf9fw,726 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/REQUESTED b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/REQUESTED new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/WHEEL new file mode 100644 index 000000000..e7fa31b6f --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (80.9.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/entry_points.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/entry_points.txt new file mode 100644 index 000000000..0db0a6c8f --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/entry_points.txt @@ -0,0 +1,51 @@ +[distutils.commands] +alias = setuptools.command.alias:alias +bdist_egg = setuptools.command.bdist_egg:bdist_egg +bdist_rpm = setuptools.command.bdist_rpm:bdist_rpm +bdist_wheel = setuptools.command.bdist_wheel:bdist_wheel +build = setuptools.command.build:build +build_clib = setuptools.command.build_clib:build_clib +build_ext = setuptools.command.build_ext:build_ext +build_py = setuptools.command.build_py:build_py +develop = setuptools.command.develop:develop +dist_info = setuptools.command.dist_info:dist_info +easy_install = setuptools.command.easy_install:easy_install +editable_wheel = setuptools.command.editable_wheel:editable_wheel +egg_info = setuptools.command.egg_info:egg_info +install = setuptools.command.install:install +install_egg_info = setuptools.command.install_egg_info:install_egg_info +install_lib = setuptools.command.install_lib:install_lib +install_scripts = setuptools.command.install_scripts:install_scripts +rotate = setuptools.command.rotate:rotate +saveopts = setuptools.command.saveopts:saveopts +sdist = setuptools.command.sdist:sdist +setopt = setuptools.command.setopt:setopt + +[distutils.setup_keywords] +dependency_links = setuptools.dist:assert_string_list +eager_resources = setuptools.dist:assert_string_list +entry_points = setuptools.dist:check_entry_points +exclude_package_data = setuptools.dist:check_package_data +extras_require = setuptools.dist:check_extras +include_package_data = setuptools.dist:assert_bool +install_requires = setuptools.dist:check_requirements +namespace_packages = setuptools.dist:check_nsp +package_data = setuptools.dist:check_package_data +packages = setuptools.dist:check_packages +python_requires = setuptools.dist:check_specifier +setup_requires = setuptools.dist:check_requirements +use_2to3 = setuptools.dist:invalid_unless_false +zip_safe = setuptools.dist:assert_bool + +[egg_info.writers] +PKG-INFO = setuptools.command.egg_info:write_pkg_info +dependency_links.txt = setuptools.command.egg_info:overwrite_arg +eager_resources.txt = setuptools.command.egg_info:overwrite_arg +entry_points.txt = setuptools.command.egg_info:write_entries +namespace_packages.txt = setuptools.command.egg_info:overwrite_arg +requires.txt = setuptools.command.egg_info:write_requirements +top_level.txt = setuptools.command.egg_info:write_toplevel_names + +[setuptools.finalize_distribution_options] +keywords = setuptools.dist:Distribution._finalize_setup_keywords +parent_finalize = setuptools.dist:_Distribution.finalize_options diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/licenses/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/licenses/LICENSE new file mode 100644 index 000000000..1bb5a4435 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/licenses/LICENSE @@ -0,0 +1,17 @@ +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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/top_level.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/top_level.txt new file mode 100644 index 000000000..b5ac10702 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools-80.9.0.dist-info/top_level.txt @@ -0,0 +1,3 @@ +_distutils_hack +pkg_resources +setuptools diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__init__.py new file mode 100644 index 000000000..f1b9bfe9b --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__init__.py @@ -0,0 +1,248 @@ +"""Extensions to the 'distutils' for large or complex distributions""" +# mypy: disable_error_code=override +# Command.reinitialize_command has an extra **kw param that distutils doesn't have +# Can't disable on the exact line because distutils doesn't exists on Python 3.12 +# and mypy isn't aware of distutils_hack, causing distutils.core.Command to be Any, +# and a [unused-ignore] to be raised on 3.12+ + +from __future__ import annotations + +import functools +import os +import sys +from abc import abstractmethod +from collections.abc import Mapping +from typing import TYPE_CHECKING, TypeVar, overload + +sys.path.extend(((vendor_path := os.path.join(os.path.dirname(os.path.dirname(__file__)), 'setuptools', '_vendor')) not in sys.path) * [vendor_path]) # fmt: skip +# workaround for #4476 +sys.modules.pop('backports', None) + +import _distutils_hack.override # noqa: F401 + +from . import logging, monkey +from .depends import Require +from .discovery import PackageFinder, PEP420PackageFinder +from .dist import Distribution +from .extension import Extension +from .version import __version__ as __version__ +from .warnings import SetuptoolsDeprecationWarning + +import distutils.core + +__all__ = [ + 'setup', + 'Distribution', + 'Command', + 'Extension', + 'Require', + 'SetuptoolsDeprecationWarning', + 'find_packages', + 'find_namespace_packages', +] + +_CommandT = TypeVar("_CommandT", bound="_Command") + +bootstrap_install_from = None + +find_packages = PackageFinder.find +find_namespace_packages = PEP420PackageFinder.find + + +def _install_setup_requires(attrs): + # Note: do not use `setuptools.Distribution` directly, as + # our PEP 517 backend patch `distutils.core.Distribution`. + class MinimalDistribution(distutils.core.Distribution): + """ + A minimal version of a distribution for supporting the + fetch_build_eggs interface. + """ + + def __init__(self, attrs: Mapping[str, object]) -> None: + _incl = 'dependency_links', 'setup_requires' + filtered = {k: attrs[k] for k in set(_incl) & set(attrs)} + super().__init__(filtered) + # Prevent accidentally triggering discovery with incomplete set of attrs + self.set_defaults._disable() + + def _get_project_config_files(self, filenames=None): + """Ignore ``pyproject.toml``, they are not related to setup_requires""" + try: + cfg, _toml = super()._split_standard_project_metadata(filenames) + except Exception: + return filenames, () + return cfg, () + + def finalize_options(self): + """ + Disable finalize_options to avoid building the working set. + Ref #2158. + """ + + dist = MinimalDistribution(attrs) + + # Honor setup.cfg's options. + dist.parse_config_files(ignore_option_errors=True) + if dist.setup_requires: + _fetch_build_eggs(dist) + + +def _fetch_build_eggs(dist: Distribution): + try: + dist.fetch_build_eggs(dist.setup_requires) + except Exception as ex: + msg = """ + It is possible a package already installed in your system + contains an version that is invalid according to PEP 440. + You can try `pip install --use-pep517` as a workaround for this problem, + or rely on a new virtual environment. + + If the problem refers to a package that is not installed yet, + please contact that package's maintainers or distributors. + """ + if "InvalidVersion" in ex.__class__.__name__: + if hasattr(ex, "add_note"): + ex.add_note(msg) # PEP 678 + else: + dist.announce(f"\n{msg}\n") + raise + + +def setup(**attrs): + logging.configure() + # Make sure we have any requirements needed to interpret 'attrs'. + _install_setup_requires(attrs) + return distutils.core.setup(**attrs) + + +setup.__doc__ = distutils.core.setup.__doc__ + +if TYPE_CHECKING: + # Work around a mypy issue where type[T] can't be used as a base: https://github.com/python/mypy/issues/10962 + from distutils.core import Command as _Command +else: + _Command = monkey.get_unpatched(distutils.core.Command) + + +class Command(_Command): + """ + Setuptools internal actions are organized using a *command design pattern*. + This means that each action (or group of closely related actions) executed during + the build should be implemented as a ``Command`` subclass. + + These commands are abstractions and do not necessarily correspond to a command that + can (or should) be executed via a terminal, in a CLI fashion (although historically + they would). + + When creating a new command from scratch, custom defined classes **SHOULD** inherit + from ``setuptools.Command`` and implement a few mandatory methods. + Between these mandatory methods, are listed: + :meth:`initialize_options`, :meth:`finalize_options` and :meth:`run`. + + A useful analogy for command classes is to think of them as subroutines with local + variables called "options". The options are "declared" in :meth:`initialize_options` + and "defined" (given their final values, aka "finalized") in :meth:`finalize_options`, + both of which must be defined by every command class. The "body" of the subroutine, + (where it does all the work) is the :meth:`run` method. + Between :meth:`initialize_options` and :meth:`finalize_options`, ``setuptools`` may set + the values for options/attributes based on user's input (or circumstance), + which means that the implementation should be careful to not overwrite values in + :meth:`finalize_options` unless necessary. + + Please note that other commands (or other parts of setuptools) may also overwrite + the values of the command's options/attributes multiple times during the build + process. + Therefore it is important to consistently implement :meth:`initialize_options` and + :meth:`finalize_options`. For example, all derived attributes (or attributes that + depend on the value of other attributes) **SHOULD** be recomputed in + :meth:`finalize_options`. + + When overwriting existing commands, custom defined classes **MUST** abide by the + same APIs implemented by the original class. They also **SHOULD** inherit from the + original class. + """ + + command_consumes_arguments = False + distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution + + def __init__(self, dist: Distribution, **kw) -> None: + """ + Construct the command for dist, updating + vars(self) with any keyword parameters. + """ + super().__init__(dist) + vars(self).update(kw) + + @overload + def reinitialize_command( + self, command: str, reinit_subcommands: bool = False, **kw + ) -> _Command: ... + @overload + def reinitialize_command( + self, command: _CommandT, reinit_subcommands: bool = False, **kw + ) -> _CommandT: ... + def reinitialize_command( + self, command: str | _Command, reinit_subcommands: bool = False, **kw + ) -> _Command: + cmd = _Command.reinitialize_command(self, command, reinit_subcommands) + vars(cmd).update(kw) + return cmd # pyright: ignore[reportReturnType] # pypa/distutils#307 + + @abstractmethod + def initialize_options(self) -> None: + """ + Set or (reset) all options/attributes/caches used by the command + to their default values. Note that these values may be overwritten during + the build. + """ + raise NotImplementedError + + @abstractmethod + def finalize_options(self) -> None: + """ + Set final values for all options/attributes used by the command. + Most of the time, each option/attribute/cache should only be set if it does not + have any value yet (e.g. ``if self.attr is None: self.attr = val``). + """ + raise NotImplementedError + + @abstractmethod + def run(self) -> None: + """ + Execute the actions intended by the command. + (Side effects **SHOULD** only take place when :meth:`run` is executed, + for example, creating new files or writing to the terminal output). + """ + raise NotImplementedError + + +def _find_all_simple(path): + """ + Find all files under 'path' + """ + results = ( + os.path.join(base, file) + for base, dirs, files in os.walk(path, followlinks=True) + for file in files + ) + return filter(os.path.isfile, results) + + +def findall(dir=os.curdir): + """ + Find all files under 'dir' and return the list of full filenames. + Unless dir is '.', return full filenames with dir prepended. + """ + files = _find_all_simple(dir) + if dir == os.curdir: + make_rel = functools.partial(os.path.relpath, start=dir) + files = map(make_rel, files) + return list(files) + + +class sic(str): + """Treat this string as-is (https://en.wikipedia.org/wiki/Sic)""" + + +# Apply monkey patches +monkey.patch_all() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2eb93500c0e76a1cdaf3a0b76d4c17dc87b03fa4 GIT binary patch literal 12099 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_core_metadata.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_core_metadata.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..919c28e160c5b1eef10ad2164d6bd49e198b4db4 GIT binary patch literal 14982 zcmch8Yj7J^c4jxw02*(A1PM^2#O6yRBmyKQN|q>zwnXY>OO!0yR+-~j48(3ypzz>y zgQf_BHQ0$$A$Ob-UAu`mai+qlacbzXQ_&=oj8gk!y}MIcSN0F!rV4b2uGLhW+T9kRB{q?_%-u#;|Mg1Kej)D*?jydh2}3{wUg)5f@Q%1G|a6hrQ&DHGh8xH(~&vJf6qoK0A#tR!uY z+YT0`vrb0_aKp6hF#853*nQL(?DAQ{g3J@O>GiqI~`4?lF*2FEF(mcP*(BPyn0g*C1@X3 z@|v3bN0{6c6m>zUG(5CT3h9OUbSf2>#)WxNP`i6Q zDkgErXvHbcOdmURC?ZJHQ5X=Etz9Na7%7T=d;t=7skEM##ic}j2zhud(^)##kS;$_ z6mR&j%!xT!Dq>LiC@M=&QbFT{;?agVQtn;Gcqlv^G%A)^82@xy6zxz%Yy<-RWF#Rz zqZkrzN+^iqb~6JvQwd=p8W(O4Twb~=rsjm{v@~#b@@i-z#S3cc;`q79wbYGNdLX@! zPKmK-d?2i+;;|b8>YO+n9y&B2#nM7Zn`Hx%K41e8oD>nQwJ?noAGA<^p*3F&K*QSL zC-no#Q9D-8nlJAUZVt=V!Q7c`i#3G_4E6f(VciZmFU3?7uRL!8H zb|ZuS8%W%xvecYD?8vKLAC~XSbYB*7li3|V6 z60H41>P<|?%SvGJCVW5%J|O4_T$bE)Dw&4$6&4-P77?e-E^V6#niZQgACIL$;|P*s zj0;J{9GB8!Y+hmJQn94MriI(-MKL|L8#&`FP;UEhs#Io zhPU{Wrh(+BhmOXgV_(6sPj+y*vpW{s%8}p7tiAl*?`*q$YcH?fzVn^c@5pX0&vM&# z_nqUb$Jd1Q)9>EAn|e1TH}`%N_|x_e+VA`RUCUp!e0<~+?=Zk2rs_H1aGPvWD`!pqC(x3o*0j8Vn$)T%yppoA4lr+)PY} z^I^sE>cmSESFTS?d_a9*RE!B}Rxyz*#q?%0z92}r-Z_p_2f_!sC(465gtDq;gaRV2 z2K-5_KyWnNYo^r~b7!|Ljy3D2mX>XI?yRebs%{3RU$Qyb@{{OLYOs zQC~Q?jm8Z@cJz~u=a%8yuQ+z>d)AN0_KrN$@r>Rd1qolK17L;LjKnNORz1B$ldo&Y z9DjD-MNo5Ml8eUUu%M)ccv|A35*Lq2=`h+kRK*d<3>w8Cv_d=pL@}$MzIHqs)$zcR zl}~>N*iXVw>Hq?t-s!pXjn!|gH*GMovnO|M+u~en_->X=0B`QHIt0~rwgoDyIbVE!BLy5Duno(|d3S#8x9Zu^CAC!VYTTZ}%qfV|G4r3LEZc1u6m?{o)T^Xh- z4!w5X40W<~`7Krax|t#Tx~ZvY0b9jyuPf17#erslTxrxy=LuDJEA9hp&nQ{j;YznyNU^Mv^PpL}r;TlRW9=$&=1oQ(tqHv^|=%C3Dc9 z385mExb#hd(_BeTRivu70>KVM30&$1`my1R?j489-m$`vxWJ-4TBL=s>>oOYf$v)ABtmG7EPF9)w(Sy_Da7c z@jP;1TqIsZHfOnyBp{T)X5uC%q> z;O5x97TJFSS$$tL?B9?!FUSo?AoHc|<~?w`vJ>dvoV*v71E-OvX}gV6#k!%U%~sis zyceEe+G!lR*L816ZiF&W%f6HMC-Y}sllNW6qOD)Fjod%{u~TlFAd%`6G=_M(Rn=Lj56j7V!5KJyW%)cqoO_U=hD|o`$hnsn zV$-*Xf6K?j^b+ct7+@-}t_i9#scH{yerY~h73_8m9X>u7CIUpXikUM>VUdJ9ToiyA z071}KOf3pL7fW*AD(j$ck$M(m;6>hmS$zxhP|?jSfOjcm+!vFic8thoVzXfqiv<}G zO_st430Q0Bt|7ms6RNATW&FNl@_J*oLaprWtp^{tiE9M$1 zZ?%+G=d!74e*3iC$~|kyn$o(DHK$wr3P%Qfz$y;izSeS7^{KL+blY0th5B?K71onM zJo**iYj35jma6nzY_96vJ}tj;uW-`Tk_G>DQA3nOF9O8;Iz_|3cmBg|>gnecUhMFp}LufB9XbaCR`71hrGqnaYGMF9X5z*y3vAcPev!)kmAy_hjA zq-R3M&OtcD3d!jdf~|@X^a&y(XxAr#9>tK76lOk}zA3iD@QAo>M6~3J3n5t{qFFeA z@Br3RER&Iom#>VU1tdj%hJY~vfSqERz6p1df9?FWt7_uPD;E@tD1iN)78J8^8^TLT zF%#@Z2%1#`%ie(YN3c~)8W2}RD3Z~*LeD660Ams{;@LF-*|)Z-+Rxnkp4x3X}s0)3%>=^`$ovSEdufzbPHcG+m4vPQlpT-B6IWziEJ)|D|u6$`NsBiN)tRAw0!r&Nm1L~;j+w`(kw2_vuSv`cMsbn|sdsVsBRO=~}vz2>bP3vJ>*7o!$ zgPb}ld`=I5D$+IC&|8p5dTU>Hkha;f_V-}FE9-cV`azW{ey53{c*mR`FjZtht$OHP zd8^f+wQ|{+b&6I}1EeaW4yEg;aIN%hS^`x(OD(&yE@-PAM&3IiMYE{Qf!BIljlU!dh+oAVgwYFisc_moeX|#Xj%6hd~EYk0El9BXh&05=G&G(b} zcS7T@+_f*f+>mV$kFC;krz&|`iVtKPV6Eve5X{7ex#zXq%AF5rt&keNOp?Z-xii6* z%wRp|0e2hI9NC=(526;esId!ZZ$U%QkB1@gdtet<4fS@hvJ~hH0Aqm~eo*DmF5xC& z#xTN>I0Ue06LBXHnFT~bJP1O?*MO9R>YTa-VOM<)vIUXps&zoZC*vvDVwFb2RZM?? zB5;@FzvZZH)^-;xd#7ioV?Xr$?h%c$K zJe5~v-pi0Nk!iT30z09z6+FjMewVSAcSu7}f5y`P^EM`5q($j+FK>?mw` zpBg|NC|?G3u4tf+;#Rj$0r*y-pNw1M52?HMnZS4jPYR8x8*-snmga?wLu)N=jw_b& zC4jeL)9T0O$X=?56GveYf+x@y0pm6J%Z;zAksAyNMYLh!RV+rB%Xo~4CQ@+#EQQz_ z;zE*Q0@pMl5tmhQpezmMQk(?yFOLQQJ`r`c;Le6ZYOO+m)S_DV)h8YOB7$@TOtIXI zN@QF6x3M*QpM;)Zmziu=M$#}ku+;|Jj|~wiI)f1}!Ru6*=v6G-SZ-6fVmw74DS^n< zE0dEK&s;hi8Gn7^^yQ0Vk#iT%UK*bi5u{f4te>n@T*NH!?RjZ2mcAKmBpx+cS1J&< z1o%#_KK z_jJBLwrTm%r7dRYGseAUUT6Nu`F-bm?k%PdpRMb|#nyv`)`N0uXp0FGF`Wfhr|jy^ zo&U_@`iyN{yZDE1Z9XTrAKqezON_;D&Rr=rP=Ve@l+hGiwXc{~(mRcN)`vHI8)><* ze}&z)Hx}&epE>;NruEwo9DOAVFqUl8zRu#_;lkeGyaoQZ00rTBUtj*f$p`GIZC{}1 z>n`}ZW#9h1b^nSVh+6sb=5@LK$QFC_Ve_71b8n%!x7ZviG>7EofkzZ=I=X6uCP>J8 zc|+K^zIkR-+7$9#!w=XaB_remAmVAfb9?pnI#Ub;3xS{--ke^@V?+=s!~MACdjfJ)#Vz15bbDyrX|* ztl;SXS?puuUnKEcTQ`n8a0E*xUZMnk`FWz}^^~JUH14kRgZ=QjYiDCm!!%_$jK_o#x{s#a*Z0f* z69cglGpEB-mB#UUO>aOCF@}Oz$vlVJ>xoN~x@=DC(N8_73OubcWVCF}T18j7NfQJ| zl8jj^{J;vh)U0t;?pc#233>uvDS&}`JOjX!HOoG$othWAZ2Qu&wmmi0!wmJ# zd*B@!0n}wCs!Z!RSfa99v`dc!ogzkzifKLyM`aXGED5kmJg(bhRmHpDNQ)Siw723r zSi}lN(r{`nl~nOp{3dWX25k;uSDMOpMl)&U*G^IuoGudq50c;rntCFyTq?QY+lw^rXmEk9Uj9hBWesM5j!`Ia5M$j0Qx+0BN0WB&s-gxW0( z`XsOi7VUONPqAaT&@o)>7%6m&$Q>siQ8v?Hf!({}UiUrh87}sW7J5eSOLEUxf$dyz ztVP#bw*6g2f3V;W%Kn3JxWlur=m{1)!Oecz^W2K*mv+yNqhq5x-*@bO&&O?Bj)|Sd zK(TRup>aR49iVKigDYcDY+Zs@9skqkKX_g~cvAM9S~*?T4(sikUfAk6l=p`pI0k+N zpweK;3(YD8C`VhKX;sw)EFS&RQS49PRkgav>W8mjIUDOK577fEpl*&jRg-Y~4^UQf zMNyD9v}nSejrR;cFyQlyahXX2Fr;2QQ&-iP-lnq5cqOndFGX$1WsMPiagya=p4g@P zcIjZoN+tz&>J+zYB6|=ur|59|;4tdS{g8MGAX&twz6ppA9{zwh&77rwpT0|jUb8dQ z67?s>MfwAJLd0Mhwjm7RL503ueZ*tedU94s;{M@irlWS!S7HmD<$r=03GwrPKp*AP z&f}ZjKl}FkLxs-c|6M}u`CW^b{#WpWjSzfP%&?mar$a?Vu83b6G>NF_#6LswQzU;5 zge>&5B;lBnRiMuQpI||Y74on1Q)^L%r>WMQ1<+}U5-C{Od+ECQF%_Dx}{ z69CKOvU?o zkY(O8z!WnAWxz%mc+(Foy!j&?VS@-3u{E$?C!uz*RdujHo+Z}J3OH4HYGJ9MZ6b5* zbmB&Ab|D5^X8ZywIIfdSvQF6isyb*(Hqm%t9$aTY#$$pM&NyvVT8R^X4wYvH^iqJZ ztAM)%F{8TkKVqvXfu%FoYu{aj-8!;~#+3sfsh_JHP301?*_&zZW;C8ASpJQLSe)m| z+E(4g)0&j&&<{il^HTL$=y_p2G8#_?I;`&)Hn0C9p_30+UwkQHmzI&|9WP9szlL!-feHw8Vf*oi?d{6oF4GD zn~wd)&01|GAJy5HX9MfL0=uuQ^z%(U8~ny=phO$P57+^9?&|6V8iEUp%-w5{s8yNI zI&=o}OjmPIuzYEriiY@1QsQ4h7N8i-uw#K1^u_`j;KRsp(8^k@n2UP7K{NL~ms!t*I9eW>^Ai40YVJfs$^EA`O-vDCqk`2VD( zHJvA|c~<`izh?hyq#j(jv5-tJgoeIEaydUdqzccN-dYa5wY*D*#CtGt&VkNoB*!8n zpe16kH$NN62x2P8C}un+6ith`!6L?ypizL+lgBZQr+lhStN7RW7D+SCXheQsTYnGb zXuLDJI=aKQtar<7dy(xeuz1*IQf7yC*tYfS_j|V37ap684s!`2a`V%x8LbkT=O`Oi zGf?%a=knB>+f_5ajvc9zherH~tLkhn+ASImhO}3eK>y^4t6mIMInzI>{qe*uJ&-Ym z!vnAddIKbg(?Ap!4HVgk#o>kntirrP_C`^!z`&!DR&1IT6Zo3(zl&m!1abUdgan*H z@;2V}zw0l0I|^RVEwZ<_=p86{2YzPwx%sE&`$pM&GWQ}L?K;3%CAp;qCgWks zRozN#g6dn66mc*~ig4m=hRVodC2w)XR@$Vtc|fs5B7AB(5>adsFkyJwClV21y;17C z6fngBf$$B!LYy4?Q=B9nF8>V`=`#M&MPi&d7fA~eKagGaBpi%b zhzq0QLwJPsNl9-3g@Bc&e`R23=ARrC-Su~r^=~Qr-%{?+sjkndj?byyzo)uCr^5e* z8vC5;`LFnL-{;h!zo+^hnN76ovByNeOe6Io=|s}-*u&7?N3LG_4E^X8+D^M4wYllG zNBb|(^xj9W8N77c<35&lK5BN+gO9pt`aJ!Z_0Z-=`%QFn$-}i79x{%VnQIhx`8se*KDOm zO#3L4Yh|g_gz0_Af2GupX^t|rjj7DnU^=1%#}{`vDu<>-_&s z>=r5%^^jJn+EY=bNWB)3svINr6t(K5mr^QGZE~oTOLHTbL&~Z1*K0c%_|ndw`TJ)6 z%N}Ytw(Xiy4AoeVgkzdbUDDSL0OX zxJ*W2!#QZgnuGxmb_e8(^T1SsRj!bmaIfz+RFs==o5YlfbvRUxOm7IE+Gi*}27)Cm z!^}GXcxAKfWg?oTZ8#bmSjM)UL9d)_N!v2WB6gacMvUtu%(rBX5V-fQ8>-5W3MS`f zGPb4CieUOPsZYcdt24{9MK1JWhFYp9m-4tR>G?8^xhz-wP0Lfz*&=0J;=|#CrNn|+ zpb0%sD~W5>>&(p2jNpl@lh+3)OoP_7vC$9GH_Ta6Bt%)5EUV`e@urr~&L&D#v0xU5 z;%~j3;8{TjOL}HepGR*_F$H0od7elcS)MVMD67Ux)dSz~JT1~niKRa2w+rCuIc65p z1}(*h^JYfR^HjWvkzbQvLh&!WScN@s2R;7;v?u=1H*@#tU;gty^lXy#Ge7mM_dWdZ z&)ECBD)@qTZ++qWI`~!axq|5bxa|6!%SjURTE2RE+2XtvVDwfw%V>cX1-JY+S{4hS zgVm9C+GV{mA_U9MmIb}an8_>!OT(5bn6Tw_Ku%McOxFswmBn7gQ#q`B8pSH?x)e3^ zMC;wrqFY*YN4vPCUEG}9)-LU6SGKe(JKETmHg?y$?}0$@xm|J3xqTIDsewD-*#)=i zd9klT;Org{HT1XE{iSzTLG6H_#`t%JM!fLI>mLazkGcuULu2ekgw4tdDr?Xh-QzeZ znge?r|AY@i*sH}RWUMpxEgm-cC-22I2{EF-hn(pQ<4UDc;kJJ9=yXJW9m)ld%*1RM z_B>kGPH@0MMEvD?tZ*_J?w59d!~fHWG$Sj`JGsdOHKIqawh{4oTqYN8<#FNg`AOFu z3me4gKblz^l$RE=#fk$qk>&$z@0!Z$ci!smBm}3g`AZe8f|Gt&3bEw(I{27?Q^T literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_entry_points.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_entry_points.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e70733781539338158a4019d3eeb79e4e9d1d7da GIT binary patch literal 4874 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_importlib.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_importlib.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f1d5166d4398d8a04a2354409926ca937eca020e GIT binary patch literal 430 zcmYL@F-yZh6vyv!ZLGy0*xA9&49%gg;-rG0rRbI=T${5=o8*PNOEKTV&ClRxaCdRi zMTmleICK*V4xPNTHhpmS|J{4<&;6e)tBG_yKCs|J>sR?$mhlhMa}9UMM?Q{_i#QrC zC(BK(zA@5WQJ-%aE=kNe)neijyztgz(={>5u}vnWvtt_*qIFV6u-6JAb6ISRxsV|w zUYJ}%u@%NC2o;4rFXoE*OtGR-(Q4{cy;kLL1ecJBK9|LMh4*M$emxu00AfyA#BbtH$2oi$W69y-R!+S zc8BM>AIvld6#t-sWC+#0o!4&S9CeI9DNJ|A~Z9_ z(q8X(vh(Xuqw|%^&<@BxV2K(VNc4O;wzJX zv-Y>qoa&=qG^zn2q97mpk@W-aT-1;H$}|#5SEdk(3GtVTsk~CFsCf)5)sI$vjQq$8 zyaw%9xfnqu^{x5@YY}<|4y`93_XRByY7<#7%~_1NoCunC7@_1IwLI1*1Q#SfPHb*> zdUpP?$H=q{ID`sDm~C*+1~M}<_2G%xY?fGg$8BfOWx>YwIqhkhGt!zCLLR1Rx`U*1 zQW@#d8tq^({==kI>Rmw%mV=g&_5ycYBACH!ml)Kth(#S&>kd!LWHRCRu!L^X>lLlM zL0w4NVg<>9G>#S^Ut~7*FK{+-1UIOufePaisMIur`ol}Kx*%SC$v~ZAr6A%kW(RSp z$0Rs*aCd;G!Xc735+Y*I&LDB*#l$Jt3y19i7~jyZGTLoMjmhOJ<=(Ai)6YrTRA;`?upKR!^=p zY#l$noY-jq-tRDp`JTF-IF?l%FK}pCZTf}$CBsC7%tRcMO6CgxM1h;0#j>IqTsfjn X3e*o3WBdi3--)BPj$M?(%^~LxNKhW2 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_normalization.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_normalization.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c4090d4f9a512cba929d73d89b3f026dc1a6d50b GIT binary patch literal 7447 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 V?6_y@4D;C;?^K`jv$HHb{|Ye#D*FHc literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_path.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_path.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..44d3b4bd807c13a882fc73e4fafecfdbe0c3fb8b GIT binary patch literal 4646 zcmcgwZ)_9E6`$R8Y$ta96Alt|nG0MULt=*@E|ALsA#lLahUf?f_aRHlj26l|ZY>xLy;s-c^sLCLNk zKR84@KI2{j2}pK2M?u%^l;^@3E} zbK0U~vX!vCMPeM7YGOu4SK{D;a&rMCAtbD&fmlRVc_3NbZ21Ea$(rgnhn_)qit;WC zR#|e=y$+|K2zSMj5e1Z!g04%ukLqTI5^N=83p#?+G9|i&6_t{>WzZZpCh)sy*vY$? zOsl44vW<8-88xOxgDzV%OxwjcY!A%RkQ<@qJr*l@q(D#IP z_lHf@BE4xjJ|$1WY?D}-v}G8Y8ICfoLg}2{MEEYFwlR@uOjQpFfAAWD>gMG_~ zzde-q1y)=Ex(UV}JMnPZofDq~VxtqU2rOV|r^UjJxAjhTvbHo@c~-*kG@4-{C(4k% z5%=PVp<7gjvkd_>cIxzrbGW~+Z(k3F2pP#uW>vihPZBGhh4|SMg!s`dS=CKG)y$)b9ykSYlD4=C#Y6@RL1s?z zGZKTdl*173>ZBeDIWcd$<9w&V8e1}RrtM8@vNZv&rww33p0sRFaT~WGD%go+sm)~P z96O;r2_T-agyG#9} zU|LyIFA*$*&ovT;RE(KHF&Mo%MWr(|ZJ5Li1>IGy;HNSUDb4m$B5N$T=w?`q8=ZCn zRpl6GgbnXy1B1{(hWFJo58U^4y`43)Xj(dtvcmVJtPpg`_aLBniW^o~Dg|JmD{5S}pv<%Lz*8Oj zoFKBoP#dGi&W|5IH99stejF41qDl=t1v#5bxd@m5k}FG~zzXQk%)}t!#)%214`)?P z!%#mBmPWa#62QW8DbW%DCw%2l9hZ2734+86Sz6{*gG@6_38E=60mOk=rqe}P%Mey; z07P2FsSH;@0f1^?0gCAkqzrwEkGAj;U+A@j;Vz?OR*RgjrDf*lJBfLsjS6@ zGns-==l;Fu%8nd+KHDe?fr|9FQU0%nczipod_U$OM;E)U;xikK25W7%5o36t=XTpu zG=?p~blby&iKJ~;(ol8EGNkQ>VgaS!meNK#=&@@!i|qj{%v^6b!qs51%F%X9JVV(9 zruv&ZO#x9)+aAk^GRc7PNS1?LldZvH02ga|D_`L8=%KFw7po%XXVCoxeF4RNCu(ea zF9Fwt&07|e3&}-&L0|s*y@A5!S7%SHZtb|)exv>7i#J}p<-ZpzY~8=&+WbiL)eNjQ zw=T9Xv@dopbbhz(l5di&`_Eg zwzT zLfU{Eo>TqVp9!|x%B8{ElvM@F?!c7QV7r0gzbIV(D8KGG0n_a8MnMQ%`q-78U&!fx zHp4px$>6K%6yd7djnQb;)gN?Vf1vQIA;^hWxdHC19 x!?WJMyCtD}&EEvwSG>Y0VQsT0oEIL|A<=(dXwM7ne-pcefi($<9h~CY{tJJHN}2!w literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_reqs.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_reqs.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9de96466b44699f80c88715408253c32d6265473 GIT binary patch literal 1938 zcmZuyO>7%Q6rNqLH@4S~ouB3p(r!W(aFf^sq!y!sMAHBUB~6nQsar+c_3pUYbbp-L zbyY`2if9fwa6}5nBK1I&OYd+-NL&(GDA7s*RR|$&kph>B18-(+X)$ zGyW-+N+1|Ne5b7#QG|Y@i{=nQfjjvJgl%*S8OY!)WOE9~QJJ@RJEBBvK@r$GVnuCH z5t%Gl9d=BK*>NRqCzOOODUzL3lFSyhQg)}($z;(=+ZiRpAsizjV0KttcDK^aAs*p` z5!>a$9F!g`;a(iUy@Q}A^K@3u8FAcaB(8$YQ-5(cbVfMSit9Hd@JUi1qsvHb3d#UZ z8r??crqJ|O20_zfq)%!3%N*!3n^9%37R~nlNs+T$AZd={`kHULj+f5pfoKP}FE6vU=A%VH57OSKCAOd~<`mIH7>%zc1~ zRZW6z?D!Os`hH-Uniufu5=lWaK|)>h$qhm?Sbw#NdgqSkljRAyEqpnM zS2W^bmEbkKQBHaq6oW5<5O?wg2;0bS*;aXKK0SOOM>zbZfL6tp*b>@MDE^u82sInC z+t{PIUWDqdf0>YB+%~ag$dGNb05Y7(bnba_*(EZDy2@S!>t@;1StDfAk?(?wcQ=<{ z0O3NmtDY~Hu&g!WCu9iMn`6-=;O&M_3|o#5k#e$ch* znvSZwj&C|uwqp>nwMvjQh+6@@O`8-*HJY|+nSi>(1p-aTqa~GJtmRi+8|O6(Kg`e8 z=83zCb>GX+EY45PxdslU;`I;J1-In-dA|xYGBqooYe|+_%2#UsitD_cn|dqnLB^96 zO~0?*gJ=)?)r#-BmY1hJ_Hvb4kP2JgC>$ArJo@4DCSlq@e|skN`xuW{i5YEP#ID+|QMK^enF#upxhC<@GH9hGrIme8ahI`=aI~jF#bH6+**3Pyulw141cXZdFR{d zZ{FKG|K|R{)J9^fSVvRGA{xKElieMEcE5h<+D3d&dcBUWog_tWfjjO)d?G-FlL-7C YqQW5;572C5HGBB(^xsI}CRmdH0$PRM$p8QV literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_scripts.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/_scripts.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4ad349c6579034b5bee488e17dc848f1e08777ab GIT binary patch literal 16829 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 OR~PCJ6-gb{{(k}QqUq-V literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/build_meta.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/build_meta.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a1269cde4876d240d90cd9a2fa1650e27b77fab8 GIT binary patch literal 24817 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 a+J*A=`SSL&&QGnJb6wK0{%fj;{Qm)Ek84!` literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/depends.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/depends.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..aff48595e53cf9c5fc44fc3ea9c27aeec9646163 GIT binary patch literal 7653 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/discovery.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/discovery.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5b389e6730294a1f7f454ccd6ffd9f978ef2ceda GIT binary patch literal 28735 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 Q!;atgJJGpre*e(_1=aWA)Bpeg literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/dist.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/dist.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..30399f98ec4f2c06b0aa2c308058a5015502f329 GIT binary patch literal 52277 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

?1V*x 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 CtXWk6 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/errors.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/errors.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0a33e0b3fb2645e9c0a343c3949cc1e47bb1d7ea GIT binary patch literal 3526 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 GiT?mfmo3Er literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/glob.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/glob.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..da916a5538d28687d0afa9d325d9ee8893206602 GIT binary patch literal 7474 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/installer.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/installer.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..774efad2e8b0a2cd28f489ef58dd7a8928ccac4c GIT binary patch literal 7849 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/launch.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/launch.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..83cc984fe7d3d7df3bbd4ca3a68664c534309e9f GIT binary patch literal 1354 zcmah}&2Jk;6rb4{uRlZMBt`j>Scyxlv}?IELIT90G$>Ue3Pq~aG-$QFtymO&uD{Aky%6NLU!#!$2Y=)DEt05PNM2wnRQ!D7L`vc`?IrmXp%5mtl~NCS{^R{VP1_L$*19yjc&7 zxnKIku%WY6!;wbKW--0Yxo0@uj=v2}_H5Y@w(B;{c3q{ z-?#4gWnUI$L;Aw8-J&@{u2U`s@hyA9EL|&xj^tM%n{9g&X8(V!if()<&7c_((eT7P zBryhWcm%40{>`97{%qp%!NUH+VQGJ{bNg(3>NG!pnx8uzpL&+0dA)P%Sq4qM+GiYI zdvxXDdta`6zVg*ao!fusCcj-dtbWH%a*LhiC+SzZpPr=W&Jj+`ABLy-se|eL>2GGc z`f~!FKPRRS%zg7{`tj1qLnd`=LZ6|VvRKTIn~ AEdT%j literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/logging.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/logging.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fa557fd4ed3f9cb24b28888ea229ae14a61d3e92 GIT binary patch literal 2130 zcmah~O=ufO6rPn<(n^ZtR!-_4nq+a4n)RQWhTcM;ZGK6jgrub)2x6rfTPv@2#mva5 z5*u6ylt3ZJ#9*+m!GV;X3OyA{bLhn)E(%lMLJv6YH7SVdGqGY zn>TNN%Vbgr=+~d@>R&oSucV>~^ni8?ARZx%u;!v-D7B&%=#gRsM{v}Q*7c&Ug>$iD z9P9T{F@cjfeqS#dI6;y)Mv}8SHb76cG%NL5x-PudfLoe~*L`oEv?@|n6af&0|Lz%J zkI*8jshNF}ORIotDqJ-Havo-Hf&YRP6$zIt5ZCho_;YiPHzyKbeR{KSxo}bLPf5k6 zn92RkH!NTE>m+Zx#k)(z^{NQJZf`CB)p3qB?xx_s_J>84-yd7d}9PaWIM&-9S% zl=F=iulnBUnNuI-KRbFi8b-fVE+cUit0%1omr4wXEgm+siqgV<;q0+Bbv zjsROmFVpWnJp176>czF|E7#lU$xVH77bcJloHwagk&2=?fFN-v;P{Ua?#twg1_L8){)Ks5hmBQh8a@7PVUD?K!FOtQu368brIO z%|@0Y`%d?cvg%8$;mBfS-x+fKIfb4^H@c+*r;zCmsP>*heaVLvu8k_xm$mo%SRoZJ zy~dBLv6`t+U-B`9_w8|jKdf)an+1Yc`_UX=xo`G>SWCT(wqmWA6~FsDWdeQfd$Z15 zlM=IAm?rm4Qg^u7txMDPuxXe51tMn{$Ar>gr5uO%MWN=Qd`;pqW#KpZjQK^?VP=_B z?FGlDCg2A37aUA*uy_{6Dt^6TbEoXM4sV%v99}iC!{9+VE}Ma9%yN^Pb-QI&s>ItFcQc6S1Hlhzz{O z60cIis=kX0R*ohhyCQRoQ)1UIh1S9VtE;kqP+7<#%34gs;rMVkk+dabx$~cWc~K-Bk2Ro)2*Y7@A2%VAWbb%Fmrz9ElvGxtNI@nl)zWO!tI)$R z0NpDM-b>xsMH;qM3Y8VjWKqEVQTez;vZAh$o&a55HTwbBGTO_c!O>1`yqz0=k+YVs zywnFe`fytxUL9IHzH)p^x3+U5;r!F+v(%H+i`?n1)ks?(S)JO_$6pSNKEAR!Fur_g zTTgfNp|(B*L+c-WZ~T&Yp7}ZRPc#yX@5PZZ&`Aun6GN-Xwd_i^Gd$5Ap4duEZX4N- zG14|hR;QniJUja2=#K+i#-+U!IySy`d*$|b$%oko+24)PoeVOj=phK34g!1Y%OH~! zG`I!;XmG$oI;g=N)YKN?Q+5}c-A2EC^_p8Psl4^&V$Tx3CXvExnPw{%R*Fu2pHtZ_ zg1ZvQrWafv!Il<;9)47Us|hRu_956a3)nJ(G=6*ao2wmNrugy6^|6(SE&b$ndbpDw zYp2K7KY5Y1Hgzk=g%zQ)KNhSsm2WBJh zrdA&0jd3O{$+L7CRGAWX3fN9m)3iTOHu$CfM2BCY!+*y$ZEDvzqD}666wxLg5AGlk L>w|kz1TOyt>#?|L literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/modified.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/modified.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c0d050f2169d68db0267f76c3b6d948876b070a1 GIT binary patch literal 529 zcmZuszfS@&82x%b00krl2PYRz3>Xlaw8Q(}%lBUU`cf>;f+%BW&+LXPLZAG?FBmpoxZ% z6_cWXeV5@%x_B!kCEmJ|Zr*y59%v=QoAo7qS%1=>4I~4#J;7v1B)U&?-x8cNl5PCk zqla}*rl-z8v%Tf2t&7f(C`Y)%@&nO z+poNwWMkSzVq|na<>t zp)zczO$vP`Gm~1nCQlXlnu{;J5D)O3-!kcCCacse|sd%j+pCKBHS%YRXsAh9QG&Wy;T$K}MVy9^E)OJuPPohLz46%`rBs0yX54saajl zK^2!TVGIN%i&f&WwA%0OgZ86=L9)cTa&L}L> zbCyF6)B{8iR}?N9MTyH3x-QRJR-T{yZ0zlFkBqSvZxe9B5SiJlk87pY3r32+HXKju>i= z`~^+Snpr)e8v1LAi^UhInE_F=#4{5w4v(9f?({BJ02|xlfkcO*~(;eF|`*z+2J|;NcMbvqzvRlbv?ri&nk; z6>tBV_r%SUfA)@SL_3z|Zn)lWd#|k$>0kBr-wC!~JA3u)jr-PuJ*!gBHf$ujECdI* zg`k=*lOp+082=C|TLR9q&b4Vf%-LU8BedmP`q)p|5&)o_@QR*P&R0qpVsAzt>f z;}%N6`npz1MZzx?^Voqj1Ld*QTuQek3joaS*d;QB>%Z;BDQ1Vx*DMF2&hFa1vTjvh zEu|sgg*^rp=z)j$+OPNhSX%cUy%RaUGP)KSSoICu@$Q2`clE$v<-p*&_klZ+{uOO4 z^1!O^fsJ6~YvlSaP+bP^wAg}|%^Q!AI!-PK7UC-}CE->LTNlKVxEE$-8faPHLx?8U zcd@AEDv=+FKM@yPmcPEDgY9e%>mFS4Q9%Ejuj}Ntu?D!0F1H;n`p}}{WU-%hKS~vASVuRyo)wRnCUcSmIF4s zv>p|11f5P9I?odUgjph&9wlT!C<&SR-CEjALyXNqt>He{!KMl~Rn=;^oP)3l#9veR zcZFp^Aa9xvK)?LZS&#sLijijp<8f}tx4Oj#=WY; z(tXfnNLrRT3Vh)|Go$D9*Yfo2{QbLimTPzXjA5o!gPn~x)?uK*5$m7i-(|8zq%O}V zp~yz0{o3nSU#~_6Dv^PkN7f^c?zoA+?aj$|j$i%ubyoEqzUzXO|6yqEZ=5+R*#5@L z&fnkY%CjoCM1z7;D#}y3o^v7%$9=}!95QVQ7`EvBK!~1z$__sX{+6QGdWHh5#w31C zJB&|HbE@Gu16x8LWV^C#hBJZAo6CUqA|$M)c8-*he#~;j>GwJK-ZYCf35oR(;1{ zVflH-IDu}XpoVbJ>w(8Wj7C^7|3S=yl884XzwADulQ5r!|)6nWBEs&PIJhW}@ z!(Pkm9+X>VL%a9k*R*SlTsq3FfMoWdoq+)Q-ck~j25h|9E8%^k_pTu%gZ}BB(!$Fg zoGML-`F|+x!9$axCR*qSdC8!^yQj<%I{ZJ}<7;VYB3gg*>>@bum}{J(#m*mYSP4c< zS%|mdQ-!plDWK=E5bcLGw)bggh7RJFlrpJqA5l2wDY%`cryx`}b4pgXR86&1Tf$+8 ziL#m<8f#f$`y0q<`=6U!0T$cu918I%MZ|a({@EX(DwEsN z{!I_*8K@pjRE{PVFZ^KqyW{K9q0c0FT{;fVuj9ya{H^#0v7g6(7XMA`x5K|4UTr_O zMFjWbOP-CMf%nb#%xcf+O3&#f&&R&Qn=Y8x^bvWm+B;I|9jW#{QR#i6PW8w}U%c9P zveI|5+V@nY@2SNLRjIoob+1duHoSemaQ!OyVX)#I0e-rVRl5c&U4zxG(Ms1Sf>-ET z@M>@)6uavZ{egc3IySw;R||^Z9*u(P$W8eT=x|dO4U!cWz)?VUg+>C-1AJ>s+|q>i z1+kfRG+n@+=Cp?imcWbFb3t$tkARZ^pE~|IA_4@uVFlm6@zmfe!dEDSflB`JjFQex zo2}o|X+yW$5P11C|LjDMP}dX%ayIm%b_hqO3x9Cra#+>6cIYrBq)j2b*@#DB*Vh#s6XWiBEG1yQKRBJhxzmXq|gI7Hd*R!QLl`Xz95d{*}i+mJ(l%h0!4R8)KG(;adjU zd&@*E@)zhgVG8WWp8||c14`^^xS7*yGxNtWpO8y3Pb=c*Te1omY}qx>SA5mN8byrvzVIQb zSCz?2{51L<7>gakA6PUqg+ZeN)(k&lKmbWmJ!u3hgd2JaD;X-=12jNqD25_VXo

  • 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 My;%Mafr@GWKVpWyZU6uP literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/unicode_utils.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/unicode_utils.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6c26ed55fd384234596aca3234f76f32a3cf4858 GIT binary patch literal 4362 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 H8mZC`w+4N{ literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/warnings.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/__pycache__/warnings.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..07083eed45120336b3b136892b5dbcb44bd7d231 GIT binary patch literal 5170 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 wppH^NMRfj(lC&36^z2n->+GA$M zq+4t?MU@Z|65J9_sHY0`9{_RS#)XSbDx7XP6mja!)VH2^v$g|q)F zOEK>=VWsoZz$pY&M+$ts%fR*!KZ=z_WQ2y*Olf-_A*zTyH&6q`CBxF=N19d2={1`dNp&thGpn-_#}{ixe%rVS*$ne~jT2%q zeW%}Rmep%DLV3JqzwlqNj7rWl7H>}tqoiut@hcX|8x~sxr62b~vu?+CQ4dsc8h_0) zc!AK0<7GDExDt~bwNS6-nYd7mo&xR!|6i7d!6hz*odvdw{`7^vymR-?fiJS3`rUW# zari>Zf8lT}y!$a76Ul1L;6=wv;Rv*P>F~vNCjXWkGJp*`wWFk~euW53-JWF_oqwqlVl-4dvkg ztWC9{vI(g7`pMiOc)yTrIi}wJI-mh?Rw!AZQOzt- zz#*Y_Jm6+6Q&Q22oY&Z8U1uENMLxr{V3D18o>cTt>zMHpsWN?L;e*-PnYlT=pLavN z;SH@)XI#r+jpJK9?iQq?|MWA#V?oE8=XMPb;a>f=o5Bw{FzcUNhzT*51oJ> z=xJciD<^6@XO>ed$?VeR=6dStC!5LaN2x?2nRXOFB@_Q8ais&WpMopJS#g8(U5JQh zV@+VYs5gl`lTXw)pGKy>AOCK=6N$GY@lIr^9a(CrXAY;|dl0=J?M%z(<7z=yln9*>0% zL#MwXUy*}QwB?U>6%-7+qZCuA0IxfMj>0%~8>C_&+_*ce@HeOsvu@! str: + """Reverse RFC-822 escaping by removing leading whitespaces from content.""" + lines = content.splitlines() + if len(lines) == 1: + return lines[0].lstrip() + return '\n'.join((lines[0].lstrip(), textwrap.dedent('\n'.join(lines[1:])))) + + +def _read_field_from_msg(msg: Message, field: str) -> str | None: + """Read Message header field.""" + value = msg[field] + if value == 'UNKNOWN': + return None + return value + + +def _read_field_unescaped_from_msg(msg: Message, field: str) -> str | None: + """Read Message header field and apply rfc822_unescape.""" + value = _read_field_from_msg(msg, field) + if value is None: + return value + return rfc822_unescape(value) + + +def _read_list_from_msg(msg: Message, field: str) -> list[str] | None: + """Read Message header field and return all results as list.""" + values = msg.get_all(field, None) + if values == []: + return None + return values + + +def _read_payload_from_msg(msg: Message) -> str | None: + value = str(msg.get_payload()).strip() + if value == 'UNKNOWN' or not value: + return None + return value + + +def read_pkg_file(self, file): + """Reads the metadata values from a file object.""" + msg = message_from_file(file) + + self.metadata_version = Version(msg['metadata-version']) + self.name = _read_field_from_msg(msg, 'name') + self.version = _read_field_from_msg(msg, 'version') + self.description = _read_field_from_msg(msg, 'summary') + # we are filling author only. + self.author = _read_field_from_msg(msg, 'author') + self.maintainer = None + self.author_email = _read_field_from_msg(msg, 'author-email') + self.maintainer_email = None + self.url = _read_field_from_msg(msg, 'home-page') + self.download_url = _read_field_from_msg(msg, 'download-url') + self.license = _read_field_unescaped_from_msg(msg, 'license') + self.license_expression = _read_field_unescaped_from_msg(msg, 'license-expression') + + self.long_description = _read_field_unescaped_from_msg(msg, 'description') + if self.long_description is None and self.metadata_version >= Version('2.1'): + self.long_description = _read_payload_from_msg(msg) + self.description = _read_field_from_msg(msg, 'summary') + + if 'keywords' in msg: + self.keywords = _read_field_from_msg(msg, 'keywords').split(',') + + self.platforms = _read_list_from_msg(msg, 'platform') + self.classifiers = _read_list_from_msg(msg, 'classifier') + + # PEP 314 - these fields only exist in 1.1 + if self.metadata_version == Version('1.1'): + self.requires = _read_list_from_msg(msg, 'requires') + self.provides = _read_list_from_msg(msg, 'provides') + self.obsoletes = _read_list_from_msg(msg, 'obsoletes') + else: + self.requires = None + self.provides = None + self.obsoletes = None + + self.license_files = _read_list_from_msg(msg, 'license-file') + + +def single_line(val): + """ + Quick and dirty validation for Summary pypa/setuptools#1390. + """ + if '\n' in val: + # TODO: Replace with `raise ValueError("newlines not allowed")` + # after reviewing #2893. + msg = "newlines are not allowed in `summary` and will break in the future" + SetuptoolsDeprecationWarning.emit("Invalid config.", msg) + # due_date is undefined. Controversial change, there was a lot of push back. + val = val.strip().split('\n')[0] + return val + + +def write_pkg_info(self, base_dir): + """Write the PKG-INFO file into the release tree.""" + temp = "" + final = os.path.join(base_dir, 'PKG-INFO') + try: + # Use a temporary file while writing to avoid race conditions + # (e.g. `importlib.metadata` reading `.egg-info/PKG-INFO`): + with NamedTemporaryFile("w", encoding="utf-8", dir=base_dir, delete=False) as f: + temp = f.name + self.write_pkg_file(f) + permissions = stat.S_IMODE(os.lstat(temp).st_mode) + os.chmod(temp, permissions | stat.S_IRGRP | stat.S_IROTH) + os.replace(temp, final) # atomic operation. + finally: + if temp and os.path.exists(temp): + os.remove(temp) + + +# Based on Python 3.5 version +def write_pkg_file(self, file): # noqa: C901 # is too complex (14) # FIXME + """Write the PKG-INFO format data to a file object.""" + version = self.get_metadata_version() + + def write_field(key, value): + file.write(f"{key}: {value}\n") + + write_field('Metadata-Version', str(version)) + write_field('Name', self.get_name()) + write_field('Version', self.get_version()) + + summary = self.get_description() + if summary: + write_field('Summary', single_line(summary)) + + optional_fields = ( + ('Home-page', 'url'), + ('Download-URL', 'download_url'), + ('Author', 'author'), + ('Author-email', 'author_email'), + ('Maintainer', 'maintainer'), + ('Maintainer-email', 'maintainer_email'), + ) + + for field, attr in optional_fields: + attr_val = getattr(self, attr, None) + if attr_val is not None: + write_field(field, attr_val) + + if license_expression := self.license_expression: + write_field('License-Expression', license_expression) + elif license := self.get_license(): + write_field('License', rfc822_escape(license)) + + for label, url in self.project_urls.items(): + write_field('Project-URL', f'{label}, {url}') + + keywords = ','.join(self.get_keywords()) + if keywords: + write_field('Keywords', keywords) + + platforms = self.get_platforms() or [] + for platform in platforms: + write_field('Platform', platform) + + self._write_list(file, 'Classifier', self.get_classifiers()) + + # PEP 314 + self._write_list(file, 'Requires', self.get_requires()) + self._write_list(file, 'Provides', self.get_provides()) + self._write_list(file, 'Obsoletes', self.get_obsoletes()) + + # Setuptools specific for PEP 345 + if hasattr(self, 'python_requires'): + write_field('Requires-Python', self.python_requires) + + # PEP 566 + if self.long_description_content_type: + write_field('Description-Content-Type', self.long_description_content_type) + + safe_license_files = map(_safe_license_file, self.license_files or []) + self._write_list(file, 'License-File', safe_license_files) + _write_requirements(self, file) + + for field, attr in _POSSIBLE_DYNAMIC_FIELDS.items(): + if (val := getattr(self, attr, None)) and not is_static(val): + write_field('Dynamic', field) + + long_description = self.get_long_description() + if long_description: + file.write(f"\n{long_description}") + if not long_description.endswith("\n"): + file.write("\n") + + +def _write_requirements(self, file): + for req in _reqs.parse(self.install_requires): + file.write(f"Requires-Dist: {req}\n") + + processed_extras = {} + for augmented_extra, reqs in self.extras_require.items(): + # Historically, setuptools allows "augmented extras": `:` + unsafe_extra, _, condition = augmented_extra.partition(":") + unsafe_extra = unsafe_extra.strip() + extra = _normalization.safe_extra(unsafe_extra) + + if extra: + _write_provides_extra(file, processed_extras, extra, unsafe_extra) + for req in _reqs.parse_strings(reqs): + r = _include_extra(req, extra, condition.strip()) + file.write(f"Requires-Dist: {r}\n") + + return processed_extras + + +def _include_extra(req: str, extra: str, condition: str) -> Requirement: + r = Requirement(req) # create a fresh object that can be modified + parts = ( + f"({r.marker})" if r.marker else None, + f"({condition})" if condition else None, + f"extra == {extra!r}" if extra else None, + ) + r.marker = Marker(" and ".join(x for x in parts if x)) + return r + + +def _write_provides_extra(file, processed_extras, safe, unsafe): + previous = processed_extras.get(safe) + if previous == unsafe: + SetuptoolsDeprecationWarning.emit( + 'Ambiguity during "extra" normalization for dependencies.', + f""" + {previous!r} and {unsafe!r} normalize to the same value:\n + {safe!r}\n + In future versions, setuptools might halt the build process. + """, + see_url="https://peps.python.org/pep-0685/", + ) + else: + processed_extras[safe] = unsafe + file.write(f"Provides-Extra: {safe}\n") + + +# from pypa/distutils#244; needed only until that logic is always available +def get_fullname(self): + return _distribution_fullname(self.get_name(), self.get_version()) + + +def _distribution_fullname(name: str, version: str) -> str: + """ + >>> _distribution_fullname('setup.tools', '1.0-2') + 'setup_tools-1.0.post2' + >>> _distribution_fullname('setup-tools', '1.2post2') + 'setup_tools-1.2.post2' + >>> _distribution_fullname('setup-tools', '1.0-r2') + 'setup_tools-1.0.post2' + >>> _distribution_fullname('setup.tools', '1.0.post') + 'setup_tools-1.0.post0' + >>> _distribution_fullname('setup.tools', '1.0+ubuntu-1') + 'setup_tools-1.0+ubuntu.1' + """ + return "{}-{}".format( + canonicalize_name(name).replace('-', '_'), + canonicalize_version(version, strip_trailing_zero=False), + ) + + +def _safe_license_file(file): + # XXX: Do we need this after the deprecation discussed in #4892, #4896?? + normalized = os.path.normpath(file).replace(os.sep, "/") + if "../" in normalized: + return os.path.basename(normalized) # Temporarily restore pre PEP639 behaviour + return normalized + + +_POSSIBLE_DYNAMIC_FIELDS = { + # Core Metadata Field x related Distribution attribute + "author": "author", + "author-email": "author_email", + "classifier": "classifiers", + "description": "long_description", + "description-content-type": "long_description_content_type", + "download-url": "download_url", + "home-page": "url", + "keywords": "keywords", + "license": "license", + # XXX: License-File is complicated because the user gives globs that are expanded + # during the build. Without special handling it is likely always + # marked as Dynamic, which is an acceptable outcome according to: + # https://github.com/pypa/setuptools/issues/4629#issuecomment-2331233677 + "license-file": "license_files", + "license-expression": "license_expression", # PEP 639 + "maintainer": "maintainer", + "maintainer-email": "maintainer_email", + "obsoletes": "obsoletes", + # "obsoletes-dist": "obsoletes_dist", # NOT USED + "platform": "platforms", + "project-url": "project_urls", + "provides": "provides", + # "provides-dist": "provides_dist", # NOT USED + "provides-extra": "extras_require", + "requires": "requires", + "requires-dist": "install_requires", + # "requires-external": "requires_external", # NOT USED + "requires-python": "python_requires", + "summary": "description", + # "supported-platform": "supported_platforms", # NOT USED +} diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_discovery.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_discovery.py new file mode 100644 index 000000000..d1b4a0ee0 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_discovery.py @@ -0,0 +1,33 @@ +import functools +import operator + +import packaging.requirements + + +# from coherent.build.discovery +def extras_from_dep(dep): + try: + markers = packaging.requirements.Requirement(dep).marker._markers + except AttributeError: + markers = () + return set( + marker[2].value + for marker in markers + if isinstance(marker, tuple) and marker[0].value == 'extra' + ) + + +def extras_from_deps(deps): + """ + >>> extras_from_deps(['requests']) + set() + >>> extras_from_deps(['pytest; extra == "test"']) + {'test'} + >>> sorted(extras_from_deps([ + ... 'requests', + ... 'pytest; extra == "test"', + ... 'pytest-cov; extra == "test"', + ... 'sphinx; extra=="doc"'])) + ['doc', 'test'] + """ + return functools.reduce(operator.or_, map(extras_from_dep, deps), set()) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__init__.py new file mode 100644 index 000000000..e374d5c56 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__init__.py @@ -0,0 +1,14 @@ +import importlib +import sys + +__version__, _, _ = sys.version.partition(' ') + + +try: + # Allow Debian and pkgsrc (only) to customize system + # behavior. Ref pypa/distutils#2 and pypa/distutils#16. + # This hook is deprecated and no other environments + # should use it. + importlib.import_module('_distutils_system_mod') +except ImportError: + pass diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..038324bd198d07b6f1076aab7f2fc62d1a8b98fa GIT binary patch literal 560 zcmYjNu}&L75S`)9IiDRXfQ%@hh(sC}c$JV6At6B|3xN!&I7M0=+zPLA_MUdvz*SJD zilE{bg7^ezXlQ7#5F$C6NU73Up^02&FJ~uAG4p12-rKi(T`Cp8#MQaq*g=3FX)_Fa z03JUZZ~_4Y7=o8o^pIh5xG`jy+H{^Y0~m~)8SOMaSOA{w<-D8=Bfy~fJexnwfi>Jl zh;as(^9rPeuxYwI*ta%e4=eW1l(N>xm&pVTxY8ZXLq%1rG;7h82rBu+<*i6a9rCTj zG6#vX%cSC>ow$)NHP$@xi?(%Xp~-&$8;_Pr literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/_log.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/_log.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ddce384572ef4b4ff4f965e39115a277e8b466e1 GIT binary patch literal 308 zcmX@j%ge<81jlwKW@rKF#~=<2FhLog^?;1&3@HpLj5!QZ3``8E3|TNam|7sc8p@7h zs$|q;dI{qBX)@np&&f|u&&*4|#hIR3;sa!-7Tsb7imhb$3{vu|T0bK{H&s6|C$&P~ zw=$q8KPxr4q*&iII6&7gKP45y@^o>F56VxDSrBFS3bWW|M4WE@B5t0sx@PQr!Rm literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/_macos_compat.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/_macos_compat.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..aace8e41f5df6027e5e2842972742d786973d20e GIT binary patch literal 597 zcmYk2F>ezw6vve@*W&27_VrZmF ztljz*Kzsyt7N)|`%3Y9{n5f9s2|GtwSWs5c^C!=eS7IOxHiZ$2lMHwNQ^p5amS!k+A9U~C$C?|qCP}(Oww+ot zQ%EC3rg1{Kb|UUEC#ld$Dso9oSC%#!l#=Kw!!xFmEj})!@|&rHy6Hl{R{hAC^AI6)1}kT<^rwN)jq@hd7T)(Jy~Bs!!ds_N=kWDO b)H#kiAKrYAdMDBPakM^(e?)gD@vQh?b?2JC literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/_modified.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/_modified.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a2781ea602a505a2598b87fa05e79d6f6e603927 GIT binary patch literal 4822 zcmbVQUu+b|8K2#~+dJQ#eg20Hgu>V^J|Fd+0}dgzsd2@hia-$pw^0vS=k@KLy?Af; zG_zN8t`k`;5|~DH9+F}ysYE5DVnKx;k^0hysxN)9xu}qZDpX0N=FMOpQl9$F?Cl;l zs6<)oW@qQmH{X2UZ+_o5{zrX%1i|z7zbKQxjUn^}`|zHCTM^b}0iml%MH!?Ds%QuW zF(V4BE*Vlr;_pBv2=9O)7ebj(A)E>G{-9A;h-4y#XeP?PWg}Lo&(uRbq=t=#LOc`a z^*W=m(3EKskchOX8d0OSVmC#1^-MEwtKZPpqBdManbtZ~`%_!g_{BhGi?$^%)LL0h zZB-jD1~Y9?+p?*rO>Kgnc343=|GKyB+FNVW+HW=cnrtge$@ZCjBYHujwo)kKoK+|) zM5mUCtvt@_hDNbss(6A}r6Tp)(qA)?Nx_LKrfJ!Vty?BNl@y)uVZ|_%aYJ*$$8C+U z8nlK^>g>aCLL=p(_H%{6%pffqiv2bCfys%?=*29xiJr6JtNDmd?UJn<^cZMxln{$J zb=k94iR3go@~j^Q;#oXiwn4jDY|->-#hyH=Pig0%XLM5&A2!NX9JflQ3W7!yGNIXY zBv*9^HxGk`gpjcQH>g}iHg9Cb`R7MfTh9mmZoe`s++>@9Cx$Kv^pNl>86kJ{^W`k^ zWV~Yim(BIppE`ojS+pdaN(LO!qE4U)=5b{00$7zgVc2`Y29Ga^j!d~t9ocqG!nTU> zv$?)WtDyBMhIXOvr{&YcIC`Dp)!f?gBge95tZ~ck16Nr@SB$>2Uo-Ua zzGB&)w9NkW-hF)({GTc+xhZ7=W>d{B6>ZBhXkS+KJl&TqSgM}aH8ou8084GRb64=fDL4=r|o8tr)4fUoVp)qJ~ssr~k@rCoR0D#_uMp2L4V zw9;|5(lD|T9{Dob^g;JxcO}}f66heWft(yb$bZ661v7YX!x$^&I7*V1)#q)ssx5c}p_n$bdtz7h#?y%=k_aNDShf zR8WdefT`q25X69TLsi9`kh=#;7~q^Jmziaopfmt24Bsv;8){wCa8gJQ^!CAz4nhF{ z-HuweeX?b-^zn}CGs}rP2P%ofmF6RJCmu!{KWzDMwtT#QtmMxz&6no`(@ezV^Q2$b2j4%=IqWi9+}kLgN<2KgGdM4g?*NpOFC6jPLYz? z$-4%C#{eCmcoEF0LEZ}+$SDLY4({ffV3r~STd07nNl<0lDjBMoU==cj$F-bN0;B6@ zu>=&wNVK}CUOetg;1gLqWAh4%&3M?GS=9%`u};v8+tpjswMNblCjfpHP#_8l>t~?y zk#H5w!&zo$_<}(2D|1jk^i+=#ylOc}46?|ic#6|kQrZ-7lOkb>nG>pR&<(V6E}=D6 z8?y>^6S4e!Oilu^R8V8y~*ac{{O`xSd`~ zLnz)eywW|q5+3H{=EyFlPHnIW+f_fa$=gu*NIZcA2*R^y6tc;81rg1QwOkznWDKn2 zTXa^Kmppd)y>L|!(EB?AsEqzBO$($6#3couT(HzS{W>=R>4j#p6^bgY&$(83R(Ehh zGqnpvGBmUErQ7%Wf59fFp!nuLZ0k>ul#(CCnjcH3ZW~W$?}i7iAG`79@|%_K4^+Yf zk0luJU%uRLaF>t_ZgP$z0jCiR0-n`qpe|%wLeqzDAV%}+;`^iglb15d@YI(}G^JUwP z#doevRNB%{gYdbIq&@N)l7ce#BUqIMNl5D$s0hnxT$NePkzI0g0^@LLNQU{2W?H-p z<~jdnI7+%<`13s@)vMkp7eCYOT~E)|CiP8f6y&n5UGiC&y=J;-VtRtZ;OvLCcgZg)c2tZL=5 zStpXs=1UM2v}~3znsDm!B{Rn_UQP&Z%{)_PX|xm1S&*>h_%%MQjOPf8?}T9ku7>3z z1Pj7$NrVMvr|~@GcR4HV3*$+V6XpLqu;KRB|3f!JlDWc^r{)Cy6@y5e73@yO-NEx5 zjxr|%Iin3%NT+pUDwO3&TtXZq9HP&{2Z6;)hBibFgCKTr>1R-^NrE7JhTi%Lb$)>w zAE1WMQTlV#1)pD`u79EKf5%$x2jVO3C!b1Uy*O9*SVr}&8(N-3Btc$_#f8rMu|sPT zydS|k2ycMA99a*s+8(rjU@g=j4BoHDYZAO4!8-_V7!%vad)C58POaCmwjT7x;96*h zAm6Wldrg8jmk4hd-LRMUu+fqAI@UIXwkAI)-)rw#ZST3U^Ukk6Z9lP!TKU%h2Oq-H AtpET3 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/_msvccompiler.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/_msvccompiler.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d844c6416964617e1cf63c6c2377c791d6a3914f GIT binary patch literal 755 zcmYjPzi-n(6uz?)+s%)rQab>G#t0$RLt|*!s1PU=iJ_q)5Z-#bORf`}_%YoYO1g}Vte@Qn4PyWu<4nD-oyiWs zfk`Ih{Z>-gs=ugKX&46tvz98Qrc0onF_G>F?8?SFD*&+DVs@&V4wrId^tF%EIs_t< z7P>}?E@K^txis4aDeEnC^jebl+E{q~mWQMMn}`1;cEIhJ1$`v&efwn)`8JAdL z8xKT>M(dTkYc3B2UX4*}2el=eW6_HRrG&fQY-ZO}SJRqaN+ljhIg|uQ4(fTVC0EFKh(3$=4yo6DUWU}5P;srW zfMYVXEJ;4?!YkE@CW+~Jh!D?9taK|_R-T-6{Q%g!!UgFrtc{TRJ%S&wMVTtK_)Y2l j=n%r6p!6HuIL%)j<*p6Q)6(MM-of6mFg6TWo_yjj6WzPL literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/archive_util.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/archive_util.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a7c23e81e19509707122e80b90d3c2a2901e9b8f GIT binary patch literal 10872 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

    6+)#AfYA(J^Ey5=QY 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 V``%dEPERel z#R`^M$?zGZ=U0t>Mt*Lpeqv5)g}!fPKv8~HYH~@jzH4xRu3vsiDum_f;uas2pOjys zUs763Ri~zc_4i^HWN5QtgVkfsO%rsaO_Bd|+l|WW3G5`GJFhle?d* WldGSvlkbAK#$^u8M%E%upb7v7&01>! literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/dep_util.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/dep_util.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e932f00af44a2e22389b05eaf2151eb1caa2b367 GIT binary patch literal 745 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/errors.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/errors.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2f7a50ca47f9541782d647feaf872c1e248e276e GIT binary patch literal 4560 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/extension.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/extension.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..730dc587e0db314f0a5aac636dd6d8eb284385fe GIT binary patch literal 10283 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 KTDWR<8~-1GrgwS( literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/sysconfig.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/sysconfig.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..45d6683edcc9b14518cad474104bcb61d9ff024c GIT binary patch literal 23141 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/unixccompiler.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/unixccompiler.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..df6f13683d61944226cb22d8af93aa0296f6986c GIT binary patch literal 448 zcmYLFJxc>Y5S_i8k{AvG3Q1!vDRPV2icM6oFa$rEG~sf)n2mec<8}{nRw?`gR{0I$ zPq4SKQBZ`l5yT>0AYCeVy?jiu^X4&c=FPr1&Iagse)78SI{%nr5xF^-UTQD`0t9hr z0kKGqqrhre2&mOtU$n1s%eH_*?|<@&HHg@cC}R*LsJb>bMPqEZDoX9R&jz=fgh>@E z#-;1~A_y6$QFT2nupktX;;fSv7qoQik*&39zCLeEohv<~zA7_SI}jx1^Z}-3;p`4~ zML@B~=>VT4%}Dg9uOvRcXx18n&_poG& z)qkEe~?TWR^e3TpdP^Hf8=m?&xQdLkN9A=@+)YOIsu7 a-WfWRJfO<3@CoHND8E)}AK*qs-TMc_279jn literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/util.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/__pycache__/util.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e7545511746c1b8e7881be0c6163246c892d1334 GIT binary patch literal 19513 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 BTh9Oh literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_log.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_log.py new file mode 100644 index 000000000..0148f157f --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_log.py @@ -0,0 +1,3 @@ +import logging + +log = logging.getLogger() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_macos_compat.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_macos_compat.py new file mode 100644 index 000000000..76ecb96ab --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_macos_compat.py @@ -0,0 +1,12 @@ +import importlib +import sys + + +def bypass_compiler_fixup(cmd, args): + return cmd + + +if sys.platform == 'darwin': + compiler_fixup = importlib.import_module('_osx_support').compiler_fixup +else: + compiler_fixup = bypass_compiler_fixup diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_modified.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_modified.py new file mode 100644 index 000000000..f64cab7d6 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_modified.py @@ -0,0 +1,95 @@ +"""Timestamp comparison of files and groups of files.""" + +from __future__ import annotations + +import functools +import os.path +from collections.abc import Callable, Iterable +from typing import Literal, TypeVar + +from jaraco.functools import splat + +from .compat.py39 import zip_strict +from .errors import DistutilsFileError + +_SourcesT = TypeVar( + "_SourcesT", bound="str | bytes | os.PathLike[str] | os.PathLike[bytes]" +) +_TargetsT = TypeVar( + "_TargetsT", bound="str | bytes | os.PathLike[str] | os.PathLike[bytes]" +) + + +def _newer(source, target): + return not os.path.exists(target) or ( + os.path.getmtime(source) > os.path.getmtime(target) + ) + + +def newer( + source: str | bytes | os.PathLike[str] | os.PathLike[bytes], + target: str | bytes | os.PathLike[str] | os.PathLike[bytes], +) -> bool: + """ + Is source modified more recently than target. + + Returns True if 'source' is modified more recently than + 'target' or if 'target' does not exist. + + Raises DistutilsFileError if 'source' does not exist. + """ + if not os.path.exists(source): + raise DistutilsFileError(f"file {os.path.abspath(source)!r} does not exist") + + return _newer(source, target) + + +def newer_pairwise( + sources: Iterable[_SourcesT], + targets: Iterable[_TargetsT], + newer: Callable[[_SourcesT, _TargetsT], bool] = newer, +) -> tuple[list[_SourcesT], list[_TargetsT]]: + """ + Filter filenames where sources are newer than targets. + + Walk two filename iterables in parallel, testing if each source is newer + than its corresponding target. Returns a pair of lists (sources, + targets) where source is newer than target, according to the semantics + of 'newer()'. + """ + newer_pairs = filter(splat(newer), zip_strict(sources, targets)) + return tuple(map(list, zip(*newer_pairs))) or ([], []) + + +def newer_group( + sources: Iterable[str | bytes | os.PathLike[str] | os.PathLike[bytes]], + target: str | bytes | os.PathLike[str] | os.PathLike[bytes], + missing: Literal["error", "ignore", "newer"] = "error", +) -> bool: + """ + Is target out-of-date with respect to any file in sources. + + Return True if 'target' is out-of-date with respect to any file + listed in 'sources'. In other words, if 'target' exists and is newer + than every file in 'sources', return False; otherwise return True. + ``missing`` controls how to handle a missing source file: + + - error (default): allow the ``stat()`` call to fail. + - ignore: silently disregard any missing source files. + - newer: treat missing source files as "target out of date". This + mode is handy in "dry-run" mode: it will pretend to carry out + commands that wouldn't work because inputs are missing, but + that doesn't matter because dry-run won't run the commands. + """ + + def missing_as_newer(source): + return missing == 'newer' and not os.path.exists(source) + + ignored = os.path.exists if missing == 'ignore' else None + return not os.path.exists(target) or any( + missing_as_newer(source) or _newer(source, target) + for source in filter(ignored, sources) + ) + + +newer_pairwise_group = functools.partial(newer_pairwise, newer=newer_group) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_msvccompiler.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_msvccompiler.py new file mode 100644 index 000000000..d07c86ef8 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/_msvccompiler.py @@ -0,0 +1,16 @@ +import warnings + +from .compilers.C import msvc + +__all__ = ["MSVCCompiler"] + +MSVCCompiler = msvc.Compiler + + +def __getattr__(name): + if name == '_get_vc_env': + warnings.warn( + "_get_vc_env is private; find an alternative (pypa/distutils#340)" + ) + return msvc._get_vc_env + raise AttributeError(name) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/archive_util.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/archive_util.py new file mode 100644 index 000000000..d860f5527 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/archive_util.py @@ -0,0 +1,294 @@ +"""distutils.archive_util + +Utility functions for creating archive files (tarballs, zip files, +that sort of thing).""" + +from __future__ import annotations + +import os +from typing import Literal, overload + +try: + import zipfile +except ImportError: + zipfile = None + + +from ._log import log +from .dir_util import mkpath +from .errors import DistutilsExecError +from .spawn import spawn + +try: + from pwd import getpwnam +except ImportError: + getpwnam = None + +try: + from grp import getgrnam +except ImportError: + getgrnam = None + + +def _get_gid(name): + """Returns a gid, given a group name.""" + if getgrnam is None or name is None: + return None + try: + result = getgrnam(name) + except KeyError: + result = None + if result is not None: + return result[2] + return None + + +def _get_uid(name): + """Returns an uid, given a user name.""" + if getpwnam is None or name is None: + return None + try: + result = getpwnam(name) + except KeyError: + result = None + if result is not None: + return result[2] + return None + + +def make_tarball( + base_name: str, + base_dir: str | os.PathLike[str], + compress: Literal["gzip", "bzip2", "xz"] | None = "gzip", + verbose: bool = False, + dry_run: bool = False, + owner: str | None = None, + group: str | None = None, +) -> str: + """Create a (possibly compressed) tar file from all the files under + 'base_dir'. + + 'compress' must be "gzip" (the default), "bzip2", "xz", or None. + + 'owner' and 'group' can be used to define an owner and a group for the + archive that is being built. If not provided, the current owner and group + will be used. + + The output tar file will be named 'base_dir' + ".tar", possibly plus + the appropriate compression extension (".gz", ".bz2", ".xz" or ".Z"). + + Returns the output filename. + """ + tar_compression = { + 'gzip': 'gz', + 'bzip2': 'bz2', + 'xz': 'xz', + None: '', + } + compress_ext = {'gzip': '.gz', 'bzip2': '.bz2', 'xz': '.xz'} + + # flags for compression program, each element of list will be an argument + if compress is not None and compress not in compress_ext.keys(): + raise ValueError( + "bad value for 'compress': must be None, 'gzip', 'bzip2', 'xz'" + ) + + archive_name = base_name + '.tar' + archive_name += compress_ext.get(compress, '') + + mkpath(os.path.dirname(archive_name), dry_run=dry_run) + + # creating the tarball + import tarfile # late import so Python build itself doesn't break + + log.info('Creating tar archive') + + uid = _get_uid(owner) + gid = _get_gid(group) + + def _set_uid_gid(tarinfo): + if gid is not None: + tarinfo.gid = gid + tarinfo.gname = group + if uid is not None: + tarinfo.uid = uid + tarinfo.uname = owner + return tarinfo + + if not dry_run: + tar = tarfile.open(archive_name, f'w|{tar_compression[compress]}') + try: + tar.add(base_dir, filter=_set_uid_gid) + finally: + tar.close() + + return archive_name + + +def make_zipfile( # noqa: C901 + base_name: str, + base_dir: str | os.PathLike[str], + verbose: bool = False, + dry_run: bool = False, +) -> str: + """Create a zip file from all the files under 'base_dir'. + + The output zip file will be named 'base_name' + ".zip". Uses either the + "zipfile" Python module (if available) or the InfoZIP "zip" utility + (if installed and found on the default search path). If neither tool is + available, raises DistutilsExecError. Returns the name of the output zip + file. + """ + zip_filename = base_name + ".zip" + mkpath(os.path.dirname(zip_filename), dry_run=dry_run) + + # If zipfile module is not available, try spawning an external + # 'zip' command. + if zipfile is None: + if verbose: + zipoptions = "-r" + else: + zipoptions = "-rq" + + try: + spawn(["zip", zipoptions, zip_filename, base_dir], dry_run=dry_run) + except DistutilsExecError: + # XXX really should distinguish between "couldn't find + # external 'zip' command" and "zip failed". + raise DistutilsExecError( + f"unable to create zip file '{zip_filename}': " + "could neither import the 'zipfile' module nor " + "find a standalone zip utility" + ) + + else: + log.info("creating '%s' and adding '%s' to it", zip_filename, base_dir) + + if not dry_run: + try: + zip = zipfile.ZipFile( + zip_filename, "w", compression=zipfile.ZIP_DEFLATED + ) + except RuntimeError: + zip = zipfile.ZipFile(zip_filename, "w", compression=zipfile.ZIP_STORED) + + with zip: + if base_dir != os.curdir: + path = os.path.normpath(os.path.join(base_dir, '')) + zip.write(path, path) + log.info("adding '%s'", path) + for dirpath, dirnames, filenames in os.walk(base_dir): + for name in dirnames: + path = os.path.normpath(os.path.join(dirpath, name, '')) + zip.write(path, path) + log.info("adding '%s'", path) + for name in filenames: + path = os.path.normpath(os.path.join(dirpath, name)) + if os.path.isfile(path): + zip.write(path, path) + log.info("adding '%s'", path) + + return zip_filename + + +ARCHIVE_FORMATS = { + 'gztar': (make_tarball, [('compress', 'gzip')], "gzip'ed tar-file"), + 'bztar': (make_tarball, [('compress', 'bzip2')], "bzip2'ed tar-file"), + 'xztar': (make_tarball, [('compress', 'xz')], "xz'ed tar-file"), + 'ztar': (make_tarball, [('compress', 'compress')], "compressed tar file"), + 'tar': (make_tarball, [('compress', None)], "uncompressed tar file"), + 'zip': (make_zipfile, [], "ZIP file"), +} + + +def check_archive_formats(formats): + """Returns the first format from the 'format' list that is unknown. + + If all formats are known, returns None + """ + for format in formats: + if format not in ARCHIVE_FORMATS: + return format + return None + + +@overload +def make_archive( + base_name: str, + format: str, + root_dir: str | os.PathLike[str] | bytes | os.PathLike[bytes] | None = None, + base_dir: str | None = None, + verbose: bool = False, + dry_run: bool = False, + owner: str | None = None, + group: str | None = None, +) -> str: ... +@overload +def make_archive( + base_name: str | os.PathLike[str], + format: str, + root_dir: str | os.PathLike[str] | bytes | os.PathLike[bytes], + base_dir: str | None = None, + verbose: bool = False, + dry_run: bool = False, + owner: str | None = None, + group: str | None = None, +) -> str: ... +def make_archive( + base_name: str | os.PathLike[str], + format: str, + root_dir: str | os.PathLike[str] | bytes | os.PathLike[bytes] | None = None, + base_dir: str | None = None, + verbose: bool = False, + dry_run: bool = False, + owner: str | None = None, + group: str | None = None, +) -> str: + """Create an archive file (eg. zip or tar). + + 'base_name' is the name of the file to create, minus any format-specific + extension; 'format' is the archive format: one of "zip", "tar", "gztar", + "bztar", "xztar", or "ztar". + + 'root_dir' is a directory that will be the root directory of the + archive; ie. we typically chdir into 'root_dir' before creating the + archive. 'base_dir' is the directory where we start archiving from; + ie. 'base_dir' will be the common prefix of all files and + directories in the archive. 'root_dir' and 'base_dir' both default + to the current directory. Returns the name of the archive file. + + 'owner' and 'group' are used when creating a tar archive. By default, + uses the current owner and group. + """ + save_cwd = os.getcwd() + if root_dir is not None: + log.debug("changing into '%s'", root_dir) + base_name = os.path.abspath(base_name) + if not dry_run: + os.chdir(root_dir) + + if base_dir is None: + base_dir = os.curdir + + kwargs = {'dry_run': dry_run} + + try: + format_info = ARCHIVE_FORMATS[format] + except KeyError: + raise ValueError(f"unknown archive format '{format}'") + + func = format_info[0] + kwargs.update(format_info[1]) + + if format != 'zip': + kwargs['owner'] = owner + kwargs['group'] = group + + try: + filename = func(base_name, base_dir, **kwargs) + finally: + if root_dir is not None: + log.debug("changing back to '%s'", save_cwd) + os.chdir(save_cwd) + + return filename diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/ccompiler.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/ccompiler.py new file mode 100644 index 000000000..58bc6a55e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/ccompiler.py @@ -0,0 +1,26 @@ +from .compat.numpy import ( # noqa: F401 + _default_compilers, + compiler_class, +) +from .compilers.C import base +from .compilers.C.base import ( + gen_lib_options, + gen_preprocess_options, + get_default_compiler, + new_compiler, + show_compilers, +) +from .compilers.C.errors import CompileError, LinkError + +__all__ = [ + 'CompileError', + 'LinkError', + 'gen_lib_options', + 'gen_preprocess_options', + 'get_default_compiler', + 'new_compiler', + 'show_compilers', +] + + +CCompiler = base.Compiler diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/cmd.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/cmd.py new file mode 100644 index 000000000..241621bd5 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/cmd.py @@ -0,0 +1,554 @@ +"""distutils.cmd + +Provides the Command class, the base class for the command classes +in the distutils.command package. +""" + +from __future__ import annotations + +import logging +import os +import re +import sys +from abc import abstractmethod +from collections.abc import Callable, MutableSequence +from typing import TYPE_CHECKING, Any, ClassVar, TypeVar, overload + +from . import _modified, archive_util, dir_util, file_util, util +from ._log import log +from .errors import DistutilsOptionError + +if TYPE_CHECKING: + # type-only import because of mutual dependence between these classes + from distutils.dist import Distribution + + from typing_extensions import TypeVarTuple, Unpack + + _Ts = TypeVarTuple("_Ts") + +_StrPathT = TypeVar("_StrPathT", bound="str | os.PathLike[str]") +_BytesPathT = TypeVar("_BytesPathT", bound="bytes | os.PathLike[bytes]") +_CommandT = TypeVar("_CommandT", bound="Command") + + +class Command: + """Abstract base class for defining command classes, the "worker bees" + of the Distutils. A useful analogy for command classes is to think of + them as subroutines with local variables called "options". The options + are "declared" in 'initialize_options()' and "defined" (given their + final values, aka "finalized") in 'finalize_options()', both of which + must be defined by every command class. The distinction between the + two is necessary because option values might come from the outside + world (command line, config file, ...), and any options dependent on + other options must be computed *after* these outside influences have + been processed -- hence 'finalize_options()'. The "body" of the + subroutine, where it does all its work based on the values of its + options, is the 'run()' method, which must also be implemented by every + command class. + """ + + # 'sub_commands' formalizes the notion of a "family" of commands, + # eg. "install" as the parent with sub-commands "install_lib", + # "install_headers", etc. The parent of a family of commands + # defines 'sub_commands' as a class attribute; it's a list of + # (command_name : string, predicate : unbound_method | string | None) + # tuples, where 'predicate' is a method of the parent command that + # determines whether the corresponding command is applicable in the + # current situation. (Eg. we "install_headers" is only applicable if + # we have any C header files to install.) If 'predicate' is None, + # that command is always applicable. + # + # 'sub_commands' is usually defined at the *end* of a class, because + # predicates can be unbound methods, so they must already have been + # defined. The canonical example is the "install" command. + sub_commands: ClassVar[ # Any to work around variance issues + list[tuple[str, Callable[[Any], bool] | None]] + ] = [] + + user_options: ClassVar[ + # Specifying both because list is invariant. Avoids mypy override assignment issues + list[tuple[str, str, str]] | list[tuple[str, str | None, str]] + ] = [] + + # -- Creation/initialization methods ------------------------------- + + def __init__(self, dist: Distribution) -> None: + """Create and initialize a new Command object. Most importantly, + invokes the 'initialize_options()' method, which is the real + initializer and depends on the actual command being + instantiated. + """ + # late import because of mutual dependence between these classes + from distutils.dist import Distribution + + if not isinstance(dist, Distribution): + raise TypeError("dist must be a Distribution instance") + if self.__class__ is Command: + raise RuntimeError("Command is an abstract class") + + self.distribution = dist + self.initialize_options() + + # Per-command versions of the global flags, so that the user can + # customize Distutils' behaviour command-by-command and let some + # commands fall back on the Distribution's behaviour. None means + # "not defined, check self.distribution's copy", while 0 or 1 mean + # false and true (duh). Note that this means figuring out the real + # value of each flag is a touch complicated -- hence "self._dry_run" + # will be handled by __getattr__, below. + # XXX This needs to be fixed. + self._dry_run = None + + # verbose is largely ignored, but needs to be set for + # backwards compatibility (I think)? + self.verbose = dist.verbose + + # Some commands define a 'self.force' option to ignore file + # timestamps, but methods defined *here* assume that + # 'self.force' exists for all commands. So define it here + # just to be safe. + self.force = None + + # The 'help' flag is just used for command-line parsing, so + # none of that complicated bureaucracy is needed. + self.help = False + + # 'finalized' records whether or not 'finalize_options()' has been + # called. 'finalize_options()' itself should not pay attention to + # this flag: it is the business of 'ensure_finalized()', which + # always calls 'finalize_options()', to respect/update it. + self.finalized = False + + # XXX A more explicit way to customize dry_run would be better. + def __getattr__(self, attr): + if attr == 'dry_run': + myval = getattr(self, "_" + attr) + if myval is None: + return getattr(self.distribution, attr) + else: + return myval + else: + raise AttributeError(attr) + + def ensure_finalized(self) -> None: + if not self.finalized: + self.finalize_options() + self.finalized = True + + # Subclasses must define: + # initialize_options() + # provide default values for all options; may be customized by + # setup script, by options from config file(s), or by command-line + # options + # finalize_options() + # decide on the final values for all options; this is called + # after all possible intervention from the outside world + # (command-line, option file, etc.) has been processed + # run() + # run the command: do whatever it is we're here to do, + # controlled by the command's various option values + + @abstractmethod + def initialize_options(self) -> None: + """Set default values for all the options that this command + supports. Note that these defaults may be overridden by other + commands, by the setup script, by config files, or by the + command-line. Thus, this is not the place to code dependencies + between options; generally, 'initialize_options()' implementations + are just a bunch of "self.foo = None" assignments. + + This method must be implemented by all command classes. + """ + raise RuntimeError( + f"abstract method -- subclass {self.__class__} must override" + ) + + @abstractmethod + def finalize_options(self) -> None: + """Set final values for all the options that this command supports. + This is always called as late as possible, ie. after any option + assignments from the command-line or from other commands have been + done. Thus, this is the place to code option dependencies: if + 'foo' depends on 'bar', then it is safe to set 'foo' from 'bar' as + long as 'foo' still has the same value it was assigned in + 'initialize_options()'. + + This method must be implemented by all command classes. + """ + raise RuntimeError( + f"abstract method -- subclass {self.__class__} must override" + ) + + def dump_options(self, header=None, indent=""): + from distutils.fancy_getopt import longopt_xlate + + if header is None: + header = f"command options for '{self.get_command_name()}':" + self.announce(indent + header, level=logging.INFO) + indent = indent + " " + for option, _, _ in self.user_options: + option = option.translate(longopt_xlate) + if option[-1] == "=": + option = option[:-1] + value = getattr(self, option) + self.announce(indent + f"{option} = {value}", level=logging.INFO) + + @abstractmethod + def run(self) -> None: + """A command's raison d'etre: carry out the action it exists to + perform, controlled by the options initialized in + 'initialize_options()', customized by other commands, the setup + script, the command-line, and config files, and finalized in + 'finalize_options()'. All terminal output and filesystem + interaction should be done by 'run()'. + + This method must be implemented by all command classes. + """ + raise RuntimeError( + f"abstract method -- subclass {self.__class__} must override" + ) + + def announce(self, msg: object, level: int = logging.DEBUG) -> None: + log.log(level, msg) + + def debug_print(self, msg: object) -> None: + """Print 'msg' to stdout if the global DEBUG (taken from the + DISTUTILS_DEBUG environment variable) flag is true. + """ + from distutils.debug import DEBUG + + if DEBUG: + print(msg) + sys.stdout.flush() + + # -- Option validation methods ------------------------------------- + # (these are very handy in writing the 'finalize_options()' method) + # + # NB. the general philosophy here is to ensure that a particular option + # value meets certain type and value constraints. If not, we try to + # force it into conformance (eg. if we expect a list but have a string, + # split the string on comma and/or whitespace). If we can't force the + # option into conformance, raise DistutilsOptionError. Thus, command + # classes need do nothing more than (eg.) + # self.ensure_string_list('foo') + # and they can be guaranteed that thereafter, self.foo will be + # a list of strings. + + def _ensure_stringlike(self, option, what, default=None): + val = getattr(self, option) + if val is None: + setattr(self, option, default) + return default + elif not isinstance(val, str): + raise DistutilsOptionError(f"'{option}' must be a {what} (got `{val}`)") + return val + + def ensure_string(self, option: str, default: str | None = None) -> None: + """Ensure that 'option' is a string; if not defined, set it to + 'default'. + """ + self._ensure_stringlike(option, "string", default) + + def ensure_string_list(self, option: str) -> None: + r"""Ensure that 'option' is a list of strings. If 'option' is + currently a string, we split it either on /,\s*/ or /\s+/, so + "foo bar baz", "foo,bar,baz", and "foo, bar baz" all become + ["foo", "bar", "baz"]. + """ + val = getattr(self, option) + if val is None: + return + elif isinstance(val, str): + setattr(self, option, re.split(r',\s*|\s+', val)) + else: + if isinstance(val, list): + ok = all(isinstance(v, str) for v in val) + else: + ok = False + if not ok: + raise DistutilsOptionError( + f"'{option}' must be a list of strings (got {val!r})" + ) + + def _ensure_tested_string(self, option, tester, what, error_fmt, default=None): + val = self._ensure_stringlike(option, what, default) + if val is not None and not tester(val): + raise DistutilsOptionError( + ("error in '%s' option: " + error_fmt) % (option, val) + ) + + def ensure_filename(self, option: str) -> None: + """Ensure that 'option' is the name of an existing file.""" + self._ensure_tested_string( + option, os.path.isfile, "filename", "'%s' does not exist or is not a file" + ) + + def ensure_dirname(self, option: str) -> None: + self._ensure_tested_string( + option, + os.path.isdir, + "directory name", + "'%s' does not exist or is not a directory", + ) + + # -- Convenience methods for commands ------------------------------ + + def get_command_name(self) -> str: + if hasattr(self, 'command_name'): + return self.command_name + else: + return self.__class__.__name__ + + def set_undefined_options( + self, src_cmd: str, *option_pairs: tuple[str, str] + ) -> None: + """Set the values of any "undefined" options from corresponding + option values in some other command object. "Undefined" here means + "is None", which is the convention used to indicate that an option + has not been changed between 'initialize_options()' and + 'finalize_options()'. Usually called from 'finalize_options()' for + options that depend on some other command rather than another + option of the same command. 'src_cmd' is the other command from + which option values will be taken (a command object will be created + for it if necessary); the remaining arguments are + '(src_option,dst_option)' tuples which mean "take the value of + 'src_option' in the 'src_cmd' command object, and copy it to + 'dst_option' in the current command object". + """ + # Option_pairs: list of (src_option, dst_option) tuples + src_cmd_obj = self.distribution.get_command_obj(src_cmd) + src_cmd_obj.ensure_finalized() + for src_option, dst_option in option_pairs: + if getattr(self, dst_option) is None: + setattr(self, dst_option, getattr(src_cmd_obj, src_option)) + + # NOTE: Because distutils is private to Setuptools and not all commands are exposed here, + # not every possible command is enumerated in the signature. + def get_finalized_command(self, command: str, create: bool = True) -> Command: + """Wrapper around Distribution's 'get_command_obj()' method: find + (create if necessary and 'create' is true) the command object for + 'command', call its 'ensure_finalized()' method, and return the + finalized command object. + """ + cmd_obj = self.distribution.get_command_obj(command, create) + cmd_obj.ensure_finalized() + return cmd_obj + + # XXX rename to 'get_reinitialized_command()'? (should do the + # same in dist.py, if so) + @overload + def reinitialize_command( + self, command: str, reinit_subcommands: bool = False + ) -> Command: ... + @overload + def reinitialize_command( + self, command: _CommandT, reinit_subcommands: bool = False + ) -> _CommandT: ... + def reinitialize_command( + self, command: str | Command, reinit_subcommands=False + ) -> Command: + return self.distribution.reinitialize_command(command, reinit_subcommands) + + def run_command(self, command: str) -> None: + """Run some other command: uses the 'run_command()' method of + Distribution, which creates and finalizes the command object if + necessary and then invokes its 'run()' method. + """ + self.distribution.run_command(command) + + def get_sub_commands(self) -> list[str]: + """Determine the sub-commands that are relevant in the current + distribution (ie., that need to be run). This is based on the + 'sub_commands' class attribute: each tuple in that list may include + a method that we call to determine if the subcommand needs to be + run for the current distribution. Return a list of command names. + """ + commands = [] + for cmd_name, method in self.sub_commands: + if method is None or method(self): + commands.append(cmd_name) + return commands + + # -- External world manipulation ----------------------------------- + + def warn(self, msg: object) -> None: + log.warning("warning: %s: %s\n", self.get_command_name(), msg) + + def execute( + self, + func: Callable[[Unpack[_Ts]], object], + args: tuple[Unpack[_Ts]], + msg: object = None, + level: int = 1, + ) -> None: + util.execute(func, args, msg, dry_run=self.dry_run) + + def mkpath(self, name: str, mode: int = 0o777) -> None: + dir_util.mkpath(name, mode, dry_run=self.dry_run) + + @overload + def copy_file( + self, + infile: str | os.PathLike[str], + outfile: _StrPathT, + preserve_mode: bool = True, + preserve_times: bool = True, + link: str | None = None, + level: int = 1, + ) -> tuple[_StrPathT | str, bool]: ... + @overload + def copy_file( + self, + infile: bytes | os.PathLike[bytes], + outfile: _BytesPathT, + preserve_mode: bool = True, + preserve_times: bool = True, + link: str | None = None, + level: int = 1, + ) -> tuple[_BytesPathT | bytes, bool]: ... + def copy_file( + self, + infile: str | os.PathLike[str] | bytes | os.PathLike[bytes], + outfile: str | os.PathLike[str] | bytes | os.PathLike[bytes], + preserve_mode: bool = True, + preserve_times: bool = True, + link: str | None = None, + level: int = 1, + ) -> tuple[str | os.PathLike[str] | bytes | os.PathLike[bytes], bool]: + """Copy a file respecting verbose, dry-run and force flags. (The + former two default to whatever is in the Distribution object, and + the latter defaults to false for commands that don't define it.)""" + return file_util.copy_file( + infile, + outfile, + preserve_mode, + preserve_times, + not self.force, + link, + dry_run=self.dry_run, + ) + + def copy_tree( + self, + infile: str | os.PathLike[str], + outfile: str, + preserve_mode: bool = True, + preserve_times: bool = True, + preserve_symlinks: bool = False, + level: int = 1, + ) -> list[str]: + """Copy an entire directory tree respecting verbose, dry-run, + and force flags. + """ + return dir_util.copy_tree( + infile, + outfile, + preserve_mode, + preserve_times, + preserve_symlinks, + not self.force, + dry_run=self.dry_run, + ) + + @overload + def move_file( + self, src: str | os.PathLike[str], dst: _StrPathT, level: int = 1 + ) -> _StrPathT | str: ... + @overload + def move_file( + self, src: bytes | os.PathLike[bytes], dst: _BytesPathT, level: int = 1 + ) -> _BytesPathT | bytes: ... + def move_file( + self, + src: str | os.PathLike[str] | bytes | os.PathLike[bytes], + dst: str | os.PathLike[str] | bytes | os.PathLike[bytes], + level: int = 1, + ) -> str | os.PathLike[str] | bytes | os.PathLike[bytes]: + """Move a file respecting dry-run flag.""" + return file_util.move_file(src, dst, dry_run=self.dry_run) + + def spawn( + self, cmd: MutableSequence[str], search_path: bool = True, level: int = 1 + ) -> None: + """Spawn an external command respecting dry-run flag.""" + from distutils.spawn import spawn + + spawn(cmd, search_path, dry_run=self.dry_run) + + @overload + def make_archive( + self, + base_name: str, + format: str, + root_dir: str | os.PathLike[str] | bytes | os.PathLike[bytes] | None = None, + base_dir: str | None = None, + owner: str | None = None, + group: str | None = None, + ) -> str: ... + @overload + def make_archive( + self, + base_name: str | os.PathLike[str], + format: str, + root_dir: str | os.PathLike[str] | bytes | os.PathLike[bytes], + base_dir: str | None = None, + owner: str | None = None, + group: str | None = None, + ) -> str: ... + def make_archive( + self, + base_name: str | os.PathLike[str], + format: str, + root_dir: str | os.PathLike[str] | bytes | os.PathLike[bytes] | None = None, + base_dir: str | None = None, + owner: str | None = None, + group: str | None = None, + ) -> str: + return archive_util.make_archive( + base_name, + format, + root_dir, + base_dir, + dry_run=self.dry_run, + owner=owner, + group=group, + ) + + def make_file( + self, + infiles: str | list[str] | tuple[str, ...], + outfile: str | os.PathLike[str] | bytes | os.PathLike[bytes], + func: Callable[[Unpack[_Ts]], object], + args: tuple[Unpack[_Ts]], + exec_msg: object = None, + skip_msg: object = None, + level: int = 1, + ) -> None: + """Special case of 'execute()' for operations that process one or + more input files and generate one output file. Works just like + 'execute()', except the operation is skipped and a different + message printed if 'outfile' already exists and is newer than all + files listed in 'infiles'. If the command defined 'self.force', + and it is true, then the command is unconditionally run -- does no + timestamp checks. + """ + if skip_msg is None: + skip_msg = f"skipping {outfile} (inputs unchanged)" + + # Allow 'infiles' to be a single string + if isinstance(infiles, str): + infiles = (infiles,) + elif not isinstance(infiles, (list, tuple)): + raise TypeError("'infiles' must be a string, or a list or tuple of strings") + + if exec_msg is None: + exec_msg = "generating {} from {}".format(outfile, ', '.join(infiles)) + + # If 'outfile' must be regenerated (either because it doesn't + # exist, is out-of-date, or the 'force' flag is true) then + # perform the action that presumably regenerates it + if self.force or _modified.newer_group(infiles, outfile): + self.execute(func, args, exec_msg, level) + # Otherwise, print the "skip" message + else: + log.debug(skip_msg) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__init__.py new file mode 100644 index 000000000..0f8a1692b --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__init__.py @@ -0,0 +1,23 @@ +"""distutils.command + +Package containing implementation of all the standard Distutils +commands.""" + +__all__ = [ + 'build', + 'build_py', + 'build_ext', + 'build_clib', + 'build_scripts', + 'clean', + 'install', + 'install_lib', + 'install_headers', + 'install_scripts', + 'install_data', + 'sdist', + 'bdist', + 'bdist_dumb', + 'bdist_rpm', + 'check', +] diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3416ec8a2b0b16ef92c9a716fab85b6123b76af0 GIT binary patch literal 543 zcmYL`u};G<5Qd#pRZB`lJ0RAq9U2Q*5mP~8psHZ2kSy0Wjj0nyu_HBXuxPg*IJ^D2jE9?z|qGKI1ZGZ3Pw6d8(xp3Zhb0wH3G>CPc_?LL(HW#in}_OPULInjKhOcI7|~ Y?D5rd9Ov6@IsT6~=(!J_Y~N;o0e(ch=l}o! literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/_framework_compat.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/_framework_compat.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..15ef8e5cc5e29f61e029934e3c1a7d0ee6118b8c GIT binary patch literal 2647 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/bdist_dumb.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/bdist_dumb.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..587252b2fde4dcaeab1d967eb7253cad47707797 GIT binary patch literal 5616 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

    q)Axa{Rx6BGmXL^5UxGJB!PvK5vc69-t7*U&d~I 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 J3csX^{{u%;fZG57 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/build.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/build.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4b480a81f013266425da26be558f3cccbdc19cee GIT binary patch literal 6309 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/build_clib.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/build_clib.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c68690dcc92572a9de6da72cbcba906caa4009de GIT binary patch literal 7649 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¥aO3FpqpRb0yIxp40oRqwxof$N*hn=tQVX}&y83RseEsEG zdrz$gyng5M!nK9X0BIlHBJTFk;;Wl665L}Xfg@E8Iac%AcS4WAYD4xP%Fg zeoY*~&{r?O;;5^F|A*X0q^SfNSBj zlA#y<3b=Zrx1>@H|4pS*3L;lQ1y>NM$^k4ASiFD*hFZ#TEKXs8XLFO#85xI#Crs#Lj>o-y zE@Nwq>%&&vlS+wl+SrcSB4z`yI<#^|z}b?Pvst(>$G_ypg_*R1%BF|xo9^)x{4ZzV z-VJ}HfQl&?66n6P1%2bb0=G(M)9^=);>W66!hhdX!$*WH9U@F(JXK>8n$-Up=X&t&2O>3l$j9+2V3 Q?wo@OEwz75@J+@31^e<3CIA2c literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/build_ext.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/build_ext.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b9968798f348e5677a98af8b8c778a1e55d8eb86 GIT binary patch literal 30256 zcmchA33Oc7dET21vjQ{Nck*E)Fd!BZ+;>vkH;^VMQHCUshj>G9z`+ds-hd>=pd`C) z52z?1V5b3C+lOGHR8Yj!@QD)3$8IgzC$77k6vKfs<5wzXPL#H4ds>K;Ye&gR`u+E9 z1MpFjleCZEefQmc{kQx7cm6|Rp@+ls+S^%ueK65KKWaG*cH{GM3xa7lm3aA|)j`}W4lhRgfQnco+y7_RKE9IooG8m{iI z9GQ-#pyX-!i zBXKF3hhVjR|~sfC^0r;bes0 zzjm!hFHGY1_3b+y?0TO%5wytOa6Fz!hLfmA>czKfe>fHkpN~c0x5W~Jc)6eKJ9sAa z#J;|REIt;Nq^H8-`&PApc;re%3=N8j(UG84_Te*xx<{h1h$t7KImV}i{LcN#AO#EL zqW$o*bO%K-A<91WQ~4^=$4dDw)4xxRP-~UY3O)36ES$vn4J+ZLdU#(XIXc1usVfJy zK@HmEl7UevnHY|yB1VJD2O~**#VI3kx&@W@#5Vj>>891&?&P=Jqx zs`bkLs1&*&Mk2|JVk9g?1lfgvVa()})P~PJ6Yfmy>+BCbr+Lyetog*mjI?{T6IV>yy}s*o4-IeTZ%4{45;zbxyE-(}vAx7aT%?;1pa~ z>dx2IM2K~N({{locm%KD6AB{*Da7ErNbm~*p;#ypO7*ZZpV?ZTZXVsgp~_j_^J@P;Z{bfhI*FwmA-^^d1coi z-+JV$6?%}PPS^mqUf3aQMA$04H{rb+@6CAg!cJie-VMT5q-w<1HheXWH3oOdZhfDo zwlXijzZ)AWZ_i;{D$BS#7L8w`9jT-fqGDtqnGnZkVSo;$ zP3OltM?^rAfus~nc}B2wJ86BRgpt$^`lKDiQxNrIKukzdr`il^QU@Qsz)PbeD4Kfm zj1ajH9*rfp^B-BB!+vl^<0xYwB3q)VXml{15F^T1P!D-PMt)>8NzjfqeO|XDJ{m`L z1R$lvs5lVejn0H)iTI!t6(al?qEG2KOTEQBfHk45t%aiN&4ZIkVzQbg=cHH8I%C$BaQ9qJMrV>^&7iJ(K|0WifN zIcv%3CTAU-ROx;d!9PQ7dqzr%&pjvm&nFVGNH`u+Ta_xj7>SK&paHd3v5tff^56Czcp;AGrBt?Fl?@h!b%-_Llq{lPQJlDZ1>*+Z>vX3g$svb~@GPIQg z?Z$B+$1D%qRWfy)3$X}t1P)(%YW79x*~7k6LJlb{NNHadrxL(wDFw^ooXfsk%f8&p zzI3e2>hms(^DX--T=rG8?90FGE3oXVc-dFUvM-ftQ2S7(#f@=6Yww|8xtvE8YIqJ% zM|Kk;2r;@xK~N#WCTzvX&XMrIrSM=x_NkjZL_k+AP#~l1U@%X1>p)HRsc=k5=U~f^ z0^^rLD#S2Wq3qK3q->`(FS9)s!XA^|^i4}ZVyjekX`Avj3(`hn7bKc!{-cTRi;3Y# zcQ_Wg+I@2Dw3uK}tNUQz>CWDS5RsVg=z&9_Gl}zwWH$)+gcuFSy1R5A+S{#AdK

    HcoCn&|#+2AGKM?;07COQP{;5=9evsqLCNBgLb! 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 ..." + ) + dir = convert_path(words[1]) + patterns = [convert_path(w) for w in words[2:]] + elif action in ('graft', 'prune'): + if len(words) != 2: + raise DistutilsTemplateError( + f"'{action}' expects a single " + ) + dir_pattern = convert_path(words[1]) + else: + raise DistutilsTemplateError(f"unknown action '{action}'") + + return (action, patterns, dir, dir_pattern) + + def process_template_line(self, line: str) -> None: # noqa: C901 + # 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 (dir_pattern). + (action, patterns, dir, dir_pattern) = self._parse_template_line(line) + + # 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': + self.debug_print("include " + ' '.join(patterns)) + for pattern in patterns: + if not self.include_pattern(pattern, anchor=True): + log.warning("warning: no files found matching '%s'", pattern) + + elif action == 'exclude': + self.debug_print("exclude " + ' '.join(patterns)) + for pattern in patterns: + if not self.exclude_pattern(pattern, anchor=True): + log.warning( + "warning: no previously-included files found matching '%s'", + pattern, + ) + + elif action == 'global-include': + self.debug_print("global-include " + ' '.join(patterns)) + for pattern in patterns: + if not self.include_pattern(pattern, anchor=False): + log.warning( + ( + "warning: no files found matching '%s' " + "anywhere in distribution" + ), + pattern, + ) + + elif action == 'global-exclude': + self.debug_print("global-exclude " + ' '.join(patterns)) + for pattern in patterns: + if not self.exclude_pattern(pattern, anchor=False): + log.warning( + ( + "warning: no previously-included files matching " + "'%s' found anywhere in distribution" + ), + pattern, + ) + + elif action == 'recursive-include': + self.debug_print("recursive-include {} {}".format(dir, ' '.join(patterns))) + for pattern in patterns: + if not self.include_pattern(pattern, prefix=dir): + msg = "warning: no files found matching '%s' under directory '%s'" + log.warning(msg, pattern, dir) + + elif action == 'recursive-exclude': + self.debug_print("recursive-exclude {} {}".format(dir, ' '.join(patterns))) + for pattern in patterns: + if not self.exclude_pattern(pattern, prefix=dir): + log.warning( + ( + "warning: no previously-included files matching " + "'%s' found under directory '%s'" + ), + pattern, + dir, + ) + + elif action == 'graft': + self.debug_print("graft " + dir_pattern) + if not self.include_pattern(None, prefix=dir_pattern): + log.warning("warning: no directories found matching '%s'", dir_pattern) + + elif action == 'prune': + self.debug_print("prune " + dir_pattern) + if not self.exclude_pattern(None, prefix=dir_pattern): + log.warning( + ("no previously-included directories found matching '%s'"), + dir_pattern, + ) + else: + raise DistutilsInternalError( + f"this cannot happen: invalid action '{action}'" + ) + + # Filtering/selection methods + @overload + def include_pattern( + self, + pattern: str, + anchor: bool = True, + prefix: str | None = None, + is_regex: Literal[False] = False, + ) -> bool: ... + @overload + def include_pattern( + self, + pattern: str | re.Pattern[str], + anchor: bool = True, + prefix: str | None = None, + *, + is_regex: Literal[True], + ) -> bool: ... + @overload + def include_pattern( + self, + pattern: str | re.Pattern[str], + anchor: bool, + prefix: str | None, + is_regex: Literal[True], + ) -> bool: ... + def include_pattern( + self, + pattern: str | re.Pattern, + anchor: bool = True, + prefix: str | None = None, + is_regex: bool = False, + ) -> bool: + """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, False otherwise. + """ + # XXX docstring lying about what the special chars are? + files_found = False + pattern_re = translate_pattern(pattern, anchor, prefix, is_regex) + self.debug_print(f"include_pattern: applying regex r'{pattern_re.pattern}'") + + # delayed loading of allfiles list + if self.allfiles is None: + self.findall() + + for name in self.allfiles: + if pattern_re.search(name): + self.debug_print(" adding " + name) + self.files.append(name) + files_found = True + return files_found + + @overload + def exclude_pattern( + self, + pattern: str, + anchor: bool = True, + prefix: str | None = None, + is_regex: Literal[False] = False, + ) -> bool: ... + @overload + def exclude_pattern( + self, + pattern: str | re.Pattern[str], + anchor: bool = True, + prefix: str | None = None, + *, + is_regex: Literal[True], + ) -> bool: ... + @overload + def exclude_pattern( + self, + pattern: str | re.Pattern[str], + anchor: bool, + prefix: str | None, + is_regex: Literal[True], + ) -> bool: ... + def exclude_pattern( + self, + pattern: str | re.Pattern, + anchor: bool = True, + prefix: str | None = None, + is_regex: bool = False, + ) -> bool: + """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, False otherwise. + """ + files_found = False + pattern_re = translate_pattern(pattern, anchor, prefix, is_regex) + self.debug_print(f"exclude_pattern: applying regex r'{pattern_re.pattern}'") + for i in range(len(self.files) - 1, -1, -1): + if pattern_re.search(self.files[i]): + self.debug_print(" removing " + self.files[i]) + del self.files[i] + files_found = True + return files_found + + +# Utility functions + + +def _find_all_simple(path): + """ + Find all files under 'path' + """ + all_unique = _UniqueDirs.filter(os.walk(path, followlinks=True)) + results = ( + os.path.join(base, file) for base, dirs, files in all_unique for file in files + ) + return filter(os.path.isfile, results) + + +class _UniqueDirs(set): + """ + Exclude previously-seen dirs from walk results, + avoiding infinite recursion. + Ref https://bugs.python.org/issue44497. + """ + + def __call__(self, walk_item): + """ + Given an item from an os.walk result, determine + if the item represents a unique dir for this instance + and if not, prevent further traversal. + """ + base, dirs, files = walk_item + stat = os.stat(base) + candidate = stat.st_dev, stat.st_ino + found = candidate in self + if found: + del dirs[:] + self.add(candidate) + return not found + + @classmethod + def filter(cls, items): + return filter(cls(), items) + + +def findall(dir: str | os.PathLike[str] = os.curdir): + """ + Find all files under 'dir' and return the list of full filenames. + Unless dir is '.', return full filenames with dir prepended. + """ + files = _find_all_simple(dir) + if dir == os.curdir: + make_rel = functools.partial(os.path.relpath, start=dir) + files = map(make_rel, files) + return list(files) + + +def glob_to_re(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 = rf'\1[^{sep}]' + pattern_re = re.sub(r'((?= 2: + set_threshold(logging.DEBUG) + + +class Log(logging.Logger): + """distutils.log.Log is deprecated, please use an alternative from `logging`.""" + + def __init__(self, threshold=WARN): + warnings.warn(Log.__doc__) # avoid DeprecationWarning to ensure warn is shown + super().__init__(__name__, level=threshold) + + @property + def threshold(self): + return self.level + + @threshold.setter + def threshold(self, level): + self.setLevel(level) + + warn = logging.Logger.warning diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/spawn.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/spawn.py new file mode 100644 index 000000000..973668f26 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/spawn.py @@ -0,0 +1,134 @@ +"""distutils.spawn + +Provides the 'spawn()' function, a front-end to various platform- +specific functions for launching another program in a sub-process. +""" + +from __future__ import annotations + +import os +import platform +import shutil +import subprocess +import sys +import warnings +from collections.abc import Mapping, MutableSequence +from typing import TYPE_CHECKING, TypeVar, overload + +from ._log import log +from .debug import DEBUG +from .errors import DistutilsExecError + +if TYPE_CHECKING: + from subprocess import _ENV + + +_MappingT = TypeVar("_MappingT", bound=Mapping) + + +def _debug(cmd): + """ + Render a subprocess command differently depending on DEBUG. + """ + return cmd if DEBUG else cmd[0] + + +def _inject_macos_ver(env: _MappingT | None) -> _MappingT | dict[str, str | int] | None: + if platform.system() != 'Darwin': + return env + + from .util import MACOSX_VERSION_VAR, get_macosx_target_ver + + target_ver = get_macosx_target_ver() + update = {MACOSX_VERSION_VAR: target_ver} if target_ver else {} + return {**_resolve(env), **update} + + +@overload +def _resolve(env: None) -> os._Environ[str]: ... +@overload +def _resolve(env: _MappingT) -> _MappingT: ... +def _resolve(env: _MappingT | None) -> _MappingT | os._Environ[str]: + return os.environ if env is None else env + + +def spawn( + cmd: MutableSequence[bytes | str | os.PathLike[str]], + search_path: bool = True, + verbose: bool = False, + dry_run: bool = False, + env: _ENV | None = None, +) -> None: + """Run another program, specified as a command list 'cmd', in a new process. + + 'cmd' is just the argument list for the new process, ie. + cmd[0] is the program to run and cmd[1:] are the rest of its arguments. + There is no way to run a program with a name different from that of its + executable. + + If 'search_path' is true (the default), the system's executable + search path will be used to find the program; otherwise, cmd[0] + must be the exact path to the executable. If 'dry_run' is true, + the command will not actually be run. + + Raise DistutilsExecError if running the program fails in any way; just + return on success. + """ + log.info(subprocess.list2cmdline(cmd)) + if dry_run: + return + + if search_path: + executable = shutil.which(cmd[0]) + if executable is not None: + cmd[0] = executable + + try: + subprocess.check_call(cmd, env=_inject_macos_ver(env)) + except OSError as exc: + raise DistutilsExecError( + f"command {_debug(cmd)!r} failed: {exc.args[-1]}" + ) from exc + except subprocess.CalledProcessError as err: + raise DistutilsExecError( + f"command {_debug(cmd)!r} failed with exit code {err.returncode}" + ) from err + + +def find_executable(executable: str, path: str | None = None) -> str | None: + """Tries to find 'executable' in the directories listed in 'path'. + + A string listing directories separated by 'os.pathsep'; defaults to + os.environ['PATH']. Returns the complete filename or None if not found. + """ + warnings.warn( + 'Use shutil.which instead of find_executable', DeprecationWarning, stacklevel=2 + ) + _, ext = os.path.splitext(executable) + if (sys.platform == 'win32') and (ext != '.exe'): + executable = executable + '.exe' + + if os.path.isfile(executable): + return executable + + if path is None: + path = os.environ.get('PATH', None) + # bpo-35755: Don't fall through if PATH is the empty string + if path is None: + try: + path = os.confstr("CS_PATH") + except (AttributeError, ValueError): + # os.confstr() or CS_PATH is not available + path = os.defpath + + # PATH='' doesn't match, whereas PATH=':' looks in the current directory + if not path: + return None + + paths = path.split(os.pathsep) + for p in paths: + f = os.path.join(p, executable) + if os.path.isfile(f): + # the file exists, we have a shot at spawn working + return f + return None diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/sysconfig.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/sysconfig.py new file mode 100644 index 000000000..7ddc869ab --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/sysconfig.py @@ -0,0 +1,598 @@ +"""Provide access to Python's configuration information. The specific +configuration variables available depend heavily on the platform and +configuration. The values may be retrieved using +get_config_var(name), and the list of variables is available via +get_config_vars().keys(). Additional convenience functions are also +available. + +Written by: Fred L. Drake, Jr. +Email: +""" + +from __future__ import annotations + +import functools +import os +import pathlib +import re +import sys +import sysconfig +from typing import TYPE_CHECKING, Literal, overload + +from jaraco.functools import pass_none + +from .ccompiler import CCompiler +from .compat import py39 +from .errors import DistutilsPlatformError +from .util import is_mingw + +if TYPE_CHECKING: + from typing_extensions import deprecated +else: + + def deprecated(message): + return lambda fn: fn + + +IS_PYPY = '__pypy__' in sys.builtin_module_names + +# These are needed in a couple of spots, so just compute them once. +PREFIX = os.path.normpath(sys.prefix) +EXEC_PREFIX = os.path.normpath(sys.exec_prefix) +BASE_PREFIX = os.path.normpath(sys.base_prefix) +BASE_EXEC_PREFIX = os.path.normpath(sys.base_exec_prefix) + +# Path to the base directory of the project. On Windows the binary may +# live in project/PCbuild/win32 or project/PCbuild/amd64. +# set for cross builds +if "_PYTHON_PROJECT_BASE" in os.environ: + project_base = os.path.abspath(os.environ["_PYTHON_PROJECT_BASE"]) +else: + if sys.executable: + project_base = os.path.dirname(os.path.abspath(sys.executable)) + else: + # sys.executable can be empty if argv[0] has been changed and Python is + # unable to retrieve the real program name + project_base = os.getcwd() + + +def _is_python_source_dir(d): + """ + Return True if the target directory appears to point to an + un-installed Python. + """ + modules = pathlib.Path(d).joinpath('Modules') + return any(modules.joinpath(fn).is_file() for fn in ('Setup', 'Setup.local')) + + +_sys_home = getattr(sys, '_home', None) + + +def _is_parent(dir_a, dir_b): + """ + Return True if a is a parent of b. + """ + return os.path.normcase(dir_a).startswith(os.path.normcase(dir_b)) + + +if os.name == 'nt': + + @pass_none + def _fix_pcbuild(d): + # In a venv, sys._home will be inside BASE_PREFIX rather than PREFIX. + prefixes = PREFIX, BASE_PREFIX + matched = ( + prefix + for prefix in prefixes + if _is_parent(d, os.path.join(prefix, "PCbuild")) + ) + return next(matched, d) + + project_base = _fix_pcbuild(project_base) + _sys_home = _fix_pcbuild(_sys_home) + + +def _python_build(): + if _sys_home: + return _is_python_source_dir(_sys_home) + return _is_python_source_dir(project_base) + + +python_build = _python_build() + + +# Calculate the build qualifier flags if they are defined. Adding the flags +# to the include and lib directories only makes sense for an installation, not +# an in-source build. +build_flags = '' +try: + if not python_build: + build_flags = sys.abiflags +except AttributeError: + # It's not a configure-based build, so the sys module doesn't have + # this attribute, which is fine. + pass + + +def get_python_version(): + """Return a string containing the major and minor Python version, + leaving off the patchlevel. Sample return values could be '1.5' + or '2.2'. + """ + return f'{sys.version_info.major}.{sys.version_info.minor}' + + +def get_python_inc(plat_specific: bool = False, prefix: str | None = None) -> str: + """Return the directory containing installed Python header files. + + If 'plat_specific' is false (the default), this is the path to the + non-platform-specific header files, i.e. Python.h and so on; + otherwise, this is the path to platform-specific header files + (namely pyconfig.h). + + If 'prefix' is supplied, use it instead of sys.base_prefix or + sys.base_exec_prefix -- i.e., ignore 'plat_specific'. + """ + default_prefix = BASE_EXEC_PREFIX if plat_specific else BASE_PREFIX + resolved_prefix = prefix if prefix is not None else default_prefix + # MinGW imitates posix like layout, but os.name != posix + os_name = "posix" if is_mingw() else os.name + try: + getter = globals()[f'_get_python_inc_{os_name}'] + except KeyError: + raise DistutilsPlatformError( + "I don't know where Python installs its C header files " + f"on platform '{os.name}'" + ) + return getter(resolved_prefix, prefix, plat_specific) + + +@pass_none +def _extant(path): + """ + Replace path with None if it doesn't exist. + """ + return path if os.path.exists(path) else None + + +def _get_python_inc_posix(prefix, spec_prefix, plat_specific): + return ( + _get_python_inc_posix_python(plat_specific) + or _extant(_get_python_inc_from_config(plat_specific, spec_prefix)) + or _get_python_inc_posix_prefix(prefix) + ) + + +def _get_python_inc_posix_python(plat_specific): + """ + Assume the executable is in the build directory. The + pyconfig.h file should be in the same directory. Since + the build directory may not be the source directory, + use "srcdir" from the makefile to find the "Include" + directory. + """ + if not python_build: + return + if plat_specific: + return _sys_home or project_base + incdir = os.path.join(get_config_var('srcdir'), 'Include') + return os.path.normpath(incdir) + + +def _get_python_inc_from_config(plat_specific, spec_prefix): + """ + If no prefix was explicitly specified, provide the include + directory from the config vars. Useful when + cross-compiling, since the config vars may come from + the host + platform Python installation, while the current Python + executable is from the build platform installation. + + >>> monkeypatch = getfixture('monkeypatch') + >>> gpifc = _get_python_inc_from_config + >>> monkeypatch.setitem(gpifc.__globals__, 'get_config_var', str.lower) + >>> gpifc(False, '/usr/bin/') + >>> gpifc(False, '') + >>> gpifc(False, None) + 'includepy' + >>> gpifc(True, None) + 'confincludepy' + """ + if spec_prefix is None: + return get_config_var('CONF' * plat_specific + 'INCLUDEPY') + + +def _get_python_inc_posix_prefix(prefix): + implementation = 'pypy' if IS_PYPY else 'python' + python_dir = implementation + get_python_version() + build_flags + return os.path.join(prefix, "include", python_dir) + + +def _get_python_inc_nt(prefix, spec_prefix, plat_specific): + if python_build: + # Include both include dirs to ensure we can find pyconfig.h + return ( + os.path.join(prefix, "include") + + os.path.pathsep + + os.path.dirname(sysconfig.get_config_h_filename()) + ) + return os.path.join(prefix, "include") + + +# allow this behavior to be monkey-patched. Ref pypa/distutils#2. +def _posix_lib(standard_lib, libpython, early_prefix, prefix): + if standard_lib: + return libpython + else: + return os.path.join(libpython, "site-packages") + + +def get_python_lib( + plat_specific: bool = False, standard_lib: bool = False, prefix: str | None = None +) -> str: + """Return the directory containing the Python library (standard or + site additions). + + If 'plat_specific' is true, return the directory containing + platform-specific modules, i.e. any module from a non-pure-Python + module distribution; otherwise, return the platform-shared library + directory. If 'standard_lib' is true, return the directory + containing standard Python library modules; otherwise, return the + directory for site-specific modules. + + If 'prefix' is supplied, use it instead of sys.base_prefix or + sys.base_exec_prefix -- i.e., ignore 'plat_specific'. + """ + + early_prefix = prefix + + if prefix is None: + if standard_lib: + prefix = plat_specific and BASE_EXEC_PREFIX or BASE_PREFIX + else: + prefix = plat_specific and EXEC_PREFIX or PREFIX + + if os.name == "posix" or is_mingw(): + if plat_specific or standard_lib: + # Platform-specific modules (any module from a non-pure-Python + # module distribution) or standard Python library modules. + libdir = getattr(sys, "platlibdir", "lib") + else: + # Pure Python + libdir = "lib" + implementation = 'pypy' if IS_PYPY else 'python' + libpython = os.path.join(prefix, libdir, implementation + get_python_version()) + return _posix_lib(standard_lib, libpython, early_prefix, prefix) + elif os.name == "nt": + if standard_lib: + return os.path.join(prefix, "Lib") + else: + return os.path.join(prefix, "Lib", "site-packages") + else: + raise DistutilsPlatformError( + f"I don't know where Python installs its library on platform '{os.name}'" + ) + + +@functools.lru_cache +def _customize_macos(): + """ + Perform first-time customization of compiler-related + config vars on macOS. Use after a compiler is known + to be needed. This customization exists primarily to support Pythons + from binary installers. The kind and paths to build tools on + the user system may vary significantly from the system + that Python itself was built on. Also the user OS + version and build tools may not support the same set + of CPU architectures for universal builds. + """ + + sys.platform == "darwin" and __import__('_osx_support').customize_compiler( + get_config_vars() + ) + + +def customize_compiler(compiler: CCompiler) -> None: + """Do any platform-specific customization of a CCompiler instance. + + Mainly needed on Unix, so we can plug in the information that + varies across Unices and is stored in Python's Makefile. + """ + if compiler.compiler_type in ["unix", "cygwin"] or ( + compiler.compiler_type == "mingw32" and is_mingw() + ): + _customize_macos() + + ( + cc, + cxx, + cflags, + ccshared, + ldshared, + ldcxxshared, + shlib_suffix, + ar, + ar_flags, + ) = get_config_vars( + 'CC', + 'CXX', + 'CFLAGS', + 'CCSHARED', + 'LDSHARED', + 'LDCXXSHARED', + 'SHLIB_SUFFIX', + 'AR', + 'ARFLAGS', + ) + + cxxflags = cflags + + if 'CC' in os.environ: + newcc = os.environ['CC'] + if 'LDSHARED' not in os.environ and ldshared.startswith(cc): + # If CC is overridden, use that as the default + # command for LDSHARED as well + ldshared = newcc + ldshared[len(cc) :] + cc = newcc + cxx = os.environ.get('CXX', cxx) + ldshared = os.environ.get('LDSHARED', ldshared) + ldcxxshared = os.environ.get('LDCXXSHARED', ldcxxshared) + cpp = os.environ.get( + 'CPP', + cc + " -E", # not always + ) + + ldshared = _add_flags(ldshared, 'LD') + ldcxxshared = _add_flags(ldcxxshared, 'LD') + cflags = os.environ.get('CFLAGS', cflags) + ldshared = _add_flags(ldshared, 'C') + cxxflags = os.environ.get('CXXFLAGS', cxxflags) + ldcxxshared = _add_flags(ldcxxshared, 'CXX') + cpp = _add_flags(cpp, 'CPP') + cflags = _add_flags(cflags, 'CPP') + cxxflags = _add_flags(cxxflags, 'CPP') + ldshared = _add_flags(ldshared, 'CPP') + ldcxxshared = _add_flags(ldcxxshared, 'CPP') + + ar = os.environ.get('AR', ar) + + archiver = ar + ' ' + os.environ.get('ARFLAGS', ar_flags) + cc_cmd = cc + ' ' + cflags + cxx_cmd = cxx + ' ' + cxxflags + + compiler.set_executables( + preprocessor=cpp, + compiler=cc_cmd, + compiler_so=cc_cmd + ' ' + ccshared, + compiler_cxx=cxx_cmd, + compiler_so_cxx=cxx_cmd + ' ' + ccshared, + linker_so=ldshared, + linker_so_cxx=ldcxxshared, + linker_exe=cc, + linker_exe_cxx=cxx, + archiver=archiver, + ) + + if 'RANLIB' in os.environ and compiler.executables.get('ranlib', None): + compiler.set_executables(ranlib=os.environ['RANLIB']) + + compiler.shared_lib_extension = shlib_suffix + + +def get_config_h_filename() -> str: + """Return full pathname of installed pyconfig.h file.""" + return sysconfig.get_config_h_filename() + + +def get_makefile_filename() -> str: + """Return full pathname of installed Makefile from the Python build.""" + return sysconfig.get_makefile_filename() + + +def parse_config_h(fp, g=None): + """Parse a config.h-style file. + + A dictionary containing name/value pairs is returned. If an + optional dictionary is passed in as the second argument, it is + used instead of a new dictionary. + """ + return sysconfig.parse_config_h(fp, vars=g) + + +# Regexes needed for parsing Makefile (and similar syntaxes, +# like old-style Setup files). +_variable_rx = re.compile(r"([a-zA-Z][a-zA-Z0-9_]+)\s*=\s*(.*)") +_findvar1_rx = re.compile(r"\$\(([A-Za-z][A-Za-z0-9_]*)\)") +_findvar2_rx = re.compile(r"\${([A-Za-z][A-Za-z0-9_]*)}") + + +def parse_makefile(fn, g=None): # noqa: C901 + """Parse a Makefile-style file. + + A dictionary containing name/value pairs is returned. If an + optional dictionary is passed in as the second argument, it is + used instead of a new dictionary. + """ + from distutils.text_file import TextFile + + fp = TextFile( + fn, + strip_comments=True, + skip_blanks=True, + join_lines=True, + errors="surrogateescape", + ) + + if g is None: + g = {} + done = {} + notdone = {} + + while True: + line = fp.readline() + if line is None: # eof + break + m = _variable_rx.match(line) + if m: + n, v = m.group(1, 2) + v = v.strip() + # `$$' is a literal `$' in make + tmpv = v.replace('$$', '') + + if "$" in tmpv: + notdone[n] = v + else: + try: + v = int(v) + except ValueError: + # insert literal `$' + done[n] = v.replace('$$', '$') + else: + done[n] = v + + # Variables with a 'PY_' prefix in the makefile. These need to + # be made available without that prefix through sysconfig. + # Special care is needed to ensure that variable expansion works, even + # if the expansion uses the name without a prefix. + renamed_variables = ('CFLAGS', 'LDFLAGS', 'CPPFLAGS') + + # do variable interpolation here + while notdone: + for name in list(notdone): + value = notdone[name] + m = _findvar1_rx.search(value) or _findvar2_rx.search(value) + if m: + n = m.group(1) + found = True + if n in done: + item = str(done[n]) + elif n in notdone: + # get it on a subsequent round + found = False + elif n in os.environ: + # do it like make: fall back to environment + item = os.environ[n] + + elif n in renamed_variables: + if name.startswith('PY_') and name[3:] in renamed_variables: + item = "" + + elif 'PY_' + n in notdone: + found = False + + else: + item = str(done['PY_' + n]) + else: + done[n] = item = "" + if found: + after = value[m.end() :] + value = value[: m.start()] + item + after + if "$" in after: + notdone[name] = value + else: + try: + value = int(value) + except ValueError: + done[name] = value.strip() + else: + done[name] = value + del notdone[name] + + if name.startswith('PY_') and name[3:] in renamed_variables: + name = name[3:] + if name not in done: + done[name] = value + else: + # bogus variable reference; just drop it since we can't deal + del notdone[name] + + fp.close() + + # strip spurious spaces + for k, v in done.items(): + if isinstance(v, str): + done[k] = v.strip() + + # save the results in the global dictionary + g.update(done) + return g + + +def expand_makefile_vars(s, vars): + """Expand Makefile-style variables -- "${foo}" or "$(foo)" -- in + 'string' according to 'vars' (a dictionary mapping variable names to + values). Variables not present in 'vars' are silently expanded to the + empty string. The variable values in 'vars' should not contain further + variable expansions; if 'vars' is the output of 'parse_makefile()', + you're fine. Returns a variable-expanded version of 's'. + """ + + # This algorithm does multiple expansion, so if vars['foo'] contains + # "${bar}", it will expand ${foo} to ${bar}, and then expand + # ${bar}... and so forth. This is fine as long as 'vars' comes from + # 'parse_makefile()', which takes care of such expansions eagerly, + # according to make's variable expansion semantics. + + while True: + m = _findvar1_rx.search(s) or _findvar2_rx.search(s) + if m: + (beg, end) = m.span() + s = s[0:beg] + vars.get(m.group(1)) + s[end:] + else: + break + return s + + +_config_vars = None + + +@overload +def get_config_vars() -> dict[str, str | int]: ... +@overload +def get_config_vars(arg: str, /, *args: str) -> list[str | int]: ... +def get_config_vars(*args: str) -> list[str | int] | dict[str, str | int]: + """With no arguments, return a dictionary of all configuration + variables relevant for the current platform. Generally this includes + everything needed to build extensions and install both pure modules and + extensions. On Unix, this means every variable defined in Python's + installed Makefile; on Windows it's a much smaller set. + + With arguments, return a list of values that result from looking up + each argument in the configuration variable dictionary. + """ + global _config_vars + if _config_vars is None: + _config_vars = sysconfig.get_config_vars().copy() + py39.add_ext_suffix(_config_vars) + + return [_config_vars.get(name) for name in args] if args else _config_vars + + +@overload +@deprecated( + "SO is deprecated, use EXT_SUFFIX. Support will be removed when this module is synchronized with stdlib Python 3.11" +) +def get_config_var(name: Literal["SO"]) -> int | str | None: ... +@overload +def get_config_var(name: str) -> int | str | None: ... +def get_config_var(name: str) -> int | str | None: + """Return the value of a single variable using the dictionary + returned by 'get_config_vars()'. Equivalent to + get_config_vars().get(name) + """ + if name == 'SO': + import warnings + + warnings.warn('SO is deprecated, use EXT_SUFFIX', DeprecationWarning, 2) + return get_config_vars().get(name) + + +@pass_none +def _add_flags(value: str, type: str) -> str: + """ + Add any flags from the environment for the given type. + + type is the prefix to FLAGS in the environment key (e.g. "C" for "CFLAGS"). + """ + flags = os.environ.get(f'{type}FLAGS') + return f'{value} {flags}' if flags else value diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__init__.py new file mode 100644 index 000000000..5a8ab0610 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__init__.py @@ -0,0 +1,42 @@ +""" +Test suite for distutils. + +Tests for the command classes in the distutils.command package are +included in distutils.tests as well, instead of using a separate +distutils.command.tests package, since command identification is done +by import rather than matching pre-defined names. +""" + +import shutil +from collections.abc import Sequence + + +def missing_compiler_executable(cmd_names: Sequence[str] = []): # pragma: no cover + """Check if the compiler components used to build the interpreter exist. + + Check for the existence of the compiler executables whose names are listed + in 'cmd_names' or all the compiler executables when 'cmd_names' is empty + and return the first missing executable or None when none is found + missing. + + """ + from distutils import ccompiler, errors, sysconfig + + compiler = ccompiler.new_compiler() + sysconfig.customize_compiler(compiler) + if compiler.compiler_type == "msvc": + # MSVC has no executables, so check whether initialization succeeds + try: + compiler.initialize() + except errors.DistutilsPlatformError: + return "msvc" + for name in compiler.executables: + if cmd_names and name not in cmd_names: + continue + cmd = getattr(compiler, name) + if cmd_names: + assert cmd is not None, f"the '{name}' executable is not configured" + elif not cmd: + continue + if shutil.which(cmd[0]) is None: + return cmd[0] diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0cb96834ebcf9e6bc0e49ca4470b33e8f21290ab GIT binary patch literal 1944 zcmaJBO=uid_`RLk-Rx$QP0}fX+Va_%-ifsXXb6+ zd(&jg2C67jDOgWdM98tF7w>xN!HX2SrjT?{5IlKH8$s#G@9pl)q6Z($o9})9|33{4 z#S0~*ZLLPAIY*SK;7Au*cM^kRZefY?Gu zek?&Jz&!f!0zw<<782HDefYa;_(L#@n>;dhY>+}|KK^Q{qE z_!ze`65l$aUWjE^Cu6ApZ)IGpyD*OHBYf*jjB`>LT|y>mny;c(YIUS96+<&fKrSz% zrm=?Bjmu~am$UX9r086oI#&p*b@~z7q`^EWu?C>_0d!g@p|FaR<&b#*K-aQBQ2}L# zo6vRWd1!Y6r>ja2g68T_bnSI(YDA)(u2Uye_Ob_quvX`icKb&6Jn=vsbvx>y>q|-3 zlnAJ`J@5ZC(SHj-|5Cr9njK|&_`u^(bO*1-1Wc~aWM^dh4rwb35IFb++5!!Mni>y- zu1`IQUcf?^w`@Rj$FW5jDg+lY%E_j5cu-?2k?G58&cgMy&Ozz=%O%K69KTi`a0RK+ zoS~p@c__*yV=FSCUu5+)09RB9=$e(78goLaxX-TBK5i(cTB_Ng5v&lVnC$^iG%+7< zr$x_JP$mDob~PI8yCb9Q3RSjJBFf0R-eggFtyk~~@cn1vp- zVff@jxNe}o#!&i=wt4cm;^cPmaJzVTt5~}6_KrEUZIZT0HYXpOukB=u+t~x{?19aR zpR=W1)5uNl6vnp;2it{%j|;EtX3*%=_Q*_oWab&lrKfM2PX@>DjBj3UPgQ{Lm*M@l z>zn4*@Zp;V5O(%W+&=xNu((O@&fh)x=-7LYW)`;!i?>fd86DT$gQH)}eKvQ;xO3*~ z%+}z+_Fzd%T>bLo=NF&u1MPqBrqRg6c5${{oPCCHZu-f-sa*s9&*dmY^ux&6L+HVw z;@Q`Y2PZJxT7-mtO+7udu2X)24&y)lG`e?>EpgSk^r(Mx#x?wjA8yZ6?g8WabB_aB#Y BC^rBA literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/support.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/support.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..32e69b0a378a2269a9ab8a231701139a880ce72b GIT binary patch literal 6430 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_bdist.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_bdist.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..10086da3310529abcb3318c8d3c2313fa70b1c8a GIT binary patch literal 1929 zcmbtV&1)M+6rcT)*7C>7mSx##8q2P*Ew`5F7rlfYitAECOo)9Flx3w^%Pa3{)tTKk zQsfeXp(+j3Hyc8s^yK0{q4!>Tkz#|CC51rgAvf1fFFEziN^2!1Ig}3Un>X)k-pu^o z+uw(WBM8QCziL~KgwUUC5e!)S<9rpSeS}dCVGi>qXYo0nW4vGrmY5Sc#G}s;7IzVr zbg|?|?D_VlBcaRWLe)?@T$|m{sY8>SHc4WGI<8}wG*hrGODp3{o{2I~nM0cMB!3A^ zn7WmUO`Jk6q(5=J#rY&K`$$JQ4$|Z?w~KND=7EY;AuW0XY{O4n!^DNag?X~9*mr&c zWFOU0=|wHb*f{D=aNa54b~vYZ7KG~DQO|yd$9$2i^D5snMs>av4*32Y#NwDh@Uw+wlM1)^(?uCnJK?95&m9?a4l>P7W3b&0NS8fDEiYC85p z6rKiVrE8-09+RdePo%oJ>4_|iCloA9M*V~~ZMTdm!&s7y=ig?xY)j8-rhYqnqk5Cr zCB5L#?5FEDm)2~oce&4(SJYc}-gdG88k-oJnax~qrjgH9s?L^Oen0c>ds%8Y`cg$J zY->gErn=)+9NRW&)<2Ptxvax*=u@=|yGqp?VnVfd)Y`-aaxyQCZOKG+ zQ3w14r4f{Z7Y4EBI3yh+aTaNUkp%OW%9^E9Ph=BRlADJrq3l`x%19E{cRa<1Uw`A; z)Fov0RoB3tJ^*qTJyBw>hvw9q0L+n>fSH1t+IL#}`=nFI0* z^8Nf9A?${H!Wu1Q;MqlI{J4}ne`i$c?cnRzpznoM725@foOsP2r~9%>U(4>B64s=> zkqzCdV1wMy%Fs+mcjra6Jv)V;&2#yBH~EiA7G$jH(pey<0>^QW(86CR{RevMS!jXV S;P%4p=v*s0_YYz#KgPc`>DIyk literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_bdist_dumb.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_bdist_dumb.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4ae1ea4ed650914dcca363e0056b54c794587a4a GIT binary patch literal 3876 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_build_ext.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_build_ext.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7c2da52157c5791b11217b77be70023d7cf91c7a GIT binary patch literal 29365 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_build_py.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_build_py.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..13d2edce86ae79f1c9c97ef1b02ca60b917a7794 GIT binary patch literal 9886 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 E1F=3*2mk;8 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_build_scripts.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_build_scripts.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2796f3c1950b04711f83e28d33b6a04970ba1a5a GIT binary patch literal 4729 zcmd^DO>7&-6`uVexuhhL5hd%#vPAt@_R1C+|Fp4zBuE@3h6_YBEW>Gu1dA1SC6Qio z*_ov!5@c%^KG2N-SxEpXK#Tb3!ad}eqCkrlMK8UGc3QC;8!+Hpa+4($ZGGyST`oz9 zblbE=FP+28+j%o@W;ow_?;HNUqr-=w{O%X>!fR~^J)s{?aaDz#JP2z@K{2E-3ac?O z#%kFZ3oWN{DL%$CRL5(slso3OWS8bi2{FNv-I_P$i}@^>)!Jh1EIN-A&rPHVsxR5^ zELd;vakd=u=UCC3pSY|NgM{aF999y<$QlWaMB;iXC8w3hY&M}O5{ctP#vqZe=)`G} zF});5;(B^6F%KUddj>&A`xMy0iCHkEr{UW}vYCvIjd*YYF^=>cByWKzlrWuhsQjM3wni|TlAPgy7hB(i!=5P<4nU6JjnE@JHLc#4HZzb zQCl6TF!ShMbuUGxz$Bf0RrR#N?6=Slsg7FQS8g~u&priwI(ueNYrDjm+rqBGTs?}A zJtBuhb~-Oa=X59sXV0-M3PL|WDoc~#Og^frjd znmkdpIg^74gdR2=ezp=_&{Jwu*3_lw+qsKaPpWZ)MBkjbI618=sx4iZdP};b&+0}L zFrwpxtVJU=NlVN|GdW{HPoIjMI2k1gL!HdX@vHJY%qFUl%^13_k*HLISk$1fv+BJk ziDYtSH&sfCIwxl}LxTB6B0W#?Wc2m_^JCD6H2yj9!?jBN;GP(K#hHidz*Fz~rB_!xA#ALTZL-cqhQ?vC$% zU}8g7;>_`Qsz&l>C$}W%bV5?Z`DY^=-WQQ}h z-a5Mnyt|TtdcPyp^+wHGl0ipXZwqYglx}*O_h8pWPr*}gUqhH#7N|G!C{`SCK#9nyj0TMz8!){glhujIXJli+S%_^r{$DN=uaE27EDiN`Yd!> z&X_;g8oHLU7Y37`Km~Yxp?hs$b>PFnlDkn1^=yWYmqW+zUU?8YT@oHUsIIhkekS~} z>-A4ZKDxB_&gwgB@2oI++j1jsdkxnWp>4%;%d_nLGT6E1 zTlKAf^FeT=;oGk~<)G_t+a0L;978CIe$5^^cgh!U zgeC={1^hc8KqiAQuAw4l)W$g1UgQCsyi^OY4IpR%%K~J>0++NhC>U-iKjWMXR^XHE z4T`F$@Gpa8)Bp%jt~$*O5?#}nZs4-WVH$NY1;6Q2m(+OHkY_d3zEedMOb&7!riX+4 zRYef}1t7a+Q>ok=c7nvCw5zR}E+u_7X_*yW7KZQuXz@6$4%2ZwjedmMv~Xgf#DZmu z$ksB#AAzalEvT-eFNDr70|(##eu=O243_xi_J?D~HpkAC$Ievx!*}`5LcbdP`QR?c z9`=>^O`*3e^se`mh2dQ{3LaX&{2(y0A&lToFtsO&)h=_wieg6fheN1UUQ}w)s8u9# zuKl0bsQLPTV1sim_#fF&_#bmc=HH5iHHN?-qZaq-vDkuD{)W%-ey1HB4o9;DM`si1 zsG7bOwiD#Z$f@R$;aPn?OTsqL!i&-HMJt(x$-?BUoStu*kdX;#>dfbwx<-d$nHJ0FOas@-znkMdB!T;t9n2Dn+tgwHwCd z4>v{fR@vqR3?(_Jt|M@{gQK5BKaOr8{#e%z;tzKJML-7zR<;(2F!nGIx;^!NenaSMcJ3NQc@09~ z|2svg=Z97l#0g%>5M1HDQV)AYx565fELbJkH5n6=qXetHu?zRnDfIO!dhJ|#kak!J z^$?W?X=Sl6PS+GXL_fn&5ie9u1P2F-_;))oWFrwzsqj`* zY^gZ1YD00T_TBnF4~x#3{>D*QwP|6X-bukjutg8s z?4%N*ZwwrvOZqRvn*;fwtv1?F=cm@brG6Dwm61i{)Aq9 qg1ld#z#}yD2%UX|jyyu6Pf+Ksdxl|#Z!d24OqP2l|BUFDW%BQT6X}xx literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_check.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_check.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..79d06b00396bf7f3440ff36d38649b4417386730 GIT binary patch literal 7175 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 Gk-q`3Qo~~a literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_cmd.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_cmd.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6311bc300ec4fea95d47914831925145f890815c GIT binary patch literal 6378 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 Xy_*8zn;u|oOS-^u!y5!Cd++}Osk<)V literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_config_cmd.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_config_cmd.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..743037fbc444f01b5ec921c036126e935950aea8 GIT binary patch literal 5163 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 myBz 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_dist.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_dist.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b2bc93a986f878d2d428fcf6dc0de06838f89932 GIT binary patch literal 26885 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 VTOLu$BdZkNS^eE};XT2-{|oEZQqTYZ literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_extension.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_extension.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3cf9299e8836018dbadba2f389bb270a163f213a GIT binary patch literal 4225 zcmbssTWl29_0DS__U?}Dg+hg)Ym9-##cSRMHMAv=2&=dzAtkYdM&p^;_3UG2bMGwc zCALT_KJ3O4SpD#(iWIl1R9EDqpH!{XrXQ`6{wyqN=#8tYf}i}kfMnHQJ$J^lYg;B% za94XD=bU@)Ip^N7%EeP6Qey@)GD2C8Ow(y&{I(hOoOy-b|Mv%_we4ZQO+>syQ z-BB13U=;FVK^l02lM2LU<(1As)Ssbm<1t1GjmP^GHjDPX@2;x?~WC zB+@oc=q7PWj+rNY#<*ix#I&uxuNd)AlBeNwK8(uPP<4eEPN}G*&AgH1XiOV3w472_ zv1M8rqIpMnJ-51evK=OK$UvY0V$$D0AUhAeSP_yUjWS6Zr)d5*wp)U~0RJa3fX*R@ z!Q7TzRmNYlG0UhowCC&yZXk!H6Y^oVS0&Lo-*l6l)9PaLW7E?77VP?HpMEz#MFqTd#LsXq(Lo? zs>GnJqos7(z(s72SE!`v*e<|e=WR^Gnr#tBwH!i&@Mwy8wL(Q5t7R$~R}IUd;j~H| zZz`s300cAXagV?(s2PKX+yR~$4Q1^LaZD{og`5Fw3M$D_sbG#9n6|ouQYaBq1DIU` zv0%7r8Z>BMH84B3r3j>XPZzORDHf=R4Gs9>vOSt*Gl^(eEz+QC4h_y`le`TlijG+@ zXxPE3MZf_H$q?mjLdBx$j8QRbn-2E*yZH@ptXA02Je;$`2m4v_ z801-Jrw`5U@@LIa5BU~f=i{rdSPy^Fa+^gCXp>Nyu%B;bpzrc92wfMlo&LNz`kZxc z%{%Y*@sR&F*`v3969}?@mX3B8^ z61#*ozy?_b0V+{(n3WO%Rwfua6(L7ssD%tibsS7XdDY64+;Ye}P|agjyV8(fN7D!~ zSxpDGz;+6G!=eI#twAU&2<%LX_%J*E7~3YgT)8q~$&Hm6cz}W9ZsrDic?n-JEz`Ny zwMlYcPx4*ZOKyOL-bat3@taqsuY7c}9_{%L;=(%@BU^8&)sFj-&Se3Xk7C=ZfqA|j z>z)!G$Q?Jwr^lb*I|I7_bf#}wj$0!#5_SD&@ooLIB z>XCV|9`9M`sKyc_o|tt`jj39#wjm1Plb znoWCGmVdypBRq*#ND5x#&!gw}37_^v&mR^39G3?<;jbt54#tGf_DSat1wT6~oj)D? zoRbDygP+Hw!EM2zq{OOrR)Q-EZBdkht(PEvC^Vud@0QfOhruU-HCCYe4SE7Sa=iw# zQpN4q_Zwj)$_@0G@0Y&yMCXo67dfo^1j$zTzEX5sgKvXg2E52R_SsJ3joQ2UN$tf8 z=A!rlqv>Ss*+)u67QXs?&sWBbe9^#eJn&@E*betl=G7~q?|AB*#$&K#ahpJXMN0z5 lasNPj9-{D(U!qLTrxGrbNsh8wU*DMgCpX4B^+ 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 bp)O;nTZdn-L3&+J>2@Kg{lq{r$N>Kr^Y=XJ literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_install_data.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_install_data.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a7032cef6d3c2b3162a73efd4918ea5f1a4580ec GIT binary patch literal 4827 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 To|R$3Jp(BA-V;~_>&AZoJ4)y? literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_install_scripts.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_install_scripts.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..138e5c25f68c3b6e8fea2005f4cbf17050b7686b GIT binary patch literal 2736 zcma)8&2JM&6rcU_j_o9dY{*A(Q3595w8^%#LVzf$+LQ_q5rUj7RjZA61MBR1-I+DT zmJ?{j!B8XwJtRl2i2Mg!I8{}9Sp${b6-Y?X1GkpY3#ZQPde!$&q2m(77 z#FY>C(*5)*X^LyVlGSD4M7n!aOWGpiw66ew0w1icmm0Im-fQowF$MCeHa3krN|ye^ z3$F>9uo?@m`yHM{-%~t1p~i$KFS0eZ;1^7&3wp$!1V1oD*Yox|okhC7&ARWyecQIs zNt<=ytudf`JUH~*C7wvvB_54g*bhKt(IqO4?^sko7S2?mJa60boQm!;Uhi9#@9`8|9+$T?Ok)}y z9es04zF=FrteW~I`E=zBvI~0N!SYw<&P>kOnjVZ!OdnUy+Hso=kybj}>K|+k?R+ir`x24ONCWP9odBs_E83&JJ$0@n4K5$Peb|NR z`XU`4yM4@sV{U4!mFmB_cx};5Wn7pclFlz*yX>aMT{uqUGnj0`bOWXz!(Gpau5!KN z!r^*_+AUpQa^d^+rM8bdiHE5P7f!gTiME$JlMhp}3*|;iUL%Qt?p*W0=b9QQL~KKC zgBBu)@D3ZUb>p3a7-~EHTYRv!cg~4eBs!6IlA*6|d{JXoBfhEeg>EQieSX^73#XCa zDjzXjcTa-vX?qw?jgOd4s0oFwnMWw>2={gRFiQqFL*Z(HJ{}udjf+l-)!1q94J2=X zSQBfpivTeWiir5Xm6*!l81}V{Pn-CZPtx9$AQJ9$pOFWy)7jzf>ZO zple>tQPFwbK{PouLT%!0@De3oR4pBooG7XI4ZTNAw)+Te+o_a|s+o7;c)isa*^D0$ zaRs!t?^sUXO8>O09(y6}ZAu3l(!r*5sv({F<@h7%Tpd2^7;M7(#mAYM2+JGrzWaaS zeI0CDFnLqFCf}L_{R%Mgz4hsqG_-Q~p_FlZGOm>Qn0 z_05txB-L_SEfShXL5PzyPMWSC_8WLK$nqHal&n!o!ZfwNIEG>V00*9f_*3xNQ?TzT b*z+eCeI3g(dsl{lkTh0y(i2`?p}gkc6_nQ@r!M0v z=PjT$p9;fuK=m~~gtSMv*h&<-BM91zV(Z8L@oqF37zOc`xoEbuj&$&UBf}QQiwZoQkUx{2wJ>q2b4c4;*U#__GUfz1+| z&wT&Wb3YT82|)wG=mW}R96ITGWmg)bV>j+i_^KPya42Mv#=H$YX_lxEwo64ulQBWr zyzDC272pZgm~{H!skOjM)Up|UXie8&$cha zJLc)#RR7xY>T-SfO8x3&{Z#I2Dpxmi+o@awQo&Njq)ABGE>S{cHz6hNRGHFy2)SRi zS>*B6jNTys7zjV5z-WP59-(SmK@BZtOyMX<`7?%$6XNg!A-;-`$#xsE>gU6uMVb1+ r-N}AnUW@9u?hk@PZK^l{@Jq)Se@8=mDESke{L^LNDf}BL47q;+r61~W literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_modified.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_modified.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4feffb35f779d36f8a12fa52b9f1432a1660d8d2 GIT binary patch literal 7242 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 K@XSke>VE;0Z_i=? literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_sdist.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_sdist.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..63b94067181e6809cff0a1ae62352c68c71cfafc GIT binary patch literal 20624 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 RSa@OybTw{!Od1F^{|9$lw95bh literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_text_file.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_text_file.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ea3c25e1c7fa2ebc5e8a4fb7fc25fcb94bea1835 GIT binary patch literal 3367 zcmds3O>Emn79RdcqDaa~DaSvulQ3}FjoL&)b> zDu>#{f(!%;A5v_KwkNyjp+HY5oP&=6_EPjGIrO452C8yfpg_9^@5!jMz{0)s4JpcM z6SYP5wv;&YX5M?>yqS4F{5+Ks5j?m5q0cR)5c-Y|q9@iSwk`s(j4&!9%wX1HDr}Ku zD9u@1g)i~}&0Dcz9Oif{QB2@iQDD&&!to`969!vWBG8?Fl?&;jxWH$H`o0;1ctpMI zxGFY@SMyAZF&1v4ec_Tg|qsAS!AGRp=Y7zpyx1;W3%ickK?n< zVhkssjbmX6EhfAUTA8JQKYtpi9NkS9W3^4MwsjYUhJcfG38BTL7mozX5z*C`lU;*0 z*+`ZH&-gjVlcTZ8G=$Z*Z4B~uMe~g$7Q^37X|-+TqL@T1Y9z3XQw_1ftn#5WgBoJ_ zu}E{Lk9P74+`gW;yYOznWgih&!~ya{?0pO?fXh7^Zs#7N-KTLspz)7}1~vx2n|mHO z)d4&RxUv5Y7x T5Wqt=e~w<29V>wA9(?d{pOusL07rIpexM(pJaAqIvd-TyK~Vt zBW@=<`DlCK;TdUrxMxnvaxRTdmj)~;{Fm&iN}FIl=hPyD16a<2gCM&t&)ta{3J)T-;03__qj z&TP;-t%qPyu_PO`j@9KrQ4JwCs2|i7Y+TmiGP)4JH3xy^4ngCKWyiF&;BwszOl;80 zs_&(ASk6o&n7WR2tuNZ!E=JYEw+KZ=VPPuej;Dwe$jI8AI#IP>= ziO|!Yj)sDHM_MUPOcFjfx zH8Z)j#I3<~`Bb-9unn+iv^5CZ$ULx(X6E><$&X+kFaL^GE3@x@DiNIh?w#c(ZY4f~ z<<7Jf-#qu<%(ke}Vq zmgAJ&v2R;A5$@!9_XS|kgh%qwY;p|4e1#7F3ypn)4tDgZaVuPL`MPOPtmb4j{pDw literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_util.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_util.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e02513e8857b07f0f3b7798feeb2fe76d7ebaaab GIT binary patch literal 13501 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_version.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_version.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3e1ed94ea241496164b9a76bf6935ab69706deec GIT binary patch literal 3881 zcmcIneP~Pl}p2iLKaftXJFm@<-w&&DPX$X}6i;WN9N>G}-q#b|U+E z_dUh2kf~<^b7)~=e=LTk%!N`M>~8*}e*^|wpllTOk8BOBz6CZ&81sLMJxCFQ?c66l zNlv{&%XY;(@7#0G$35@f^Sf7naysh}v_JkfKK?u49?_23_%gFQ1q%|e(kQkfZ+L03SJN^Wvj&X7jFm0l}R}mPslfeKb(D?DA(jsO$}bS_cC)ZSQ$~Y zAbdZCOvDqxK!r<8j0C4=wQ*&tI}nZp)d@}RnvRcNk6#6ARo0TznxZ7sV5~C1phlO( zpfPhLre}3eWwtf*Bu<#69Ue6ZyqNr-mD?GKLv*%g!-rX1{%b+3SADkbMm;Pz|$S zsMm7CTvbD}n$mQ|GiGYWtC9I?O}tGrgBoGt zchgI=n=XIW=FhtPkHLdAC;Aty=2&vm)t0rjZMfRV0SK~ZNol$? z`Q0{{Js=mL7UrrYKE`1l3)r$pV#T&SeLJq((?5V6*oo`03pe0{Sj2AZsU074(M>Xd z-u^X0Z$a!ic8;6l?MS2ZFj|^57j-{4snO$1J@Y*$q=htZEV=tNgb$_J_YwA{IiQEr zJkTR);eGUh&4i={rpDXXMom{@{r_TU6a|cC&aXBv%{YJPa1s&bz2#@}Ycw*mn3f9+ zZ-8p`%eNtNoIz>6Dgi(274+U8s)e)Xi#_*2xC~5FbpJ(84J4-GQEK#kz2Re_tSU3UIV&?S?9wPJ}2E zhF_n~MXmw~hp$RpiVFq$Q(PnvA;-X6;)+I5hRGr7k#1WML4iU^dfNXi!oQAp8Yj`~JqU(wR(yQ*luqOVpuq-d{BPAB9^c}kOUNkg*e zbyY70{^)!RV(RrTsj5uq>1G7bEy@Tz&Gh=cZthvgVaQmwmCqhkXK#eziRhM@IE|xo z^vtBEyU%E~papSafNgL)*ax(#gGazvodF1)M}Kp)<(*>YmAlcb!=HCF=bi4%TOWNV z>j>nX-X(jP6Ehd?g6w48(L{9|zP#gj-qB+6V09>S^P|SBqqET5;Hg`*71~g9`wptN z*WVsmJfC4Rg9X;&e3NLX z%L6Oo3cqrGg{qvMs|o$8hFFinMG_Y~2$58=`+j%!!?gFX!Ff zZ)LvbT|Jx=BZh;!flar+fLLdJUi4;21~0WN4KEF3ecyZFejsEU26s6a%ewtfjzDT( z{?mdyO*@E(#PaSVccUBb_Aflg9yj_|de+$$Z9TF+vVJMs|D&vQIoJ3`*7HWePIZea zt%2XSzAUkyNe2g9!e?jQK=*(<1q=h+6R=Da+{?iGNiFbJPw^Vqtw1q&D7PBD3KZ7D zQw{902JCVM?D7We0xUlRyOk6C>!bcx*!>^I&?2)%e2s70Df(i2qBLP;5xS}ET~NeSG@^OQeX)kxU@5&J^@k?xco z0B=Or;*oyS`UR@jVJeeO%5_l^poCs5NeBqsX6VwA2qis~^it9XnqvL&`}i0x~R_2HcVbWZI5W`$PkV+BgK z8wveD z)6CiEeW?(`sbn)aqldOwzH+lpCf~yLd#L5GcIrp!+e2S z9-)T6qW(w7S+F3sVcz?*rk^$~@qcEHKVey>ewRaRQ-N|%>t14*`W-~6k>h^=B>jg5 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_versionpredicate.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/test_versionpredicate.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e3e46433cc7b6b443a242d7809c7191c3a0fd244 GIT binary patch literal 243 zcmX@j%ge<81jlwKW`O9&AOanHW&w&!XQ*V*Wb|9fP{ah}eFmxdHAz1sKQ~oBF(TZlX-=wL5i8J%j6hrrVtiy~WMnL22C@Kw=0|`4 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/unix_compat.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/__pycache__/unix_compat.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..52c075cd3b3399088d3e2aff8daf900ae7648136 GIT binary patch literal 821 zcmb7?K}-`t6o%jIZcCw*E-kelOl)XPAcQUoi5DaxfUyZ;1D42MHcNMaZMU6uW}CJo zCe?#6#)EjlBc6=WgLh9{ym%>kpjj>?p1hdGUJNIv)E2K!CiA{|^ZuFtCG#Z^7yv## zf6{lJAb{`fO?OCtq4kr)J{Vvi3smUu5K_^3Mo@+GD5(-g6+{IDSWrFK!#T(qa)aFq zFQOsjZvv=&Sjx#4*)HY6UAlx>k4FZJp&sm0h-uVT;@S(UjWSGyvYy8cw5EnT9NP}gf$9n2gzm|00Z&{B)qS|**o zw|d|8*_Q5X5n6Bq{61}}cOVsXns>b{Z`$UT8>Ag~TB&GOG}CYcy@Y9KQ}3YF?&j>7 zvO@}3(Jfq2?pD*3#@0}2;plj5W+$&*!041bl<<{KbA+28XTbOm!FafVR^c^#Rugl<(KG}l$PWdWhUn6>%mz$nMwKul_eSZ zdB%E%M*78>C8@dviOJcC=|J7ZsU@WaCHeU|#rp9nnZ-a&nLuVqYBA7`Thi1Cq`k&&^88OQll`6vv(TE|*Jt13HO;fsNsY#)3{rh=mr^fpTgkh6pKgFNV11*p}@S@(mc- z_zZjom|2)$K?(~J(``sq89MPC2nwntKmYvR|NZ^^X*Np`tdH+$8IBP8;V=CP|HAnP zfVZeXMIcay7&`4My%NqMTt7p|+yWIAVTCgs_>K|qC>wP=7UL?)qK+frNjB+t0vu;? z$1(6Un+B)}I;Ujdlnk7bfm1SYN(N3z@3fe1{G^AAaD(C8_%APlcI$y)R321X83)(d z9yj)hJZ|igx)KueeR;->k`!RV=-s`W>gF=OSE-^F z?7o@9U;%7<1mPzRg5VoUzT@aCo`1&kH!r{7n-^g?jxM6B;a8W7uNFFSS2fqb_BZ#l B!EgWo literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/compat/py39.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/compat/py39.py new file mode 100644 index 000000000..aca3939a0 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/compat/py39.py @@ -0,0 +1,40 @@ +import sys + +if sys.version_info >= (3, 10): + from test.support.import_helper import ( + CleanImport as CleanImport, + ) + from test.support.import_helper import ( + DirsOnSysPath as DirsOnSysPath, + ) + from test.support.os_helper import ( + EnvironmentVarGuard as EnvironmentVarGuard, + ) + from test.support.os_helper import ( + rmtree as rmtree, + ) + from test.support.os_helper import ( + skip_unless_symlink as skip_unless_symlink, + ) + from test.support.os_helper import ( + unlink as unlink, + ) +else: + from test.support import ( + CleanImport as CleanImport, + ) + from test.support import ( + DirsOnSysPath as DirsOnSysPath, + ) + from test.support import ( + EnvironmentVarGuard as EnvironmentVarGuard, + ) + from test.support import ( + rmtree as rmtree, + ) + from test.support import ( + skip_unless_symlink as skip_unless_symlink, + ) + from test.support import ( + unlink as unlink, + ) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/support.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/support.py new file mode 100644 index 000000000..9cd2b8a9e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/support.py @@ -0,0 +1,134 @@ +"""Support code for distutils test cases.""" + +import itertools +import os +import pathlib +import shutil +import sys +import sysconfig +import tempfile +from distutils.core import Distribution + +import pytest +from more_itertools import always_iterable + + +@pytest.mark.usefixtures('distutils_managed_tempdir') +class TempdirManager: + """ + Mix-in class that handles temporary directories for test cases. + """ + + def mkdtemp(self): + """Create a temporary directory that will be cleaned up. + + Returns the path of the directory. + """ + d = tempfile.mkdtemp() + self.tempdirs.append(d) + return d + + def write_file(self, path, content='xxx'): + """Writes a file in the given path. + + path can be a string or a sequence. + """ + pathlib.Path(*always_iterable(path)).write_text(content, encoding='utf-8') + + def create_dist(self, pkg_name='foo', **kw): + """Will generate a test environment. + + This function creates: + - a Distribution instance using keywords + - a temporary directory with a package structure + + It returns the package directory and the distribution + instance. + """ + tmp_dir = self.mkdtemp() + pkg_dir = os.path.join(tmp_dir, pkg_name) + os.mkdir(pkg_dir) + dist = Distribution(attrs=kw) + + return pkg_dir, dist + + +class DummyCommand: + """Class to store options for retrieval via set_undefined_options().""" + + def __init__(self, **kwargs): + vars(self).update(kwargs) + + def ensure_finalized(self): + pass + + +def copy_xxmodule_c(directory): + """Helper for tests that need the xxmodule.c source file. + + Example use: + + def test_compile(self): + copy_xxmodule_c(self.tmpdir) + self.assertIn('xxmodule.c', os.listdir(self.tmpdir)) + + If the source file can be found, it will be copied to *directory*. If not, + the test will be skipped. Errors during copy are not caught. + """ + shutil.copy(_get_xxmodule_path(), os.path.join(directory, 'xxmodule.c')) + + +def _get_xxmodule_path(): + source_name = 'xxmodule.c' if sys.version_info > (3, 9) else 'xxmodule-3.8.c' + return os.path.join(os.path.dirname(__file__), source_name) + + +def fixup_build_ext(cmd): + """Function needed to make build_ext tests pass. + + When Python was built with --enable-shared on Unix, -L. is not enough to + find libpython.so, because regrtest runs in a tempdir, not in the + source directory where the .so lives. + + When Python was built with in debug mode on Windows, build_ext commands + need their debug attribute set, and it is not done automatically for + some reason. + + This function handles both of these things. Example use: + + cmd = build_ext(dist) + support.fixup_build_ext(cmd) + cmd.ensure_finalized() + + Unlike most other Unix platforms, Mac OS X embeds absolute paths + to shared libraries into executables, so the fixup is not needed there. + """ + if os.name == 'nt': + cmd.debug = sys.executable.endswith('_d.exe') + elif sysconfig.get_config_var('Py_ENABLE_SHARED'): + # To further add to the shared builds fun on Unix, we can't just add + # library_dirs to the Extension() instance because that doesn't get + # plumbed through to the final compiler command. + runshared = sysconfig.get_config_var('RUNSHARED') + if runshared is None: + cmd.library_dirs = ['.'] + else: + if sys.platform == 'darwin': + cmd.library_dirs = [] + else: + name, equals, value = runshared.partition('=') + cmd.library_dirs = [d for d in value.split(os.pathsep) if d] + + +def combine_markers(cls): + """ + pytest will honor markers as found on the class, but when + markers are on multiple subclasses, only one appears. Use + this decorator to combine those markers. + """ + cls.pytestmark = [ + mark + for base in itertools.chain([cls], cls.__bases__) + for mark in getattr(base, 'pytestmark', []) + ] + return cls diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_archive_util.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_archive_util.py new file mode 100644 index 000000000..3e4ed75a7 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_archive_util.py @@ -0,0 +1,353 @@ +"""Tests for distutils.archive_util.""" + +import functools +import operator +import os +import pathlib +import sys +import tarfile +from distutils import archive_util +from distutils.archive_util import ( + ARCHIVE_FORMATS, + check_archive_formats, + make_archive, + make_tarball, + make_zipfile, +) +from distutils.spawn import spawn +from distutils.tests import support +from os.path import splitdrive + +import path +import pytest +from test.support import patch + +from .unix_compat import UID_0_SUPPORT, grp, pwd, require_uid_0, require_unix_id + + +def can_fs_encode(filename): + """ + Return True if the filename can be saved in the file system. + """ + if os.path.supports_unicode_filenames: + return True + try: + filename.encode(sys.getfilesystemencoding()) + except UnicodeEncodeError: + return False + return True + + +def all_equal(values): + return functools.reduce(operator.eq, values) + + +def same_drive(*paths): + return all_equal(pathlib.Path(path).drive for path in paths) + + +class ArchiveUtilTestCase(support.TempdirManager): + @pytest.mark.usefixtures('needs_zlib') + def test_make_tarball(self, name='archive'): + # creating something to tar + tmpdir = self._create_files() + self._make_tarball(tmpdir, name, '.tar.gz') + # trying an uncompressed one + self._make_tarball(tmpdir, name, '.tar', compress=None) + + @pytest.mark.usefixtures('needs_zlib') + def test_make_tarball_gzip(self): + tmpdir = self._create_files() + self._make_tarball(tmpdir, 'archive', '.tar.gz', compress='gzip') + + def test_make_tarball_bzip2(self): + pytest.importorskip('bz2') + tmpdir = self._create_files() + self._make_tarball(tmpdir, 'archive', '.tar.bz2', compress='bzip2') + + def test_make_tarball_xz(self): + pytest.importorskip('lzma') + tmpdir = self._create_files() + self._make_tarball(tmpdir, 'archive', '.tar.xz', compress='xz') + + @pytest.mark.skipif("not can_fs_encode('årchiv')") + def test_make_tarball_latin1(self): + """ + Mirror test_make_tarball, except filename contains latin characters. + """ + self.test_make_tarball('årchiv') # note this isn't a real word + + @pytest.mark.skipif("not can_fs_encode('のアーカイブ')") + def test_make_tarball_extended(self): + """ + Mirror test_make_tarball, except filename contains extended + characters outside the latin charset. + """ + self.test_make_tarball('のアーカイブ') # japanese for archive + + def _make_tarball(self, tmpdir, target_name, suffix, **kwargs): + tmpdir2 = self.mkdtemp() + if same_drive(tmpdir, tmpdir2): + pytest.skip("source and target should be on same drive") + + base_name = os.path.join(tmpdir2, target_name) + + # working with relative paths to avoid tar warnings + with path.Path(tmpdir): + make_tarball(splitdrive(base_name)[1], 'dist', **kwargs) + + # check if the compressed tarball was created + tarball = base_name + suffix + assert os.path.exists(tarball) + assert self._tarinfo(tarball) == self._created_files + + def _tarinfo(self, path): + tar = tarfile.open(path) + try: + names = tar.getnames() + names.sort() + return names + finally: + tar.close() + + _zip_created_files = [ + 'dist/', + 'dist/file1', + 'dist/file2', + 'dist/sub/', + 'dist/sub/file3', + 'dist/sub2/', + ] + _created_files = [p.rstrip('/') for p in _zip_created_files] + + def _create_files(self): + # creating something to tar + tmpdir = self.mkdtemp() + dist = os.path.join(tmpdir, 'dist') + os.mkdir(dist) + self.write_file([dist, 'file1'], 'xxx') + self.write_file([dist, 'file2'], 'xxx') + os.mkdir(os.path.join(dist, 'sub')) + self.write_file([dist, 'sub', 'file3'], 'xxx') + os.mkdir(os.path.join(dist, 'sub2')) + return tmpdir + + @pytest.mark.usefixtures('needs_zlib') + @pytest.mark.skipif("not (shutil.which('tar') and shutil.which('gzip'))") + def test_tarfile_vs_tar(self): + tmpdir = self._create_files() + tmpdir2 = self.mkdtemp() + base_name = os.path.join(tmpdir2, 'archive') + old_dir = os.getcwd() + os.chdir(tmpdir) + try: + make_tarball(base_name, 'dist') + finally: + os.chdir(old_dir) + + # check if the compressed tarball was created + tarball = base_name + '.tar.gz' + assert os.path.exists(tarball) + + # now create another tarball using `tar` + tarball2 = os.path.join(tmpdir, 'archive2.tar.gz') + tar_cmd = ['tar', '-cf', 'archive2.tar', 'dist'] + gzip_cmd = ['gzip', '-f', '-9', 'archive2.tar'] + old_dir = os.getcwd() + os.chdir(tmpdir) + try: + spawn(tar_cmd) + spawn(gzip_cmd) + finally: + os.chdir(old_dir) + + assert os.path.exists(tarball2) + # let's compare both tarballs + assert self._tarinfo(tarball) == self._created_files + assert self._tarinfo(tarball2) == self._created_files + + # trying an uncompressed one + base_name = os.path.join(tmpdir2, 'archive') + old_dir = os.getcwd() + os.chdir(tmpdir) + try: + make_tarball(base_name, 'dist', compress=None) + finally: + os.chdir(old_dir) + tarball = base_name + '.tar' + assert os.path.exists(tarball) + + # now for a dry_run + base_name = os.path.join(tmpdir2, 'archive') + old_dir = os.getcwd() + os.chdir(tmpdir) + try: + make_tarball(base_name, 'dist', compress=None, dry_run=True) + finally: + os.chdir(old_dir) + tarball = base_name + '.tar' + assert os.path.exists(tarball) + + @pytest.mark.usefixtures('needs_zlib') + def test_make_zipfile(self): + zipfile = pytest.importorskip('zipfile') + # creating something to tar + tmpdir = self._create_files() + base_name = os.path.join(self.mkdtemp(), 'archive') + with path.Path(tmpdir): + make_zipfile(base_name, 'dist') + + # check if the compressed tarball was created + tarball = base_name + '.zip' + assert os.path.exists(tarball) + with zipfile.ZipFile(tarball) as zf: + assert sorted(zf.namelist()) == self._zip_created_files + + def test_make_zipfile_no_zlib(self): + zipfile = pytest.importorskip('zipfile') + patch(self, archive_util.zipfile, 'zlib', None) # force zlib ImportError + + called = [] + zipfile_class = zipfile.ZipFile + + def fake_zipfile(*a, **kw): + if kw.get('compression', None) == zipfile.ZIP_STORED: + called.append((a, kw)) + return zipfile_class(*a, **kw) + + patch(self, archive_util.zipfile, 'ZipFile', fake_zipfile) + + # create something to tar and compress + tmpdir = self._create_files() + base_name = os.path.join(self.mkdtemp(), 'archive') + with path.Path(tmpdir): + make_zipfile(base_name, 'dist') + + tarball = base_name + '.zip' + assert called == [((tarball, "w"), {'compression': zipfile.ZIP_STORED})] + assert os.path.exists(tarball) + with zipfile.ZipFile(tarball) as zf: + assert sorted(zf.namelist()) == self._zip_created_files + + def test_check_archive_formats(self): + assert check_archive_formats(['gztar', 'xxx', 'zip']) == 'xxx' + assert ( + check_archive_formats(['gztar', 'bztar', 'xztar', 'ztar', 'tar', 'zip']) + is None + ) + + def test_make_archive(self): + tmpdir = self.mkdtemp() + base_name = os.path.join(tmpdir, 'archive') + with pytest.raises(ValueError): + make_archive(base_name, 'xxx') + + def test_make_archive_cwd(self): + current_dir = os.getcwd() + + def _breaks(*args, **kw): + raise RuntimeError() + + ARCHIVE_FORMATS['xxx'] = (_breaks, [], 'xxx file') + try: + try: + make_archive('xxx', 'xxx', root_dir=self.mkdtemp()) + except Exception: + pass + assert os.getcwd() == current_dir + finally: + ARCHIVE_FORMATS.pop('xxx') + + def test_make_archive_tar(self): + base_dir = self._create_files() + base_name = os.path.join(self.mkdtemp(), 'archive') + res = make_archive(base_name, 'tar', base_dir, 'dist') + assert os.path.exists(res) + assert os.path.basename(res) == 'archive.tar' + assert self._tarinfo(res) == self._created_files + + @pytest.mark.usefixtures('needs_zlib') + def test_make_archive_gztar(self): + base_dir = self._create_files() + base_name = os.path.join(self.mkdtemp(), 'archive') + res = make_archive(base_name, 'gztar', base_dir, 'dist') + assert os.path.exists(res) + assert os.path.basename(res) == 'archive.tar.gz' + assert self._tarinfo(res) == self._created_files + + def test_make_archive_bztar(self): + pytest.importorskip('bz2') + base_dir = self._create_files() + base_name = os.path.join(self.mkdtemp(), 'archive') + res = make_archive(base_name, 'bztar', base_dir, 'dist') + assert os.path.exists(res) + assert os.path.basename(res) == 'archive.tar.bz2' + assert self._tarinfo(res) == self._created_files + + def test_make_archive_xztar(self): + pytest.importorskip('lzma') + base_dir = self._create_files() + base_name = os.path.join(self.mkdtemp(), 'archive') + res = make_archive(base_name, 'xztar', base_dir, 'dist') + assert os.path.exists(res) + assert os.path.basename(res) == 'archive.tar.xz' + assert self._tarinfo(res) == self._created_files + + def test_make_archive_owner_group(self): + # testing make_archive with owner and group, with various combinations + # this works even if there's not gid/uid support + if UID_0_SUPPORT: + group = grp.getgrgid(0)[0] + owner = pwd.getpwuid(0)[0] + else: + group = owner = 'root' + + base_dir = self._create_files() + root_dir = self.mkdtemp() + base_name = os.path.join(self.mkdtemp(), 'archive') + res = make_archive( + base_name, 'zip', root_dir, base_dir, owner=owner, group=group + ) + assert os.path.exists(res) + + res = make_archive(base_name, 'zip', root_dir, base_dir) + assert os.path.exists(res) + + res = make_archive( + base_name, 'tar', root_dir, base_dir, owner=owner, group=group + ) + assert os.path.exists(res) + + res = make_archive( + base_name, 'tar', root_dir, base_dir, owner='kjhkjhkjg', group='oihohoh' + ) + assert os.path.exists(res) + + @pytest.mark.usefixtures('needs_zlib') + @require_unix_id + @require_uid_0 + def test_tarfile_root_owner(self): + tmpdir = self._create_files() + base_name = os.path.join(self.mkdtemp(), 'archive') + old_dir = os.getcwd() + os.chdir(tmpdir) + group = grp.getgrgid(0)[0] + owner = pwd.getpwuid(0)[0] + try: + archive_name = make_tarball( + base_name, 'dist', compress=None, owner=owner, group=group + ) + finally: + os.chdir(old_dir) + + # check if the compressed tarball was created + assert os.path.exists(archive_name) + + # now checks the rights + archive = tarfile.open(archive_name) + try: + for member in archive.getmembers(): + assert member.uid == 0 + assert member.gid == 0 + finally: + archive.close() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist.py new file mode 100644 index 000000000..d5696fc3d --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist.py @@ -0,0 +1,47 @@ +"""Tests for distutils.command.bdist.""" + +from distutils.command.bdist import bdist +from distutils.tests import support + + +class TestBuild(support.TempdirManager): + def test_formats(self): + # let's create a command and make sure + # we can set the format + dist = self.create_dist()[1] + cmd = bdist(dist) + cmd.formats = ['gztar'] + cmd.ensure_finalized() + assert cmd.formats == ['gztar'] + + # what formats does bdist offer? + formats = [ + 'bztar', + 'gztar', + 'rpm', + 'tar', + 'xztar', + 'zip', + 'ztar', + ] + found = sorted(cmd.format_commands) + assert found == formats + + def test_skip_build(self): + # bug #10946: bdist --skip-build should trickle down to subcommands + dist = self.create_dist()[1] + cmd = bdist(dist) + cmd.skip_build = True + cmd.ensure_finalized() + dist.command_obj['bdist'] = cmd + + names = [ + 'bdist_dumb', + ] # bdist_rpm does not support --skip-build + + for name in names: + subcmd = cmd.get_finalized_command(name) + if getattr(subcmd, '_unsupported', False): + # command is not supported on this build + continue + assert subcmd.skip_build, f'{name} should take --skip-build from bdist' diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist_dumb.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist_dumb.py new file mode 100644 index 000000000..1fc51d244 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist_dumb.py @@ -0,0 +1,78 @@ +"""Tests for distutils.command.bdist_dumb.""" + +import os +import sys +import zipfile +from distutils.command.bdist_dumb import bdist_dumb +from distutils.core import Distribution +from distutils.tests import support + +import pytest + +SETUP_PY = """\ +from distutils.core import setup +import foo + +setup(name='foo', version='0.1', py_modules=['foo'], + url='xxx', author='xxx', author_email='xxx') + +""" + + +@support.combine_markers +@pytest.mark.usefixtures('save_env') +@pytest.mark.usefixtures('save_argv') +@pytest.mark.usefixtures('save_cwd') +class TestBuildDumb( + support.TempdirManager, +): + @pytest.mark.usefixtures('needs_zlib') + def test_simple_built(self): + # let's create a simple package + tmp_dir = self.mkdtemp() + pkg_dir = os.path.join(tmp_dir, 'foo') + os.mkdir(pkg_dir) + self.write_file((pkg_dir, 'setup.py'), SETUP_PY) + self.write_file((pkg_dir, 'foo.py'), '#') + self.write_file((pkg_dir, 'MANIFEST.in'), 'include foo.py') + self.write_file((pkg_dir, 'README'), '') + + dist = Distribution({ + 'name': 'foo', + 'version': '0.1', + 'py_modules': ['foo'], + 'url': 'xxx', + 'author': 'xxx', + 'author_email': 'xxx', + }) + dist.script_name = 'setup.py' + os.chdir(pkg_dir) + + sys.argv = ['setup.py'] + cmd = bdist_dumb(dist) + + # so the output is the same no matter + # what is the platform + cmd.format = 'zip' + + cmd.ensure_finalized() + cmd.run() + + # see what we have + dist_created = os.listdir(os.path.join(pkg_dir, 'dist')) + base = f"{dist.get_fullname()}.{cmd.plat_name}.zip" + + assert dist_created == [base] + + # now let's check what we have in the zip file + fp = zipfile.ZipFile(os.path.join('dist', base)) + try: + contents = fp.namelist() + finally: + fp.close() + + contents = sorted(filter(None, map(os.path.basename, contents))) + wanted = ['foo-0.1-py{}.{}.egg-info'.format(*sys.version_info[:2]), 'foo.py'] + if not sys.dont_write_bytecode: + wanted.append(f'foo.{sys.implementation.cache_tag}.pyc') + assert contents == sorted(wanted) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist_rpm.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist_rpm.py new file mode 100644 index 000000000..75051430e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_bdist_rpm.py @@ -0,0 +1,127 @@ +"""Tests for distutils.command.bdist_rpm.""" + +import os +import shutil # noqa: F401 +import sys +from distutils.command.bdist_rpm import bdist_rpm +from distutils.core import Distribution +from distutils.tests import support + +import pytest +from test.support import requires_zlib + +SETUP_PY = """\ +from distutils.core import setup +import foo + +setup(name='foo', version='0.1', py_modules=['foo'], + url='xxx', author='xxx', author_email='xxx') + +""" + + +@pytest.fixture(autouse=True) +def sys_executable_encodable(): + try: + sys.executable.encode('UTF-8') + except UnicodeEncodeError: + pytest.skip("sys.executable is not encodable to UTF-8") + + +mac_woes = pytest.mark.skipif( + "not sys.platform.startswith('linux')", + reason='spurious sdtout/stderr output under macOS', +) + + +@pytest.mark.usefixtures('save_env') +@pytest.mark.usefixtures('save_argv') +@pytest.mark.usefixtures('save_cwd') +class TestBuildRpm( + support.TempdirManager, +): + @mac_woes + @requires_zlib() + @pytest.mark.skipif("not shutil.which('rpm')") + @pytest.mark.skipif("not shutil.which('rpmbuild')") + def test_quiet(self): + # let's create a package + tmp_dir = self.mkdtemp() + os.environ['HOME'] = tmp_dir # to confine dir '.rpmdb' creation + pkg_dir = os.path.join(tmp_dir, 'foo') + os.mkdir(pkg_dir) + self.write_file((pkg_dir, 'setup.py'), SETUP_PY) + self.write_file((pkg_dir, 'foo.py'), '#') + self.write_file((pkg_dir, 'MANIFEST.in'), 'include foo.py') + self.write_file((pkg_dir, 'README'), '') + + dist = Distribution({ + 'name': 'foo', + 'version': '0.1', + 'py_modules': ['foo'], + 'url': 'xxx', + 'author': 'xxx', + 'author_email': 'xxx', + }) + dist.script_name = 'setup.py' + os.chdir(pkg_dir) + + sys.argv = ['setup.py'] + cmd = bdist_rpm(dist) + cmd.fix_python = True + + # running in quiet mode + cmd.quiet = True + cmd.ensure_finalized() + cmd.run() + + dist_created = os.listdir(os.path.join(pkg_dir, 'dist')) + assert 'foo-0.1-1.noarch.rpm' in dist_created + + # bug #2945: upload ignores bdist_rpm files + assert ('bdist_rpm', 'any', 'dist/foo-0.1-1.src.rpm') in dist.dist_files + assert ('bdist_rpm', 'any', 'dist/foo-0.1-1.noarch.rpm') in dist.dist_files + + @mac_woes + @requires_zlib() + # https://bugs.python.org/issue1533164 + @pytest.mark.skipif("not shutil.which('rpm')") + @pytest.mark.skipif("not shutil.which('rpmbuild')") + def test_no_optimize_flag(self): + # let's create a package that breaks bdist_rpm + tmp_dir = self.mkdtemp() + os.environ['HOME'] = tmp_dir # to confine dir '.rpmdb' creation + pkg_dir = os.path.join(tmp_dir, 'foo') + os.mkdir(pkg_dir) + self.write_file((pkg_dir, 'setup.py'), SETUP_PY) + self.write_file((pkg_dir, 'foo.py'), '#') + self.write_file((pkg_dir, 'MANIFEST.in'), 'include foo.py') + self.write_file((pkg_dir, 'README'), '') + + dist = Distribution({ + 'name': 'foo', + 'version': '0.1', + 'py_modules': ['foo'], + 'url': 'xxx', + 'author': 'xxx', + 'author_email': 'xxx', + }) + dist.script_name = 'setup.py' + os.chdir(pkg_dir) + + sys.argv = ['setup.py'] + cmd = bdist_rpm(dist) + cmd.fix_python = True + + cmd.quiet = True + cmd.ensure_finalized() + cmd.run() + + dist_created = os.listdir(os.path.join(pkg_dir, 'dist')) + assert 'foo-0.1-1.noarch.rpm' in dist_created + + # bug #2945: upload ignores bdist_rpm files + assert ('bdist_rpm', 'any', 'dist/foo-0.1-1.src.rpm') in dist.dist_files + assert ('bdist_rpm', 'any', 'dist/foo-0.1-1.noarch.rpm') in dist.dist_files + + os.remove(os.path.join(pkg_dir, 'dist', 'foo-0.1-1.noarch.rpm')) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build.py new file mode 100644 index 000000000..f7fe69acd --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build.py @@ -0,0 +1,49 @@ +"""Tests for distutils.command.build.""" + +import os +import sys +from distutils.command.build import build +from distutils.tests import support +from sysconfig import get_config_var, get_platform + + +class TestBuild(support.TempdirManager): + def test_finalize_options(self): + pkg_dir, dist = self.create_dist() + cmd = build(dist) + cmd.finalize_options() + + # if not specified, plat_name gets the current platform + assert cmd.plat_name == get_platform() + + # build_purelib is build + lib + wanted = os.path.join(cmd.build_base, 'lib') + assert cmd.build_purelib == wanted + + # build_platlib is 'build/lib.platform-cache_tag[-pydebug]' + # examples: + # build/lib.macosx-10.3-i386-cpython39 + plat_spec = f'.{cmd.plat_name}-{sys.implementation.cache_tag}' + if get_config_var('Py_GIL_DISABLED'): + plat_spec += 't' + if hasattr(sys, 'gettotalrefcount'): + assert cmd.build_platlib.endswith('-pydebug') + plat_spec += '-pydebug' + wanted = os.path.join(cmd.build_base, 'lib' + plat_spec) + assert cmd.build_platlib == wanted + + # by default, build_lib = build_purelib + assert cmd.build_lib == cmd.build_purelib + + # build_temp is build/temp. + wanted = os.path.join(cmd.build_base, 'temp' + plat_spec) + assert cmd.build_temp == wanted + + # build_scripts is build/scripts-x.x + wanted = os.path.join( + cmd.build_base, f'scripts-{sys.version_info.major}.{sys.version_info.minor}' + ) + assert cmd.build_scripts == wanted + + # executable is os.path.normpath(sys.executable) + assert cmd.executable == os.path.normpath(sys.executable) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_clib.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_clib.py new file mode 100644 index 000000000..f76f26bce --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_clib.py @@ -0,0 +1,134 @@ +"""Tests for distutils.command.build_clib.""" + +import os +from distutils.command.build_clib import build_clib +from distutils.errors import DistutilsSetupError +from distutils.tests import missing_compiler_executable, support + +import pytest + + +class TestBuildCLib(support.TempdirManager): + def test_check_library_dist(self): + pkg_dir, dist = self.create_dist() + cmd = build_clib(dist) + + # 'libraries' option must be a list + with pytest.raises(DistutilsSetupError): + cmd.check_library_list('foo') + + # each element of 'libraries' must a 2-tuple + with pytest.raises(DistutilsSetupError): + cmd.check_library_list(['foo1', 'foo2']) + + # first element of each tuple in 'libraries' + # must be a string (the library name) + with pytest.raises(DistutilsSetupError): + cmd.check_library_list([(1, 'foo1'), ('name', 'foo2')]) + + # library name may not contain directory separators + with pytest.raises(DistutilsSetupError): + cmd.check_library_list( + [('name', 'foo1'), ('another/name', 'foo2')], + ) + + # second element of each tuple must be a dictionary (build info) + with pytest.raises(DistutilsSetupError): + cmd.check_library_list( + [('name', {}), ('another', 'foo2')], + ) + + # those work + libs = [('name', {}), ('name', {'ok': 'good'})] + cmd.check_library_list(libs) + + def test_get_source_files(self): + pkg_dir, dist = self.create_dist() + cmd = build_clib(dist) + + # "in 'libraries' option 'sources' must be present and must be + # a list of source filenames + cmd.libraries = [('name', {})] + with pytest.raises(DistutilsSetupError): + cmd.get_source_files() + + cmd.libraries = [('name', {'sources': 1})] + with pytest.raises(DistutilsSetupError): + cmd.get_source_files() + + cmd.libraries = [('name', {'sources': ['a', 'b']})] + assert cmd.get_source_files() == ['a', 'b'] + + cmd.libraries = [('name', {'sources': ('a', 'b')})] + assert cmd.get_source_files() == ['a', 'b'] + + cmd.libraries = [ + ('name', {'sources': ('a', 'b')}), + ('name2', {'sources': ['c', 'd']}), + ] + assert cmd.get_source_files() == ['a', 'b', 'c', 'd'] + + def test_build_libraries(self): + pkg_dir, dist = self.create_dist() + cmd = build_clib(dist) + + class FakeCompiler: + def compile(*args, **kw): + pass + + create_static_lib = compile + + cmd.compiler = FakeCompiler() + + # build_libraries is also doing a bit of typo checking + lib = [('name', {'sources': 'notvalid'})] + with pytest.raises(DistutilsSetupError): + cmd.build_libraries(lib) + + lib = [('name', {'sources': list()})] + cmd.build_libraries(lib) + + lib = [('name', {'sources': tuple()})] + cmd.build_libraries(lib) + + def test_finalize_options(self): + pkg_dir, dist = self.create_dist() + cmd = build_clib(dist) + + cmd.include_dirs = 'one-dir' + cmd.finalize_options() + assert cmd.include_dirs == ['one-dir'] + + cmd.include_dirs = None + cmd.finalize_options() + assert cmd.include_dirs == [] + + cmd.distribution.libraries = 'WONTWORK' + with pytest.raises(DistutilsSetupError): + cmd.finalize_options() + + @pytest.mark.skipif('platform.system() == "Windows"') + def test_run(self): + pkg_dir, dist = self.create_dist() + cmd = build_clib(dist) + + foo_c = os.path.join(pkg_dir, 'foo.c') + self.write_file(foo_c, 'int main(void) { return 1;}\n') + cmd.libraries = [('foo', {'sources': [foo_c]})] + + build_temp = os.path.join(pkg_dir, 'build') + os.mkdir(build_temp) + cmd.build_temp = build_temp + cmd.build_clib = build_temp + + # Before we run the command, we want to make sure + # all commands are present on the system. + ccmd = missing_compiler_executable() + if ccmd is not None: + self.skipTest(f'The {ccmd!r} command is not found') + + # this should work + cmd.run() + + # let's check the result + assert 'libfoo.a' in os.listdir(build_temp) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_ext.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_ext.py new file mode 100644 index 000000000..dab0507f3 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_ext.py @@ -0,0 +1,628 @@ +import contextlib +import glob +import importlib +import os.path +import platform +import re +import shutil +import site +import subprocess +import sys +import tempfile +import textwrap +import time +from distutils import sysconfig +from distutils.command.build_ext import build_ext +from distutils.core import Distribution +from distutils.errors import ( + CompileError, + DistutilsPlatformError, + DistutilsSetupError, + UnknownFileError, +) +from distutils.extension import Extension +from distutils.tests import missing_compiler_executable +from distutils.tests.support import TempdirManager, copy_xxmodule_c, fixup_build_ext +from io import StringIO + +import jaraco.path +import path +import pytest +from test import support + +from .compat import py39 as import_helper + + +@pytest.fixture() +def user_site_dir(request): + self = request.instance + self.tmp_dir = self.mkdtemp() + self.tmp_path = path.Path(self.tmp_dir) + from distutils.command import build_ext + + orig_user_base = site.USER_BASE + + site.USER_BASE = self.mkdtemp() + build_ext.USER_BASE = site.USER_BASE + + # bpo-30132: On Windows, a .pdb file may be created in the current + # working directory. Create a temporary working directory to cleanup + # everything at the end of the test. + with self.tmp_path: + yield + + site.USER_BASE = orig_user_base + build_ext.USER_BASE = orig_user_base + + if sys.platform == 'cygwin': + time.sleep(1) + + +@contextlib.contextmanager +def safe_extension_import(name, path): + with import_helper.CleanImport(name): + with extension_redirect(name, path) as new_path: + with import_helper.DirsOnSysPath(new_path): + yield + + +@contextlib.contextmanager +def extension_redirect(mod, path): + """ + Tests will fail to tear down an extension module if it's been imported. + + Before importing, copy the file to a temporary directory that won't + be cleaned up. Yield the new path. + """ + if platform.system() != "Windows" and sys.platform != "cygwin": + yield path + return + with import_helper.DirsOnSysPath(path): + spec = importlib.util.find_spec(mod) + filename = os.path.basename(spec.origin) + trash_dir = tempfile.mkdtemp(prefix='deleteme') + dest = os.path.join(trash_dir, os.path.basename(filename)) + shutil.copy(spec.origin, dest) + yield trash_dir + # TODO: can the file be scheduled for deletion? + + +@pytest.mark.usefixtures('user_site_dir') +class TestBuildExt(TempdirManager): + def build_ext(self, *args, **kwargs): + return build_ext(*args, **kwargs) + + @pytest.mark.parametrize("copy_so", [False]) + def test_build_ext(self, copy_so): + missing_compiler_executable() + copy_xxmodule_c(self.tmp_dir) + xx_c = os.path.join(self.tmp_dir, 'xxmodule.c') + xx_ext = Extension('xx', [xx_c]) + if sys.platform != "win32": + if not copy_so: + xx_ext = Extension( + 'xx', + [xx_c], + library_dirs=['/usr/lib'], + libraries=['z'], + runtime_library_dirs=['/usr/lib'], + ) + elif sys.platform == 'linux': + libz_so = { + os.path.realpath(name) for name in glob.iglob('/usr/lib*/libz.so*') + } + libz_so = sorted(libz_so, key=lambda lib_path: len(lib_path)) + shutil.copyfile(libz_so[-1], '/tmp/libxx_z.so') + + xx_ext = Extension( + 'xx', + [xx_c], + library_dirs=['/tmp'], + libraries=['xx_z'], + runtime_library_dirs=['/tmp'], + ) + dist = Distribution({'name': 'xx', 'ext_modules': [xx_ext]}) + dist.package_dir = self.tmp_dir + cmd = self.build_ext(dist) + fixup_build_ext(cmd) + cmd.build_lib = self.tmp_dir + cmd.build_temp = self.tmp_dir + + old_stdout = sys.stdout + if not support.verbose: + # silence compiler output + sys.stdout = StringIO() + try: + cmd.ensure_finalized() + cmd.run() + finally: + sys.stdout = old_stdout + + with safe_extension_import('xx', self.tmp_dir): + self._test_xx(copy_so) + + if sys.platform == 'linux' and copy_so: + os.unlink('/tmp/libxx_z.so') + + @staticmethod + def _test_xx(copy_so): + import xx # type: ignore[import-not-found] # Module generated for tests + + for attr in ('error', 'foo', 'new', 'roj'): + assert hasattr(xx, attr) + + assert xx.foo(2, 5) == 7 + assert xx.foo(13, 15) == 28 + assert xx.new().demo() is None + if support.HAVE_DOCSTRINGS: + doc = 'This is a template module just for instruction.' + assert xx.__doc__ == doc + assert isinstance(xx.Null(), xx.Null) + assert isinstance(xx.Str(), xx.Str) + + if sys.platform == 'linux': + so_headers = subprocess.check_output( + ["readelf", "-d", xx.__file__], universal_newlines=True + ) + import pprint + + pprint.pprint(so_headers) + rpaths = [ + rpath + for line in so_headers.split("\n") + if "RPATH" in line or "RUNPATH" in line + for rpath in line.split()[2][1:-1].split(":") + ] + if not copy_so: + pprint.pprint(rpaths) + # Linked against a library in /usr/lib{,64} + assert "/usr/lib" not in rpaths and "/usr/lib64" not in rpaths + else: + # Linked against a library in /tmp + assert "/tmp" in rpaths + # The import is the real test here + + def test_solaris_enable_shared(self): + dist = Distribution({'name': 'xx'}) + cmd = self.build_ext(dist) + old = sys.platform + + sys.platform = 'sunos' # fooling finalize_options + from distutils.sysconfig import _config_vars + + old_var = _config_vars.get('Py_ENABLE_SHARED') + _config_vars['Py_ENABLE_SHARED'] = True + try: + cmd.ensure_finalized() + finally: + sys.platform = old + if old_var is None: + del _config_vars['Py_ENABLE_SHARED'] + else: + _config_vars['Py_ENABLE_SHARED'] = old_var + + # make sure we get some library dirs under solaris + assert len(cmd.library_dirs) > 0 + + def test_user_site(self): + import site + + dist = Distribution({'name': 'xx'}) + cmd = self.build_ext(dist) + + # making sure the user option is there + options = [name for name, short, label in cmd.user_options] + assert 'user' in options + + # setting a value + cmd.user = True + + # setting user based lib and include + lib = os.path.join(site.USER_BASE, 'lib') + incl = os.path.join(site.USER_BASE, 'include') + os.mkdir(lib) + os.mkdir(incl) + + # let's run finalize + cmd.ensure_finalized() + + # see if include_dirs and library_dirs + # were set + assert lib in cmd.library_dirs + assert lib in cmd.rpath + assert incl in cmd.include_dirs + + def test_optional_extension(self): + # this extension will fail, but let's ignore this failure + # with the optional argument. + modules = [Extension('foo', ['xxx'], optional=False)] + dist = Distribution({'name': 'xx', 'ext_modules': modules}) + cmd = self.build_ext(dist) + cmd.ensure_finalized() + with pytest.raises((UnknownFileError, CompileError)): + cmd.run() # should raise an error + + modules = [Extension('foo', ['xxx'], optional=True)] + dist = Distribution({'name': 'xx', 'ext_modules': modules}) + cmd = self.build_ext(dist) + cmd.ensure_finalized() + cmd.run() # should pass + + def test_finalize_options(self): + # Make sure Python's include directories (for Python.h, pyconfig.h, + # etc.) are in the include search path. + modules = [Extension('foo', ['xxx'], optional=False)] + dist = Distribution({'name': 'xx', 'ext_modules': modules}) + cmd = self.build_ext(dist) + cmd.finalize_options() + + py_include = sysconfig.get_python_inc() + for p in py_include.split(os.path.pathsep): + assert p in cmd.include_dirs + + plat_py_include = sysconfig.get_python_inc(plat_specific=True) + for p in plat_py_include.split(os.path.pathsep): + assert p in cmd.include_dirs + + # make sure cmd.libraries is turned into a list + # if it's a string + cmd = self.build_ext(dist) + cmd.libraries = 'my_lib, other_lib lastlib' + cmd.finalize_options() + assert cmd.libraries == ['my_lib', 'other_lib', 'lastlib'] + + # make sure cmd.library_dirs is turned into a list + # if it's a string + cmd = self.build_ext(dist) + cmd.library_dirs = f'my_lib_dir{os.pathsep}other_lib_dir' + cmd.finalize_options() + assert 'my_lib_dir' in cmd.library_dirs + assert 'other_lib_dir' in cmd.library_dirs + + # make sure rpath is turned into a list + # if it's a string + cmd = self.build_ext(dist) + cmd.rpath = f'one{os.pathsep}two' + cmd.finalize_options() + assert cmd.rpath == ['one', 'two'] + + # make sure cmd.link_objects is turned into a list + # if it's a string + cmd = build_ext(dist) + cmd.link_objects = 'one two,three' + cmd.finalize_options() + assert cmd.link_objects == ['one', 'two', 'three'] + + # XXX more tests to perform for win32 + + # make sure define is turned into 2-tuples + # strings if they are ','-separated strings + cmd = self.build_ext(dist) + cmd.define = 'one,two' + cmd.finalize_options() + assert cmd.define == [('one', '1'), ('two', '1')] + + # make sure undef is turned into a list of + # strings if they are ','-separated strings + cmd = self.build_ext(dist) + cmd.undef = 'one,two' + cmd.finalize_options() + assert cmd.undef == ['one', 'two'] + + # make sure swig_opts is turned into a list + cmd = self.build_ext(dist) + cmd.swig_opts = None + cmd.finalize_options() + assert cmd.swig_opts == [] + + cmd = self.build_ext(dist) + cmd.swig_opts = '1 2' + cmd.finalize_options() + assert cmd.swig_opts == ['1', '2'] + + def test_check_extensions_list(self): + dist = Distribution() + cmd = self.build_ext(dist) + cmd.finalize_options() + + # 'extensions' option must be a list of Extension instances + with pytest.raises(DistutilsSetupError): + cmd.check_extensions_list('foo') + + # each element of 'ext_modules' option must be an + # Extension instance or 2-tuple + exts = [('bar', 'foo', 'bar'), 'foo'] + with pytest.raises(DistutilsSetupError): + cmd.check_extensions_list(exts) + + # first element of each tuple in 'ext_modules' + # must be the extension name (a string) and match + # a python dotted-separated name + exts = [('foo-bar', '')] + with pytest.raises(DistutilsSetupError): + cmd.check_extensions_list(exts) + + # second element of each tuple in 'ext_modules' + # must be a dictionary (build info) + exts = [('foo.bar', '')] + with pytest.raises(DistutilsSetupError): + cmd.check_extensions_list(exts) + + # ok this one should pass + exts = [('foo.bar', {'sources': [''], 'libraries': 'foo', 'some': 'bar'})] + cmd.check_extensions_list(exts) + ext = exts[0] + assert isinstance(ext, Extension) + + # check_extensions_list adds in ext the values passed + # when they are in ('include_dirs', 'library_dirs', 'libraries' + # 'extra_objects', 'extra_compile_args', 'extra_link_args') + assert ext.libraries == 'foo' + assert not hasattr(ext, 'some') + + # 'macros' element of build info dict must be 1- or 2-tuple + exts = [ + ( + 'foo.bar', + { + 'sources': [''], + 'libraries': 'foo', + 'some': 'bar', + 'macros': [('1', '2', '3'), 'foo'], + }, + ) + ] + with pytest.raises(DistutilsSetupError): + cmd.check_extensions_list(exts) + + exts[0][1]['macros'] = [('1', '2'), ('3',)] + cmd.check_extensions_list(exts) + assert exts[0].undef_macros == ['3'] + assert exts[0].define_macros == [('1', '2')] + + def test_get_source_files(self): + modules = [Extension('foo', ['xxx'], optional=False)] + dist = Distribution({'name': 'xx', 'ext_modules': modules}) + cmd = self.build_ext(dist) + cmd.ensure_finalized() + assert cmd.get_source_files() == ['xxx'] + + def test_unicode_module_names(self): + modules = [ + Extension('foo', ['aaa'], optional=False), + Extension('föö', ['uuu'], optional=False), + ] + dist = Distribution({'name': 'xx', 'ext_modules': modules}) + cmd = self.build_ext(dist) + cmd.ensure_finalized() + assert re.search(r'foo(_d)?\..*', cmd.get_ext_filename(modules[0].name)) + assert re.search(r'föö(_d)?\..*', cmd.get_ext_filename(modules[1].name)) + assert cmd.get_export_symbols(modules[0]) == ['PyInit_foo'] + assert cmd.get_export_symbols(modules[1]) == ['PyInitU_f_1gaa'] + + def test_export_symbols__init__(self): + # https://github.com/python/cpython/issues/80074 + # https://github.com/pypa/setuptools/issues/4826 + modules = [ + Extension('foo.__init__', ['aaa']), + Extension('föö.__init__', ['uuu']), + ] + dist = Distribution({'name': 'xx', 'ext_modules': modules}) + cmd = self.build_ext(dist) + cmd.ensure_finalized() + assert cmd.get_export_symbols(modules[0]) == ['PyInit_foo'] + assert cmd.get_export_symbols(modules[1]) == ['PyInitU_f_1gaa'] + + def test_compiler_option(self): + # cmd.compiler is an option and + # should not be overridden by a compiler instance + # when the command is run + dist = Distribution() + cmd = self.build_ext(dist) + cmd.compiler = 'unix' + cmd.ensure_finalized() + cmd.run() + assert cmd.compiler == 'unix' + + def test_get_outputs(self): + missing_compiler_executable() + tmp_dir = self.mkdtemp() + c_file = os.path.join(tmp_dir, 'foo.c') + self.write_file(c_file, 'void PyInit_foo(void) {}\n') + ext = Extension('foo', [c_file], optional=False) + dist = Distribution({'name': 'xx', 'ext_modules': [ext]}) + cmd = self.build_ext(dist) + fixup_build_ext(cmd) + cmd.ensure_finalized() + assert len(cmd.get_outputs()) == 1 + + cmd.build_lib = os.path.join(self.tmp_dir, 'build') + cmd.build_temp = os.path.join(self.tmp_dir, 'tempt') + + # issue #5977 : distutils build_ext.get_outputs + # returns wrong result with --inplace + other_tmp_dir = os.path.realpath(self.mkdtemp()) + old_wd = os.getcwd() + os.chdir(other_tmp_dir) + try: + cmd.inplace = True + cmd.run() + so_file = cmd.get_outputs()[0] + finally: + os.chdir(old_wd) + assert os.path.exists(so_file) + ext_suffix = sysconfig.get_config_var('EXT_SUFFIX') + assert so_file.endswith(ext_suffix) + so_dir = os.path.dirname(so_file) + assert so_dir == other_tmp_dir + + cmd.inplace = False + cmd.compiler = None + cmd.run() + so_file = cmd.get_outputs()[0] + assert os.path.exists(so_file) + assert so_file.endswith(ext_suffix) + so_dir = os.path.dirname(so_file) + assert so_dir == cmd.build_lib + + # inplace = False, cmd.package = 'bar' + build_py = cmd.get_finalized_command('build_py') + build_py.package_dir = {'': 'bar'} + path = cmd.get_ext_fullpath('foo') + # checking that the last directory is the build_dir + path = os.path.split(path)[0] + assert path == cmd.build_lib + + # inplace = True, cmd.package = 'bar' + cmd.inplace = True + other_tmp_dir = os.path.realpath(self.mkdtemp()) + old_wd = os.getcwd() + os.chdir(other_tmp_dir) + try: + path = cmd.get_ext_fullpath('foo') + finally: + os.chdir(old_wd) + # checking that the last directory is bar + path = os.path.split(path)[0] + lastdir = os.path.split(path)[-1] + assert lastdir == 'bar' + + def test_ext_fullpath(self): + ext = sysconfig.get_config_var('EXT_SUFFIX') + # building lxml.etree inplace + # etree_c = os.path.join(self.tmp_dir, 'lxml.etree.c') + # etree_ext = Extension('lxml.etree', [etree_c]) + # dist = Distribution({'name': 'lxml', 'ext_modules': [etree_ext]}) + dist = Distribution() + cmd = self.build_ext(dist) + cmd.inplace = True + cmd.distribution.package_dir = {'': 'src'} + cmd.distribution.packages = ['lxml', 'lxml.html'] + curdir = os.getcwd() + wanted = os.path.join(curdir, 'src', 'lxml', 'etree' + ext) + path = cmd.get_ext_fullpath('lxml.etree') + assert wanted == path + + # building lxml.etree not inplace + cmd.inplace = False + cmd.build_lib = os.path.join(curdir, 'tmpdir') + wanted = os.path.join(curdir, 'tmpdir', 'lxml', 'etree' + ext) + path = cmd.get_ext_fullpath('lxml.etree') + assert wanted == path + + # building twisted.runner.portmap not inplace + build_py = cmd.get_finalized_command('build_py') + build_py.package_dir = {} + cmd.distribution.packages = ['twisted', 'twisted.runner.portmap'] + path = cmd.get_ext_fullpath('twisted.runner.portmap') + wanted = os.path.join(curdir, 'tmpdir', 'twisted', 'runner', 'portmap' + ext) + assert wanted == path + + # building twisted.runner.portmap inplace + cmd.inplace = True + path = cmd.get_ext_fullpath('twisted.runner.portmap') + wanted = os.path.join(curdir, 'twisted', 'runner', 'portmap' + ext) + assert wanted == path + + @pytest.mark.skipif('platform.system() != "Darwin"') + @pytest.mark.usefixtures('save_env') + def test_deployment_target_default(self): + # Issue 9516: Test that, in the absence of the environment variable, + # an extension module is compiled with the same deployment target as + # the interpreter. + self._try_compile_deployment_target('==', None) + + @pytest.mark.skipif('platform.system() != "Darwin"') + @pytest.mark.usefixtures('save_env') + def test_deployment_target_too_low(self): + # Issue 9516: Test that an extension module is not allowed to be + # compiled with a deployment target less than that of the interpreter. + with pytest.raises(DistutilsPlatformError): + self._try_compile_deployment_target('>', '10.1') + + @pytest.mark.skipif('platform.system() != "Darwin"') + @pytest.mark.usefixtures('save_env') + def test_deployment_target_higher_ok(self): # pragma: no cover + # Issue 9516: Test that an extension module can be compiled with a + # deployment target higher than that of the interpreter: the ext + # module may depend on some newer OS feature. + deptarget = sysconfig.get_config_var('MACOSX_DEPLOYMENT_TARGET') + if deptarget: + # increment the minor version number (i.e. 10.6 -> 10.7) + deptarget = [int(x) for x in deptarget.split('.')] + deptarget[-1] += 1 + deptarget = '.'.join(str(i) for i in deptarget) + self._try_compile_deployment_target('<', deptarget) + + def _try_compile_deployment_target(self, operator, target): # pragma: no cover + if target is None: + if os.environ.get('MACOSX_DEPLOYMENT_TARGET'): + del os.environ['MACOSX_DEPLOYMENT_TARGET'] + else: + os.environ['MACOSX_DEPLOYMENT_TARGET'] = target + + jaraco.path.build( + { + 'deptargetmodule.c': textwrap.dedent(f"""\ + #include + + int dummy; + + #if TARGET {operator} MAC_OS_X_VERSION_MIN_REQUIRED + #else + #error "Unexpected target" + #endif + + """), + }, + self.tmp_path, + ) + + # get the deployment target that the interpreter was built with + target = sysconfig.get_config_var('MACOSX_DEPLOYMENT_TARGET') + target = tuple(map(int, target.split('.')[0:2])) + # format the target value as defined in the Apple + # Availability Macros. We can't use the macro names since + # at least one value we test with will not exist yet. + if target[:2] < (10, 10): + # for 10.1 through 10.9.x -> "10n0" + tmpl = '{:02}{:01}0' + else: + # for 10.10 and beyond -> "10nn00" + if len(target) >= 2: + tmpl = '{:02}{:02}00' + else: + # 11 and later can have no minor version (11 instead of 11.0) + tmpl = '{:02}0000' + target = tmpl.format(*target) + deptarget_ext = Extension( + 'deptarget', + [self.tmp_path / 'deptargetmodule.c'], + extra_compile_args=[f'-DTARGET={target}'], + ) + dist = Distribution({'name': 'deptarget', 'ext_modules': [deptarget_ext]}) + dist.package_dir = self.tmp_dir + cmd = self.build_ext(dist) + cmd.build_lib = self.tmp_dir + cmd.build_temp = self.tmp_dir + + try: + old_stdout = sys.stdout + if not support.verbose: + # silence compiler output + sys.stdout = StringIO() + try: + cmd.ensure_finalized() + cmd.run() + finally: + sys.stdout = old_stdout + + except CompileError: + self.fail("Wrong deployment target during compilation") + + +class TestParallelBuildExt(TestBuildExt): + def build_ext(self, *args, **kwargs): + build_ext = super().build_ext(*args, **kwargs) + build_ext.parallel = True + return build_ext diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_py.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_py.py new file mode 100644 index 000000000..b316ed43a --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_py.py @@ -0,0 +1,196 @@ +"""Tests for distutils.command.build_py.""" + +import os +import sys +from distutils.command.build_py import build_py +from distutils.core import Distribution +from distutils.errors import DistutilsFileError +from distutils.tests import support + +import jaraco.path +import pytest + + +@support.combine_markers +class TestBuildPy(support.TempdirManager): + def test_package_data(self): + sources = self.mkdtemp() + jaraco.path.build( + { + '__init__.py': "# Pretend this is a package.", + 'README.txt': 'Info about this package', + }, + sources, + ) + + destination = self.mkdtemp() + + dist = Distribution({"packages": ["pkg"], "package_dir": {"pkg": sources}}) + # script_name need not exist, it just need to be initialized + dist.script_name = os.path.join(sources, "setup.py") + dist.command_obj["build"] = support.DummyCommand( + force=False, build_lib=destination + ) + dist.packages = ["pkg"] + dist.package_data = {"pkg": ["README.txt"]} + dist.package_dir = {"pkg": sources} + + cmd = build_py(dist) + cmd.compile = True + cmd.ensure_finalized() + assert cmd.package_data == dist.package_data + + cmd.run() + + # This makes sure the list of outputs includes byte-compiled + # files for Python modules but not for package data files + # (there shouldn't *be* byte-code files for those!). + assert len(cmd.get_outputs()) == 3 + pkgdest = os.path.join(destination, "pkg") + files = os.listdir(pkgdest) + pycache_dir = os.path.join(pkgdest, "__pycache__") + assert "__init__.py" in files + assert "README.txt" in files + if sys.dont_write_bytecode: + assert not os.path.exists(pycache_dir) + else: + pyc_files = os.listdir(pycache_dir) + assert f"__init__.{sys.implementation.cache_tag}.pyc" in pyc_files + + def test_empty_package_dir(self): + # See bugs #1668596/#1720897 + sources = self.mkdtemp() + jaraco.path.build({'__init__.py': '', 'doc': {'testfile': ''}}, sources) + + os.chdir(sources) + dist = Distribution({ + "packages": ["pkg"], + "package_dir": {"pkg": ""}, + "package_data": {"pkg": ["doc/*"]}, + }) + # script_name need not exist, it just need to be initialized + dist.script_name = os.path.join(sources, "setup.py") + dist.script_args = ["build"] + dist.parse_command_line() + + try: + dist.run_commands() + except DistutilsFileError: + self.fail("failed package_data test when package_dir is ''") + + @pytest.mark.skipif('sys.dont_write_bytecode') + def test_byte_compile(self): + project_dir, dist = self.create_dist(py_modules=['boiledeggs']) + os.chdir(project_dir) + self.write_file('boiledeggs.py', 'import antigravity') + cmd = build_py(dist) + cmd.compile = True + cmd.build_lib = 'here' + cmd.finalize_options() + cmd.run() + + found = os.listdir(cmd.build_lib) + assert sorted(found) == ['__pycache__', 'boiledeggs.py'] + found = os.listdir(os.path.join(cmd.build_lib, '__pycache__')) + assert found == [f'boiledeggs.{sys.implementation.cache_tag}.pyc'] + + @pytest.mark.skipif('sys.dont_write_bytecode') + def test_byte_compile_optimized(self): + project_dir, dist = self.create_dist(py_modules=['boiledeggs']) + os.chdir(project_dir) + self.write_file('boiledeggs.py', 'import antigravity') + cmd = build_py(dist) + cmd.compile = False + cmd.optimize = 1 + cmd.build_lib = 'here' + cmd.finalize_options() + cmd.run() + + found = os.listdir(cmd.build_lib) + assert sorted(found) == ['__pycache__', 'boiledeggs.py'] + found = os.listdir(os.path.join(cmd.build_lib, '__pycache__')) + expect = f'boiledeggs.{sys.implementation.cache_tag}.opt-1.pyc' + assert sorted(found) == [expect] + + def test_dir_in_package_data(self): + """ + A directory in package_data should not be added to the filelist. + """ + # See bug 19286 + sources = self.mkdtemp() + jaraco.path.build( + { + 'pkg': { + '__init__.py': '', + 'doc': { + 'testfile': '', + # create a directory that could be incorrectly detected as a file + 'otherdir': {}, + }, + } + }, + sources, + ) + + os.chdir(sources) + dist = Distribution({"packages": ["pkg"], "package_data": {"pkg": ["doc/*"]}}) + # script_name need not exist, it just need to be initialized + dist.script_name = os.path.join(sources, "setup.py") + dist.script_args = ["build"] + dist.parse_command_line() + + try: + dist.run_commands() + except DistutilsFileError: + self.fail("failed package_data when data dir includes a dir") + + def test_dont_write_bytecode(self, caplog): + # makes sure byte_compile is not used + dist = self.create_dist()[1] + cmd = build_py(dist) + cmd.compile = True + cmd.optimize = 1 + + old_dont_write_bytecode = sys.dont_write_bytecode + sys.dont_write_bytecode = True + try: + cmd.byte_compile([]) + finally: + sys.dont_write_bytecode = old_dont_write_bytecode + + assert 'byte-compiling is disabled' in caplog.records[0].message + + def test_namespace_package_does_not_warn(self, caplog): + """ + Originally distutils implementation did not account for PEP 420 + and included warns for package directories that did not contain + ``__init__.py`` files. + After the acceptance of PEP 420, these warnings don't make more sense + so we want to ensure there are not displayed to not confuse the users. + """ + # Create a fake project structure with a package namespace: + tmp = self.mkdtemp() + jaraco.path.build({'ns': {'pkg': {'module.py': ''}}}, tmp) + os.chdir(tmp) + + # Configure the package: + attrs = { + "name": "ns.pkg", + "packages": ["ns", "ns.pkg"], + "script_name": "setup.py", + } + dist = Distribution(attrs) + + # Run code paths that would trigger the trap: + cmd = dist.get_command_obj("build_py") + cmd.finalize_options() + modules = cmd.find_all_modules() + assert len(modules) == 1 + module_path = modules[0][-1] + assert module_path.replace(os.sep, "/") == "ns/pkg/module.py" + + cmd.run() + + assert not any( + "package init file" in msg and "not found" in msg for msg in caplog.messages + ) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_scripts.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_scripts.py new file mode 100644 index 000000000..3582f691e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_build_scripts.py @@ -0,0 +1,96 @@ +"""Tests for distutils.command.build_scripts.""" + +import os +import textwrap +from distutils import sysconfig +from distutils.command.build_scripts import build_scripts +from distutils.core import Distribution +from distutils.tests import support + +import jaraco.path + + +class TestBuildScripts(support.TempdirManager): + def test_default_settings(self): + cmd = self.get_build_scripts_cmd("/foo/bar", []) + assert not cmd.force + assert cmd.build_dir is None + + cmd.finalize_options() + + assert cmd.force + assert cmd.build_dir == "/foo/bar" + + def test_build(self): + source = self.mkdtemp() + target = self.mkdtemp() + expected = self.write_sample_scripts(source) + + cmd = self.get_build_scripts_cmd( + target, [os.path.join(source, fn) for fn in expected] + ) + cmd.finalize_options() + cmd.run() + + built = os.listdir(target) + for name in expected: + assert name in built + + def get_build_scripts_cmd(self, target, scripts): + import sys + + dist = Distribution() + dist.scripts = scripts + dist.command_obj["build"] = support.DummyCommand( + build_scripts=target, force=True, executable=sys.executable + ) + return build_scripts(dist) + + @staticmethod + def write_sample_scripts(dir): + spec = { + 'script1.py': textwrap.dedent(""" + #! /usr/bin/env python2.3 + # bogus script w/ Python sh-bang + pass + """).lstrip(), + 'script2.py': textwrap.dedent(""" + #!/usr/bin/python + # bogus script w/ Python sh-bang + pass + """).lstrip(), + 'shell.sh': textwrap.dedent(""" + #!/bin/sh + # bogus shell script w/ sh-bang + exit 0 + """).lstrip(), + } + jaraco.path.build(spec, dir) + return list(spec) + + def test_version_int(self): + source = self.mkdtemp() + target = self.mkdtemp() + expected = self.write_sample_scripts(source) + + cmd = self.get_build_scripts_cmd( + target, [os.path.join(source, fn) for fn in expected] + ) + cmd.finalize_options() + + # https://bugs.python.org/issue4524 + # + # On linux-g++-32 with command line `./configure --enable-ipv6 + # --with-suffix=3`, python is compiled okay but the build scripts + # failed when writing the name of the executable + old = sysconfig.get_config_vars().get('VERSION') + sysconfig._config_vars['VERSION'] = 4 + try: + cmd.run() + finally: + if old is not None: + sysconfig._config_vars['VERSION'] = old + + built = os.listdir(target) + for name in expected: + assert name in built diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_check.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_check.py new file mode 100644 index 000000000..b672b1f97 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_check.py @@ -0,0 +1,194 @@ +"""Tests for distutils.command.check.""" + +import os +import textwrap +from distutils.command.check import check +from distutils.errors import DistutilsSetupError +from distutils.tests import support + +import pytest + +try: + import pygments +except ImportError: + pygments = None + + +HERE = os.path.dirname(__file__) + + +@support.combine_markers +class TestCheck(support.TempdirManager): + def _run(self, metadata=None, cwd=None, **options): + if metadata is None: + metadata = {} + if cwd is not None: + old_dir = os.getcwd() + os.chdir(cwd) + pkg_info, dist = self.create_dist(**metadata) + cmd = check(dist) + cmd.initialize_options() + for name, value in options.items(): + setattr(cmd, name, value) + cmd.ensure_finalized() + cmd.run() + if cwd is not None: + os.chdir(old_dir) + return cmd + + def test_check_metadata(self): + # let's run the command with no metadata at all + # by default, check is checking the metadata + # should have some warnings + cmd = self._run() + assert cmd._warnings == 1 + + # now let's add the required fields + # and run it again, to make sure we don't get + # any warning anymore + metadata = { + 'url': 'xxx', + 'author': 'xxx', + 'author_email': 'xxx', + 'name': 'xxx', + 'version': 'xxx', + } + cmd = self._run(metadata) + assert cmd._warnings == 0 + + # now with the strict mode, we should + # get an error if there are missing metadata + with pytest.raises(DistutilsSetupError): + self._run({}, **{'strict': 1}) + + # and of course, no error when all metadata are present + cmd = self._run(metadata, strict=True) + assert cmd._warnings == 0 + + # now a test with non-ASCII characters + metadata = { + 'url': 'xxx', + 'author': '\u00c9ric', + 'author_email': 'xxx', + 'name': 'xxx', + 'version': 'xxx', + 'description': 'Something about esszet \u00df', + 'long_description': 'More things about esszet \u00df', + } + cmd = self._run(metadata) + assert cmd._warnings == 0 + + def test_check_author_maintainer(self): + for kind in ("author", "maintainer"): + # ensure no warning when author_email or maintainer_email is given + # (the spec allows these fields to take the form "Name ") + metadata = { + 'url': 'xxx', + kind + '_email': 'Name ', + 'name': 'xxx', + 'version': 'xxx', + } + cmd = self._run(metadata) + assert cmd._warnings == 0 + + # the check should not warn if only email is given + metadata[kind + '_email'] = 'name@email.com' + cmd = self._run(metadata) + assert cmd._warnings == 0 + + # the check should not warn if only the name is given + metadata[kind] = "Name" + del metadata[kind + '_email'] + cmd = self._run(metadata) + assert cmd._warnings == 0 + + def test_check_document(self): + pytest.importorskip('docutils') + pkg_info, dist = self.create_dist() + cmd = check(dist) + + # let's see if it detects broken rest + broken_rest = 'title\n===\n\ntest' + msgs = cmd._check_rst_data(broken_rest) + assert len(msgs) == 1 + + # and non-broken rest + rest = 'title\n=====\n\ntest' + msgs = cmd._check_rst_data(rest) + assert len(msgs) == 0 + + def test_check_restructuredtext(self): + pytest.importorskip('docutils') + # let's see if it detects broken rest in long_description + broken_rest = 'title\n===\n\ntest' + pkg_info, dist = self.create_dist(long_description=broken_rest) + cmd = check(dist) + cmd.check_restructuredtext() + assert cmd._warnings == 1 + + # let's see if we have an error with strict=True + metadata = { + 'url': 'xxx', + 'author': 'xxx', + 'author_email': 'xxx', + 'name': 'xxx', + 'version': 'xxx', + 'long_description': broken_rest, + } + with pytest.raises(DistutilsSetupError): + self._run(metadata, **{'strict': 1, 'restructuredtext': 1}) + + # and non-broken rest, including a non-ASCII character to test #12114 + metadata['long_description'] = 'title\n=====\n\ntest \u00df' + cmd = self._run(metadata, strict=True, restructuredtext=True) + assert cmd._warnings == 0 + + # check that includes work to test #31292 + metadata['long_description'] = 'title\n=====\n\n.. include:: includetest.rst' + cmd = self._run(metadata, cwd=HERE, strict=True, restructuredtext=True) + assert cmd._warnings == 0 + + def test_check_restructuredtext_with_syntax_highlight(self): + pytest.importorskip('docutils') + # Don't fail if there is a `code` or `code-block` directive + + example_rst_docs = [ + textwrap.dedent( + """\ + Here's some code: + + .. code:: python + + def foo(): + pass + """ + ), + textwrap.dedent( + """\ + Here's some code: + + .. code-block:: python + + def foo(): + pass + """ + ), + ] + + for rest_with_code in example_rst_docs: + pkg_info, dist = self.create_dist(long_description=rest_with_code) + cmd = check(dist) + cmd.check_restructuredtext() + msgs = cmd._check_rst_data(rest_with_code) + if pygments is not None: + assert len(msgs) == 0 + else: + assert len(msgs) == 1 + assert ( + str(msgs[0][1]) + == 'Cannot analyze code. Pygments package not found.' + ) + + def test_check_all(self): + with pytest.raises(DistutilsSetupError): + self._run({}, **{'strict': 1, 'restructuredtext': 1}) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_clean.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_clean.py new file mode 100644 index 000000000..cc78f30f3 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_clean.py @@ -0,0 +1,45 @@ +"""Tests for distutils.command.clean.""" + +import os +from distutils.command.clean import clean +from distutils.tests import support + + +class TestClean(support.TempdirManager): + def test_simple_run(self): + pkg_dir, dist = self.create_dist() + cmd = clean(dist) + + # let's add some elements clean should remove + dirs = [ + (d, os.path.join(pkg_dir, d)) + for d in ( + 'build_temp', + 'build_lib', + 'bdist_base', + 'build_scripts', + 'build_base', + ) + ] + + for name, path in dirs: + os.mkdir(path) + setattr(cmd, name, path) + if name == 'build_base': + continue + for f in ('one', 'two', 'three'): + self.write_file(os.path.join(path, f)) + + # let's run the command + cmd.all = 1 + cmd.ensure_finalized() + cmd.run() + + # make sure the files where removed + for _name, path in dirs: + assert not os.path.exists(path), f'{path} was not removed' + + # let's run the command again (should spit warnings but succeed) + cmd.all = 1 + cmd.ensure_finalized() + cmd.run() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_cmd.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_cmd.py new file mode 100644 index 000000000..76e8f5989 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_cmd.py @@ -0,0 +1,107 @@ +"""Tests for distutils.cmd.""" + +import os +from distutils import debug +from distutils.cmd import Command +from distutils.dist import Distribution +from distutils.errors import DistutilsOptionError + +import pytest + + +class MyCmd(Command): + def initialize_options(self): + pass + + +@pytest.fixture +def cmd(request): + return MyCmd(Distribution()) + + +class TestCommand: + def test_ensure_string_list(self, cmd): + cmd.not_string_list = ['one', 2, 'three'] + cmd.yes_string_list = ['one', 'two', 'three'] + cmd.not_string_list2 = object() + cmd.yes_string_list2 = 'ok' + cmd.ensure_string_list('yes_string_list') + cmd.ensure_string_list('yes_string_list2') + + with pytest.raises(DistutilsOptionError): + cmd.ensure_string_list('not_string_list') + + with pytest.raises(DistutilsOptionError): + cmd.ensure_string_list('not_string_list2') + + cmd.option1 = 'ok,dok' + cmd.ensure_string_list('option1') + assert cmd.option1 == ['ok', 'dok'] + + cmd.option2 = ['xxx', 'www'] + cmd.ensure_string_list('option2') + + cmd.option3 = ['ok', 2] + with pytest.raises(DistutilsOptionError): + cmd.ensure_string_list('option3') + + def test_make_file(self, cmd): + # making sure it raises when infiles is not a string or a list/tuple + with pytest.raises(TypeError): + cmd.make_file(infiles=True, outfile='', func='func', args=()) + + # making sure execute gets called properly + def _execute(func, args, exec_msg, level): + assert exec_msg == 'generating out from in' + + cmd.force = True + cmd.execute = _execute + cmd.make_file(infiles='in', outfile='out', func='func', args=()) + + def test_dump_options(self, cmd): + msgs = [] + + def _announce(msg, level): + msgs.append(msg) + + cmd.announce = _announce + cmd.option1 = 1 + cmd.option2 = 1 + cmd.user_options = [('option1', '', ''), ('option2', '', '')] + cmd.dump_options() + + wanted = ["command options for 'MyCmd':", ' option1 = 1', ' option2 = 1'] + assert msgs == wanted + + def test_ensure_string(self, cmd): + cmd.option1 = 'ok' + cmd.ensure_string('option1') + + cmd.option2 = None + cmd.ensure_string('option2', 'xxx') + assert hasattr(cmd, 'option2') + + cmd.option3 = 1 + with pytest.raises(DistutilsOptionError): + cmd.ensure_string('option3') + + def test_ensure_filename(self, cmd): + cmd.option1 = __file__ + cmd.ensure_filename('option1') + cmd.option2 = 'xxx' + with pytest.raises(DistutilsOptionError): + cmd.ensure_filename('option2') + + def test_ensure_dirname(self, cmd): + cmd.option1 = os.path.dirname(__file__) or os.curdir + cmd.ensure_dirname('option1') + cmd.option2 = 'xxx' + with pytest.raises(DistutilsOptionError): + cmd.ensure_dirname('option2') + + def test_debug_print(self, cmd, capsys, monkeypatch): + cmd.debug_print('xxx') + assert capsys.readouterr().out == '' + monkeypatch.setattr(debug, 'DEBUG', True) + cmd.debug_print('xxx') + assert capsys.readouterr().out == 'xxx\n' diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_config_cmd.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_config_cmd.py new file mode 100644 index 000000000..ebee2ef93 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_config_cmd.py @@ -0,0 +1,87 @@ +"""Tests for distutils.command.config.""" + +import os +import sys +from distutils._log import log +from distutils.command.config import config, dump_file +from distutils.tests import missing_compiler_executable, support + +import more_itertools +import path +import pytest + + +@pytest.fixture(autouse=True) +def info_log(request, monkeypatch): + self = request.instance + self._logs = [] + monkeypatch.setattr(log, 'info', self._info) + + +@support.combine_markers +class TestConfig(support.TempdirManager): + def _info(self, msg, *args): + for line in msg.splitlines(): + self._logs.append(line) + + def test_dump_file(self): + this_file = path.Path(__file__).with_suffix('.py') + with this_file.open(encoding='utf-8') as f: + numlines = more_itertools.ilen(f) + + dump_file(this_file, 'I am the header') + assert len(self._logs) == numlines + 1 + + @pytest.mark.skipif('platform.system() == "Windows"') + def test_search_cpp(self): + cmd = missing_compiler_executable(['preprocessor']) + if cmd is not None: + self.skipTest(f'The {cmd!r} command is not found') + pkg_dir, dist = self.create_dist() + cmd = config(dist) + cmd._check_compiler() + compiler = cmd.compiler + if sys.platform[:3] == "aix" and "xlc" in compiler.preprocessor[0].lower(): + self.skipTest( + 'xlc: The -E option overrides the -P, -o, and -qsyntaxonly options' + ) + + # simple pattern searches + match = cmd.search_cpp(pattern='xxx', body='/* xxx */') + assert match == 0 + + match = cmd.search_cpp(pattern='_configtest', body='/* xxx */') + assert match == 1 + + def test_finalize_options(self): + # finalize_options does a bit of transformation + # on options + pkg_dir, dist = self.create_dist() + cmd = config(dist) + cmd.include_dirs = f'one{os.pathsep}two' + cmd.libraries = 'one' + cmd.library_dirs = f'three{os.pathsep}four' + cmd.ensure_finalized() + + assert cmd.include_dirs == ['one', 'two'] + assert cmd.libraries == ['one'] + assert cmd.library_dirs == ['three', 'four'] + + def test_clean(self): + # _clean removes files + tmp_dir = self.mkdtemp() + f1 = os.path.join(tmp_dir, 'one') + f2 = os.path.join(tmp_dir, 'two') + + self.write_file(f1, 'xxx') + self.write_file(f2, 'xxx') + + for f in (f1, f2): + assert os.path.exists(f) + + pkg_dir, dist = self.create_dist() + cmd = config(dist) + cmd._clean(f1, f2) + + for f in (f1, f2): + assert not os.path.exists(f) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_core.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_core.py new file mode 100644 index 000000000..bad3fb7e8 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_core.py @@ -0,0 +1,130 @@ +"""Tests for distutils.core.""" + +import distutils.core +import io +import os +import sys +from distutils.dist import Distribution + +import pytest + +# setup script that uses __file__ +setup_using___file__ = """\ + +__file__ + +from distutils.core import setup +setup() +""" + +setup_prints_cwd = """\ + +import os +print(os.getcwd()) + +from distutils.core import setup +setup() +""" + +setup_does_nothing = """\ +from distutils.core import setup +setup() +""" + + +setup_defines_subclass = """\ +from distutils.core import setup +from distutils.command.install import install as _install + +class install(_install): + sub_commands = _install.sub_commands + ['cmd'] + +setup(cmdclass={'install': install}) +""" + +setup_within_if_main = """\ +from distutils.core import setup + +def main(): + return setup(name="setup_within_if_main") + +if __name__ == "__main__": + main() +""" + + +@pytest.fixture(autouse=True) +def save_stdout(monkeypatch): + monkeypatch.setattr(sys, 'stdout', sys.stdout) + + +@pytest.fixture +def temp_file(tmp_path): + return tmp_path / 'file' + + +@pytest.mark.usefixtures('save_env') +@pytest.mark.usefixtures('save_argv') +class TestCore: + def test_run_setup_provides_file(self, temp_file): + # Make sure the script can use __file__; if that's missing, the test + # setup.py script will raise NameError. + temp_file.write_text(setup_using___file__, encoding='utf-8') + distutils.core.run_setup(temp_file) + + def test_run_setup_preserves_sys_argv(self, temp_file): + # Make sure run_setup does not clobber sys.argv + argv_copy = sys.argv.copy() + temp_file.write_text(setup_does_nothing, encoding='utf-8') + distutils.core.run_setup(temp_file) + assert sys.argv == argv_copy + + def test_run_setup_defines_subclass(self, temp_file): + # Make sure the script can use __file__; if that's missing, the test + # setup.py script will raise NameError. + temp_file.write_text(setup_defines_subclass, encoding='utf-8') + dist = distutils.core.run_setup(temp_file) + install = dist.get_command_obj('install') + assert 'cmd' in install.sub_commands + + def test_run_setup_uses_current_dir(self, tmp_path): + """ + Test that the setup script is run with the current directory + as its own current directory. + """ + sys.stdout = io.StringIO() + cwd = os.getcwd() + + # Create a directory and write the setup.py file there: + setup_py = tmp_path / 'setup.py' + setup_py.write_text(setup_prints_cwd, encoding='utf-8') + distutils.core.run_setup(setup_py) + + output = sys.stdout.getvalue() + if output.endswith("\n"): + output = output[:-1] + assert cwd == output + + def test_run_setup_within_if_main(self, temp_file): + temp_file.write_text(setup_within_if_main, encoding='utf-8') + dist = distutils.core.run_setup(temp_file, stop_after="config") + assert isinstance(dist, Distribution) + assert dist.get_name() == "setup_within_if_main" + + def test_run_commands(self, temp_file): + sys.argv = ['setup.py', 'build'] + temp_file.write_text(setup_within_if_main, encoding='utf-8') + dist = distutils.core.run_setup(temp_file, stop_after="commandline") + assert 'build' not in dist.have_run + distutils.core.run_commands(dist) + assert 'build' in dist.have_run + + def test_debug_mode(self, capsys, monkeypatch): + # this covers the code called when DEBUG is set + sys.argv = ['setup.py', '--name'] + distutils.core.setup(name='bar') + assert capsys.readouterr().out == 'bar\n' + monkeypatch.setattr(distutils.core, 'DEBUG', True) + distutils.core.setup(name='bar') + wanted = "options (after parsing config files):\n" + assert capsys.readouterr().out.startswith(wanted) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_dir_util.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_dir_util.py new file mode 100644 index 000000000..326cb3461 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_dir_util.py @@ -0,0 +1,139 @@ +"""Tests for distutils.dir_util.""" + +import os +import pathlib +import stat +import sys +import unittest.mock as mock +from distutils import dir_util, errors +from distutils.dir_util import ( + copy_tree, + create_tree, + ensure_relative, + mkpath, + remove_tree, +) +from distutils.tests import support + +import jaraco.path +import path +import pytest + + +@pytest.fixture(autouse=True) +def stuff(request, monkeypatch, distutils_managed_tempdir): + self = request.instance + tmp_dir = self.mkdtemp() + self.root_target = os.path.join(tmp_dir, 'deep') + self.target = os.path.join(self.root_target, 'here') + self.target2 = os.path.join(tmp_dir, 'deep2') + + +class TestDirUtil(support.TempdirManager): + def test_mkpath_remove_tree_verbosity(self, caplog): + mkpath(self.target, verbose=False) + assert not caplog.records + remove_tree(self.root_target, verbose=False) + + mkpath(self.target, verbose=True) + wanted = [f'creating {self.target}'] + assert caplog.messages == wanted + caplog.clear() + + remove_tree(self.root_target, verbose=True) + wanted = [f"removing '{self.root_target}' (and everything under it)"] + assert caplog.messages == wanted + + @pytest.mark.skipif("platform.system() == 'Windows'") + def test_mkpath_with_custom_mode(self): + # Get and set the current umask value for testing mode bits. + umask = os.umask(0o002) + os.umask(umask) + mkpath(self.target, 0o700) + assert stat.S_IMODE(os.stat(self.target).st_mode) == 0o700 & ~umask + mkpath(self.target2, 0o555) + assert stat.S_IMODE(os.stat(self.target2).st_mode) == 0o555 & ~umask + + def test_create_tree_verbosity(self, caplog): + create_tree(self.root_target, ['one', 'two', 'three'], verbose=False) + assert caplog.messages == [] + remove_tree(self.root_target, verbose=False) + + wanted = [f'creating {self.root_target}'] + create_tree(self.root_target, ['one', 'two', 'three'], verbose=True) + assert caplog.messages == wanted + + remove_tree(self.root_target, verbose=False) + + def test_copy_tree_verbosity(self, caplog): + mkpath(self.target, verbose=False) + + copy_tree(self.target, self.target2, verbose=False) + assert caplog.messages == [] + + remove_tree(self.root_target, verbose=False) + + mkpath(self.target, verbose=False) + a_file = path.Path(self.target) / 'ok.txt' + jaraco.path.build({'ok.txt': 'some content'}, self.target) + + wanted = [f'copying {a_file} -> {self.target2}'] + copy_tree(self.target, self.target2, verbose=True) + assert caplog.messages == wanted + + remove_tree(self.root_target, verbose=False) + remove_tree(self.target2, verbose=False) + + def test_copy_tree_skips_nfs_temp_files(self): + mkpath(self.target, verbose=False) + + jaraco.path.build({'ok.txt': 'some content', '.nfs123abc': ''}, self.target) + + copy_tree(self.target, self.target2) + assert os.listdir(self.target2) == ['ok.txt'] + + remove_tree(self.root_target, verbose=False) + remove_tree(self.target2, verbose=False) + + def test_ensure_relative(self): + if os.sep == '/': + assert ensure_relative('/home/foo') == 'home/foo' + assert ensure_relative('some/path') == 'some/path' + else: # \\ + assert ensure_relative('c:\\home\\foo') == 'c:home\\foo' + assert ensure_relative('home\\foo') == 'home\\foo' + + def test_copy_tree_exception_in_listdir(self): + """ + An exception in listdir should raise a DistutilsFileError + """ + with ( + mock.patch("os.listdir", side_effect=OSError()), + pytest.raises(errors.DistutilsFileError), + ): + src = self.tempdirs[-1] + dir_util.copy_tree(src, None) + + def test_mkpath_exception_uncached(self, monkeypatch, tmp_path): + """ + Caching should not remember failed attempts. + + pypa/distutils#304 + """ + + class FailPath(pathlib.Path): + def mkdir(self, *args, **kwargs): + raise OSError("Failed to create directory") + + if sys.version_info < (3, 12): + _flavour = pathlib.Path()._flavour + + target = tmp_path / 'foodir' + + with pytest.raises(errors.DistutilsFileError): + mkpath(FailPath(target)) + + assert not target.exists() + + mkpath(target) + assert target.exists() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_dist.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_dist.py new file mode 100644 index 000000000..2c5beebe6 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_dist.py @@ -0,0 +1,552 @@ +"""Tests for distutils.dist.""" + +import email +import email.generator +import email.policy +import functools +import io +import os +import sys +import textwrap +import unittest.mock as mock +import warnings +from distutils.cmd import Command +from distutils.dist import Distribution, fix_help_options +from distutils.tests import support +from typing import ClassVar + +import jaraco.path +import pytest + +pydistutils_cfg = '.' * (os.name == 'posix') + 'pydistutils.cfg' + + +class test_dist(Command): + """Sample distutils extension command.""" + + user_options: ClassVar[list[tuple[str, str, str]]] = [ + ("sample-option=", "S", "help text"), + ] + + def initialize_options(self): + self.sample_option = None + + +class TestDistribution(Distribution): + """Distribution subclasses that avoids the default search for + configuration files. + + The ._config_files attribute must be set before + .parse_config_files() is called. + """ + + def find_config_files(self): + return self._config_files + + +@pytest.fixture +def clear_argv(): + del sys.argv[1:] + + +@support.combine_markers +@pytest.mark.usefixtures('save_env') +@pytest.mark.usefixtures('save_argv') +class TestDistributionBehavior(support.TempdirManager): + def create_distribution(self, configfiles=()): + d = TestDistribution() + d._config_files = configfiles + d.parse_config_files() + d.parse_command_line() + return d + + def test_command_packages_unspecified(self, clear_argv): + sys.argv.append("build") + d = self.create_distribution() + assert d.get_command_packages() == ["distutils.command"] + + def test_command_packages_cmdline(self, clear_argv): + from distutils.tests.test_dist import test_dist + + sys.argv.extend([ + "--command-packages", + "foo.bar,distutils.tests", + "test_dist", + "-Ssometext", + ]) + d = self.create_distribution() + # let's actually try to load our test command: + assert d.get_command_packages() == [ + "distutils.command", + "foo.bar", + "distutils.tests", + ] + cmd = d.get_command_obj("test_dist") + assert isinstance(cmd, test_dist) + assert cmd.sample_option == "sometext" + + @pytest.mark.skipif( + 'distutils' not in Distribution.parse_config_files.__module__, + reason='Cannot test when virtualenv has monkey-patched Distribution', + ) + def test_venv_install_options(self, tmp_path, clear_argv): + sys.argv.append("install") + file = str(tmp_path / 'file') + + fakepath = '/somedir' + + jaraco.path.build({ + file: f""" + [install] + install-base = {fakepath} + install-platbase = {fakepath} + install-lib = {fakepath} + install-platlib = {fakepath} + install-purelib = {fakepath} + install-headers = {fakepath} + install-scripts = {fakepath} + install-data = {fakepath} + prefix = {fakepath} + exec-prefix = {fakepath} + home = {fakepath} + user = {fakepath} + root = {fakepath} + """, + }) + + # Base case: Not in a Virtual Environment + with mock.patch.multiple(sys, prefix='/a', base_prefix='/a'): + d = self.create_distribution([file]) + + option_tuple = (file, fakepath) + + result_dict = { + 'install_base': option_tuple, + 'install_platbase': option_tuple, + 'install_lib': option_tuple, + 'install_platlib': option_tuple, + 'install_purelib': option_tuple, + 'install_headers': option_tuple, + 'install_scripts': option_tuple, + 'install_data': option_tuple, + 'prefix': option_tuple, + 'exec_prefix': option_tuple, + 'home': option_tuple, + 'user': option_tuple, + 'root': option_tuple, + } + + assert sorted(d.command_options.get('install').keys()) == sorted( + result_dict.keys() + ) + + for key, value in d.command_options.get('install').items(): + assert value == result_dict[key] + + # Test case: In a Virtual Environment + with mock.patch.multiple(sys, prefix='/a', base_prefix='/b'): + d = self.create_distribution([file]) + + for key in result_dict.keys(): + assert key not in d.command_options.get('install', {}) + + def test_command_packages_configfile(self, tmp_path, clear_argv): + sys.argv.append("build") + file = str(tmp_path / "file") + jaraco.path.build({ + file: """ + [global] + command_packages = foo.bar, splat + """, + }) + + d = self.create_distribution([file]) + assert d.get_command_packages() == ["distutils.command", "foo.bar", "splat"] + + # ensure command line overrides config: + sys.argv[1:] = ["--command-packages", "spork", "build"] + d = self.create_distribution([file]) + assert d.get_command_packages() == ["distutils.command", "spork"] + + # Setting --command-packages to '' should cause the default to + # be used even if a config file specified something else: + sys.argv[1:] = ["--command-packages", "", "build"] + d = self.create_distribution([file]) + assert d.get_command_packages() == ["distutils.command"] + + def test_empty_options(self, request): + # an empty options dictionary should not stay in the + # list of attributes + + # catching warnings + warns = [] + + def _warn(msg): + warns.append(msg) + + request.addfinalizer( + functools.partial(setattr, warnings, 'warn', warnings.warn) + ) + warnings.warn = _warn + dist = Distribution( + attrs={ + 'author': 'xxx', + 'name': 'xxx', + 'version': 'xxx', + 'url': 'xxxx', + 'options': {}, + } + ) + + assert len(warns) == 0 + assert 'options' not in dir(dist) + + def test_finalize_options(self): + attrs = {'keywords': 'one,two', 'platforms': 'one,two'} + + dist = Distribution(attrs=attrs) + dist.finalize_options() + + # finalize_option splits platforms and keywords + assert dist.metadata.platforms == ['one', 'two'] + assert dist.metadata.keywords == ['one', 'two'] + + attrs = {'keywords': 'foo bar', 'platforms': 'foo bar'} + dist = Distribution(attrs=attrs) + dist.finalize_options() + assert dist.metadata.platforms == ['foo bar'] + assert dist.metadata.keywords == ['foo bar'] + + def test_get_command_packages(self): + dist = Distribution() + assert dist.command_packages is None + cmds = dist.get_command_packages() + assert cmds == ['distutils.command'] + assert dist.command_packages == ['distutils.command'] + + dist.command_packages = 'one,two' + cmds = dist.get_command_packages() + assert cmds == ['distutils.command', 'one', 'two'] + + def test_announce(self): + # make sure the level is known + dist = Distribution() + with pytest.raises(TypeError): + dist.announce('ok', level='ok2') + + def test_find_config_files_disable(self, temp_home): + # Ticket #1180: Allow user to disable their home config file. + jaraco.path.build({pydistutils_cfg: '[distutils]\n'}, temp_home) + + d = Distribution() + all_files = d.find_config_files() + + d = Distribution(attrs={'script_args': ['--no-user-cfg']}) + files = d.find_config_files() + + # make sure --no-user-cfg disables the user cfg file + assert len(all_files) - 1 == len(files) + + def test_script_args_list_coercion(self): + d = Distribution(attrs={'script_args': ('build', '--no-user-cfg')}) + + # make sure script_args is a list even if it started as a different iterable + assert d.script_args == ['build', '--no-user-cfg'] + + @pytest.mark.skipif( + 'platform.system() == "Windows"', + reason='Windows does not honor chmod 000', + ) + def test_find_config_files_permission_error(self, fake_home): + """ + Finding config files should not fail when directory is inaccessible. + """ + fake_home.joinpath(pydistutils_cfg).write_text('', encoding='utf-8') + fake_home.chmod(0o000) + Distribution().find_config_files() + + +@pytest.mark.usefixtures('save_env') +@pytest.mark.usefixtures('save_argv') +class TestMetadata(support.TempdirManager): + def format_metadata(self, dist): + sio = io.StringIO() + dist.metadata.write_pkg_file(sio) + return sio.getvalue() + + def test_simple_metadata(self): + attrs = {"name": "package", "version": "1.0"} + dist = Distribution(attrs) + meta = self.format_metadata(dist) + assert "Metadata-Version: 1.0" in meta + assert "provides:" not in meta.lower() + assert "requires:" not in meta.lower() + assert "obsoletes:" not in meta.lower() + + def test_provides(self): + attrs = { + "name": "package", + "version": "1.0", + "provides": ["package", "package.sub"], + } + dist = Distribution(attrs) + assert dist.metadata.get_provides() == ["package", "package.sub"] + assert dist.get_provides() == ["package", "package.sub"] + meta = self.format_metadata(dist) + assert "Metadata-Version: 1.1" in meta + assert "requires:" not in meta.lower() + assert "obsoletes:" not in meta.lower() + + def test_provides_illegal(self): + with pytest.raises(ValueError): + Distribution( + {"name": "package", "version": "1.0", "provides": ["my.pkg (splat)"]}, + ) + + def test_requires(self): + attrs = { + "name": "package", + "version": "1.0", + "requires": ["other", "another (==1.0)"], + } + dist = Distribution(attrs) + assert dist.metadata.get_requires() == ["other", "another (==1.0)"] + assert dist.get_requires() == ["other", "another (==1.0)"] + meta = self.format_metadata(dist) + assert "Metadata-Version: 1.1" in meta + assert "provides:" not in meta.lower() + assert "Requires: other" in meta + assert "Requires: another (==1.0)" in meta + assert "obsoletes:" not in meta.lower() + + def test_requires_illegal(self): + with pytest.raises(ValueError): + Distribution( + {"name": "package", "version": "1.0", "requires": ["my.pkg (splat)"]}, + ) + + def test_requires_to_list(self): + attrs = {"name": "package", "requires": iter(["other"])} + dist = Distribution(attrs) + assert isinstance(dist.metadata.requires, list) + + def test_obsoletes(self): + attrs = { + "name": "package", + "version": "1.0", + "obsoletes": ["other", "another (<1.0)"], + } + dist = Distribution(attrs) + assert dist.metadata.get_obsoletes() == ["other", "another (<1.0)"] + assert dist.get_obsoletes() == ["other", "another (<1.0)"] + meta = self.format_metadata(dist) + assert "Metadata-Version: 1.1" in meta + assert "provides:" not in meta.lower() + assert "requires:" not in meta.lower() + assert "Obsoletes: other" in meta + assert "Obsoletes: another (<1.0)" in meta + + def test_obsoletes_illegal(self): + with pytest.raises(ValueError): + Distribution( + {"name": "package", "version": "1.0", "obsoletes": ["my.pkg (splat)"]}, + ) + + def test_obsoletes_to_list(self): + attrs = {"name": "package", "obsoletes": iter(["other"])} + dist = Distribution(attrs) + assert isinstance(dist.metadata.obsoletes, list) + + def test_classifier(self): + attrs = { + 'name': 'Boa', + 'version': '3.0', + 'classifiers': ['Programming Language :: Python :: 3'], + } + dist = Distribution(attrs) + assert dist.get_classifiers() == ['Programming Language :: Python :: 3'] + meta = self.format_metadata(dist) + assert 'Metadata-Version: 1.1' in meta + + def test_classifier_invalid_type(self, caplog): + attrs = { + 'name': 'Boa', + 'version': '3.0', + 'classifiers': ('Programming Language :: Python :: 3',), + } + d = Distribution(attrs) + # should have warning about passing a non-list + assert 'should be a list' in caplog.messages[0] + # should be converted to a list + assert isinstance(d.metadata.classifiers, list) + assert d.metadata.classifiers == list(attrs['classifiers']) + + def test_keywords(self): + attrs = { + 'name': 'Monty', + 'version': '1.0', + 'keywords': ['spam', 'eggs', 'life of brian'], + } + dist = Distribution(attrs) + assert dist.get_keywords() == ['spam', 'eggs', 'life of brian'] + + def test_keywords_invalid_type(self, caplog): + attrs = { + 'name': 'Monty', + 'version': '1.0', + 'keywords': ('spam', 'eggs', 'life of brian'), + } + d = Distribution(attrs) + # should have warning about passing a non-list + assert 'should be a list' in caplog.messages[0] + # should be converted to a list + assert isinstance(d.metadata.keywords, list) + assert d.metadata.keywords == list(attrs['keywords']) + + def test_platforms(self): + attrs = { + 'name': 'Monty', + 'version': '1.0', + 'platforms': ['GNU/Linux', 'Some Evil Platform'], + } + dist = Distribution(attrs) + assert dist.get_platforms() == ['GNU/Linux', 'Some Evil Platform'] + + def test_platforms_invalid_types(self, caplog): + attrs = { + 'name': 'Monty', + 'version': '1.0', + 'platforms': ('GNU/Linux', 'Some Evil Platform'), + } + d = Distribution(attrs) + # should have warning about passing a non-list + assert 'should be a list' in caplog.messages[0] + # should be converted to a list + assert isinstance(d.metadata.platforms, list) + assert d.metadata.platforms == list(attrs['platforms']) + + def test_download_url(self): + attrs = { + 'name': 'Boa', + 'version': '3.0', + 'download_url': 'http://example.org/boa', + } + dist = Distribution(attrs) + meta = self.format_metadata(dist) + assert 'Metadata-Version: 1.1' in meta + + def test_long_description(self): + long_desc = textwrap.dedent( + """\ + example:: + We start here + and continue here + and end here.""" + ) + attrs = {"name": "package", "version": "1.0", "long_description": long_desc} + + dist = Distribution(attrs) + meta = self.format_metadata(dist) + meta = meta.replace('\n' + 8 * ' ', '\n') + assert long_desc in meta + + def test_custom_pydistutils(self, temp_home): + """ + pydistutils.cfg is found + """ + jaraco.path.build({pydistutils_cfg: ''}, temp_home) + config_path = temp_home / pydistutils_cfg + + assert str(config_path) in Distribution().find_config_files() + + def test_extra_pydistutils(self, monkeypatch, tmp_path): + jaraco.path.build({'overrides.cfg': ''}, tmp_path) + filename = tmp_path / 'overrides.cfg' + monkeypatch.setenv('DIST_EXTRA_CONFIG', str(filename)) + assert str(filename) in Distribution().find_config_files() + + def test_fix_help_options(self): + help_tuples = [('a', 'b', 'c', 'd'), (1, 2, 3, 4)] + fancy_options = fix_help_options(help_tuples) + assert fancy_options[0] == ('a', 'b', 'c') + assert fancy_options[1] == (1, 2, 3) + + def test_show_help(self, request, capsys): + # smoke test, just makes sure some help is displayed + dist = Distribution() + sys.argv = [] + dist.help = True + dist.script_name = 'setup.py' + dist.parse_command_line() + + output = [ + line for line in capsys.readouterr().out.split('\n') if line.strip() != '' + ] + assert output + + def test_read_metadata(self): + attrs = { + "name": "package", + "version": "1.0", + "long_description": "desc", + "description": "xxx", + "download_url": "http://example.com", + "keywords": ['one', 'two'], + "requires": ['foo'], + } + + dist = Distribution(attrs) + metadata = dist.metadata + + # write it then reloads it + PKG_INFO = io.StringIO() + metadata.write_pkg_file(PKG_INFO) + PKG_INFO.seek(0) + metadata.read_pkg_file(PKG_INFO) + + assert metadata.name == "package" + assert metadata.version == "1.0" + assert metadata.description == "xxx" + assert metadata.download_url == 'http://example.com' + assert metadata.keywords == ['one', 'two'] + assert metadata.platforms is None + assert metadata.obsoletes is None + assert metadata.requires == ['foo'] + + def test_round_trip_through_email_generator(self): + """ + In pypa/setuptools#4033, it was shown that once PKG-INFO is + re-generated using ``email.generator.Generator``, some control + characters might cause problems. + """ + # Given a PKG-INFO file ... + attrs = { + "name": "package", + "version": "1.0", + "long_description": "hello\x0b\nworld\n", + } + dist = Distribution(attrs) + metadata = dist.metadata + + with io.StringIO() as buffer: + metadata.write_pkg_file(buffer) + msg = buffer.getvalue() + + # ... when it is read and re-written using stdlib's email library, + orig = email.message_from_string(msg) + policy = email.policy.EmailPolicy( + utf8=True, + mangle_from_=False, + max_line_length=0, + ) + with io.StringIO() as buffer: + email.generator.Generator(buffer, policy=policy).flatten(orig) + + buffer.seek(0) + regen = email.message_from_file(buffer) + + # ... then it should be the same as the original + # (except for the specific line break characters) + orig_desc = set(orig["Description"].splitlines()) + regen_desc = set(regen["Description"].splitlines()) + assert regen_desc == orig_desc diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_extension.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_extension.py new file mode 100644 index 000000000..5e8e76822 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_extension.py @@ -0,0 +1,117 @@ +"""Tests for distutils.extension.""" + +import os +import pathlib +import warnings +from distutils.extension import Extension, read_setup_file + +import pytest +from test.support.warnings_helper import check_warnings + + +class TestExtension: + def test_read_setup_file(self): + # trying to read a Setup file + # (sample extracted from the PyGame project) + setup = os.path.join(os.path.dirname(__file__), 'Setup.sample') + + exts = read_setup_file(setup) + names = [ext.name for ext in exts] + names.sort() + + # here are the extensions read_setup_file should have created + # out of the file + wanted = [ + '_arraysurfarray', + '_camera', + '_numericsndarray', + '_numericsurfarray', + 'base', + 'bufferproxy', + 'cdrom', + 'color', + 'constants', + 'display', + 'draw', + 'event', + 'fastevent', + 'font', + 'gfxdraw', + 'image', + 'imageext', + 'joystick', + 'key', + 'mask', + 'mixer', + 'mixer_music', + 'mouse', + 'movie', + 'overlay', + 'pixelarray', + 'pypm', + 'rect', + 'rwobject', + 'scrap', + 'surface', + 'surflock', + 'time', + 'transform', + ] + + assert names == wanted + + def test_extension_init(self): + # the first argument, which is the name, must be a string + with pytest.raises(TypeError): + Extension(1, []) + ext = Extension('name', []) + assert ext.name == 'name' + + # the second argument, which is the list of files, must + # be an iterable of strings or PathLike objects, and not a string + with pytest.raises(TypeError): + Extension('name', 'file') + with pytest.raises(TypeError): + Extension('name', ['file', 1]) + ext = Extension('name', ['file1', 'file2']) + assert ext.sources == ['file1', 'file2'] + ext = Extension('name', [pathlib.Path('file1'), pathlib.Path('file2')]) + assert ext.sources == ['file1', 'file2'] + + # any non-string iterable of strings or PathLike objects should work + ext = Extension('name', ('file1', 'file2')) # tuple + assert ext.sources == ['file1', 'file2'] + ext = Extension('name', {'file1', 'file2'}) # set + assert sorted(ext.sources) == ['file1', 'file2'] + ext = Extension('name', iter(['file1', 'file2'])) # iterator + assert ext.sources == ['file1', 'file2'] + ext = Extension('name', [pathlib.Path('file1'), 'file2']) # mixed types + assert ext.sources == ['file1', 'file2'] + + # others arguments have defaults + for attr in ( + 'include_dirs', + 'define_macros', + 'undef_macros', + 'library_dirs', + 'libraries', + 'runtime_library_dirs', + 'extra_objects', + 'extra_compile_args', + 'extra_link_args', + 'export_symbols', + 'swig_opts', + 'depends', + ): + assert getattr(ext, attr) == [] + + assert ext.language is None + assert ext.optional is None + + # if there are unknown keyword options, warn about them + with check_warnings() as w: + warnings.simplefilter('always') + ext = Extension('name', ['file1', 'file2'], chic=True) + + assert len(w.warnings) == 1 + assert str(w.warnings[0].message) == "Unknown Extension options: 'chic'" diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_file_util.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_file_util.py new file mode 100644 index 000000000..a75d4a031 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_file_util.py @@ -0,0 +1,95 @@ +"""Tests for distutils.file_util.""" + +import errno +import os +import unittest.mock as mock +from distutils.errors import DistutilsFileError +from distutils.file_util import copy_file, move_file + +import jaraco.path +import pytest + + +@pytest.fixture(autouse=True) +def stuff(request, tmp_path): + self = request.instance + self.source = tmp_path / 'f1' + self.target = tmp_path / 'f2' + self.target_dir = tmp_path / 'd1' + + +class TestFileUtil: + def test_move_file_verbosity(self, caplog): + jaraco.path.build({self.source: 'some content'}) + + move_file(self.source, self.target, verbose=False) + assert not caplog.messages + + # back to original state + move_file(self.target, self.source, verbose=False) + + move_file(self.source, self.target, verbose=True) + wanted = [f'moving {self.source} -> {self.target}'] + assert caplog.messages == wanted + + # back to original state + move_file(self.target, self.source, verbose=False) + + caplog.clear() + # now the target is a dir + os.mkdir(self.target_dir) + move_file(self.source, self.target_dir, verbose=True) + wanted = [f'moving {self.source} -> {self.target_dir}'] + assert caplog.messages == wanted + + def test_move_file_exception_unpacking_rename(self): + # see issue 22182 + with ( + mock.patch("os.rename", side_effect=OSError("wrong", 1)), + pytest.raises(DistutilsFileError), + ): + jaraco.path.build({self.source: 'spam eggs'}) + move_file(self.source, self.target, verbose=False) + + def test_move_file_exception_unpacking_unlink(self): + # see issue 22182 + with ( + mock.patch("os.rename", side_effect=OSError(errno.EXDEV, "wrong")), + mock.patch("os.unlink", side_effect=OSError("wrong", 1)), + pytest.raises(DistutilsFileError), + ): + jaraco.path.build({self.source: 'spam eggs'}) + move_file(self.source, self.target, verbose=False) + + def test_copy_file_hard_link(self): + jaraco.path.build({self.source: 'some content'}) + # Check first that copy_file() will not fall back on copying the file + # instead of creating the hard link. + try: + os.link(self.source, self.target) + except OSError as e: + self.skipTest(f'os.link: {e}') + else: + self.target.unlink() + st = os.stat(self.source) + copy_file(self.source, self.target, link='hard') + st2 = os.stat(self.source) + st3 = os.stat(self.target) + assert os.path.samestat(st, st2), (st, st2) + assert os.path.samestat(st2, st3), (st2, st3) + assert self.source.read_text(encoding='utf-8') == 'some content' + + def test_copy_file_hard_link_failure(self): + # If hard linking fails, copy_file() falls back on copying file + # (some special filesystems don't support hard linking even under + # Unix, see issue #8876). + jaraco.path.build({self.source: 'some content'}) + st = os.stat(self.source) + with mock.patch("os.link", side_effect=OSError(0, "linking unsupported")): + copy_file(self.source, self.target, link='hard') + st2 = os.stat(self.source) + st3 = os.stat(self.target) + assert os.path.samestat(st, st2), (st, st2) + assert not os.path.samestat(st2, st3), (st2, st3) + for fn in (self.source, self.target): + assert fn.read_text(encoding='utf-8') == 'some content' diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_filelist.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_filelist.py new file mode 100644 index 000000000..130e6fb53 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_filelist.py @@ -0,0 +1,336 @@ +"""Tests for distutils.filelist.""" + +import logging +import os +import re +from distutils import debug, filelist +from distutils.errors import DistutilsTemplateError +from distutils.filelist import FileList, glob_to_re, translate_pattern + +import jaraco.path +import pytest + +from .compat import py39 as os_helper + +MANIFEST_IN = """\ +include ok +include xo +exclude xo +include foo.tmp +include buildout.cfg +global-include *.x +global-include *.txt +global-exclude *.tmp +recursive-include f *.oo +recursive-exclude global *.x +graft dir +prune dir3 +""" + + +def make_local_path(s): + """Converts '/' in a string to os.sep""" + return s.replace('/', os.sep) + + +class TestFileList: + def assertNoWarnings(self, caplog): + warnings = [rec for rec in caplog.records if rec.levelno == logging.WARNING] + assert not warnings + caplog.clear() + + def assertWarnings(self, caplog): + warnings = [rec for rec in caplog.records if rec.levelno == logging.WARNING] + assert warnings + caplog.clear() + + def test_glob_to_re(self): + sep = os.sep + if os.sep == '\\': + sep = re.escape(os.sep) + + for glob, regex in ( + # simple cases + ('foo*', r'(?s:foo[^%(sep)s]*)\Z'), + ('foo?', r'(?s:foo[^%(sep)s])\Z'), + ('foo??', r'(?s:foo[^%(sep)s][^%(sep)s])\Z'), + # special cases + (r'foo\\*', r'(?s:foo\\\\[^%(sep)s]*)\Z'), + (r'foo\\\*', r'(?s:foo\\\\\\[^%(sep)s]*)\Z'), + ('foo????', r'(?s:foo[^%(sep)s][^%(sep)s][^%(sep)s][^%(sep)s])\Z'), + (r'foo\\??', r'(?s:foo\\\\[^%(sep)s][^%(sep)s])\Z'), + ): + regex = regex % {'sep': sep} + assert glob_to_re(glob) == regex + + def test_process_template_line(self): + # testing all MANIFEST.in template patterns + file_list = FileList() + mlp = make_local_path + + # simulated file list + file_list.allfiles = [ + 'foo.tmp', + 'ok', + 'xo', + 'four.txt', + 'buildout.cfg', + # filelist does not filter out VCS directories, + # it's sdist that does + mlp('.hg/last-message.txt'), + mlp('global/one.txt'), + mlp('global/two.txt'), + mlp('global/files.x'), + mlp('global/here.tmp'), + mlp('f/o/f.oo'), + mlp('dir/graft-one'), + mlp('dir/dir2/graft2'), + mlp('dir3/ok'), + mlp('dir3/sub/ok.txt'), + ] + + for line in MANIFEST_IN.split('\n'): + if line.strip() == '': + continue + file_list.process_template_line(line) + + wanted = [ + 'ok', + 'buildout.cfg', + 'four.txt', + mlp('.hg/last-message.txt'), + mlp('global/one.txt'), + mlp('global/two.txt'), + mlp('f/o/f.oo'), + mlp('dir/graft-one'), + mlp('dir/dir2/graft2'), + ] + + assert file_list.files == wanted + + def test_debug_print(self, capsys, monkeypatch): + file_list = FileList() + file_list.debug_print('xxx') + assert capsys.readouterr().out == '' + + monkeypatch.setattr(debug, 'DEBUG', True) + file_list.debug_print('xxx') + assert capsys.readouterr().out == 'xxx\n' + + def test_set_allfiles(self): + file_list = FileList() + files = ['a', 'b', 'c'] + file_list.set_allfiles(files) + assert file_list.allfiles == files + + def test_remove_duplicates(self): + file_list = FileList() + file_list.files = ['a', 'b', 'a', 'g', 'c', 'g'] + # files must be sorted beforehand (sdist does it) + file_list.sort() + file_list.remove_duplicates() + assert file_list.files == ['a', 'b', 'c', 'g'] + + def test_translate_pattern(self): + # not regex + assert hasattr(translate_pattern('a', anchor=True, is_regex=False), 'search') + + # is a regex + regex = re.compile('a') + assert translate_pattern(regex, anchor=True, is_regex=True) == regex + + # plain string flagged as regex + assert hasattr(translate_pattern('a', anchor=True, is_regex=True), 'search') + + # glob support + assert translate_pattern('*.py', anchor=True, is_regex=False).search( + 'filelist.py' + ) + + def test_exclude_pattern(self): + # return False if no match + file_list = FileList() + assert not file_list.exclude_pattern('*.py') + + # return True if files match + file_list = FileList() + file_list.files = ['a.py', 'b.py'] + assert file_list.exclude_pattern('*.py') + + # test excludes + file_list = FileList() + file_list.files = ['a.py', 'a.txt'] + file_list.exclude_pattern('*.py') + assert file_list.files == ['a.txt'] + + def test_include_pattern(self): + # return False if no match + file_list = FileList() + file_list.set_allfiles([]) + assert not file_list.include_pattern('*.py') + + # return True if files match + file_list = FileList() + file_list.set_allfiles(['a.py', 'b.txt']) + assert file_list.include_pattern('*.py') + + # test * matches all files + file_list = FileList() + assert file_list.allfiles is None + file_list.set_allfiles(['a.py', 'b.txt']) + file_list.include_pattern('*') + assert file_list.allfiles == ['a.py', 'b.txt'] + + def test_process_template(self, caplog): + mlp = make_local_path + # invalid lines + file_list = FileList() + for action in ( + 'include', + 'exclude', + 'global-include', + 'global-exclude', + 'recursive-include', + 'recursive-exclude', + 'graft', + 'prune', + 'blarg', + ): + with pytest.raises(DistutilsTemplateError): + file_list.process_template_line(action) + + # include + file_list = FileList() + file_list.set_allfiles(['a.py', 'b.txt', mlp('d/c.py')]) + + file_list.process_template_line('include *.py') + assert file_list.files == ['a.py'] + self.assertNoWarnings(caplog) + + file_list.process_template_line('include *.rb') + assert file_list.files == ['a.py'] + self.assertWarnings(caplog) + + # exclude + file_list = FileList() + file_list.files = ['a.py', 'b.txt', mlp('d/c.py')] + + file_list.process_template_line('exclude *.py') + assert file_list.files == ['b.txt', mlp('d/c.py')] + self.assertNoWarnings(caplog) + + file_list.process_template_line('exclude *.rb') + assert file_list.files == ['b.txt', mlp('d/c.py')] + self.assertWarnings(caplog) + + # global-include + file_list = FileList() + file_list.set_allfiles(['a.py', 'b.txt', mlp('d/c.py')]) + + file_list.process_template_line('global-include *.py') + assert file_list.files == ['a.py', mlp('d/c.py')] + self.assertNoWarnings(caplog) + + file_list.process_template_line('global-include *.rb') + assert file_list.files == ['a.py', mlp('d/c.py')] + self.assertWarnings(caplog) + + # global-exclude + file_list = FileList() + file_list.files = ['a.py', 'b.txt', mlp('d/c.py')] + + file_list.process_template_line('global-exclude *.py') + assert file_list.files == ['b.txt'] + self.assertNoWarnings(caplog) + + file_list.process_template_line('global-exclude *.rb') + assert file_list.files == ['b.txt'] + self.assertWarnings(caplog) + + # recursive-include + file_list = FileList() + file_list.set_allfiles(['a.py', mlp('d/b.py'), mlp('d/c.txt'), mlp('d/d/e.py')]) + + file_list.process_template_line('recursive-include d *.py') + assert file_list.files == [mlp('d/b.py'), mlp('d/d/e.py')] + self.assertNoWarnings(caplog) + + file_list.process_template_line('recursive-include e *.py') + assert file_list.files == [mlp('d/b.py'), mlp('d/d/e.py')] + self.assertWarnings(caplog) + + # recursive-exclude + file_list = FileList() + file_list.files = ['a.py', mlp('d/b.py'), mlp('d/c.txt'), mlp('d/d/e.py')] + + file_list.process_template_line('recursive-exclude d *.py') + assert file_list.files == ['a.py', mlp('d/c.txt')] + self.assertNoWarnings(caplog) + + file_list.process_template_line('recursive-exclude e *.py') + assert file_list.files == ['a.py', mlp('d/c.txt')] + self.assertWarnings(caplog) + + # graft + file_list = FileList() + file_list.set_allfiles(['a.py', mlp('d/b.py'), mlp('d/d/e.py'), mlp('f/f.py')]) + + file_list.process_template_line('graft d') + assert file_list.files == [mlp('d/b.py'), mlp('d/d/e.py')] + self.assertNoWarnings(caplog) + + file_list.process_template_line('graft e') + assert file_list.files == [mlp('d/b.py'), mlp('d/d/e.py')] + self.assertWarnings(caplog) + + # prune + file_list = FileList() + file_list.files = ['a.py', mlp('d/b.py'), mlp('d/d/e.py'), mlp('f/f.py')] + + file_list.process_template_line('prune d') + assert file_list.files == ['a.py', mlp('f/f.py')] + self.assertNoWarnings(caplog) + + file_list.process_template_line('prune e') + assert file_list.files == ['a.py', mlp('f/f.py')] + self.assertWarnings(caplog) + + +class TestFindAll: + @os_helper.skip_unless_symlink + def test_missing_symlink(self, temp_cwd): + os.symlink('foo', 'bar') + assert filelist.findall() == [] + + def test_basic_discovery(self, temp_cwd): + """ + When findall is called with no parameters or with + '.' as the parameter, the dot should be omitted from + the results. + """ + jaraco.path.build({'foo': {'file1.txt': ''}, 'bar': {'file2.txt': ''}}) + file1 = os.path.join('foo', 'file1.txt') + file2 = os.path.join('bar', 'file2.txt') + expected = [file2, file1] + assert sorted(filelist.findall()) == expected + + def test_non_local_discovery(self, tmp_path): + """ + When findall is called with another path, the full + path name should be returned. + """ + jaraco.path.build({'file1.txt': ''}, tmp_path) + expected = [str(tmp_path / 'file1.txt')] + assert filelist.findall(tmp_path) == expected + + @os_helper.skip_unless_symlink + def test_symlink_loop(self, tmp_path): + jaraco.path.build( + { + 'link-to-parent': jaraco.path.Symlink('.'), + 'somefile': '', + }, + tmp_path, + ) + files = filelist.findall(tmp_path) + assert len(files) == 1 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install.py new file mode 100644 index 000000000..b3ffb2e66 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install.py @@ -0,0 +1,245 @@ +"""Tests for distutils.command.install.""" + +import logging +import os +import pathlib +import site +import sys +from distutils import sysconfig +from distutils.command import install as install_module +from distutils.command.build_ext import build_ext +from distutils.command.install import INSTALL_SCHEMES, install +from distutils.core import Distribution +from distutils.errors import DistutilsOptionError +from distutils.extension import Extension +from distutils.tests import missing_compiler_executable, support +from distutils.util import is_mingw + +import pytest + + +def _make_ext_name(modname): + return modname + sysconfig.get_config_var('EXT_SUFFIX') + + +@support.combine_markers +@pytest.mark.usefixtures('save_env') +class TestInstall( + support.TempdirManager, +): + @pytest.mark.xfail( + 'platform.system() == "Windows" and sys.version_info > (3, 11)', + reason="pypa/distutils#148", + ) + def test_home_installation_scheme(self): + # This ensure two things: + # - that --home generates the desired set of directory names + # - test --home is supported on all platforms + builddir = self.mkdtemp() + destination = os.path.join(builddir, "installation") + + dist = Distribution({"name": "foopkg"}) + # script_name need not exist, it just need to be initialized + dist.script_name = os.path.join(builddir, "setup.py") + dist.command_obj["build"] = support.DummyCommand( + build_base=builddir, + build_lib=os.path.join(builddir, "lib"), + ) + + cmd = install(dist) + cmd.home = destination + cmd.ensure_finalized() + + assert cmd.install_base == destination + assert cmd.install_platbase == destination + + def check_path(got, expected): + got = os.path.normpath(got) + expected = os.path.normpath(expected) + assert got == expected + + impl_name = sys.implementation.name.replace("cpython", "python") + libdir = os.path.join(destination, "lib", impl_name) + check_path(cmd.install_lib, libdir) + _platlibdir = getattr(sys, "platlibdir", "lib") + platlibdir = os.path.join(destination, _platlibdir, impl_name) + check_path(cmd.install_platlib, platlibdir) + check_path(cmd.install_purelib, libdir) + check_path( + cmd.install_headers, + os.path.join(destination, "include", impl_name, "foopkg"), + ) + check_path(cmd.install_scripts, os.path.join(destination, "bin")) + check_path(cmd.install_data, destination) + + def test_user_site(self, monkeypatch): + # test install with --user + # preparing the environment for the test + self.tmpdir = self.mkdtemp() + orig_site = site.USER_SITE + orig_base = site.USER_BASE + monkeypatch.setattr(site, 'USER_BASE', os.path.join(self.tmpdir, 'B')) + monkeypatch.setattr(site, 'USER_SITE', os.path.join(self.tmpdir, 'S')) + monkeypatch.setattr(install_module, 'USER_BASE', site.USER_BASE) + monkeypatch.setattr(install_module, 'USER_SITE', site.USER_SITE) + + def _expanduser(path): + if path.startswith('~'): + return os.path.normpath(self.tmpdir + path[1:]) + return path + + monkeypatch.setattr(os.path, 'expanduser', _expanduser) + + for key in ('nt_user', 'posix_user'): + assert key in INSTALL_SCHEMES + + dist = Distribution({'name': 'xx'}) + cmd = install(dist) + + # making sure the user option is there + options = [name for name, short, label in cmd.user_options] + assert 'user' in options + + # setting a value + cmd.user = True + + # user base and site shouldn't be created yet + assert not os.path.exists(site.USER_BASE) + assert not os.path.exists(site.USER_SITE) + + # let's run finalize + cmd.ensure_finalized() + + # now they should + assert os.path.exists(site.USER_BASE) + assert os.path.exists(site.USER_SITE) + + assert 'userbase' in cmd.config_vars + assert 'usersite' in cmd.config_vars + + actual_headers = os.path.relpath(cmd.install_headers, site.USER_BASE) + if os.name == 'nt' and not is_mingw(): + site_path = os.path.relpath(os.path.dirname(orig_site), orig_base) + include = os.path.join(site_path, 'Include') + else: + include = sysconfig.get_python_inc(0, '') + expect_headers = os.path.join(include, 'xx') + + assert os.path.normcase(actual_headers) == os.path.normcase(expect_headers) + + def test_handle_extra_path(self): + dist = Distribution({'name': 'xx', 'extra_path': 'path,dirs'}) + cmd = install(dist) + + # two elements + cmd.handle_extra_path() + assert cmd.extra_path == ['path', 'dirs'] + assert cmd.extra_dirs == 'dirs' + assert cmd.path_file == 'path' + + # one element + cmd.extra_path = ['path'] + cmd.handle_extra_path() + assert cmd.extra_path == ['path'] + assert cmd.extra_dirs == 'path' + assert cmd.path_file == 'path' + + # none + dist.extra_path = cmd.extra_path = None + cmd.handle_extra_path() + assert cmd.extra_path is None + assert cmd.extra_dirs == '' + assert cmd.path_file is None + + # three elements (no way !) + cmd.extra_path = 'path,dirs,again' + with pytest.raises(DistutilsOptionError): + cmd.handle_extra_path() + + def test_finalize_options(self): + dist = Distribution({'name': 'xx'}) + cmd = install(dist) + + # must supply either prefix/exec-prefix/home or + # install-base/install-platbase -- not both + cmd.prefix = 'prefix' + cmd.install_base = 'base' + with pytest.raises(DistutilsOptionError): + cmd.finalize_options() + + # must supply either home or prefix/exec-prefix -- not both + cmd.install_base = None + cmd.home = 'home' + with pytest.raises(DistutilsOptionError): + cmd.finalize_options() + + # can't combine user with prefix/exec_prefix/home or + # install_(plat)base + cmd.prefix = None + cmd.user = 'user' + with pytest.raises(DistutilsOptionError): + cmd.finalize_options() + + def test_record(self): + install_dir = self.mkdtemp() + project_dir, dist = self.create_dist(py_modules=['hello'], scripts=['sayhi']) + os.chdir(project_dir) + self.write_file('hello.py', "def main(): print('o hai')") + self.write_file('sayhi', 'from hello import main; main()') + + cmd = install(dist) + dist.command_obj['install'] = cmd + cmd.root = install_dir + cmd.record = os.path.join(project_dir, 'filelist') + cmd.ensure_finalized() + cmd.run() + + content = pathlib.Path(cmd.record).read_text(encoding='utf-8') + + found = [pathlib.Path(line).name for line in content.splitlines()] + expected = [ + 'hello.py', + f'hello.{sys.implementation.cache_tag}.pyc', + 'sayhi', + 'UNKNOWN-0.0.0-py{}.{}.egg-info'.format(*sys.version_info[:2]), + ] + assert found == expected + + def test_record_extensions(self): + cmd = missing_compiler_executable() + if cmd is not None: + pytest.skip(f'The {cmd!r} command is not found') + install_dir = self.mkdtemp() + project_dir, dist = self.create_dist( + ext_modules=[Extension('xx', ['xxmodule.c'])] + ) + os.chdir(project_dir) + support.copy_xxmodule_c(project_dir) + + buildextcmd = build_ext(dist) + support.fixup_build_ext(buildextcmd) + buildextcmd.ensure_finalized() + + cmd = install(dist) + dist.command_obj['install'] = cmd + dist.command_obj['build_ext'] = buildextcmd + cmd.root = install_dir + cmd.record = os.path.join(project_dir, 'filelist') + cmd.ensure_finalized() + cmd.run() + + content = pathlib.Path(cmd.record).read_text(encoding='utf-8') + + found = [pathlib.Path(line).name for line in content.splitlines()] + expected = [ + _make_ext_name('xx'), + 'UNKNOWN-0.0.0-py{}.{}.egg-info'.format(*sys.version_info[:2]), + ] + assert found == expected + + def test_debug_mode(self, caplog, monkeypatch): + # this covers the code called when DEBUG is set + monkeypatch.setattr(install_module, 'DEBUG', True) + caplog.set_level(logging.DEBUG) + self.test_record() + assert any(rec for rec in caplog.records if rec.levelno == logging.DEBUG) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_data.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_data.py new file mode 100644 index 000000000..c800f86c6 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_data.py @@ -0,0 +1,74 @@ +"""Tests for distutils.command.install_data.""" + +import os +import pathlib +from distutils.command.install_data import install_data +from distutils.tests import support + +import pytest + + +@pytest.mark.usefixtures('save_env') +class TestInstallData( + support.TempdirManager, +): + def test_simple_run(self): + pkg_dir, dist = self.create_dist() + cmd = install_data(dist) + cmd.install_dir = inst = os.path.join(pkg_dir, 'inst') + + # data_files can contain + # - simple files + # - a Path object + # - a tuple with a path, and a list of file + one = os.path.join(pkg_dir, 'one') + self.write_file(one, 'xxx') + inst2 = os.path.join(pkg_dir, 'inst2') + two = os.path.join(pkg_dir, 'two') + self.write_file(two, 'xxx') + three = pathlib.Path(pkg_dir) / 'three' + self.write_file(three, 'xxx') + + cmd.data_files = [one, (inst2, [two]), three] + assert cmd.get_inputs() == [one, (inst2, [two]), three] + + # let's run the command + cmd.ensure_finalized() + cmd.run() + + # let's check the result + assert len(cmd.get_outputs()) == 3 + rthree = os.path.split(one)[-1] + assert os.path.exists(os.path.join(inst, rthree)) + rtwo = os.path.split(two)[-1] + assert os.path.exists(os.path.join(inst2, rtwo)) + rone = os.path.split(one)[-1] + assert os.path.exists(os.path.join(inst, rone)) + cmd.outfiles = [] + + # let's try with warn_dir one + cmd.warn_dir = True + cmd.ensure_finalized() + cmd.run() + + # let's check the result + assert len(cmd.get_outputs()) == 3 + assert os.path.exists(os.path.join(inst, rthree)) + assert os.path.exists(os.path.join(inst2, rtwo)) + assert os.path.exists(os.path.join(inst, rone)) + cmd.outfiles = [] + + # now using root and empty dir + cmd.root = os.path.join(pkg_dir, 'root') + inst5 = os.path.join(pkg_dir, 'inst5') + four = os.path.join(cmd.install_dir, 'four') + self.write_file(four, 'xx') + cmd.data_files = [one, (inst2, [two]), three, ('inst5', [four]), (inst5, [])] + cmd.ensure_finalized() + cmd.run() + + # let's check the result + assert len(cmd.get_outputs()) == 5 + assert os.path.exists(os.path.join(inst, rthree)) + assert os.path.exists(os.path.join(inst2, rtwo)) + assert os.path.exists(os.path.join(inst, rone)) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_headers.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_headers.py new file mode 100644 index 000000000..2c74f06b9 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_headers.py @@ -0,0 +1,33 @@ +"""Tests for distutils.command.install_headers.""" + +import os +from distutils.command.install_headers import install_headers +from distutils.tests import support + +import pytest + + +@pytest.mark.usefixtures('save_env') +class TestInstallHeaders( + support.TempdirManager, +): + def test_simple_run(self): + # we have two headers + header_list = self.mkdtemp() + header1 = os.path.join(header_list, 'header1') + header2 = os.path.join(header_list, 'header2') + self.write_file(header1) + self.write_file(header2) + headers = [header1, header2] + + pkg_dir, dist = self.create_dist(headers=headers) + cmd = install_headers(dist) + assert cmd.get_inputs() == headers + + # let's run the command + cmd.install_dir = os.path.join(pkg_dir, 'inst') + cmd.ensure_finalized() + cmd.run() + + # let's check the results + assert len(cmd.get_outputs()) == 2 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_lib.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_lib.py new file mode 100644 index 000000000..f685a5795 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_lib.py @@ -0,0 +1,110 @@ +"""Tests for distutils.command.install_data.""" + +import importlib.util +import os +import sys +from distutils.command.install_lib import install_lib +from distutils.errors import DistutilsOptionError +from distutils.extension import Extension +from distutils.tests import support + +import pytest + + +@support.combine_markers +@pytest.mark.usefixtures('save_env') +class TestInstallLib( + support.TempdirManager, +): + def test_finalize_options(self): + dist = self.create_dist()[1] + cmd = install_lib(dist) + + cmd.finalize_options() + assert cmd.compile == 1 + assert cmd.optimize == 0 + + # optimize must be 0, 1, or 2 + cmd.optimize = 'foo' + with pytest.raises(DistutilsOptionError): + cmd.finalize_options() + cmd.optimize = '4' + with pytest.raises(DistutilsOptionError): + cmd.finalize_options() + + cmd.optimize = '2' + cmd.finalize_options() + assert cmd.optimize == 2 + + @pytest.mark.skipif('sys.dont_write_bytecode') + def test_byte_compile(self): + project_dir, dist = self.create_dist() + os.chdir(project_dir) + cmd = install_lib(dist) + cmd.compile = cmd.optimize = 1 + + f = os.path.join(project_dir, 'foo.py') + self.write_file(f, '# python file') + cmd.byte_compile([f]) + pyc_file = importlib.util.cache_from_source('foo.py', optimization='') + pyc_opt_file = importlib.util.cache_from_source( + 'foo.py', optimization=cmd.optimize + ) + assert os.path.exists(pyc_file) + assert os.path.exists(pyc_opt_file) + + def test_get_outputs(self): + project_dir, dist = self.create_dist() + os.chdir(project_dir) + os.mkdir('spam') + cmd = install_lib(dist) + + # setting up a dist environment + cmd.compile = cmd.optimize = 1 + cmd.install_dir = self.mkdtemp() + f = os.path.join(project_dir, 'spam', '__init__.py') + self.write_file(f, '# python package') + cmd.distribution.ext_modules = [Extension('foo', ['xxx'])] + cmd.distribution.packages = ['spam'] + cmd.distribution.script_name = 'setup.py' + + # get_outputs should return 4 elements: spam/__init__.py and .pyc, + # foo.import-tag-abiflags.so / foo.pyd + outputs = cmd.get_outputs() + assert len(outputs) == 4, outputs + + def test_get_inputs(self): + project_dir, dist = self.create_dist() + os.chdir(project_dir) + os.mkdir('spam') + cmd = install_lib(dist) + + # setting up a dist environment + cmd.compile = cmd.optimize = 1 + cmd.install_dir = self.mkdtemp() + f = os.path.join(project_dir, 'spam', '__init__.py') + self.write_file(f, '# python package') + cmd.distribution.ext_modules = [Extension('foo', ['xxx'])] + cmd.distribution.packages = ['spam'] + cmd.distribution.script_name = 'setup.py' + + # get_inputs should return 2 elements: spam/__init__.py and + # foo.import-tag-abiflags.so / foo.pyd + inputs = cmd.get_inputs() + assert len(inputs) == 2, inputs + + def test_dont_write_bytecode(self, caplog): + # makes sure byte_compile is not used + dist = self.create_dist()[1] + cmd = install_lib(dist) + cmd.compile = True + cmd.optimize = 1 + + old_dont_write_bytecode = sys.dont_write_bytecode + sys.dont_write_bytecode = True + try: + cmd.byte_compile([]) + finally: + sys.dont_write_bytecode = old_dont_write_bytecode + + assert 'byte-compiling is disabled' in caplog.messages[0] diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_scripts.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_scripts.py new file mode 100644 index 000000000..868b1c225 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_install_scripts.py @@ -0,0 +1,52 @@ +"""Tests for distutils.command.install_scripts.""" + +import os +from distutils.command.install_scripts import install_scripts +from distutils.core import Distribution +from distutils.tests import support + +from . import test_build_scripts + + +class TestInstallScripts(support.TempdirManager): + def test_default_settings(self): + dist = Distribution() + dist.command_obj["build"] = support.DummyCommand(build_scripts="/foo/bar") + dist.command_obj["install"] = support.DummyCommand( + install_scripts="/splat/funk", + force=True, + skip_build=True, + ) + cmd = install_scripts(dist) + assert not cmd.force + assert not cmd.skip_build + assert cmd.build_dir is None + assert cmd.install_dir is None + + cmd.finalize_options() + + assert cmd.force + assert cmd.skip_build + assert cmd.build_dir == "/foo/bar" + assert cmd.install_dir == "/splat/funk" + + def test_installation(self): + source = self.mkdtemp() + + expected = test_build_scripts.TestBuildScripts.write_sample_scripts(source) + + target = self.mkdtemp() + dist = Distribution() + dist.command_obj["build"] = support.DummyCommand(build_scripts=source) + dist.command_obj["install"] = support.DummyCommand( + install_scripts=target, + force=True, + skip_build=True, + ) + cmd = install_scripts(dist) + cmd.finalize_options() + cmd.run() + + installed = os.listdir(target) + for name in expected: + assert name in installed diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_log.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_log.py new file mode 100644 index 000000000..d67779fc9 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_log.py @@ -0,0 +1,12 @@ +"""Tests for distutils.log""" + +import logging +from distutils._log import log + + +class TestLog: + def test_non_ascii(self, caplog): + caplog.set_level(logging.DEBUG) + log.debug('Dεbug\tMėssãge') + log.fatal('Fαtal\tÈrrōr') + assert caplog.messages == ['Dεbug\tMėssãge', 'Fαtal\tÈrrōr'] diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_modified.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_modified.py new file mode 100644 index 000000000..e35cec2d6 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_modified.py @@ -0,0 +1,126 @@ +"""Tests for distutils._modified.""" + +import os +import types +from distutils._modified import newer, newer_group, newer_pairwise, newer_pairwise_group +from distutils.errors import DistutilsFileError +from distutils.tests import support + +import pytest + + +class TestDepUtil(support.TempdirManager): + def test_newer(self): + tmpdir = self.mkdtemp() + new_file = os.path.join(tmpdir, 'new') + old_file = os.path.abspath(__file__) + + # Raise DistutilsFileError if 'new_file' does not exist. + with pytest.raises(DistutilsFileError): + newer(new_file, old_file) + + # Return true if 'new_file' exists and is more recently modified than + # 'old_file', or if 'new_file' exists and 'old_file' doesn't. + self.write_file(new_file) + assert newer(new_file, 'I_dont_exist') + assert newer(new_file, old_file) + + # Return false if both exist and 'old_file' is the same age or younger + # than 'new_file'. + assert not newer(old_file, new_file) + + def _setup_1234(self): + tmpdir = self.mkdtemp() + sources = os.path.join(tmpdir, 'sources') + targets = os.path.join(tmpdir, 'targets') + os.mkdir(sources) + os.mkdir(targets) + one = os.path.join(sources, 'one') + two = os.path.join(sources, 'two') + three = os.path.abspath(__file__) # I am the old file + four = os.path.join(targets, 'four') + self.write_file(one) + self.write_file(two) + self.write_file(four) + return one, two, three, four + + def test_newer_pairwise(self): + one, two, three, four = self._setup_1234() + + assert newer_pairwise([one, two], [three, four]) == ([one], [three]) + + def test_newer_pairwise_mismatch(self): + one, two, three, four = self._setup_1234() + + with pytest.raises(ValueError): + newer_pairwise([one], [three, four]) + + with pytest.raises(ValueError): + newer_pairwise([one, two], [three]) + + def test_newer_pairwise_empty(self): + assert newer_pairwise([], []) == ([], []) + + def test_newer_pairwise_fresh(self): + one, two, three, four = self._setup_1234() + + assert newer_pairwise([one, three], [two, four]) == ([], []) + + def test_newer_group(self): + tmpdir = self.mkdtemp() + sources = os.path.join(tmpdir, 'sources') + os.mkdir(sources) + one = os.path.join(sources, 'one') + two = os.path.join(sources, 'two') + three = os.path.join(sources, 'three') + old_file = os.path.abspath(__file__) + + # return true if 'old_file' is out-of-date with respect to any file + # listed in 'sources'. + self.write_file(one) + self.write_file(two) + self.write_file(three) + assert newer_group([one, two, three], old_file) + assert not newer_group([one, two, old_file], three) + + # missing handling + os.remove(one) + with pytest.raises(OSError): + newer_group([one, two, old_file], three) + + assert not newer_group([one, two, old_file], three, missing='ignore') + + assert newer_group([one, two, old_file], three, missing='newer') + + +@pytest.fixture +def groups_target(tmp_path): + """ + Set up some older sources, a target, and newer sources. + + Returns a simple namespace with these values. + """ + filenames = ['older.c', 'older.h', 'target.o', 'newer.c', 'newer.h'] + paths = [tmp_path / name for name in filenames] + + for mtime, path in enumerate(paths): + path.write_text('', encoding='utf-8') + + # make sure modification times are sequential + os.utime(path, (mtime, mtime)) + + return types.SimpleNamespace(older=paths[:2], target=paths[2], newer=paths[3:]) + + +def test_newer_pairwise_group(groups_target): + older = newer_pairwise_group([groups_target.older], [groups_target.target]) + newer = newer_pairwise_group([groups_target.newer], [groups_target.target]) + assert older == ([], []) + assert newer == ([groups_target.newer], [groups_target.target]) + + +def test_newer_group_no_sources_no_target(tmp_path): + """ + Consider no sources and no target "newer". + """ + assert newer_group([], str(tmp_path / 'does-not-exist')) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_sdist.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_sdist.py new file mode 100644 index 000000000..6b1a376b2 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_sdist.py @@ -0,0 +1,470 @@ +"""Tests for distutils.command.sdist.""" + +import os +import pathlib +import shutil # noqa: F401 +import tarfile +import zipfile +from distutils.archive_util import ARCHIVE_FORMATS +from distutils.command.sdist import sdist, show_formats +from distutils.core import Distribution +from distutils.errors import DistutilsOptionError +from distutils.filelist import FileList +from os.path import join +from textwrap import dedent + +import jaraco.path +import path +import pytest +from more_itertools import ilen + +from . import support +from .unix_compat import grp, pwd, require_uid_0, require_unix_id + +SETUP_PY = """ +from distutils.core import setup +import somecode + +setup(name='fake') +""" + +MANIFEST = """\ +# file GENERATED by distutils, do NOT edit +README +buildout.cfg +inroot.txt +setup.py +data%(sep)sdata.dt +scripts%(sep)sscript.py +some%(sep)sfile.txt +some%(sep)sother_file.txt +somecode%(sep)s__init__.py +somecode%(sep)sdoc.dat +somecode%(sep)sdoc.txt +""" + + +@pytest.fixture(autouse=True) +def project_dir(request, distutils_managed_tempdir): + self = request.instance + self.tmp_dir = self.mkdtemp() + jaraco.path.build( + { + 'somecode': { + '__init__.py': '#', + }, + 'README': 'xxx', + 'setup.py': SETUP_PY, + }, + self.tmp_dir, + ) + with path.Path(self.tmp_dir): + yield + + +def clean_lines(filepath): + with pathlib.Path(filepath).open(encoding='utf-8') as f: + yield from filter(None, map(str.strip, f)) + + +class TestSDist(support.TempdirManager): + def get_cmd(self, metadata=None): + """Returns a cmd""" + if metadata is None: + metadata = { + 'name': 'ns.fake--pkg', + 'version': '1.0', + 'url': 'xxx', + 'author': 'xxx', + 'author_email': 'xxx', + } + dist = Distribution(metadata) + dist.script_name = 'setup.py' + dist.packages = ['somecode'] + dist.include_package_data = True + cmd = sdist(dist) + cmd.dist_dir = 'dist' + return dist, cmd + + @pytest.mark.usefixtures('needs_zlib') + def test_prune_file_list(self): + # this test creates a project with some VCS dirs and an NFS rename + # file, then launches sdist to check they get pruned on all systems + + # creating VCS directories with some files in them + os.mkdir(join(self.tmp_dir, 'somecode', '.svn')) + self.write_file((self.tmp_dir, 'somecode', '.svn', 'ok.py'), 'xxx') + + os.mkdir(join(self.tmp_dir, 'somecode', '.hg')) + self.write_file((self.tmp_dir, 'somecode', '.hg', 'ok'), 'xxx') + + os.mkdir(join(self.tmp_dir, 'somecode', '.git')) + self.write_file((self.tmp_dir, 'somecode', '.git', 'ok'), 'xxx') + + self.write_file((self.tmp_dir, 'somecode', '.nfs0001'), 'xxx') + + # now building a sdist + dist, cmd = self.get_cmd() + + # zip is available universally + # (tar might not be installed under win32) + cmd.formats = ['zip'] + + cmd.ensure_finalized() + cmd.run() + + # now let's check what we have + dist_folder = join(self.tmp_dir, 'dist') + files = os.listdir(dist_folder) + assert files == ['ns_fake_pkg-1.0.zip'] + + zip_file = zipfile.ZipFile(join(dist_folder, 'ns_fake_pkg-1.0.zip')) + try: + content = zip_file.namelist() + finally: + zip_file.close() + + # making sure everything has been pruned correctly + expected = [ + '', + 'PKG-INFO', + 'README', + 'setup.py', + 'somecode/', + 'somecode/__init__.py', + ] + assert sorted(content) == ['ns_fake_pkg-1.0/' + x for x in expected] + + @pytest.mark.usefixtures('needs_zlib') + @pytest.mark.skipif("not shutil.which('tar')") + @pytest.mark.skipif("not shutil.which('gzip')") + def test_make_distribution(self): + # now building a sdist + dist, cmd = self.get_cmd() + + # creating a gztar then a tar + cmd.formats = ['gztar', 'tar'] + cmd.ensure_finalized() + cmd.run() + + # making sure we have two files + dist_folder = join(self.tmp_dir, 'dist') + result = os.listdir(dist_folder) + result.sort() + assert result == ['ns_fake_pkg-1.0.tar', 'ns_fake_pkg-1.0.tar.gz'] + + os.remove(join(dist_folder, 'ns_fake_pkg-1.0.tar')) + os.remove(join(dist_folder, 'ns_fake_pkg-1.0.tar.gz')) + + # now trying a tar then a gztar + cmd.formats = ['tar', 'gztar'] + + cmd.ensure_finalized() + cmd.run() + + result = os.listdir(dist_folder) + result.sort() + assert result == ['ns_fake_pkg-1.0.tar', 'ns_fake_pkg-1.0.tar.gz'] + + @pytest.mark.usefixtures('needs_zlib') + def test_add_defaults(self): + # https://bugs.python.org/issue2279 + + # add_default should also include + # data_files and package_data + dist, cmd = self.get_cmd() + + # filling data_files by pointing files + # in package_data + dist.package_data = {'': ['*.cfg', '*.dat'], 'somecode': ['*.txt']} + self.write_file((self.tmp_dir, 'somecode', 'doc.txt'), '#') + self.write_file((self.tmp_dir, 'somecode', 'doc.dat'), '#') + + # adding some data in data_files + data_dir = join(self.tmp_dir, 'data') + os.mkdir(data_dir) + self.write_file((data_dir, 'data.dt'), '#') + some_dir = join(self.tmp_dir, 'some') + os.mkdir(some_dir) + # make sure VCS directories are pruned (#14004) + hg_dir = join(self.tmp_dir, '.hg') + os.mkdir(hg_dir) + self.write_file((hg_dir, 'last-message.txt'), '#') + # a buggy regex used to prevent this from working on windows (#6884) + self.write_file((self.tmp_dir, 'buildout.cfg'), '#') + self.write_file((self.tmp_dir, 'inroot.txt'), '#') + self.write_file((some_dir, 'file.txt'), '#') + self.write_file((some_dir, 'other_file.txt'), '#') + + dist.data_files = [ + ('data', ['data/data.dt', 'buildout.cfg', 'inroot.txt', 'notexisting']), + 'some/file.txt', + 'some/other_file.txt', + ] + + # adding a script + script_dir = join(self.tmp_dir, 'scripts') + os.mkdir(script_dir) + self.write_file((script_dir, 'script.py'), '#') + dist.scripts = [join('scripts', 'script.py')] + + cmd.formats = ['zip'] + cmd.use_defaults = True + + cmd.ensure_finalized() + cmd.run() + + # now let's check what we have + dist_folder = join(self.tmp_dir, 'dist') + files = os.listdir(dist_folder) + assert files == ['ns_fake_pkg-1.0.zip'] + + zip_file = zipfile.ZipFile(join(dist_folder, 'ns_fake_pkg-1.0.zip')) + try: + content = zip_file.namelist() + finally: + zip_file.close() + + # making sure everything was added + expected = [ + '', + 'PKG-INFO', + 'README', + 'buildout.cfg', + 'data/', + 'data/data.dt', + 'inroot.txt', + 'scripts/', + 'scripts/script.py', + 'setup.py', + 'some/', + 'some/file.txt', + 'some/other_file.txt', + 'somecode/', + 'somecode/__init__.py', + 'somecode/doc.dat', + 'somecode/doc.txt', + ] + assert sorted(content) == ['ns_fake_pkg-1.0/' + x for x in expected] + + # checking the MANIFEST + manifest = pathlib.Path(self.tmp_dir, 'MANIFEST').read_text(encoding='utf-8') + assert manifest == MANIFEST % {'sep': os.sep} + + @staticmethod + def warnings(messages, prefix='warning: '): + return [msg for msg in messages if msg.startswith(prefix)] + + @pytest.mark.usefixtures('needs_zlib') + def test_metadata_check_option(self, caplog): + # testing the `medata-check` option + dist, cmd = self.get_cmd(metadata={}) + + # this should raise some warnings ! + # with the `check` subcommand + cmd.ensure_finalized() + cmd.run() + assert len(self.warnings(caplog.messages, 'warning: check: ')) == 1 + + # trying with a complete set of metadata + caplog.clear() + dist, cmd = self.get_cmd() + cmd.ensure_finalized() + cmd.metadata_check = False + cmd.run() + assert len(self.warnings(caplog.messages, 'warning: check: ')) == 0 + + def test_show_formats(self, capsys): + show_formats() + + # the output should be a header line + one line per format + num_formats = len(ARCHIVE_FORMATS.keys()) + output = [ + line + for line in capsys.readouterr().out.split('\n') + if line.strip().startswith('--formats=') + ] + assert len(output) == num_formats + + def test_finalize_options(self): + dist, cmd = self.get_cmd() + cmd.finalize_options() + + # default options set by finalize + assert cmd.manifest == 'MANIFEST' + assert cmd.template == 'MANIFEST.in' + assert cmd.dist_dir == 'dist' + + # formats has to be a string splitable on (' ', ',') or + # a stringlist + cmd.formats = 1 + with pytest.raises(DistutilsOptionError): + cmd.finalize_options() + cmd.formats = ['zip'] + cmd.finalize_options() + + # formats has to be known + cmd.formats = 'supazipa' + with pytest.raises(DistutilsOptionError): + cmd.finalize_options() + + # the following tests make sure there is a nice error message instead + # of a traceback when parsing an invalid manifest template + + def _check_template(self, content, caplog): + dist, cmd = self.get_cmd() + os.chdir(self.tmp_dir) + self.write_file('MANIFEST.in', content) + cmd.ensure_finalized() + cmd.filelist = FileList() + cmd.read_template() + assert len(self.warnings(caplog.messages)) == 1 + + def test_invalid_template_unknown_command(self, caplog): + self._check_template('taunt knights *', caplog) + + def test_invalid_template_wrong_arguments(self, caplog): + # this manifest command takes one argument + self._check_template('prune', caplog) + + @pytest.mark.skipif("platform.system() != 'Windows'") + def test_invalid_template_wrong_path(self, caplog): + # on Windows, trailing slashes are not allowed + # this used to crash instead of raising a warning: #8286 + self._check_template('include examples/', caplog) + + @pytest.mark.usefixtures('needs_zlib') + def test_get_file_list(self): + # make sure MANIFEST is recalculated + dist, cmd = self.get_cmd() + + # filling data_files by pointing files in package_data + dist.package_data = {'somecode': ['*.txt']} + self.write_file((self.tmp_dir, 'somecode', 'doc.txt'), '#') + cmd.formats = ['gztar'] + cmd.ensure_finalized() + cmd.run() + + assert ilen(clean_lines(cmd.manifest)) == 5 + + # adding a file + self.write_file((self.tmp_dir, 'somecode', 'doc2.txt'), '#') + + # make sure build_py is reinitialized, like a fresh run + build_py = dist.get_command_obj('build_py') + build_py.finalized = False + build_py.ensure_finalized() + + cmd.run() + + manifest2 = list(clean_lines(cmd.manifest)) + + # do we have the new file in MANIFEST ? + assert len(manifest2) == 6 + assert 'doc2.txt' in manifest2[-1] + + @pytest.mark.usefixtures('needs_zlib') + def test_manifest_marker(self): + # check that autogenerated MANIFESTs have a marker + dist, cmd = self.get_cmd() + cmd.ensure_finalized() + cmd.run() + + assert ( + next(clean_lines(cmd.manifest)) + == '# file GENERATED by distutils, do NOT edit' + ) + + @pytest.mark.usefixtures('needs_zlib') + def test_manifest_comments(self): + # make sure comments don't cause exceptions or wrong includes + contents = dedent( + """\ + # bad.py + #bad.py + good.py + """ + ) + dist, cmd = self.get_cmd() + cmd.ensure_finalized() + self.write_file((self.tmp_dir, cmd.manifest), contents) + self.write_file((self.tmp_dir, 'good.py'), '# pick me!') + self.write_file((self.tmp_dir, 'bad.py'), "# don't pick me!") + self.write_file((self.tmp_dir, '#bad.py'), "# don't pick me!") + cmd.run() + assert cmd.filelist.files == ['good.py'] + + @pytest.mark.usefixtures('needs_zlib') + def test_manual_manifest(self): + # check that a MANIFEST without a marker is left alone + dist, cmd = self.get_cmd() + cmd.formats = ['gztar'] + cmd.ensure_finalized() + self.write_file((self.tmp_dir, cmd.manifest), 'README.manual') + self.write_file( + (self.tmp_dir, 'README.manual'), + 'This project maintains its MANIFEST file itself.', + ) + cmd.run() + assert cmd.filelist.files == ['README.manual'] + + assert list(clean_lines(cmd.manifest)) == ['README.manual'] + + archive_name = join(self.tmp_dir, 'dist', 'ns_fake_pkg-1.0.tar.gz') + archive = tarfile.open(archive_name) + try: + filenames = [tarinfo.name for tarinfo in archive] + finally: + archive.close() + assert sorted(filenames) == [ + 'ns_fake_pkg-1.0', + 'ns_fake_pkg-1.0/PKG-INFO', + 'ns_fake_pkg-1.0/README.manual', + ] + + @pytest.mark.usefixtures('needs_zlib') + @require_unix_id + @require_uid_0 + @pytest.mark.skipif("not shutil.which('tar')") + @pytest.mark.skipif("not shutil.which('gzip')") + def test_make_distribution_owner_group(self): + # now building a sdist + dist, cmd = self.get_cmd() + + # creating a gztar and specifying the owner+group + cmd.formats = ['gztar'] + cmd.owner = pwd.getpwuid(0)[0] + cmd.group = grp.getgrgid(0)[0] + cmd.ensure_finalized() + cmd.run() + + # making sure we have the good rights + archive_name = join(self.tmp_dir, 'dist', 'ns_fake_pkg-1.0.tar.gz') + archive = tarfile.open(archive_name) + try: + for member in archive.getmembers(): + assert member.uid == 0 + assert member.gid == 0 + finally: + archive.close() + + # building a sdist again + dist, cmd = self.get_cmd() + + # creating a gztar + cmd.formats = ['gztar'] + cmd.ensure_finalized() + cmd.run() + + # making sure we have the good rights + archive_name = join(self.tmp_dir, 'dist', 'ns_fake_pkg-1.0.tar.gz') + archive = tarfile.open(archive_name) + + # note that we are not testing the group ownership here + # because, depending on the platforms and the container + # rights (see #7408) + try: + for member in archive.getmembers(): + assert member.uid == os.getuid() + finally: + archive.close() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_spawn.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_spawn.py new file mode 100644 index 000000000..3b9fc926f --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_spawn.py @@ -0,0 +1,141 @@ +"""Tests for distutils.spawn.""" + +import os +import stat +import sys +import unittest.mock as mock +from distutils.errors import DistutilsExecError +from distutils.spawn import find_executable, spawn +from distutils.tests import support + +import path +import pytest +from test.support import unix_shell + +from .compat import py39 as os_helper + + +class TestSpawn(support.TempdirManager): + @pytest.mark.skipif("os.name not in ('nt', 'posix')") + def test_spawn(self): + tmpdir = self.mkdtemp() + + # creating something executable + # through the shell that returns 1 + if sys.platform != 'win32': + exe = os.path.join(tmpdir, 'foo.sh') + self.write_file(exe, f'#!{unix_shell}\nexit 1') + else: + exe = os.path.join(tmpdir, 'foo.bat') + self.write_file(exe, 'exit 1') + + os.chmod(exe, 0o777) + with pytest.raises(DistutilsExecError): + spawn([exe]) + + # now something that works + if sys.platform != 'win32': + exe = os.path.join(tmpdir, 'foo.sh') + self.write_file(exe, f'#!{unix_shell}\nexit 0') + else: + exe = os.path.join(tmpdir, 'foo.bat') + self.write_file(exe, 'exit 0') + + os.chmod(exe, 0o777) + spawn([exe]) # should work without any error + + def test_find_executable(self, tmp_path): + program_path = self._make_executable(tmp_path, '.exe') + program = program_path.name + program_noeext = program_path.with_suffix('').name + filename = str(program_path) + tmp_dir = path.Path(tmp_path) + + # test path parameter + rv = find_executable(program, path=tmp_dir) + assert rv == filename + + if sys.platform == 'win32': + # test without ".exe" extension + rv = find_executable(program_noeext, path=tmp_dir) + assert rv == filename + + # test find in the current directory + with tmp_dir: + rv = find_executable(program) + assert rv == program + + # test non-existent program + dont_exist_program = "dontexist_" + program + rv = find_executable(dont_exist_program, path=tmp_dir) + assert rv is None + + # PATH='': no match, except in the current directory + with os_helper.EnvironmentVarGuard() as env: + env['PATH'] = '' + with ( + mock.patch( + 'distutils.spawn.os.confstr', return_value=tmp_dir, create=True + ), + mock.patch('distutils.spawn.os.defpath', tmp_dir), + ): + rv = find_executable(program) + assert rv is None + + # look in current directory + with tmp_dir: + rv = find_executable(program) + assert rv == program + + # PATH=':': explicitly looks in the current directory + with os_helper.EnvironmentVarGuard() as env: + env['PATH'] = os.pathsep + with ( + mock.patch('distutils.spawn.os.confstr', return_value='', create=True), + mock.patch('distutils.spawn.os.defpath', ''), + ): + rv = find_executable(program) + assert rv is None + + # look in current directory + with tmp_dir: + rv = find_executable(program) + assert rv == program + + # missing PATH: test os.confstr("CS_PATH") and os.defpath + with os_helper.EnvironmentVarGuard() as env: + env.pop('PATH', None) + + # without confstr + with ( + mock.patch( + 'distutils.spawn.os.confstr', side_effect=ValueError, create=True + ), + mock.patch('distutils.spawn.os.defpath', tmp_dir), + ): + rv = find_executable(program) + assert rv == filename + + # with confstr + with ( + mock.patch( + 'distutils.spawn.os.confstr', return_value=tmp_dir, create=True + ), + mock.patch('distutils.spawn.os.defpath', ''), + ): + rv = find_executable(program) + assert rv == filename + + @staticmethod + def _make_executable(tmp_path, ext): + # Give the temporary program a suffix regardless of platform. + # It's needed on Windows and not harmful on others. + program = tmp_path.joinpath('program').with_suffix(ext) + program.write_text("", encoding='utf-8') + program.chmod(stat.S_IXUSR) + return program + + def test_spawn_missing_exe(self): + with pytest.raises(DistutilsExecError) as ctx: + spawn(['does-not-exist']) + assert "command 'does-not-exist' failed" in str(ctx.value) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_sysconfig.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_sysconfig.py new file mode 100644 index 000000000..43d77c23f --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_sysconfig.py @@ -0,0 +1,319 @@ +"""Tests for distutils.sysconfig.""" + +import contextlib +import distutils +import os +import pathlib +import subprocess +import sys +from distutils import sysconfig +from distutils.ccompiler import new_compiler # noqa: F401 +from distutils.unixccompiler import UnixCCompiler + +import jaraco.envs +import path +import pytest +from jaraco.text import trim +from test.support import swap_item + + +def _gen_makefile(root, contents): + jaraco.path.build({'Makefile': trim(contents)}, root) + return root / 'Makefile' + + +@pytest.mark.usefixtures('save_env') +class TestSysconfig: + def test_get_config_h_filename(self): + config_h = sysconfig.get_config_h_filename() + assert os.path.isfile(config_h) + + @pytest.mark.skipif("platform.system() == 'Windows'") + @pytest.mark.skipif("sys.implementation.name != 'cpython'") + def test_get_makefile_filename(self): + makefile = sysconfig.get_makefile_filename() + assert os.path.isfile(makefile) + + def test_get_python_lib(self, tmp_path): + assert sysconfig.get_python_lib() != sysconfig.get_python_lib(prefix=tmp_path) + + def test_get_config_vars(self): + cvars = sysconfig.get_config_vars() + assert isinstance(cvars, dict) + assert cvars + + @pytest.mark.skipif('sysconfig.IS_PYPY') + @pytest.mark.skipif('sysconfig.python_build') + @pytest.mark.xfail('platform.system() == "Windows"') + def test_srcdir_simple(self): + # See #15364. + srcdir = pathlib.Path(sysconfig.get_config_var('srcdir')) + + assert srcdir.absolute() + assert srcdir.is_dir() + + makefile = pathlib.Path(sysconfig.get_makefile_filename()) + assert makefile.parent.samefile(srcdir) + + @pytest.mark.skipif('sysconfig.IS_PYPY') + @pytest.mark.skipif('not sysconfig.python_build') + def test_srcdir_python_build(self): + # See #15364. + srcdir = pathlib.Path(sysconfig.get_config_var('srcdir')) + + # The python executable has not been installed so srcdir + # should be a full source checkout. + Python_h = srcdir.joinpath('Include', 'Python.h') + assert Python_h.is_file() + assert sysconfig._is_python_source_dir(srcdir) + assert sysconfig._is_python_source_dir(str(srcdir)) + + def test_srcdir_independent_of_cwd(self): + """ + srcdir should be independent of the current working directory + """ + # See #15364. + srcdir = sysconfig.get_config_var('srcdir') + with path.Path('..'): + srcdir2 = sysconfig.get_config_var('srcdir') + assert srcdir == srcdir2 + + def customize_compiler(self): + # make sure AR gets caught + class compiler: + compiler_type = 'unix' + executables = UnixCCompiler.executables + + def __init__(self): + self.exes = {} + + def set_executables(self, **kw): + for k, v in kw.items(): + self.exes[k] = v + + sysconfig_vars = { + 'AR': 'sc_ar', + 'CC': 'sc_cc', + 'CXX': 'sc_cxx', + 'ARFLAGS': '--sc-arflags', + 'CFLAGS': '--sc-cflags', + 'CCSHARED': '--sc-ccshared', + 'LDSHARED': 'sc_ldshared', + 'SHLIB_SUFFIX': 'sc_shutil_suffix', + } + + comp = compiler() + with contextlib.ExitStack() as cm: + for key, value in sysconfig_vars.items(): + cm.enter_context(swap_item(sysconfig._config_vars, key, value)) + sysconfig.customize_compiler(comp) + + return comp + + @pytest.mark.skipif("not isinstance(new_compiler(), UnixCCompiler)") + @pytest.mark.usefixtures('disable_macos_customization') + def test_customize_compiler(self): + # Make sure that sysconfig._config_vars is initialized + sysconfig.get_config_vars() + + os.environ['AR'] = 'env_ar' + os.environ['CC'] = 'env_cc' + os.environ['CPP'] = 'env_cpp' + os.environ['CXX'] = 'env_cxx --env-cxx-flags' + os.environ['LDSHARED'] = 'env_ldshared' + os.environ['LDFLAGS'] = '--env-ldflags' + os.environ['ARFLAGS'] = '--env-arflags' + os.environ['CFLAGS'] = '--env-cflags' + os.environ['CPPFLAGS'] = '--env-cppflags' + os.environ['RANLIB'] = 'env_ranlib' + + comp = self.customize_compiler() + assert comp.exes['archiver'] == 'env_ar --env-arflags' + assert comp.exes['preprocessor'] == 'env_cpp --env-cppflags' + assert comp.exes['compiler'] == 'env_cc --env-cflags --env-cppflags' + assert comp.exes['compiler_so'] == ( + 'env_cc --env-cflags --env-cppflags --sc-ccshared' + ) + assert ( + comp.exes['compiler_cxx'] + == 'env_cxx --env-cxx-flags --sc-cflags --env-cppflags' + ) + assert comp.exes['linker_exe'] == 'env_cc' + assert comp.exes['linker_so'] == ( + 'env_ldshared --env-ldflags --env-cflags --env-cppflags' + ) + assert comp.shared_lib_extension == 'sc_shutil_suffix' + + if sys.platform == "darwin": + assert comp.exes['ranlib'] == 'env_ranlib' + else: + assert 'ranlib' not in comp.exes + + del os.environ['AR'] + del os.environ['CC'] + del os.environ['CPP'] + del os.environ['CXX'] + del os.environ['LDSHARED'] + del os.environ['LDFLAGS'] + del os.environ['ARFLAGS'] + del os.environ['CFLAGS'] + del os.environ['CPPFLAGS'] + del os.environ['RANLIB'] + + comp = self.customize_compiler() + assert comp.exes['archiver'] == 'sc_ar --sc-arflags' + assert comp.exes['preprocessor'] == 'sc_cc -E' + assert comp.exes['compiler'] == 'sc_cc --sc-cflags' + assert comp.exes['compiler_so'] == 'sc_cc --sc-cflags --sc-ccshared' + assert comp.exes['compiler_cxx'] == 'sc_cxx --sc-cflags' + assert comp.exes['linker_exe'] == 'sc_cc' + assert comp.exes['linker_so'] == 'sc_ldshared' + assert comp.shared_lib_extension == 'sc_shutil_suffix' + assert 'ranlib' not in comp.exes + + def test_parse_makefile_base(self, tmp_path): + makefile = _gen_makefile( + tmp_path, + """ + CONFIG_ARGS= '--arg1=optarg1' 'ENV=LIB' + VAR=$OTHER + OTHER=foo + """, + ) + d = sysconfig.parse_makefile(makefile) + assert d == {'CONFIG_ARGS': "'--arg1=optarg1' 'ENV=LIB'", 'OTHER': 'foo'} + + def test_parse_makefile_literal_dollar(self, tmp_path): + makefile = _gen_makefile( + tmp_path, + """ + CONFIG_ARGS= '--arg1=optarg1' 'ENV=\\$$LIB' + VAR=$OTHER + OTHER=foo + """, + ) + d = sysconfig.parse_makefile(makefile) + assert d == {'CONFIG_ARGS': r"'--arg1=optarg1' 'ENV=\$LIB'", 'OTHER': 'foo'} + + def test_sysconfig_module(self): + import sysconfig as global_sysconfig + + assert global_sysconfig.get_config_var('CFLAGS') == sysconfig.get_config_var( + 'CFLAGS' + ) + assert global_sysconfig.get_config_var('LDFLAGS') == sysconfig.get_config_var( + 'LDFLAGS' + ) + + # On macOS, binary installers support extension module building on + # various levels of the operating system with differing Xcode + # configurations, requiring customization of some of the + # compiler configuration directives to suit the environment on + # the installed machine. Some of these customizations may require + # running external programs and are thus deferred until needed by + # the first extension module build. Only + # the Distutils version of sysconfig is used for extension module + # builds, which happens earlier in the Distutils tests. This may + # cause the following tests to fail since no tests have caused + # the global version of sysconfig to call the customization yet. + # The solution for now is to simply skip this test in this case. + # The longer-term solution is to only have one version of sysconfig. + @pytest.mark.skipif("sysconfig.get_config_var('CUSTOMIZED_OSX_COMPILER')") + def test_sysconfig_compiler_vars(self): + import sysconfig as global_sysconfig + + if sysconfig.get_config_var('CUSTOMIZED_OSX_COMPILER'): + pytest.skip('compiler flags customized') + assert global_sysconfig.get_config_var('LDSHARED') == sysconfig.get_config_var( + 'LDSHARED' + ) + assert global_sysconfig.get_config_var('CC') == sysconfig.get_config_var('CC') + + @pytest.mark.skipif("not sysconfig.get_config_var('EXT_SUFFIX')") + def test_SO_deprecation(self): + with pytest.warns(DeprecationWarning): + sysconfig.get_config_var('SO') + + def test_customize_compiler_before_get_config_vars(self, tmp_path): + # Issue #21923: test that a Distribution compiler + # instance can be called without an explicit call to + # get_config_vars(). + jaraco.path.build( + { + 'file': trim(""" + from distutils.core import Distribution + config = Distribution().get_command_obj('config') + # try_compile may pass or it may fail if no compiler + # is found but it should not raise an exception. + rc = config.try_compile('int x;') + """) + }, + tmp_path, + ) + p = subprocess.Popen( + [sys.executable, tmp_path / 'file'], + stdout=subprocess.PIPE, + stderr=subprocess.STDOUT, + universal_newlines=True, + encoding='utf-8', + ) + outs, errs = p.communicate() + assert 0 == p.returncode, "Subprocess failed: " + outs + + def test_parse_config_h(self): + config_h = sysconfig.get_config_h_filename() + input = {} + with open(config_h, encoding="utf-8") as f: + result = sysconfig.parse_config_h(f, g=input) + assert input is result + with open(config_h, encoding="utf-8") as f: + result = sysconfig.parse_config_h(f) + assert isinstance(result, dict) + + @pytest.mark.skipif("platform.system() != 'Windows'") + @pytest.mark.skipif("sys.implementation.name != 'cpython'") + def test_win_ext_suffix(self): + assert sysconfig.get_config_var("EXT_SUFFIX").endswith(".pyd") + assert sysconfig.get_config_var("EXT_SUFFIX") != ".pyd" + + @pytest.mark.skipif("platform.system() != 'Windows'") + @pytest.mark.skipif("sys.implementation.name != 'cpython'") + @pytest.mark.skipif( + '\\PCbuild\\'.casefold() not in sys.executable.casefold(), + reason='Need sys.executable to be in a source tree', + ) + def test_win_build_venv_from_source_tree(self, tmp_path): + """Ensure distutils.sysconfig detects venvs from source tree builds.""" + env = jaraco.envs.VEnv() + env.create_opts = env.clean_opts + env.root = tmp_path + env.ensure_env() + cmd = [ + env.exe(), + "-c", + "import distutils.sysconfig; print(distutils.sysconfig.python_build)", + ] + distutils_path = os.path.dirname(os.path.dirname(distutils.__file__)) + out = subprocess.check_output( + cmd, env={**os.environ, "PYTHONPATH": distutils_path} + ) + assert out == "True" + + def test_get_python_inc_missing_config_dir(self, monkeypatch): + """ + In portable Python installations, the sysconfig will be broken, + pointing to the directories where the installation was built and + not where it currently is. In this case, ensure that the missing + directory isn't used for get_python_inc. + + See pypa/distutils#178. + """ + + def override(name): + if name == 'INCLUDEPY': + return '/does-not-exist' + return sysconfig.get_config_var(name) + + monkeypatch.setattr(sysconfig, 'get_config_var', override) + + assert os.path.exists(sysconfig.get_python_inc()) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_text_file.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_text_file.py new file mode 100644 index 000000000..f51115656 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_text_file.py @@ -0,0 +1,127 @@ +"""Tests for distutils.text_file.""" + +from distutils.tests import support +from distutils.text_file import TextFile + +import jaraco.path +import path + +TEST_DATA = """# test file + +line 3 \\ +# intervening comment + continues on next line +""" + + +class TestTextFile(support.TempdirManager): + def test_class(self): + # old tests moved from text_file.__main__ + # so they are really called by the buildbots + + # result 1: no fancy options + result1 = [ + '# test file\n', + '\n', + 'line 3 \\\n', + '# intervening comment\n', + ' continues on next line\n', + ] + + # result 2: just strip comments + result2 = ["\n", "line 3 \\\n", " continues on next line\n"] + + # result 3: just strip blank lines + result3 = [ + "# test file\n", + "line 3 \\\n", + "# intervening comment\n", + " continues on next line\n", + ] + + # result 4: default, strip comments, blank lines, + # and trailing whitespace + result4 = ["line 3 \\", " continues on next line"] + + # result 5: strip comments and blanks, plus join lines (but don't + # "collapse" joined lines + result5 = ["line 3 continues on next line"] + + # result 6: strip comments and blanks, plus join lines (and + # "collapse" joined lines + result6 = ["line 3 continues on next line"] + + def test_input(count, description, file, expected_result): + result = file.readlines() + assert result == expected_result + + tmp_path = path.Path(self.mkdtemp()) + filename = tmp_path / 'test.txt' + jaraco.path.build({filename.name: TEST_DATA}, tmp_path) + + in_file = TextFile( + filename, + strip_comments=False, + skip_blanks=False, + lstrip_ws=False, + rstrip_ws=False, + ) + try: + test_input(1, "no processing", in_file, result1) + finally: + in_file.close() + + in_file = TextFile( + filename, + strip_comments=True, + skip_blanks=False, + lstrip_ws=False, + rstrip_ws=False, + ) + try: + test_input(2, "strip comments", in_file, result2) + finally: + in_file.close() + + in_file = TextFile( + filename, + strip_comments=False, + skip_blanks=True, + lstrip_ws=False, + rstrip_ws=False, + ) + try: + test_input(3, "strip blanks", in_file, result3) + finally: + in_file.close() + + in_file = TextFile(filename) + try: + test_input(4, "default processing", in_file, result4) + finally: + in_file.close() + + in_file = TextFile( + filename, + strip_comments=True, + skip_blanks=True, + join_lines=True, + rstrip_ws=True, + ) + try: + test_input(5, "join lines without collapsing", in_file, result5) + finally: + in_file.close() + + in_file = TextFile( + filename, + strip_comments=True, + skip_blanks=True, + join_lines=True, + rstrip_ws=True, + collapse_join=True, + ) + try: + test_input(6, "join lines with collapsing", in_file, result6) + finally: + in_file.close() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_util.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_util.py new file mode 100644 index 000000000..00c9743ed --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_util.py @@ -0,0 +1,243 @@ +"""Tests for distutils.util.""" + +import email +import email.generator +import email.policy +import io +import os +import pathlib +import sys +import sysconfig as stdlib_sysconfig +import unittest.mock as mock +from copy import copy +from distutils import sysconfig, util +from distutils.errors import DistutilsByteCompileError, DistutilsPlatformError +from distutils.util import ( + byte_compile, + change_root, + check_environ, + convert_path, + get_host_platform, + get_platform, + grok_environment_error, + rfc822_escape, + split_quoted, + strtobool, +) + +import pytest + + +@pytest.fixture(autouse=True) +def environment(monkeypatch): + monkeypatch.setattr(os, 'name', os.name) + monkeypatch.setattr(sys, 'platform', sys.platform) + monkeypatch.setattr(sys, 'version', sys.version) + monkeypatch.setattr(os, 'sep', os.sep) + monkeypatch.setattr(os.path, 'join', os.path.join) + monkeypatch.setattr(os.path, 'isabs', os.path.isabs) + monkeypatch.setattr(os.path, 'splitdrive', os.path.splitdrive) + monkeypatch.setattr(sysconfig, '_config_vars', copy(sysconfig._config_vars)) + + +@pytest.mark.usefixtures('save_env') +class TestUtil: + def test_get_host_platform(self): + with mock.patch('os.name', 'nt'): + with mock.patch('sys.version', '... [... (ARM64)]'): + assert get_host_platform() == 'win-arm64' + with mock.patch('sys.version', '... [... (ARM)]'): + assert get_host_platform() == 'win-arm32' + + with mock.patch('sys.version_info', (3, 9, 0, 'final', 0)): + assert get_host_platform() == stdlib_sysconfig.get_platform() + + def test_get_platform(self): + with mock.patch('os.name', 'nt'): + with mock.patch.dict('os.environ', {'VSCMD_ARG_TGT_ARCH': 'x86'}): + assert get_platform() == 'win32' + with mock.patch.dict('os.environ', {'VSCMD_ARG_TGT_ARCH': 'x64'}): + assert get_platform() == 'win-amd64' + with mock.patch.dict('os.environ', {'VSCMD_ARG_TGT_ARCH': 'arm'}): + assert get_platform() == 'win-arm32' + with mock.patch.dict('os.environ', {'VSCMD_ARG_TGT_ARCH': 'arm64'}): + assert get_platform() == 'win-arm64' + + def test_convert_path(self): + expected = os.sep.join(('', 'home', 'to', 'my', 'stuff')) + assert convert_path('/home/to/my/stuff') == expected + assert convert_path(pathlib.Path('/home/to/my/stuff')) == expected + assert convert_path('.') == os.curdir + + def test_change_root(self): + # linux/mac + os.name = 'posix' + + def _isabs(path): + return path[0] == '/' + + os.path.isabs = _isabs + + def _join(*path): + return '/'.join(path) + + os.path.join = _join + + assert change_root('/root', '/old/its/here') == '/root/old/its/here' + assert change_root('/root', 'its/here') == '/root/its/here' + + # windows + os.name = 'nt' + os.sep = '\\' + + def _isabs(path): + return path.startswith('c:\\') + + os.path.isabs = _isabs + + def _splitdrive(path): + if path.startswith('c:'): + return ('', path.replace('c:', '')) + return ('', path) + + os.path.splitdrive = _splitdrive + + def _join(*path): + return '\\'.join(path) + + os.path.join = _join + + assert ( + change_root('c:\\root', 'c:\\old\\its\\here') == 'c:\\root\\old\\its\\here' + ) + assert change_root('c:\\root', 'its\\here') == 'c:\\root\\its\\here' + + # BugsBunny os (it's a great os) + os.name = 'BugsBunny' + with pytest.raises(DistutilsPlatformError): + change_root('c:\\root', 'its\\here') + + # XXX platforms to be covered: mac + + def test_check_environ(self): + util.check_environ.cache_clear() + os.environ.pop('HOME', None) + + check_environ() + + assert os.environ['PLAT'] == get_platform() + + @pytest.mark.skipif("os.name != 'posix'") + def test_check_environ_getpwuid(self): + util.check_environ.cache_clear() + os.environ.pop('HOME', None) + + import pwd + + # only set pw_dir field, other fields are not used + result = pwd.struct_passwd(( + None, + None, + None, + None, + None, + '/home/distutils', + None, + )) + with mock.patch.object(pwd, 'getpwuid', return_value=result): + check_environ() + assert os.environ['HOME'] == '/home/distutils' + + util.check_environ.cache_clear() + os.environ.pop('HOME', None) + + # bpo-10496: Catch pwd.getpwuid() error + with mock.patch.object(pwd, 'getpwuid', side_effect=KeyError): + check_environ() + assert 'HOME' not in os.environ + + def test_split_quoted(self): + assert split_quoted('""one"" "two" \'three\' \\four') == [ + 'one', + 'two', + 'three', + 'four', + ] + + def test_strtobool(self): + yes = ('y', 'Y', 'yes', 'True', 't', 'true', 'True', 'On', 'on', '1') + no = ('n', 'no', 'f', 'false', 'off', '0', 'Off', 'No', 'N') + + for y in yes: + assert strtobool(y) + + for n in no: + assert not strtobool(n) + + indent = 8 * ' ' + + @pytest.mark.parametrize( + "given,wanted", + [ + # 0x0b, 0x0c, ..., etc are also considered a line break by Python + ("hello\x0b\nworld\n", f"hello\x0b{indent}\n{indent}world\n{indent}"), + ("hello\x1eworld", f"hello\x1e{indent}world"), + ("", ""), + ( + "I am a\npoor\nlonesome\nheader\n", + f"I am a\n{indent}poor\n{indent}lonesome\n{indent}header\n{indent}", + ), + ], + ) + def test_rfc822_escape(self, given, wanted): + """ + We want to ensure a multi-line header parses correctly. + + For interoperability, the escaped value should also "round-trip" over + `email.generator.Generator.flatten` and `email.message_from_*` + (see pypa/setuptools#4033). + + The main issue is that internally `email.policy.EmailPolicy` uses + `splitlines` which will split on some control chars. If all the new lines + are not prefixed with spaces, the parser will interrupt reading + the current header and produce an incomplete value, while + incorrectly interpreting the rest of the headers as part of the payload. + """ + res = rfc822_escape(given) + + policy = email.policy.EmailPolicy( + utf8=True, + mangle_from_=False, + max_line_length=0, + ) + with io.StringIO() as buffer: + raw = f"header: {res}\nother-header: 42\n\npayload\n" + orig = email.message_from_string(raw) + email.generator.Generator(buffer, policy=policy).flatten(orig) + buffer.seek(0) + regen = email.message_from_file(buffer) + + for msg in (orig, regen): + assert msg.get_payload() == "payload\n" + assert msg["other-header"] == "42" + # Generator may replace control chars with `\n` + assert set(msg["header"].splitlines()) == set(res.splitlines()) + + assert res == wanted + + def test_dont_write_bytecode(self): + # makes sure byte_compile raise a DistutilsError + # if sys.dont_write_bytecode is True + old_dont_write_bytecode = sys.dont_write_bytecode + sys.dont_write_bytecode = True + try: + with pytest.raises(DistutilsByteCompileError): + byte_compile([]) + finally: + sys.dont_write_bytecode = old_dont_write_bytecode + + def test_grok_environment_error(self): + # test obsolete function to ensure backward compat (#4931) + exc = OSError("Unable to find batch file") + msg = grok_environment_error(exc) + assert msg == "error: Unable to find batch file" diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_version.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_version.py new file mode 100644 index 000000000..b68f09772 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_version.py @@ -0,0 +1,80 @@ +"""Tests for distutils.version.""" + +import distutils +from distutils.version import LooseVersion, StrictVersion + +import pytest + + +@pytest.fixture(autouse=True) +def suppress_deprecation(): + with distutils.version.suppress_known_deprecation(): + yield + + +class TestVersion: + def test_prerelease(self): + version = StrictVersion('1.2.3a1') + assert version.version == (1, 2, 3) + assert version.prerelease == ('a', 1) + assert str(version) == '1.2.3a1' + + version = StrictVersion('1.2.0') + assert str(version) == '1.2' + + def test_cmp_strict(self): + versions = ( + ('1.5.1', '1.5.2b2', -1), + ('161', '3.10a', ValueError), + ('8.02', '8.02', 0), + ('3.4j', '1996.07.12', ValueError), + ('3.2.pl0', '3.1.1.6', ValueError), + ('2g6', '11g', ValueError), + ('0.9', '2.2', -1), + ('1.2.1', '1.2', 1), + ('1.1', '1.2.2', -1), + ('1.2', '1.1', 1), + ('1.2.1', '1.2.2', -1), + ('1.2.2', '1.2', 1), + ('1.2', '1.2.2', -1), + ('0.4.0', '0.4', 0), + ('1.13++', '5.5.kw', ValueError), + ) + + for v1, v2, wanted in versions: + try: + res = StrictVersion(v1)._cmp(StrictVersion(v2)) + except ValueError: + if wanted is ValueError: + continue + else: + raise AssertionError(f"cmp({v1}, {v2}) shouldn't raise ValueError") + assert res == wanted, f'cmp({v1}, {v2}) should be {wanted}, got {res}' + res = StrictVersion(v1)._cmp(v2) + assert res == wanted, f'cmp({v1}, {v2}) should be {wanted}, got {res}' + res = StrictVersion(v1)._cmp(object()) + assert res is NotImplemented, ( + f'cmp({v1}, {v2}) should be NotImplemented, got {res}' + ) + + def test_cmp(self): + versions = ( + ('1.5.1', '1.5.2b2', -1), + ('161', '3.10a', 1), + ('8.02', '8.02', 0), + ('3.4j', '1996.07.12', -1), + ('3.2.pl0', '3.1.1.6', 1), + ('2g6', '11g', -1), + ('0.960923', '2.2beta29', -1), + ('1.13++', '5.5.kw', -1), + ) + + for v1, v2, wanted in versions: + res = LooseVersion(v1)._cmp(LooseVersion(v2)) + assert res == wanted, f'cmp({v1}, {v2}) should be {wanted}, got {res}' + res = LooseVersion(v1)._cmp(v2) + assert res == wanted, f'cmp({v1}, {v2}) should be {wanted}, got {res}' + res = LooseVersion(v1)._cmp(object()) + assert res is NotImplemented, ( + f'cmp({v1}, {v2}) should be NotImplemented, got {res}' + ) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_versionpredicate.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/test_versionpredicate.py new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/unix_compat.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/unix_compat.py new file mode 100644 index 000000000..a5d9ee45c --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/tests/unix_compat.py @@ -0,0 +1,17 @@ +import sys + +try: + import grp + import pwd +except ImportError: + grp = pwd = None + +import pytest + +UNIX_ID_SUPPORT = grp and pwd +UID_0_SUPPORT = UNIX_ID_SUPPORT and sys.platform != "cygwin" + +require_unix_id = pytest.mark.skipif( + not UNIX_ID_SUPPORT, reason="Requires grp and pwd support" +) +require_uid_0 = pytest.mark.skipif(not UID_0_SUPPORT, reason="Requires UID 0 support") diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/text_file.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/text_file.py new file mode 100644 index 000000000..89d9048d5 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/text_file.py @@ -0,0 +1,286 @@ +"""text_file + +provides the TextFile class, which gives an interface to text files +that (optionally) takes care of stripping comments, ignoring blank +lines, and joining lines with backslashes.""" + +import sys + + +class TextFile: + """Provides a file-like object that takes care of all the things you + commonly want to do when processing a text file that has some + line-by-line syntax: strip comments (as long as "#" is your + comment character), skip blank lines, join adjacent lines by + escaping the newline (ie. backslash at end of line), strip + leading and/or trailing whitespace. All of these are optional + and independently controllable. + + Provides a 'warn()' method so you can generate warning messages that + report physical line number, even if the logical line in question + spans multiple physical lines. Also provides 'unreadline()' for + implementing line-at-a-time lookahead. + + Constructor is called as: + + TextFile (filename=None, file=None, **options) + + It bombs (RuntimeError) if both 'filename' and 'file' are None; + 'filename' should be a string, and 'file' a file object (or + something that provides 'readline()' and 'close()' methods). It is + recommended that you supply at least 'filename', so that TextFile + can include it in warning messages. If 'file' is not supplied, + TextFile creates its own using 'io.open()'. + + The options are all boolean, and affect the value returned by + 'readline()': + strip_comments [default: true] + strip from "#" to end-of-line, as well as any whitespace + leading up to the "#" -- unless it is escaped by a backslash + lstrip_ws [default: false] + strip leading whitespace from each line before returning it + rstrip_ws [default: true] + strip trailing whitespace (including line terminator!) from + each line before returning it + skip_blanks [default: true} + skip lines that are empty *after* stripping comments and + whitespace. (If both lstrip_ws and rstrip_ws are false, + then some lines may consist of solely whitespace: these will + *not* be skipped, even if 'skip_blanks' is true.) + join_lines [default: false] + if a backslash is the last non-newline character on a line + after stripping comments and whitespace, join the following line + to it to form one "logical line"; if N consecutive lines end + with a backslash, then N+1 physical lines will be joined to + form one logical line. + collapse_join [default: false] + strip leading whitespace from lines that are joined to their + predecessor; only matters if (join_lines and not lstrip_ws) + errors [default: 'strict'] + error handler used to decode the file content + + Note that since 'rstrip_ws' can strip the trailing newline, the + semantics of 'readline()' must differ from those of the builtin file + object's 'readline()' method! In particular, 'readline()' returns + None for end-of-file: an empty string might just be a blank line (or + an all-whitespace line), if 'rstrip_ws' is true but 'skip_blanks' is + not.""" + + default_options = { + 'strip_comments': 1, + 'skip_blanks': 1, + 'lstrip_ws': 0, + 'rstrip_ws': 1, + 'join_lines': 0, + 'collapse_join': 0, + 'errors': 'strict', + } + + def __init__(self, filename=None, file=None, **options): + """Construct a new TextFile object. At least one of 'filename' + (a string) and 'file' (a file-like object) must be supplied. + They keyword argument options are described above and affect + the values returned by 'readline()'.""" + if filename is None and file is None: + raise RuntimeError( + "you must supply either or both of 'filename' and 'file'" + ) + + # set values for all options -- either from client option hash + # or fallback to default_options + for opt in self.default_options.keys(): + if opt in options: + setattr(self, opt, options[opt]) + else: + setattr(self, opt, self.default_options[opt]) + + # sanity check client option hash + for opt in options.keys(): + if opt not in self.default_options: + raise KeyError(f"invalid TextFile option '{opt}'") + + if file is None: + self.open(filename) + else: + self.filename = filename + self.file = file + self.current_line = 0 # assuming that file is at BOF! + + # 'linebuf' is a stack of lines that will be emptied before we + # actually read from the file; it's only populated by an + # 'unreadline()' operation + self.linebuf = [] + + def open(self, filename): + """Open a new file named 'filename'. This overrides both the + 'filename' and 'file' arguments to the constructor.""" + self.filename = filename + self.file = open(self.filename, errors=self.errors, encoding='utf-8') + self.current_line = 0 + + def close(self): + """Close the current file and forget everything we know about it + (filename, current line number).""" + file = self.file + self.file = None + self.filename = None + self.current_line = None + file.close() + + def gen_error(self, msg, line=None): + outmsg = [] + if line is None: + line = self.current_line + outmsg.append(self.filename + ", ") + if isinstance(line, (list, tuple)): + outmsg.append("lines {}-{}: ".format(*line)) + else: + outmsg.append(f"line {int(line)}: ") + outmsg.append(str(msg)) + return "".join(outmsg) + + def error(self, msg, line=None): + raise ValueError("error: " + self.gen_error(msg, line)) + + def warn(self, msg, line=None): + """Print (to stderr) a warning message tied to the current logical + line in the current file. If the current logical line in the + file spans multiple physical lines, the warning refers to the + whole range, eg. "lines 3-5". If 'line' supplied, it overrides + the current line number; it may be a list or tuple to indicate a + range of physical lines, or an integer for a single physical + line.""" + sys.stderr.write("warning: " + self.gen_error(msg, line) + "\n") + + def readline(self): # noqa: C901 + """Read and return a single logical line from the current file (or + from an internal buffer if lines have previously been "unread" + with 'unreadline()'). If the 'join_lines' option is true, this + may involve reading multiple physical lines concatenated into a + single string. Updates the current line number, so calling + 'warn()' after 'readline()' emits a warning about the physical + line(s) just read. Returns None on end-of-file, since the empty + string can occur if 'rstrip_ws' is true but 'strip_blanks' is + not.""" + # If any "unread" lines waiting in 'linebuf', return the top + # one. (We don't actually buffer read-ahead data -- lines only + # get put in 'linebuf' if the client explicitly does an + # 'unreadline()'. + if self.linebuf: + line = self.linebuf[-1] + del self.linebuf[-1] + return line + + buildup_line = '' + + while True: + # read the line, make it None if EOF + line = self.file.readline() + if line == '': + line = None + + if self.strip_comments and line: + # Look for the first "#" in the line. If none, never + # mind. If we find one and it's the first character, or + # is not preceded by "\", then it starts a comment -- + # strip the comment, strip whitespace before it, and + # carry on. Otherwise, it's just an escaped "#", so + # unescape it (and any other escaped "#"'s that might be + # lurking in there) and otherwise leave the line alone. + + pos = line.find("#") + if pos == -1: # no "#" -- no comments + pass + + # It's definitely a comment -- either "#" is the first + # character, or it's elsewhere and unescaped. + elif pos == 0 or line[pos - 1] != "\\": + # Have to preserve the trailing newline, because it's + # the job of a later step (rstrip_ws) to remove it -- + # and if rstrip_ws is false, we'd better preserve it! + # (NB. this means that if the final line is all comment + # and has no trailing newline, we will think that it's + # EOF; I think that's OK.) + eol = (line[-1] == '\n') and '\n' or '' + line = line[0:pos] + eol + + # If all that's left is whitespace, then skip line + # *now*, before we try to join it to 'buildup_line' -- + # that way constructs like + # hello \\ + # # comment that should be ignored + # there + # result in "hello there". + if line.strip() == "": + continue + else: # it's an escaped "#" + line = line.replace("\\#", "#") + + # did previous line end with a backslash? then accumulate + if self.join_lines and buildup_line: + # oops: end of file + if line is None: + self.warn("continuation line immediately precedes end-of-file") + return buildup_line + + if self.collapse_join: + line = line.lstrip() + line = buildup_line + line + + # careful: pay attention to line number when incrementing it + if isinstance(self.current_line, list): + self.current_line[1] = self.current_line[1] + 1 + else: + self.current_line = [self.current_line, self.current_line + 1] + # just an ordinary line, read it as usual + else: + if line is None: # eof + return None + + # still have to be careful about incrementing the line number! + if isinstance(self.current_line, list): + self.current_line = self.current_line[1] + 1 + else: + self.current_line = self.current_line + 1 + + # strip whitespace however the client wants (leading and + # trailing, or one or the other, or neither) + if self.lstrip_ws and self.rstrip_ws: + line = line.strip() + elif self.lstrip_ws: + line = line.lstrip() + elif self.rstrip_ws: + line = line.rstrip() + + # blank line (whether we rstrip'ed or not)? skip to next line + # if appropriate + if line in ('', '\n') and self.skip_blanks: + continue + + if self.join_lines: + if line[-1] == '\\': + buildup_line = line[:-1] + continue + + if line[-2:] == '\\\n': + buildup_line = line[0:-2] + '\n' + continue + + # well, I guess there's some actual content there: return it + return line + + def readlines(self): + """Read and return the list of all logical lines remaining in the + current file.""" + lines = [] + while True: + line = self.readline() + if line is None: + return lines + lines.append(line) + + def unreadline(self, line): + """Push 'line' (a string) onto an internal buffer that will be + checked by future 'readline()' calls. Handy for implementing + a parser with line-at-a-time lookahead.""" + self.linebuf.append(line) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/unixccompiler.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/unixccompiler.py new file mode 100644 index 000000000..20b8ce6b9 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/unixccompiler.py @@ -0,0 +1,9 @@ +import importlib + +from .compilers.C import unix + +UnixCCompiler = unix.Compiler + +# ensure import of unixccompiler implies ccompiler imported +# (pypa/setuptools#4871) +importlib.import_module('distutils.ccompiler') diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/util.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/util.py new file mode 100644 index 000000000..6dbe049f4 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/util.py @@ -0,0 +1,518 @@ +"""distutils.util + +Miscellaneous utility functions -- anything that doesn't fit into +one of the other *util.py modules. +""" + +from __future__ import annotations + +import functools +import importlib.util +import os +import pathlib +import re +import string +import subprocess +import sys +import sysconfig +import tempfile +from collections.abc import Callable, Iterable, Mapping +from typing import TYPE_CHECKING, AnyStr + +from jaraco.functools import pass_none + +from ._log import log +from ._modified import newer +from .errors import DistutilsByteCompileError, DistutilsPlatformError +from .spawn import spawn + +if TYPE_CHECKING: + from typing_extensions import TypeVarTuple, Unpack + + _Ts = TypeVarTuple("_Ts") + + +def get_host_platform() -> str: + """ + Return a string that identifies the current platform. Use this + function to distinguish platform-specific build directories and + platform-specific built distributions. + """ + + # This function initially exposed platforms as defined in Python 3.9 + # even with older Python versions when distutils was split out. + # Now it delegates to stdlib sysconfig. + + return sysconfig.get_platform() + + +def get_platform() -> str: + if os.name == 'nt': + TARGET_TO_PLAT = { + 'x86': 'win32', + 'x64': 'win-amd64', + 'arm': 'win-arm32', + 'arm64': 'win-arm64', + } + target = os.environ.get('VSCMD_ARG_TGT_ARCH') + return TARGET_TO_PLAT.get(target) or get_host_platform() + return get_host_platform() + + +if sys.platform == 'darwin': + _syscfg_macosx_ver = None # cache the version pulled from sysconfig +MACOSX_VERSION_VAR = 'MACOSX_DEPLOYMENT_TARGET' + + +def _clear_cached_macosx_ver(): + """For testing only. Do not call.""" + global _syscfg_macosx_ver + _syscfg_macosx_ver = None + + +def get_macosx_target_ver_from_syscfg(): + """Get the version of macOS latched in the Python interpreter configuration. + Returns the version as a string or None if can't obtain one. Cached.""" + global _syscfg_macosx_ver + if _syscfg_macosx_ver is None: + from distutils import sysconfig + + ver = sysconfig.get_config_var(MACOSX_VERSION_VAR) or '' + if ver: + _syscfg_macosx_ver = ver + return _syscfg_macosx_ver + + +def get_macosx_target_ver(): + """Return the version of macOS for which we are building. + + The target version defaults to the version in sysconfig latched at time + the Python interpreter was built, unless overridden by an environment + variable. If neither source has a value, then None is returned""" + + syscfg_ver = get_macosx_target_ver_from_syscfg() + env_ver = os.environ.get(MACOSX_VERSION_VAR) + + if env_ver: + # Validate overridden version against sysconfig version, if have both. + # Ensure that the deployment target of the build process is not less + # than 10.3 if the interpreter was built for 10.3 or later. This + # ensures extension modules are built with correct compatibility + # values, specifically LDSHARED which can use + # '-undefined dynamic_lookup' which only works on >= 10.3. + if ( + syscfg_ver + and split_version(syscfg_ver) >= [10, 3] + and split_version(env_ver) < [10, 3] + ): + my_msg = ( + '$' + MACOSX_VERSION_VAR + ' mismatch: ' + f'now "{env_ver}" but "{syscfg_ver}" during configure; ' + 'must use 10.3 or later' + ) + raise DistutilsPlatformError(my_msg) + return env_ver + return syscfg_ver + + +def split_version(s: str) -> list[int]: + """Convert a dot-separated string into a list of numbers for comparisons""" + return [int(n) for n in s.split('.')] + + +@pass_none +def convert_path(pathname: str | os.PathLike[str]) -> str: + r""" + Allow for pathlib.Path inputs, coax to a native path string. + + If None is passed, will just pass it through as + Setuptools relies on this behavior. + + >>> convert_path(None) is None + True + + Removes empty paths. + + >>> convert_path('foo/./bar').replace('\\', '/') + 'foo/bar' + """ + return os.fspath(pathlib.PurePath(pathname)) + + +def change_root( + new_root: AnyStr | os.PathLike[AnyStr], pathname: AnyStr | os.PathLike[AnyStr] +) -> AnyStr: + """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. + """ + 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] == os.sep: + path = path[1:] + return os.path.join(new_root, path) + + raise DistutilsPlatformError(f"nothing known about platform '{os.name}'") + + +@functools.lru_cache +def check_environ() -> None: + """Ensure that 'os.environ' has all the environment variables we + guarantee that users can use in config files, command-line options, + etc. Currently this includes: + HOME - user's home directory (Unix only) + PLAT - description of the current platform, including hardware + and OS (see 'get_platform()') + """ + if os.name == 'posix' and 'HOME' not in os.environ: + try: + import pwd + + os.environ['HOME'] = pwd.getpwuid(os.getuid())[5] + except (ImportError, KeyError): + # bpo-10496: if the current user identifier doesn't exist in the + # password database, do nothing + pass + + if 'PLAT' not in os.environ: + os.environ['PLAT'] = get_platform() + + +def subst_vars(s, local_vars: Mapping[str, object]) -> str: + """ + Perform variable substitution on 'string'. + Variables are indicated by format-style braces ("{var}"). + Variable is substituted by the value found in the 'local_vars' + dictionary or in 'os.environ' if it's not in 'local_vars'. + 'os.environ' is first checked/augmented to guarantee that it contains + certain values: see 'check_environ()'. Raise ValueError for any + variables not found in either 'local_vars' or 'os.environ'. + """ + check_environ() + lookup = dict(os.environ) + lookup.update((name, str(value)) for name, value in local_vars.items()) + try: + return _subst_compat(s).format_map(lookup) + except KeyError as var: + raise ValueError(f"invalid variable {var}") + + +def _subst_compat(s): + """ + Replace shell/Perl-style variable substitution with + format-style. For compatibility. + """ + + def _subst(match): + return f'{{{match.group(1)}}}' + + repl = re.sub(r'\$([a-zA-Z_][a-zA-Z_0-9]*)', _subst, s) + if repl != s: + import warnings + + warnings.warn( + "shell/Perl-style substitutions are deprecated", + DeprecationWarning, + ) + return repl + + +def grok_environment_error(exc: object, prefix: str = "error: ") -> str: + # Function kept for backward compatibility. + # Used to try clever things with EnvironmentErrors, + # but nowadays str(exception) produces good messages. + return prefix + str(exc) + + +# Needed by 'split_quoted()' +_wordchars_re = _squote_re = _dquote_re = None + + +def _init_regex(): + global _wordchars_re, _squote_re, _dquote_re + _wordchars_re = re.compile(rf'[^\\\'\"{string.whitespace} ]*') + _squote_re = re.compile(r"'(?:[^'\\]|\\.)*'") + _dquote_re = re.compile(r'"(?:[^"\\]|\\.)*"') + + +def split_quoted(s: str) -> list[str]: + """Split a string up according to Unix shell-like rules for quotes and + backslashes. In short: words are delimited by spaces, as long as those + spaces are not escaped by a backslash, or inside a quoted string. + Single and double quotes are equivalent, and the quote characters can + be backslash-escaped. The backslash is stripped from any two-character + escape sequence, leaving only the escaped character. The quote + characters are stripped from any quoted string. Returns a list of + words. + """ + + # This is a nice algorithm for splitting up a single string, since it + # doesn't require character-by-character examination. It was a little + # bit of a brain-bender to get it working right, though... + if _wordchars_re is None: + _init_regex() + + s = s.strip() + words = [] + pos = 0 + + while s: + m = _wordchars_re.match(s, pos) + end = m.end() + if end == len(s): + words.append(s[:end]) + break + + if s[end] in string.whitespace: + # unescaped, unquoted whitespace: now + # we definitely have a word delimiter + words.append(s[:end]) + s = s[end:].lstrip() + pos = 0 + + elif s[end] == '\\': + # preserve whatever is being escaped; + # will become part of the current word + s = s[:end] + s[end + 1 :] + pos = end + 1 + + else: + if s[end] == "'": # slurp singly-quoted string + m = _squote_re.match(s, end) + elif s[end] == '"': # slurp doubly-quoted string + m = _dquote_re.match(s, end) + else: + raise RuntimeError(f"this can't happen (bad char '{s[end]}')") + + if m is None: + raise ValueError(f"bad string (mismatched {s[end]} quotes?)") + + (beg, end) = m.span() + s = s[:beg] + s[beg + 1 : end - 1] + s[end:] + pos = m.end() - 2 + + if pos >= len(s): + words.append(s) + break + + return words + + +# split_quoted () + + +def execute( + func: Callable[[Unpack[_Ts]], object], + args: tuple[Unpack[_Ts]], + msg: object = None, + verbose: bool = False, + dry_run: bool = False, +) -> None: + """ + Perform some action that affects the outside world (e.g. by + writing to the filesystem). Such actions are special because they + are disabled by the 'dry_run' flag. This method handles that + complication; simply supply the + function to call and an argument tuple for it (to embody the + "external action" being performed) and an optional message to + emit. + """ + if msg is None: + msg = f"{func.__name__}{args!r}" + if msg[-2:] == ',)': # correct for singleton tuple + msg = msg[0:-2] + ')' + + log.info(msg) + if not dry_run: + func(*args) + + +def strtobool(val: str) -> bool: + """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 True + elif val in ('n', 'no', 'f', 'false', 'off', '0'): + return False + else: + raise ValueError(f"invalid truth value {val!r}") + + +def byte_compile( # noqa: C901 + py_files: Iterable[str], + optimize: int = 0, + force: bool = False, + prefix: str | None = None, + base_dir: str | None = None, + verbose: bool = True, + dry_run: bool = False, + direct: bool | None = None, +) -> None: + """Byte-compile a collection of Python source files to .pyc + files in a __pycache__ subdirectory. 'py_files' is a list + of files to compile; any files that don't end in ".py" are silently + skipped. 'optimize' must be one of the following: + 0 - don't optimize + 1 - normal optimization (like "python -O") + 2 - extra optimization (like "python -OO") + If 'force' is true, all files are recompiled regardless of + timestamps. + + The source filename encoded in each bytecode file defaults to the + filenames listed in 'py_files'; you can modify these with 'prefix' and + 'basedir'. 'prefix' is a string that will be stripped off of each + source filename, and 'base_dir' is a directory name that will be + prepended (after 'prefix' is stripped). You can supply either or both + (or neither) of 'prefix' and 'base_dir', as you wish. + + If 'dry_run' is true, doesn't actually do anything that would + affect the filesystem. + + Byte-compilation is either done directly in this interpreter process + with the standard py_compile module, or indirectly by writing a + temporary script and executing it. Normally, you should let + 'byte_compile()' figure out to use direct compilation or not (see + the source for details). The 'direct' flag is used by the script + generated in indirect mode; unless you know what you're doing, leave + it set to None. + """ + + # nothing is done if sys.dont_write_bytecode is True + if sys.dont_write_bytecode: + raise DistutilsByteCompileError('byte-compiling is disabled.') + + # First, if the caller didn't force us into direct or indirect mode, + # figure out which mode we should be in. We take a conservative + # approach: choose direct mode *only* if the current interpreter is + # in debug mode and optimize is 0. If we're not in debug mode (-O + # or -OO), we don't know which level of optimization this + # interpreter is running with, so we can't do direct + # byte-compilation and be certain that it's the right thing. Thus, + # always compile indirectly if the current interpreter is in either + # optimize mode, or if either optimization level was requested by + # the caller. + if direct is None: + direct = __debug__ and optimize == 0 + + # "Indirect" byte-compilation: write a temporary script and then + # run it with the appropriate flags. + if not direct: + (script_fd, script_name) = tempfile.mkstemp(".py") + log.info("writing byte-compilation script '%s'", script_name) + if not dry_run: + script = os.fdopen(script_fd, "w", encoding='utf-8') + + with script: + script.write( + """\ +from distutils.util import byte_compile +files = [ +""" + ) + + # XXX would be nice to write absolute filenames, just for + # safety's sake (script should be more robust in the face of + # chdir'ing before running it). But this requires abspath'ing + # 'prefix' as well, and that breaks the hack in build_lib's + # 'byte_compile()' method that carefully tacks on a trailing + # slash (os.sep really) to make sure the prefix here is "just + # right". This whole prefix business is rather delicate -- the + # problem is that it's really a directory, but I'm treating it + # as a dumb string, so trailing slashes and so forth matter. + + script.write(",\n".join(map(repr, py_files)) + "]\n") + script.write( + f""" +byte_compile(files, optimize={optimize!r}, force={force!r}, + prefix={prefix!r}, base_dir={base_dir!r}, + verbose={verbose!r}, dry_run=False, + direct=True) +""" + ) + + cmd = [sys.executable] + cmd.extend(subprocess._optim_args_from_interpreter_flags()) + cmd.append(script_name) + spawn(cmd, dry_run=dry_run) + execute(os.remove, (script_name,), f"removing {script_name}", dry_run=dry_run) + + # "Direct" byte-compilation: use the py_compile module to compile + # right here, right now. Note that the script generated in indirect + # mode simply calls 'byte_compile()' in direct mode, a weird sort of + # cross-process recursion. Hey, it works! + else: + from py_compile import compile + + for file in py_files: + if file[-3:] != ".py": + # This lets us be lazy and not filter filenames in + # the "install_lib" command. + continue + + # Terminology from the py_compile module: + # cfile - byte-compiled file + # dfile - purported source filename (same as 'file' by default) + if optimize >= 0: + opt = '' if optimize == 0 else optimize + cfile = importlib.util.cache_from_source(file, optimization=opt) + else: + cfile = importlib.util.cache_from_source(file) + dfile = file + if prefix: + if file[: len(prefix)] != prefix: + raise ValueError( + f"invalid prefix: filename {file!r} doesn't start with {prefix!r}" + ) + dfile = dfile[len(prefix) :] + if base_dir: + dfile = os.path.join(base_dir, dfile) + + cfile_base = os.path.basename(cfile) + if direct: + if force or newer(file, cfile): + log.info("byte-compiling %s to %s", file, cfile_base) + if not dry_run: + compile(file, cfile, dfile) + else: + log.debug("skipping byte-compilation of %s to %s", file, cfile_base) + + +def rfc822_escape(header: str) -> str: + """Return a version of the string escaped for inclusion in an + RFC-822 header, by ensuring there are 8 spaces space after each newline. + """ + indent = 8 * " " + lines = header.splitlines(keepends=True) + + # Emulate the behaviour of `str.split` + # (the terminal line break in `splitlines` does not result in an extra line): + ends_in_newline = lines and lines[-1].splitlines()[0] != lines[-1] + suffix = indent if ends_in_newline else "" + + return indent.join(lines) + suffix + + +def is_mingw() -> bool: + """Returns True if the current platform is mingw. + + Python compiled with Mingw-w64 has sys.platform == 'win32' and + get_platform() starts with 'mingw'. + """ + return sys.platform == 'win32' and get_platform().startswith('mingw') + + +def is_freethreaded(): + """Return True if the Python interpreter is built with free threading support.""" + return bool(sysconfig.get_config_var('Py_GIL_DISABLED')) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/version.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/version.py new file mode 100644 index 000000000..2223ee9c8 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/version.py @@ -0,0 +1,348 @@ +# +# distutils/version.py +# +# Implements multiple version numbering conventions for the +# Python Module Distribution Utilities. +# +# $Id$ +# + +"""Provides classes to represent module version numbers (one class for +each style of version numbering). There are currently two such classes +implemented: StrictVersion and LooseVersion. + +Every version number class implements the following interface: + * the 'parse' method takes a string and parses it to some internal + representation; if the string is an invalid version number, + 'parse' raises a ValueError exception + * the class constructor takes an optional string argument which, + if supplied, is passed to 'parse' + * __str__ reconstructs the string that was passed to 'parse' (or + an equivalent string -- ie. one that will generate an equivalent + version number instance) + * __repr__ generates Python code to recreate the version number instance + * _cmp compares the current instance with either another instance + of the same class or a string (which will be parsed to an instance + of the same class, thus must follow the same rules) +""" + +import contextlib +import re +import warnings + + +@contextlib.contextmanager +def suppress_known_deprecation(): + with warnings.catch_warnings(record=True) as ctx: + warnings.filterwarnings( + action='default', + category=DeprecationWarning, + message="distutils Version classes are deprecated.", + ) + yield ctx + + +class Version: + """Abstract base class for version numbering classes. Just provides + constructor (__init__) and reproducer (__repr__), because those + seem to be the same for all version numbering classes; and route + rich comparisons to _cmp. + """ + + def __init__(self, vstring=None): + if vstring: + self.parse(vstring) + warnings.warn( + "distutils Version classes are deprecated. Use packaging.version instead.", + DeprecationWarning, + stacklevel=2, + ) + + def __repr__(self): + return f"{self.__class__.__name__} ('{self}')" + + def __eq__(self, other): + c = self._cmp(other) + if c is NotImplemented: + return c + return c == 0 + + def __lt__(self, other): + c = self._cmp(other) + if c is NotImplemented: + return c + return c < 0 + + def __le__(self, other): + c = self._cmp(other) + if c is NotImplemented: + return c + return c <= 0 + + def __gt__(self, other): + c = self._cmp(other) + if c is NotImplemented: + return c + return c > 0 + + def __ge__(self, other): + c = self._cmp(other) + if c is NotImplemented: + return c + return c >= 0 + + +# Interface for version-number classes -- must be implemented +# by the following classes (the concrete ones -- Version should +# be treated as an abstract class). +# __init__ (string) - create and take same action as 'parse' +# (string parameter is optional) +# parse (string) - convert a string representation to whatever +# internal representation is appropriate for +# this style of version numbering +# __str__ (self) - convert back to a string; should be very similar +# (if not identical to) the string supplied to parse +# __repr__ (self) - generate Python code to recreate +# the instance +# _cmp (self, other) - compare two version numbers ('other' may +# be an unparsed version string, or another +# instance of your version class) + + +class StrictVersion(Version): + """Version numbering for anal retentives and software idealists. + Implements the standard interface for version number classes as + described above. A version number consists of two or three + dot-separated numeric components, with an optional "pre-release" tag + on the end. The pre-release tag consists of the letter 'a' or 'b' + followed by a number. If the numeric components of two version + numbers are equal, then one with a pre-release tag will always + be deemed earlier (lesser) than one without. + + The following are valid version numbers (shown in the order that + would be obtained by sorting according to the supplied cmp function): + + 0.4 0.4.0 (these two are equivalent) + 0.4.1 + 0.5a1 + 0.5b3 + 0.5 + 0.9.6 + 1.0 + 1.0.4a3 + 1.0.4b1 + 1.0.4 + + The following are examples of invalid version numbers: + + 1 + 2.7.2.2 + 1.3.a4 + 1.3pl1 + 1.3c4 + + The rationale for this version numbering system will be explained + in the distutils documentation. + """ + + version_re = re.compile( + r'^(\d+) \. (\d+) (\. (\d+))? ([ab](\d+))?$', re.VERBOSE | re.ASCII + ) + + def parse(self, vstring): + match = self.version_re.match(vstring) + if not match: + raise ValueError(f"invalid version number '{vstring}'") + + (major, minor, patch, prerelease, prerelease_num) = match.group(1, 2, 4, 5, 6) + + if patch: + self.version = tuple(map(int, [major, minor, patch])) + else: + self.version = tuple(map(int, [major, minor])) + (0,) + + if prerelease: + self.prerelease = (prerelease[0], int(prerelease_num)) + else: + self.prerelease = None + + def __str__(self): + if self.version[2] == 0: + vstring = '.'.join(map(str, self.version[0:2])) + else: + vstring = '.'.join(map(str, self.version)) + + if self.prerelease: + vstring = vstring + self.prerelease[0] + str(self.prerelease[1]) + + return vstring + + def _cmp(self, other): + if isinstance(other, str): + with suppress_known_deprecation(): + other = StrictVersion(other) + elif not isinstance(other, StrictVersion): + return NotImplemented + + if self.version == other.version: + # versions match; pre-release drives the comparison + return self._cmp_prerelease(other) + + return -1 if self.version < other.version else 1 + + def _cmp_prerelease(self, other): + """ + case 1: self has prerelease, other doesn't; other is greater + case 2: self doesn't have prerelease, other does: self is greater + case 3: both or neither have prerelease: compare them! + """ + if self.prerelease and not other.prerelease: + return -1 + elif not self.prerelease and other.prerelease: + return 1 + + if self.prerelease == other.prerelease: + return 0 + elif self.prerelease < other.prerelease: + return -1 + else: + return 1 + + +# end class StrictVersion + + +# The rules according to Greg Stein: +# 1) a version number has 1 or more numbers separated by a period or by +# sequences of letters. If only periods, then these are compared +# left-to-right to determine an ordering. +# 2) sequences of letters are part of the tuple for comparison and are +# compared lexicographically +# 3) recognize the numeric components may have leading zeroes +# +# The LooseVersion class below implements these rules: a version number +# string is split up into a tuple of integer and string components, and +# comparison is a simple tuple comparison. This means that version +# numbers behave in a predictable and obvious way, but a way that might +# not necessarily be how people *want* version numbers to behave. There +# wouldn't be a problem if people could stick to purely numeric version +# numbers: just split on period and compare the numbers as tuples. +# However, people insist on putting letters into their version numbers; +# the most common purpose seems to be: +# - indicating a "pre-release" version +# ('alpha', 'beta', 'a', 'b', 'pre', 'p') +# - indicating a post-release patch ('p', 'pl', 'patch') +# but of course this can't cover all version number schemes, and there's +# no way to know what a programmer means without asking him. +# +# The problem is what to do with letters (and other non-numeric +# characters) in a version number. The current implementation does the +# obvious and predictable thing: keep them as strings and compare +# lexically within a tuple comparison. This has the desired effect if +# an appended letter sequence implies something "post-release": +# eg. "0.99" < "0.99pl14" < "1.0", and "5.001" < "5.001m" < "5.002". +# +# However, if letters in a version number imply a pre-release version, +# the "obvious" thing isn't correct. Eg. you would expect that +# "1.5.1" < "1.5.2a2" < "1.5.2", but under the tuple/lexical comparison +# implemented here, this just isn't so. +# +# Two possible solutions come to mind. The first is to tie the +# comparison algorithm to a particular set of semantic rules, as has +# been done in the StrictVersion class above. This works great as long +# as everyone can go along with bondage and discipline. Hopefully a +# (large) subset of Python module programmers will agree that the +# particular flavour of bondage and discipline provided by StrictVersion +# provides enough benefit to be worth using, and will submit their +# version numbering scheme to its domination. The free-thinking +# anarchists in the lot will never give in, though, and something needs +# to be done to accommodate them. +# +# Perhaps a "moderately strict" version class could be implemented that +# lets almost anything slide (syntactically), and makes some heuristic +# assumptions about non-digits in version number strings. This could +# sink into special-case-hell, though; if I was as talented and +# idiosyncratic as Larry Wall, I'd go ahead and implement a class that +# somehow knows that "1.2.1" < "1.2.2a2" < "1.2.2" < "1.2.2pl3", and is +# just as happy dealing with things like "2g6" and "1.13++". I don't +# think I'm smart enough to do it right though. +# +# In any case, I've coded the test suite for this module (see +# ../test/test_version.py) specifically to fail on things like comparing +# "1.2a2" and "1.2". That's not because the *code* is doing anything +# wrong, it's because the simple, obvious design doesn't match my +# complicated, hairy expectations for real-world version numbers. It +# would be a snap to fix the test suite to say, "Yep, LooseVersion does +# the Right Thing" (ie. the code matches the conception). But I'd rather +# have a conception that matches common notions about version numbers. + + +class LooseVersion(Version): + """Version numbering for anarchists and software realists. + Implements the standard interface for version number classes as + described above. A version number consists of a series of numbers, + separated by either periods or strings of letters. When comparing + version numbers, the numeric components will be compared + numerically, and the alphabetic components lexically. The following + are all valid version numbers, in no particular order: + + 1.5.1 + 1.5.2b2 + 161 + 3.10a + 8.02 + 3.4j + 1996.07.12 + 3.2.pl0 + 3.1.1.6 + 2g6 + 11g + 0.960923 + 2.2beta29 + 1.13++ + 5.5.kw + 2.0b1pl0 + + In fact, there is no such thing as an invalid version number under + this scheme; the rules for comparison are simple and predictable, + but may not always give the results you want (for some definition + of "want"). + """ + + component_re = re.compile(r'(\d+ | [a-z]+ | \.)', re.VERBOSE) + + def parse(self, vstring): + # I've given up on thinking I can reconstruct the version string + # from the parsed tuple -- so I just store the string here for + # use by __str__ + self.vstring = vstring + components = [x for x in self.component_re.split(vstring) if x and x != '.'] + for i, obj in enumerate(components): + try: + components[i] = int(obj) + except ValueError: + pass + + self.version = components + + def __str__(self): + return self.vstring + + def __repr__(self): + return f"LooseVersion ('{self}')" + + def _cmp(self, other): + if isinstance(other, str): + other = LooseVersion(other) + elif not isinstance(other, LooseVersion): + return NotImplemented + + if self.version == other.version: + return 0 + if self.version < other.version: + return -1 + if self.version > other.version: + return 1 + + +# end class LooseVersion diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/versionpredicate.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/versionpredicate.py new file mode 100644 index 000000000..fe31b0ed8 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/versionpredicate.py @@ -0,0 +1,175 @@ +"""Module for parsing and testing package version predicate strings.""" + +import operator +import re + +from . import version + +re_validPackage = re.compile(r"(?i)^\s*([a-z_]\w*(?:\.[a-z_]\w*)*)(.*)", re.ASCII) +# (package) (rest) + +re_paren = re.compile(r"^\s*\((.*)\)\s*$") # (list) inside of parentheses +re_splitComparison = re.compile(r"^\s*(<=|>=|<|>|!=|==)\s*([^\s,]+)\s*$") +# (comp) (version) + + +def splitUp(pred): + """Parse a single version comparison. + + Return (comparison string, StrictVersion) + """ + res = re_splitComparison.match(pred) + if not res: + raise ValueError(f"bad package restriction syntax: {pred!r}") + comp, verStr = res.groups() + with version.suppress_known_deprecation(): + other = version.StrictVersion(verStr) + return (comp, other) + + +compmap = { + "<": operator.lt, + "<=": operator.le, + "==": operator.eq, + ">": operator.gt, + ">=": operator.ge, + "!=": operator.ne, +} + + +class VersionPredicate: + """Parse and test package version predicates. + + >>> v = VersionPredicate('pyepat.abc (>1.0, <3333.3a1, !=1555.1b3)') + + The `name` attribute provides the full dotted name that is given:: + + >>> v.name + 'pyepat.abc' + + The str() of a `VersionPredicate` provides a normalized + human-readable version of the expression:: + + >>> print(v) + pyepat.abc (> 1.0, < 3333.3a1, != 1555.1b3) + + The `satisfied_by()` method can be used to determine with a given + version number is included in the set described by the version + restrictions:: + + >>> v.satisfied_by('1.1') + True + >>> v.satisfied_by('1.4') + True + >>> v.satisfied_by('1.0') + False + >>> v.satisfied_by('4444.4') + False + >>> v.satisfied_by('1555.1b3') + False + + `VersionPredicate` is flexible in accepting extra whitespace:: + + >>> v = VersionPredicate(' pat( == 0.1 ) ') + >>> v.name + 'pat' + >>> v.satisfied_by('0.1') + True + >>> v.satisfied_by('0.2') + False + + If any version numbers passed in do not conform to the + restrictions of `StrictVersion`, a `ValueError` is raised:: + + >>> v = VersionPredicate('p1.p2.p3.p4(>=1.0, <=1.3a1, !=1.2zb3)') + Traceback (most recent call last): + ... + ValueError: invalid version number '1.2zb3' + + It the module or package name given does not conform to what's + allowed as a legal module or package name, `ValueError` is + raised:: + + >>> v = VersionPredicate('foo-bar') + Traceback (most recent call last): + ... + ValueError: expected parenthesized list: '-bar' + + >>> v = VersionPredicate('foo bar (12.21)') + Traceback (most recent call last): + ... + ValueError: expected parenthesized list: 'bar (12.21)' + + """ + + def __init__(self, versionPredicateStr): + """Parse a version predicate string.""" + # Fields: + # name: package name + # pred: list of (comparison string, StrictVersion) + + versionPredicateStr = versionPredicateStr.strip() + if not versionPredicateStr: + raise ValueError("empty package restriction") + match = re_validPackage.match(versionPredicateStr) + if not match: + raise ValueError(f"bad package name in {versionPredicateStr!r}") + self.name, paren = match.groups() + paren = paren.strip() + if paren: + match = re_paren.match(paren) + if not match: + raise ValueError(f"expected parenthesized list: {paren!r}") + str = match.groups()[0] + self.pred = [splitUp(aPred) for aPred in str.split(",")] + if not self.pred: + raise ValueError(f"empty parenthesized list in {versionPredicateStr!r}") + else: + self.pred = [] + + def __str__(self): + if self.pred: + seq = [cond + " " + str(ver) for cond, ver in self.pred] + return self.name + " (" + ", ".join(seq) + ")" + else: + return self.name + + def satisfied_by(self, version): + """True if version is compatible with all the predicates in self. + The parameter version must be acceptable to the StrictVersion + constructor. It may be either a string or StrictVersion. + """ + for cond, ver in self.pred: + if not compmap[cond](version, ver): + return False + return True + + +_provision_rx = None + + +def split_provision(value): + """Return the name and optional version number of a provision. + + The version number, if given, will be returned as a `StrictVersion` + instance, otherwise it will be `None`. + + >>> split_provision('mypkg') + ('mypkg', None) + >>> split_provision(' mypkg( 1.2 ) ') + ('mypkg', StrictVersion ('1.2')) + """ + global _provision_rx + if _provision_rx is None: + _provision_rx = re.compile( + r"([a-zA-Z_]\w*(?:\.[a-zA-Z_]\w*)*)(?:\s*\(\s*([^)\s]+)\s*\))?$", re.ASCII + ) + value = value.strip() + m = _provision_rx.match(value) + if not m: + raise ValueError(f"illegal provides specification: {value!r}") + ver = m.group(2) or None + if ver: + with version.suppress_known_deprecation(): + ver = version.StrictVersion(ver) + return m.group(1), ver diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/zosccompiler.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/zosccompiler.py new file mode 100644 index 000000000..e49630ac6 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/zosccompiler.py @@ -0,0 +1,3 @@ +from .compilers.C import zos + +zOSCCompiler = zos.Compiler diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_entry_points.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_entry_points.py new file mode 100644 index 000000000..cd5dd2c8a --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_entry_points.py @@ -0,0 +1,94 @@ +import functools +import itertools +import operator + +from jaraco.functools import pass_none +from jaraco.text import yield_lines +from more_itertools import consume + +from ._importlib import metadata +from ._itertools import ensure_unique +from .errors import OptionError + + +def ensure_valid(ep): + """ + Exercise one of the dynamic properties to trigger + the pattern match. + + This function is deprecated in favor of importlib_metadata 8.7 and + Python 3.14 importlib.metadata, which validates entry points on + construction. + """ + try: + ep.extras + except (AttributeError, AssertionError) as ex: + # Why both? See https://github.com/python/importlib_metadata/issues/488 + msg = ( + f"Problems to parse {ep}.\nPlease ensure entry-point follows the spec: " + "https://packaging.python.org/en/latest/specifications/entry-points/" + ) + raise OptionError(msg) from ex + + +def load_group(value, group): + """ + Given a value of an entry point or series of entry points, + return each as an EntryPoint. + """ + # normalize to a single sequence of lines + lines = yield_lines(value) + text = f'[{group}]\n' + '\n'.join(lines) + return metadata.EntryPoints._from_text(text) + + +def by_group_and_name(ep): + return ep.group, ep.name + + +def validate(eps: metadata.EntryPoints): + """ + Ensure entry points are unique by group and name and validate each. + """ + consume(map(ensure_valid, ensure_unique(eps, key=by_group_and_name))) + return eps + + +@functools.singledispatch +def load(eps): + """ + Given a Distribution.entry_points, produce EntryPoints. + """ + groups = itertools.chain.from_iterable( + load_group(value, group) for group, value in eps.items() + ) + return validate(metadata.EntryPoints(groups)) + + +@load.register(str) +def _(eps): + r""" + >>> ep, = load('[console_scripts]\nfoo=bar') + >>> ep.group + 'console_scripts' + >>> ep.name + 'foo' + >>> ep.value + 'bar' + """ + return validate(metadata.EntryPoints(metadata.EntryPoints._from_text(eps))) + + +load.register(type(None), lambda x: x) + + +@pass_none +def render(eps: metadata.EntryPoints): + by_group = operator.attrgetter('group') + groups = itertools.groupby(sorted(eps, key=by_group), by_group) + + return '\n'.join(f'[{group}]\n{render_items(items)}\n' for group, items in groups) + + +def render_items(eps): + return '\n'.join(f'{ep.name} = {ep.value}' for ep in sorted(eps)) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_imp.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_imp.py new file mode 100644 index 000000000..f1d9f2921 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_imp.py @@ -0,0 +1,87 @@ +""" +Re-implementation of find_module and get_frozen_object +from the deprecated imp module. +""" + +import importlib.machinery +import importlib.util +import os +import tokenize +from importlib.util import module_from_spec + +PY_SOURCE = 1 +PY_COMPILED = 2 +C_EXTENSION = 3 +C_BUILTIN = 6 +PY_FROZEN = 7 + + +def find_spec(module, paths): + finder = ( + importlib.machinery.PathFinder().find_spec + if isinstance(paths, list) + else importlib.util.find_spec + ) + return finder(module, paths) + + +def find_module(module, paths=None): + """Just like 'imp.find_module()', but with package support""" + spec = find_spec(module, paths) + if spec is None: + raise ImportError(f"Can't find {module}") + if not spec.has_location and hasattr(spec, 'submodule_search_locations'): + spec = importlib.util.spec_from_loader('__init__.py', spec.loader) + + kind = -1 + file = None + static = isinstance(spec.loader, type) + if ( + spec.origin == 'frozen' + or static + and issubclass(spec.loader, importlib.machinery.FrozenImporter) + ): + kind = PY_FROZEN + path = None # imp compabilty + suffix = mode = '' # imp compatibility + elif ( + spec.origin == 'built-in' + or static + and issubclass(spec.loader, importlib.machinery.BuiltinImporter) + ): + kind = C_BUILTIN + path = None # imp compabilty + suffix = mode = '' # imp compatibility + elif spec.has_location: + path = spec.origin + suffix = os.path.splitext(path)[1] + mode = 'r' if suffix in importlib.machinery.SOURCE_SUFFIXES else 'rb' + + if suffix in importlib.machinery.SOURCE_SUFFIXES: + kind = PY_SOURCE + file = tokenize.open(path) + elif suffix in importlib.machinery.BYTECODE_SUFFIXES: + kind = PY_COMPILED + file = open(path, 'rb') + elif suffix in importlib.machinery.EXTENSION_SUFFIXES: + kind = C_EXTENSION + + else: + path = None + suffix = mode = '' + + return file, path, (suffix, mode, kind) + + +def get_frozen_object(module, paths=None): + spec = find_spec(module, paths) + if not spec: + raise ImportError(f"Can't find {module}") + return spec.loader.get_code(module) + + +def get_module(module, paths, info): + spec = find_spec(module, paths) + if not spec: + raise ImportError(f"Can't find {module}") + return module_from_spec(spec) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_importlib.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_importlib.py new file mode 100644 index 000000000..ce0fd5265 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_importlib.py @@ -0,0 +1,9 @@ +import sys + +if sys.version_info < (3, 10): + import importlib_metadata as metadata # pragma: no cover +else: + import importlib.metadata as metadata # noqa: F401 + + +import importlib.resources as resources # noqa: F401 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_itertools.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_itertools.py new file mode 100644 index 000000000..d6ca84135 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_itertools.py @@ -0,0 +1,23 @@ +from more_itertools import consume # noqa: F401 + + +# copied from jaraco.itertools 6.1 +def ensure_unique(iterable, key=lambda x: x): + """ + Wrap an iterable to raise a ValueError if non-unique values are encountered. + + >>> list(ensure_unique('abc')) + ['a', 'b', 'c'] + >>> consume(ensure_unique('abca')) + Traceback (most recent call last): + ... + ValueError: Duplicate element 'a' encountered. + """ + seen = set() + seen_add = seen.add + for element in iterable: + k = key(element) + if k in seen: + raise ValueError(f"Duplicate element {element!r} encountered.") + seen_add(k) + yield element diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_normalization.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_normalization.py new file mode 100644 index 000000000..fb89323c9 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_normalization.py @@ -0,0 +1,177 @@ +""" +Helpers for normalization as expected in wheel/sdist/module file names +and core metadata +""" + +import re +from typing import TYPE_CHECKING + +import packaging + +# https://packaging.python.org/en/latest/specifications/core-metadata/#name +_VALID_NAME = re.compile(r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", re.I) +_UNSAFE_NAME_CHARS = re.compile(r"[^A-Z0-9._-]+", re.I) +_NON_ALPHANUMERIC = re.compile(r"[^A-Z0-9]+", re.I) +_PEP440_FALLBACK = re.compile(r"^v?(?P(?:[0-9]+!)?[0-9]+(?:\.[0-9]+)*)", re.I) + + +def safe_identifier(name: str) -> str: + """Make a string safe to be used as Python identifier. + >>> safe_identifier("12abc") + '_12abc' + >>> safe_identifier("__editable__.myns.pkg-78.9.3_local") + '__editable___myns_pkg_78_9_3_local' + """ + safe = re.sub(r'\W|^(?=\d)', '_', name) + assert safe.isidentifier() + return safe + + +def safe_name(component: str) -> str: + """Escape a component used as a project name according to Core Metadata. + >>> safe_name("hello world") + 'hello-world' + >>> safe_name("hello?world") + 'hello-world' + >>> safe_name("hello_world") + 'hello_world' + """ + return _UNSAFE_NAME_CHARS.sub("-", component) + + +def safe_version(version: str) -> str: + """Convert an arbitrary string into a valid version string. + Can still raise an ``InvalidVersion`` exception. + To avoid exceptions use ``best_effort_version``. + >>> safe_version("1988 12 25") + '1988.12.25' + >>> safe_version("v0.2.1") + '0.2.1' + >>> safe_version("v0.2?beta") + '0.2b0' + >>> safe_version("v0.2 beta") + '0.2b0' + >>> safe_version("ubuntu lts") + Traceback (most recent call last): + ... + packaging.version.InvalidVersion: Invalid version: 'ubuntu.lts' + """ + v = version.replace(' ', '.') + try: + return str(packaging.version.Version(v)) + except packaging.version.InvalidVersion: + attempt = _UNSAFE_NAME_CHARS.sub("-", v) + return str(packaging.version.Version(attempt)) + + +def best_effort_version(version: str) -> str: + """Convert an arbitrary string into a version-like string. + Fallback when ``safe_version`` is not safe enough. + >>> best_effort_version("v0.2 beta") + '0.2b0' + >>> best_effort_version("ubuntu lts") + '0.dev0+sanitized.ubuntu.lts' + >>> best_effort_version("0.23ubuntu1") + '0.23.dev0+sanitized.ubuntu1' + >>> best_effort_version("0.23-") + '0.23.dev0+sanitized' + >>> best_effort_version("0.-_") + '0.dev0+sanitized' + >>> best_effort_version("42.+?1") + '42.dev0+sanitized.1' + """ + try: + return safe_version(version) + except packaging.version.InvalidVersion: + v = version.replace(' ', '.') + match = _PEP440_FALLBACK.search(v) + if match: + safe = match["safe"] + rest = v[len(safe) :] + else: + safe = "0" + rest = version + safe_rest = _NON_ALPHANUMERIC.sub(".", rest).strip(".") + local = f"sanitized.{safe_rest}".strip(".") + return safe_version(f"{safe}.dev0+{local}") + + +def safe_extra(extra: str) -> str: + """Normalize extra name according to PEP 685 + >>> safe_extra("_FrIeNdLy-._.-bArD") + 'friendly-bard' + >>> safe_extra("FrIeNdLy-._.-bArD__._-") + 'friendly-bard' + """ + return _NON_ALPHANUMERIC.sub("-", extra).strip("-").lower() + + +def filename_component(value: str) -> str: + """Normalize each component of a filename (e.g. distribution/version part of wheel) + Note: ``value`` needs to be already normalized. + >>> filename_component("my-pkg") + 'my_pkg' + """ + return value.replace("-", "_").strip("_") + + +def filename_component_broken(value: str) -> str: + """ + Produce the incorrect filename component for compatibility. + + See pypa/setuptools#4167 for detailed analysis. + + TODO: replace this with filename_component after pip 24 is + nearly-ubiquitous. + + >>> filename_component_broken('foo_bar-baz') + 'foo-bar-baz' + """ + return value.replace('_', '-') + + +def safer_name(value: str) -> str: + """Like ``safe_name`` but can be used as filename component for wheel""" + # See bdist_wheel.safer_name + return ( + # Per https://packaging.python.org/en/latest/specifications/name-normalization/#name-normalization + re.sub(r"[-_.]+", "-", safe_name(value)) + .lower() + # Per https://packaging.python.org/en/latest/specifications/binary-distribution-format/#escaping-and-unicode + .replace("-", "_") + ) + + +def safer_best_effort_version(value: str) -> str: + """Like ``best_effort_version`` but can be used as filename component for wheel""" + # See bdist_wheel.safer_verion + # TODO: Replace with only safe_version in the future (no need for best effort) + return filename_component(best_effort_version(value)) + + +def _missing_canonicalize_license_expression(expression: str) -> str: + """ + Defer import error to affect only users that actually use it + https://github.com/pypa/setuptools/issues/4894 + >>> _missing_canonicalize_license_expression("a OR b") + Traceback (most recent call last): + ... + ImportError: ...Cannot import `packaging.licenses`... + """ + raise ImportError( + "Cannot import `packaging.licenses`." + """ + Setuptools>=77.0.0 requires "packaging>=24.2" to work properly. + Please make sure you have a suitable version installed. + """ + ) + + +try: + from packaging.licenses import ( + canonicalize_license_expression as _canonicalize_license_expression, + ) +except ImportError: # pragma: nocover + if not TYPE_CHECKING: + # XXX: pyright is still upset even with # pyright: ignore[reportAssignmentType] + _canonicalize_license_expression = _missing_canonicalize_license_expression diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_path.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_path.py new file mode 100644 index 000000000..2b7802293 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_path.py @@ -0,0 +1,93 @@ +from __future__ import annotations + +import contextlib +import os +import sys +from typing import TYPE_CHECKING, TypeVar, Union + +from more_itertools import unique_everseen + +if TYPE_CHECKING: + from typing_extensions import TypeAlias + +StrPath: TypeAlias = Union[str, os.PathLike[str]] # Same as _typeshed.StrPath +StrPathT = TypeVar("StrPathT", bound=Union[str, os.PathLike[str]]) + + +def ensure_directory(path): + """Ensure that the parent directory of `path` exists""" + dirname = os.path.dirname(path) + os.makedirs(dirname, exist_ok=True) + + +def same_path(p1: StrPath, p2: StrPath) -> bool: + """Differs from os.path.samefile because it does not require paths to exist. + Purely string based (no comparison between i-nodes). + >>> same_path("a/b", "./a/b") + True + >>> same_path("a/b", "a/./b") + True + >>> same_path("a/b", "././a/b") + True + >>> same_path("a/b", "./a/b/c/..") + True + >>> same_path("a/b", "../a/b/c") + False + >>> same_path("a", "a/b") + False + """ + return normpath(p1) == normpath(p2) + + +def _cygwin_patch(filename: StrPath): # 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 + + +def normpath(filename: StrPath) -> str: + """Normalize a file/dir name for comparison purposes.""" + return os.path.normcase(os.path.realpath(os.path.normpath(_cygwin_patch(filename)))) + + +@contextlib.contextmanager +def paths_on_pythonpath(paths): + """ + Add the indicated paths to the head of the PYTHONPATH environment + variable so that subprocesses will also see the packages at + these paths. + + Do this in a context that restores the value on exit. + + >>> getfixture('monkeypatch').setenv('PYTHONPATH', 'anything') + >>> with paths_on_pythonpath(['foo', 'bar']): + ... assert 'foo' in os.environ['PYTHONPATH'] + ... assert 'anything' in os.environ['PYTHONPATH'] + >>> os.environ['PYTHONPATH'] + 'anything' + + >>> getfixture('monkeypatch').delenv('PYTHONPATH') + >>> with paths_on_pythonpath(['foo', 'bar']): + ... assert 'foo' in os.environ['PYTHONPATH'] + >>> os.environ.get('PYTHONPATH') + """ + nothing = object() + orig_pythonpath = os.environ.get('PYTHONPATH', nothing) + current_pythonpath = os.environ.get('PYTHONPATH', '') + try: + prefix = os.pathsep.join(unique_everseen(paths)) + to_join = filter(None, [prefix, current_pythonpath]) + new_path = os.pathsep.join(to_join) + if new_path: + os.environ['PYTHONPATH'] = new_path + yield + finally: + if orig_pythonpath is nothing: + os.environ.pop('PYTHONPATH', None) + else: + os.environ['PYTHONPATH'] = orig_pythonpath diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_reqs.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_reqs.py new file mode 100644 index 000000000..7be56cbf3 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_reqs.py @@ -0,0 +1,42 @@ +from __future__ import annotations + +from collections.abc import Iterable, Iterator +from functools import lru_cache +from typing import TYPE_CHECKING, Callable, TypeVar, Union, overload + +import jaraco.text as text +from packaging.requirements import Requirement + +if TYPE_CHECKING: + from typing_extensions import TypeAlias + +_T = TypeVar("_T") +_StrOrIter: TypeAlias = Union[str, Iterable[str]] + + +parse_req: Callable[[str], Requirement] = lru_cache()(Requirement) +# Setuptools parses the same requirement many times +# (e.g. first for validation than for normalisation), +# so it might be worth to cache. + + +def parse_strings(strs: _StrOrIter) -> Iterator[str]: + """ + Yield requirement strings for each specification in `strs`. + + `strs` must be a string, or a (possibly-nested) iterable thereof. + """ + return text.join_continuation(map(text.drop_comment, text.yield_lines(strs))) + + +# These overloads are only needed because of a mypy false-positive, pyright gets it right +# https://github.com/python/mypy/issues/3737 +@overload +def parse(strs: _StrOrIter) -> Iterator[Requirement]: ... +@overload +def parse(strs: _StrOrIter, parser: Callable[[str], _T]) -> Iterator[_T]: ... +def parse(strs: _StrOrIter, parser: Callable[[str], _T] = parse_req) -> Iterator[_T]: # type: ignore[assignment] + """ + Parse requirements. + """ + return map(parser, parse_strings(strs)) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_scripts.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_scripts.py new file mode 100644 index 000000000..88bf02f92 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_scripts.py @@ -0,0 +1,361 @@ +from __future__ import annotations + +import os +import re +import shlex +import shutil +import struct +import subprocess +import sys +import textwrap +from collections.abc import Iterable +from typing import TYPE_CHECKING, TypedDict + +from ._importlib import metadata, resources + +if TYPE_CHECKING: + from typing_extensions import Self + +from .warnings import SetuptoolsWarning + +from distutils.command.build_scripts import first_line_re +from distutils.util import get_platform + + +class _SplitArgs(TypedDict, total=False): + comments: bool + posix: bool + + +class CommandSpec(list): + """ + A command spec for a #! header, specified as a list of arguments akin to + those passed to Popen. + """ + + options: list[str] = [] + split_args = _SplitArgs() + + @classmethod + def best(cls): + """ + Choose the best CommandSpec class based on environmental conditions. + """ + return cls + + @classmethod + def _sys_executable(cls): + _default = os.path.normpath(sys.executable) + return os.environ.get('__PYVENV_LAUNCHER__', _default) + + @classmethod + def from_param(cls, param: Self | str | Iterable[str] | None) -> Self: + """ + Construct a CommandSpec from a parameter to build_scripts, which may + be None. + """ + if isinstance(param, cls): + return param + if isinstance(param, str): + return cls.from_string(param) + if isinstance(param, Iterable): + return cls(param) + if param is None: + return cls.from_environment() + raise TypeError(f"Argument has an unsupported type {type(param)}") + + @classmethod + def from_environment(cls): + return cls([cls._sys_executable()]) + + @classmethod + def from_string(cls, string: str) -> Self: + """ + Construct a command spec from a simple string representing a command + line parseable by shlex.split. + """ + items = shlex.split(string, **cls.split_args) + return cls(items) + + def install_options(self, script_text: str): + self.options = shlex.split(self._extract_options(script_text)) + cmdline = subprocess.list2cmdline(self) + if not isascii(cmdline): + self.options[:0] = ['-x'] + + @staticmethod + def _extract_options(orig_script): + """ + Extract any options from the first line of the script. + """ + first = (orig_script + '\n').splitlines()[0] + match = _first_line_re().match(first) + options = match.group(1) or '' if match else '' + return options.strip() + + def as_header(self): + return self._render(self + list(self.options)) + + @staticmethod + def _strip_quotes(item): + _QUOTES = '"\'' + for q in _QUOTES: + if item.startswith(q) and item.endswith(q): + return item[1:-1] + return item + + @staticmethod + def _render(items): + cmdline = subprocess.list2cmdline( + CommandSpec._strip_quotes(item.strip()) for item in items + ) + return '#!' + cmdline + '\n' + + +class WindowsCommandSpec(CommandSpec): + split_args = _SplitArgs(posix=False) + + +class ScriptWriter: + """ + Encapsulates behavior around writing entry point scripts for console and + gui apps. + """ + + template = textwrap.dedent( + r""" + # EASY-INSTALL-ENTRY-SCRIPT: %(spec)r,%(group)r,%(name)r + import re + import sys + + # for compatibility with easy_install; see #2198 + __requires__ = %(spec)r + + try: + from importlib.metadata import distribution + except ImportError: + try: + from importlib_metadata import distribution + except ImportError: + from pkg_resources import load_entry_point + + + def importlib_load_entry_point(spec, group, name): + dist_name, _, _ = spec.partition('==') + matches = ( + entry_point + for entry_point in distribution(dist_name).entry_points + if entry_point.group == group and entry_point.name == name + ) + return next(matches).load() + + + globals().setdefault('load_entry_point', importlib_load_entry_point) + + + if __name__ == '__main__': + sys.argv[0] = re.sub(r'(-script\.pyw?|\.exe)?$', '', sys.argv[0]) + sys.exit(load_entry_point(%(spec)r, %(group)r, %(name)r)()) + """ + ).lstrip() + + command_spec_class = CommandSpec + + @classmethod + def get_args(cls, dist, header=None): + """ + Yield write_script() argument tuples for a distribution's + console_scripts and gui_scripts entry points. + """ + + # If distribution is not an importlib.metadata.Distribution, assume + # it's a pkg_resources.Distribution and transform it. + if not hasattr(dist, 'entry_points'): + SetuptoolsWarning.emit("Unsupported distribution encountered.") + dist = metadata.Distribution.at(dist.egg_info) + + if header is None: + header = cls.get_header() + spec = f'{dist.name}=={dist.version}' + for type_ in 'console', 'gui': + group = f'{type_}_scripts' + for ep in dist.entry_points.select(group=group): + name = ep.name + cls._ensure_safe_name(ep.name) + script_text = cls.template % locals() + args = cls._get_script_args(type_, ep.name, header, script_text) + yield from args + + @staticmethod + def _ensure_safe_name(name): + """ + Prevent paths in *_scripts entry point names. + """ + has_path_sep = re.search(r'[\\/]', name) + if has_path_sep: + raise ValueError("Path separators not allowed in script names") + + @classmethod + def best(cls): + """ + Select the best ScriptWriter for this environment. + """ + if sys.platform == 'win32' or (os.name == 'java' and os._name == 'nt'): + return WindowsScriptWriter.best() + else: + return cls + + @classmethod + def _get_script_args(cls, type_, name, header, script_text): + # Simply write the stub with no extension. + yield (name, header + script_text) + + @classmethod + def get_header( + cls, + script_text: str = "", + executable: str | CommandSpec | Iterable[str] | None = None, + ) -> str: + """Create a #! line, getting options (if any) from script_text""" + cmd = cls.command_spec_class.best().from_param(executable) + cmd.install_options(script_text) + return cmd.as_header() + + +class WindowsScriptWriter(ScriptWriter): + command_spec_class = WindowsCommandSpec + + @classmethod + def best(cls): + """ + Select the best ScriptWriter suitable for Windows + """ + writer_lookup = dict( + executable=WindowsExecutableLauncherWriter, + natural=cls, + ) + # for compatibility, use the executable launcher by default + launcher = os.environ.get('SETUPTOOLS_LAUNCHER', 'executable') + return writer_lookup[launcher] + + @classmethod + def _get_script_args(cls, type_, name, header, script_text): + "For Windows, add a .py extension" + ext = dict(console='.pya', gui='.pyw')[type_] + if ext not in os.environ['PATHEXT'].lower().split(';'): + msg = ( + "{ext} not listed in PATHEXT; scripts will not be " + "recognized as executables." + ).format(**locals()) + SetuptoolsWarning.emit(msg) + old = ['.pya', '.py', '-script.py', '.pyc', '.pyo', '.pyw', '.exe'] + old.remove(ext) + header = cls._adjust_header(type_, header) + blockers = [name + x for x in old] + yield name + ext, header + script_text, 't', blockers + + @classmethod + def _adjust_header(cls, type_, orig_header): + """ + Make sure 'pythonw' is used for gui and 'python' is used for + console (regardless of what sys.executable is). + """ + pattern = 'pythonw.exe' + repl = 'python.exe' + if type_ == 'gui': + pattern, repl = repl, pattern + pattern_ob = re.compile(re.escape(pattern), re.IGNORECASE) + new_header = pattern_ob.sub(string=orig_header, repl=repl) + return new_header if cls._use_header(new_header) else orig_header + + @staticmethod + def _use_header(new_header): + """ + Should _adjust_header use the replaced header? + + On non-windows systems, always use. On + Windows systems, only use the replaced header if it resolves + to an executable on the system. + """ + clean_header = new_header[2:-1].strip('"') + return sys.platform != 'win32' or shutil.which(clean_header) + + +class WindowsExecutableLauncherWriter(WindowsScriptWriter): + @classmethod + def _get_script_args(cls, type_, name, header, script_text): + """ + For Windows, add a .py extension and an .exe launcher + """ + if type_ == 'gui': + launcher_type = 'gui' + ext = '-script.pyw' + old = ['.pyw'] + else: + launcher_type = 'cli' + ext = '-script.py' + old = ['.py', '.pyc', '.pyo'] + hdr = cls._adjust_header(type_, header) + blockers = [name + x for x in old] + yield (name + ext, hdr + script_text, 't', blockers) + yield ( + name + '.exe', + get_win_launcher(launcher_type), + 'b', # write in binary mode + ) + if not is_64bit(): + # install a manifest for the launcher to prevent Windows + # from detecting it as an installer (which it will for + # launchers like easy_install.exe). Consider only + # adding a manifest for launchers detected as installers. + # See Distribute #143 for details. + m_name = name + '.exe.manifest' + yield (m_name, load_launcher_manifest(name), 't') + + +def get_win_launcher(type): + """ + Load the Windows launcher (executable) suitable for launching a script. + + `type` should be either 'cli' or 'gui' + + Returns the executable as a byte string. + """ + launcher_fn = f'{type}.exe' + if is_64bit(): + if get_platform() == "win-arm64": + launcher_fn = launcher_fn.replace(".", "-arm64.") + else: + launcher_fn = launcher_fn.replace(".", "-64.") + else: + launcher_fn = launcher_fn.replace(".", "-32.") + return resources.files('setuptools').joinpath(launcher_fn).read_bytes() + + +def load_launcher_manifest(name): + res = resources.files(__name__).joinpath('launcher manifest.xml') + return res.read_text(encoding='utf-8') % vars() + + +def _first_line_re(): + """ + Return a regular expression based on first_line_re suitable for matching + strings. + """ + if isinstance(first_line_re.pattern, str): + return first_line_re + + # first_line_re in Python >=3.1.4 and >=3.2.1 is a bytes pattern. + return re.compile(first_line_re.pattern.decode()) + + +def is_64bit(): + return struct.calcsize("P") == 8 + + +def isascii(s): + try: + s.encode('ascii') + except UnicodeError: + return False + return True diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_shutil.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_shutil.py new file mode 100644 index 000000000..660459a11 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_shutil.py @@ -0,0 +1,59 @@ +"""Convenience layer on top of stdlib's shutil and os""" + +import os +import stat +from typing import Callable, TypeVar + +from .compat import py311 + +from distutils import log + +try: + from os import chmod # pyright: ignore[reportAssignmentType] + # Losing type-safety w/ pyright, but that's ok +except ImportError: # pragma: no cover + # Jython compatibility + def chmod(*args: object, **kwargs: object) -> None: # type: ignore[misc] # Mypy reuses the imported definition anyway + pass + + +_T = TypeVar("_T") + + +def attempt_chmod_verbose(path, mode): + log.debug("changing mode of %s to %o", path, mode) + try: + chmod(path, mode) + except OSError as e: # pragma: no cover + log.debug("chmod failed: %s", e) + + +# Must match shutil._OnExcCallback +def _auto_chmod( + func: Callable[..., _T], arg: str, exc: BaseException +) -> _T: # pragma: no cover + """shutils onexc callback to automatically call chmod for certain functions.""" + # Only retry for scenarios known to have an issue + if func in [os.unlink, os.remove] and os.name == 'nt': + attempt_chmod_verbose(arg, stat.S_IWRITE) + return func(arg) + raise exc + + +def rmtree(path, ignore_errors=False, onexc=_auto_chmod): + """ + Similar to ``shutil.rmtree`` but automatically executes ``chmod`` + for well know Windows failure scenarios. + """ + return py311.shutil_rmtree(path, ignore_errors, onexc) + + +def rmdir(path, **opts): + if os.path.isdir(path): + rmtree(path, **opts) + + +def current_umask(): + tmp = os.umask(0o022) + os.umask(tmp) + return tmp diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_static.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_static.py new file mode 100644 index 000000000..af35862cf --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_static.py @@ -0,0 +1,188 @@ +from functools import wraps +from typing import TypeVar + +import packaging.specifiers + +from .warnings import SetuptoolsDeprecationWarning + + +class Static: + """ + Wrapper for built-in object types that are allow setuptools to identify + static core metadata (in opposition to ``Dynamic``, as defined :pep:`643`). + + The trick is to mark values with :class:`Static` when they come from + ``pyproject.toml`` or ``setup.cfg``, so if any plugin overwrite the value + with a built-in, setuptools will be able to recognise the change. + + We inherit from built-in classes, so that we don't need to change the existing + code base to deal with the new types. + We also should strive for immutability objects to avoid changes after the + initial parsing. + """ + + _mutated_: bool = False # TODO: Remove after deprecation warning is solved + + +def _prevent_modification(target: type, method: str, copying: str) -> None: + """ + Because setuptools is very flexible we cannot fully prevent + plugins and user customizations from modifying static values that were + parsed from config files. + But we can attempt to block "in-place" mutations and identify when they + were done. + """ + fn = getattr(target, method, None) + if fn is None: + return + + @wraps(fn) + def _replacement(self: Static, *args, **kwargs): + # TODO: After deprecation period raise NotImplementedError instead of warning + # which obviated the existence and checks of the `_mutated_` attribute. + self._mutated_ = True + SetuptoolsDeprecationWarning.emit( + "Direct modification of value will be disallowed", + f""" + In an effort to implement PEP 643, direct/in-place changes of static values + that come from configuration files are deprecated. + If you need to modify this value, please first create a copy with {copying} + and make sure conform to all relevant standards when overriding setuptools + functionality (https://packaging.python.org/en/latest/specifications/). + """, + due_date=(2025, 10, 10), # Initially introduced in 2024-09-06 + ) + return fn(self, *args, **kwargs) + + _replacement.__doc__ = "" # otherwise doctest may fail. + setattr(target, method, _replacement) + + +class Str(str, Static): + pass + + +class Tuple(tuple, Static): + pass + + +class List(list, Static): + """ + :meta private: + >>> x = List([1, 2, 3]) + >>> is_static(x) + True + >>> x += [0] # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + SetuptoolsDeprecationWarning: Direct modification ... + >>> is_static(x) # no longer static after modification + False + >>> y = list(x) + >>> y.clear() + >>> y + [] + >>> y == x + False + >>> is_static(List(y)) + True + """ + + +# Make `List` immutable-ish +# (certain places of setuptools/distutils issue a warn if we use tuple instead of list) +for _method in ( + '__delitem__', + '__iadd__', + '__setitem__', + 'append', + 'clear', + 'extend', + 'insert', + 'remove', + 'reverse', + 'pop', +): + _prevent_modification(List, _method, "`list(value)`") + + +class Dict(dict, Static): + """ + :meta private: + >>> x = Dict({'a': 1, 'b': 2}) + >>> is_static(x) + True + >>> x['c'] = 0 # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + SetuptoolsDeprecationWarning: Direct modification ... + >>> x._mutated_ + True + >>> is_static(x) # no longer static after modification + False + >>> y = dict(x) + >>> y.popitem() + ('b', 2) + >>> y == x + False + >>> is_static(Dict(y)) + True + """ + + +# Make `Dict` immutable-ish (we cannot inherit from types.MappingProxyType): +for _method in ( + '__delitem__', + '__ior__', + '__setitem__', + 'clear', + 'pop', + 'popitem', + 'setdefault', + 'update', +): + _prevent_modification(Dict, _method, "`dict(value)`") + + +class SpecifierSet(packaging.specifiers.SpecifierSet, Static): + """Not exactly a built-in type but useful for ``requires-python``""" + + +T = TypeVar("T") + + +def noop(value: T) -> T: + """ + >>> noop(42) + 42 + """ + return value + + +_CONVERSIONS = {str: Str, tuple: Tuple, list: List, dict: Dict} + + +def attempt_conversion(value: T) -> T: + """ + >>> is_static(attempt_conversion("hello")) + True + >>> is_static(object()) + False + """ + return _CONVERSIONS.get(type(value), noop)(value) # type: ignore[call-overload] + + +def is_static(value: object) -> bool: + """ + >>> is_static(a := Dict({'a': 1})) + True + >>> is_static(dict(a)) + False + >>> is_static(b := List([1, 2, 3])) + True + >>> is_static(list(b)) + False + """ + return isinstance(value, Static) and not value._mutated_ + + +EMPTY_LIST = List() +EMPTY_DICT = Dict() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/__pycache__/typing_extensions.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/__pycache__/typing_extensions.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..908ee456aed83df06ddae6d594592f954faf2d60 GIT binary patch literal 139535 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
                                              # pre-release
    +            [-_\.]?
    +            (?Palpha|a|beta|b|preview|pre|c|rc)
    +            [-_\.]?
    +            (?P[0-9]+)?
    +        )?
    +        (?P                                         # post release
    +            (?:-(?P[0-9]+))
    +            |
    +            (?:
    +                [-_\.]?
    +                (?Ppost|rev|r)
    +                [-_\.]?
    +                (?P[0-9]+)?
    +            )
    +        )?
    +        (?P                                          # dev release
    +            [-_\.]?
    +            (?Pdev)
    +            [-_\.]?
    +            (?P[0-9]+)?
    +        )?
    +    )
    +    (?:\+(?P[a-z0-9]+(?:[-_\.][a-z0-9]+)*))?       # local version
    +"""
    +
    +VERSION_PATTERN = _VERSION_PATTERN
    +"""
    +A string containing the regular expression used to match a valid version.
    +
    +The pattern is not anchored at either end, and is intended for embedding in larger
    +expressions (for example, matching a version number as part of a file name). The
    +regular expression should be compiled with the ``re.VERBOSE`` and ``re.IGNORECASE``
    +flags set.
    +
    +:meta hide-value:
    +"""
    +
    +
    +class Version(_BaseVersion):
    +    """This class abstracts handling of a project's versions.
    +
    +    A :class:`Version` instance is comparison aware and can be compared and
    +    sorted using the standard Python interfaces.
    +
    +    >>> v1 = Version("1.0a5")
    +    >>> v2 = Version("1.0")
    +    >>> v1
    +    
    +    >>> v2
    +    
    +    >>> v1 < v2
    +    True
    +    >>> v1 == v2
    +    False
    +    >>> v1 > v2
    +    False
    +    >>> v1 >= v2
    +    False
    +    >>> v1 <= v2
    +    True
    +    """
    +
    +    _regex = re.compile(r"^\s*" + VERSION_PATTERN + r"\s*$", re.VERBOSE | re.IGNORECASE)
    +    _key: CmpKey
    +
    +    def __init__(self, version: str) -> None:
    +        """Initialize a Version object.
    +
    +        :param version:
    +            The string representation of a version which will be parsed and normalized
    +            before use.
    +        :raises InvalidVersion:
    +            If the ``version`` does not conform to PEP 440 in any way then this
    +            exception will be raised.
    +        """
    +
    +        # Validate the version and parse it into pieces
    +        match = self._regex.search(version)
    +        if not match:
    +            raise InvalidVersion(f"Invalid version: {version!r}")
    +
    +        # Store the parsed out pieces of the version
    +        self._version = _Version(
    +            epoch=int(match.group("epoch")) if match.group("epoch") else 0,
    +            release=tuple(int(i) for i in match.group("release").split(".")),
    +            pre=_parse_letter_version(match.group("pre_l"), match.group("pre_n")),
    +            post=_parse_letter_version(
    +                match.group("post_l"), match.group("post_n1") or match.group("post_n2")
    +            ),
    +            dev=_parse_letter_version(match.group("dev_l"), match.group("dev_n")),
    +            local=_parse_local_version(match.group("local")),
    +        )
    +
    +        # Generate a key which will be used for sorting
    +        self._key = _cmpkey(
    +            self._version.epoch,
    +            self._version.release,
    +            self._version.pre,
    +            self._version.post,
    +            self._version.dev,
    +            self._version.local,
    +        )
    +
    +    def __repr__(self) -> str:
    +        """A representation of the Version that shows all internal state.
    +
    +        >>> Version('1.0.0')
    +        
    +        """
    +        return f""
    +
    +    def __str__(self) -> str:
    +        """A string representation of the version that can be round-tripped.
    +
    +        >>> str(Version("1.0a5"))
    +        '1.0a5'
    +        """
    +        parts = []
    +
    +        # Epoch
    +        if self.epoch != 0:
    +            parts.append(f"{self.epoch}!")
    +
    +        # Release segment
    +        parts.append(".".join(str(x) for x in self.release))
    +
    +        # Pre-release
    +        if self.pre is not None:
    +            parts.append("".join(str(x) for x in self.pre))
    +
    +        # Post-release
    +        if self.post is not None:
    +            parts.append(f".post{self.post}")
    +
    +        # Development release
    +        if self.dev is not None:
    +            parts.append(f".dev{self.dev}")
    +
    +        # Local version segment
    +        if self.local is not None:
    +            parts.append(f"+{self.local}")
    +
    +        return "".join(parts)
    +
    +    @property
    +    def epoch(self) -> int:
    +        """The epoch of the version.
    +
    +        >>> Version("2.0.0").epoch
    +        0
    +        >>> Version("1!2.0.0").epoch
    +        1
    +        """
    +        return self._version.epoch
    +
    +    @property
    +    def release(self) -> tuple[int, ...]:
    +        """The components of the "release" segment of the version.
    +
    +        >>> Version("1.2.3").release
    +        (1, 2, 3)
    +        >>> Version("2.0.0").release
    +        (2, 0, 0)
    +        >>> Version("1!2.0.0.post0").release
    +        (2, 0, 0)
    +
    +        Includes trailing zeroes but not the epoch or any pre-release / development /
    +        post-release suffixes.
    +        """
    +        return self._version.release
    +
    +    @property
    +    def pre(self) -> tuple[str, int] | None:
    +        """The pre-release segment of the version.
    +
    +        >>> print(Version("1.2.3").pre)
    +        None
    +        >>> Version("1.2.3a1").pre
    +        ('a', 1)
    +        >>> Version("1.2.3b1").pre
    +        ('b', 1)
    +        >>> Version("1.2.3rc1").pre
    +        ('rc', 1)
    +        """
    +        return self._version.pre
    +
    +    @property
    +    def post(self) -> int | None:
    +        """The post-release number of the version.
    +
    +        >>> print(Version("1.2.3").post)
    +        None
    +        >>> Version("1.2.3.post1").post
    +        1
    +        """
    +        return self._version.post[1] if self._version.post else None
    +
    +    @property
    +    def dev(self) -> int | None:
    +        """The development number of the version.
    +
    +        >>> print(Version("1.2.3").dev)
    +        None
    +        >>> Version("1.2.3.dev1").dev
    +        1
    +        """
    +        return self._version.dev[1] if self._version.dev else None
    +
    +    @property
    +    def local(self) -> str | None:
    +        """The local version segment of the version.
    +
    +        >>> print(Version("1.2.3").local)
    +        None
    +        >>> Version("1.2.3+abc").local
    +        'abc'
    +        """
    +        if self._version.local:
    +            return ".".join(str(x) for x in self._version.local)
    +        else:
    +            return None
    +
    +    @property
    +    def public(self) -> str:
    +        """The public portion of the version.
    +
    +        >>> Version("1.2.3").public
    +        '1.2.3'
    +        >>> Version("1.2.3+abc").public
    +        '1.2.3'
    +        >>> Version("1!1.2.3dev1+abc").public
    +        '1!1.2.3.dev1'
    +        """
    +        return str(self).split("+", 1)[0]
    +
    +    @property
    +    def base_version(self) -> str:
    +        """The "base version" of the version.
    +
    +        >>> Version("1.2.3").base_version
    +        '1.2.3'
    +        >>> Version("1.2.3+abc").base_version
    +        '1.2.3'
    +        >>> Version("1!1.2.3dev1+abc").base_version
    +        '1!1.2.3'
    +
    +        The "base version" is the public version of the project without any pre or post
    +        release markers.
    +        """
    +        parts = []
    +
    +        # Epoch
    +        if self.epoch != 0:
    +            parts.append(f"{self.epoch}!")
    +
    +        # Release segment
    +        parts.append(".".join(str(x) for x in self.release))
    +
    +        return "".join(parts)
    +
    +    @property
    +    def is_prerelease(self) -> bool:
    +        """Whether this version is a pre-release.
    +
    +        >>> Version("1.2.3").is_prerelease
    +        False
    +        >>> Version("1.2.3a1").is_prerelease
    +        True
    +        >>> Version("1.2.3b1").is_prerelease
    +        True
    +        >>> Version("1.2.3rc1").is_prerelease
    +        True
    +        >>> Version("1.2.3dev1").is_prerelease
    +        True
    +        """
    +        return self.dev is not None or self.pre is not None
    +
    +    @property
    +    def is_postrelease(self) -> bool:
    +        """Whether this version is a post-release.
    +
    +        >>> Version("1.2.3").is_postrelease
    +        False
    +        >>> Version("1.2.3.post1").is_postrelease
    +        True
    +        """
    +        return self.post is not None
    +
    +    @property
    +    def is_devrelease(self) -> bool:
    +        """Whether this version is a development release.
    +
    +        >>> Version("1.2.3").is_devrelease
    +        False
    +        >>> Version("1.2.3.dev1").is_devrelease
    +        True
    +        """
    +        return self.dev is not None
    +
    +    @property
    +    def major(self) -> int:
    +        """The first item of :attr:`release` or ``0`` if unavailable.
    +
    +        >>> Version("1.2.3").major
    +        1
    +        """
    +        return self.release[0] if len(self.release) >= 1 else 0
    +
    +    @property
    +    def minor(self) -> int:
    +        """The second item of :attr:`release` or ``0`` if unavailable.
    +
    +        >>> Version("1.2.3").minor
    +        2
    +        >>> Version("1").minor
    +        0
    +        """
    +        return self.release[1] if len(self.release) >= 2 else 0
    +
    +    @property
    +    def micro(self) -> int:
    +        """The third item of :attr:`release` or ``0`` if unavailable.
    +
    +        >>> Version("1.2.3").micro
    +        3
    +        >>> Version("1").micro
    +        0
    +        """
    +        return self.release[2] if len(self.release) >= 3 else 0
    +
    +
    +class _TrimmedRelease(Version):
    +    @property
    +    def release(self) -> tuple[int, ...]:
    +        """
    +        Release segment without any trailing zeros.
    +
    +        >>> _TrimmedRelease('1.0.0').release
    +        (1,)
    +        >>> _TrimmedRelease('0.0').release
    +        (0,)
    +        """
    +        rel = super().release
    +        nonzeros = (index for index, val in enumerate(rel) if val)
    +        last_nonzero = max(nonzeros, default=0)
    +        return rel[: last_nonzero + 1]
    +
    +
    +def _parse_letter_version(
    +    letter: str | None, number: str | bytes | SupportsInt | None
    +) -> tuple[str, int] | None:
    +    if letter:
    +        # We consider there to be an implicit 0 in a pre-release if there is
    +        # not a numeral associated with it.
    +        if number is None:
    +            number = 0
    +
    +        # We normalize any letters to their lower case form
    +        letter = letter.lower()
    +
    +        # We consider some words to be alternate spellings of other words and
    +        # in those cases we want to normalize the spellings to our preferred
    +        # spelling.
    +        if letter == "alpha":
    +            letter = "a"
    +        elif letter == "beta":
    +            letter = "b"
    +        elif letter in ["c", "pre", "preview"]:
    +            letter = "rc"
    +        elif letter in ["rev", "r"]:
    +            letter = "post"
    +
    +        return letter, int(number)
    +
    +    assert not letter
    +    if number:
    +        # We assume if we are given a number, but we are not given a letter
    +        # then this is using the implicit post release syntax (e.g. 1.0-1)
    +        letter = "post"
    +
    +        return letter, int(number)
    +
    +    return None
    +
    +
    +_local_version_separators = re.compile(r"[\._-]")
    +
    +
    +def _parse_local_version(local: str | None) -> LocalType | None:
    +    """
    +    Takes a string like abc.1.twelve and turns it into ("abc", 1, "twelve").
    +    """
    +    if local is not None:
    +        return tuple(
    +            part.lower() if not part.isdigit() else int(part)
    +            for part in _local_version_separators.split(local)
    +        )
    +    return None
    +
    +
    +def _cmpkey(
    +    epoch: int,
    +    release: tuple[int, ...],
    +    pre: tuple[str, int] | None,
    +    post: tuple[str, int] | None,
    +    dev: tuple[str, int] | None,
    +    local: LocalType | None,
    +) -> CmpKey:
    +    # When we compare a release version, we want to compare it with all of the
    +    # trailing zeros removed. So we'll use a reverse the list, drop all the now
    +    # leading zeros until we come to something non zero, then take the rest
    +    # re-reverse it back into the correct order and make it a tuple and use
    +    # that for our sorting key.
    +    _release = tuple(
    +        reversed(list(itertools.dropwhile(lambda x: x == 0, reversed(release))))
    +    )
    +
    +    # We need to "trick" the sorting algorithm to put 1.0.dev0 before 1.0a0.
    +    # We'll do this by abusing the pre segment, but we _only_ want to do this
    +    # if there is not a pre or a post segment. If we have one of those then
    +    # the normal sorting rules will handle this case correctly.
    +    if pre is None and post is None and dev is not None:
    +        _pre: CmpPrePostDevType = NegativeInfinity
    +    # Versions without a pre-release (except as noted above) should sort after
    +    # those with one.
    +    elif pre is None:
    +        _pre = Infinity
    +    else:
    +        _pre = pre
    +
    +    # Versions without a post segment should sort before those with one.
    +    if post is None:
    +        _post: CmpPrePostDevType = NegativeInfinity
    +
    +    else:
    +        _post = post
    +
    +    # Versions without a development segment should sort after those with one.
    +    if dev is None:
    +        _dev: CmpPrePostDevType = Infinity
    +
    +    else:
    +        _dev = dev
    +
    +    if local is None:
    +        # Versions without a local segment should sort before those with one.
    +        _local: CmpLocalType = NegativeInfinity
    +    else:
    +        # Versions with a local segment need that segment parsed to implement
    +        # the sorting rules in PEP440.
    +        # - Alpha numeric segments sort before numeric segments
    +        # - Alpha numeric segments sort lexicographically
    +        # - Numeric segments sort numerically
    +        # - Shorter versions sort before longer versions when the prefixes
    +        #   match exactly
    +        _local = tuple(
    +            (i, "") if isinstance(i, int) else (NegativeInfinity, i) for i in local
    +        )
    +
    +    return epoch, _release, _pre, _post, _dev, _local
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/INSTALLER
    new file mode 100644
    index 000000000..a1b589e38
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/INSTALLER
    @@ -0,0 +1 @@
    +pip
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/METADATA
    new file mode 100644
    index 000000000..ab51ef36a
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/METADATA
    @@ -0,0 +1,319 @@
    +Metadata-Version: 2.3
    +Name: platformdirs
    +Version: 4.2.2
    +Summary: A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`.
    +Project-URL: Documentation, https://platformdirs.readthedocs.io
    +Project-URL: Homepage, https://github.com/platformdirs/platformdirs
    +Project-URL: Source, https://github.com/platformdirs/platformdirs
    +Project-URL: Tracker, https://github.com/platformdirs/platformdirs/issues
    +Maintainer-email: Bernát Gábor , Julian Berman , Ofek Lev , Ronny Pfannschmidt 
    +License-Expression: MIT
    +License-File: LICENSE
    +Keywords: appdirs,application,cache,directory,log,user
    +Classifier: Development Status :: 5 - Production/Stable
    +Classifier: Intended Audience :: Developers
    +Classifier: License :: OSI Approved :: MIT License
    +Classifier: Operating System :: OS Independent
    +Classifier: Programming Language :: Python
    +Classifier: Programming Language :: Python :: 3 :: Only
    +Classifier: Programming Language :: Python :: 3.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 :: Software Development :: Libraries :: Python Modules
    +Requires-Python: >=3.8
    +Provides-Extra: docs
    +Requires-Dist: furo>=2023.9.10; extra == 'docs'
    +Requires-Dist: proselint>=0.13; extra == 'docs'
    +Requires-Dist: sphinx-autodoc-typehints>=1.25.2; extra == 'docs'
    +Requires-Dist: sphinx>=7.2.6; extra == 'docs'
    +Provides-Extra: test
    +Requires-Dist: appdirs==1.4.4; extra == 'test'
    +Requires-Dist: covdefaults>=2.3; extra == 'test'
    +Requires-Dist: pytest-cov>=4.1; extra == 'test'
    +Requires-Dist: pytest-mock>=3.12; extra == 'test'
    +Requires-Dist: pytest>=7.4.3; extra == 'test'
    +Provides-Extra: type
    +Requires-Dist: mypy>=1.8; extra == 'type'
    +Description-Content-Type: text/x-rst
    +
    +The problem
    +===========
    +
    +.. image:: https://github.com/platformdirs/platformdirs/actions/workflows/check.yml/badge.svg
    +   :target: https://github.com/platformdirs/platformdirs/actions
    +
    +When writing desktop application, finding the right location to store user data
    +and configuration varies per platform. Even for single-platform apps, there
    +may by plenty of nuances in figuring out the right location.
    +
    +For example, if running on macOS, you should use::
    +
    +    ~/Library/Application Support/
    +
    +If on Windows (at least English Win) that should be::
    +
    +    C:\Documents and Settings\\Application Data\Local Settings\\
    +
    +or possibly::
    +
    +    C:\Documents and Settings\\Application Data\\
    +
    +for `roaming profiles `_ but that is another story.
    +
    +On Linux (and other Unices), according to the `XDG Basedir Spec`_, it should be::
    +
    +    ~/.local/share/
    +
    +.. _XDG Basedir Spec: https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
    +
    +``platformdirs`` to the rescue
    +==============================
    +
    +This kind of thing is what the ``platformdirs`` package is for.
    +``platformdirs`` will help you choose an appropriate:
    +
    +- user data dir (``user_data_dir``)
    +- user config dir (``user_config_dir``)
    +- user cache dir (``user_cache_dir``)
    +- site data dir (``site_data_dir``)
    +- site config dir (``site_config_dir``)
    +- user log dir (``user_log_dir``)
    +- user documents dir (``user_documents_dir``)
    +- user downloads dir (``user_downloads_dir``)
    +- user pictures dir (``user_pictures_dir``)
    +- user videos dir (``user_videos_dir``)
    +- user music dir (``user_music_dir``)
    +- user desktop dir (``user_desktop_dir``)
    +- user runtime dir (``user_runtime_dir``)
    +
    +And also:
    +
    +- Is slightly opinionated on the directory names used. Look for "OPINION" in
    +  documentation and code for when an opinion is being applied.
    +
    +Example output
    +==============
    +
    +On macOS:
    +
    +.. code-block:: pycon
    +
    +    >>> from platformdirs import *
    +    >>> appname = "SuperApp"
    +    >>> appauthor = "Acme"
    +    >>> user_data_dir(appname, appauthor)
    +    '/Users/trentm/Library/Application Support/SuperApp'
    +    >>> site_data_dir(appname, appauthor)
    +    '/Library/Application Support/SuperApp'
    +    >>> user_cache_dir(appname, appauthor)
    +    '/Users/trentm/Library/Caches/SuperApp'
    +    >>> user_log_dir(appname, appauthor)
    +    '/Users/trentm/Library/Logs/SuperApp'
    +    >>> user_documents_dir()
    +    '/Users/trentm/Documents'
    +    >>> user_downloads_dir()
    +    '/Users/trentm/Downloads'
    +    >>> user_pictures_dir()
    +    '/Users/trentm/Pictures'
    +    >>> user_videos_dir()
    +    '/Users/trentm/Movies'
    +    >>> user_music_dir()
    +    '/Users/trentm/Music'
    +    >>> user_desktop_dir()
    +    '/Users/trentm/Desktop'
    +    >>> user_runtime_dir(appname, appauthor)
    +    '/Users/trentm/Library/Caches/TemporaryItems/SuperApp'
    +
    +On Windows:
    +
    +.. code-block:: pycon
    +
    +    >>> from platformdirs import *
    +    >>> appname = "SuperApp"
    +    >>> appauthor = "Acme"
    +    >>> user_data_dir(appname, appauthor)
    +    'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp'
    +    >>> user_data_dir(appname, appauthor, roaming=True)
    +    'C:\\Users\\trentm\\AppData\\Roaming\\Acme\\SuperApp'
    +    >>> user_cache_dir(appname, appauthor)
    +    'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp\\Cache'
    +    >>> user_log_dir(appname, appauthor)
    +    'C:\\Users\\trentm\\AppData\\Local\\Acme\\SuperApp\\Logs'
    +    >>> user_documents_dir()
    +    'C:\\Users\\trentm\\Documents'
    +    >>> user_downloads_dir()
    +    'C:\\Users\\trentm\\Downloads'
    +    >>> user_pictures_dir()
    +    'C:\\Users\\trentm\\Pictures'
    +    >>> user_videos_dir()
    +    'C:\\Users\\trentm\\Videos'
    +    >>> user_music_dir()
    +    'C:\\Users\\trentm\\Music'
    +    >>> user_desktop_dir()
    +    'C:\\Users\\trentm\\Desktop'
    +    >>> user_runtime_dir(appname, appauthor)
    +    'C:\\Users\\trentm\\AppData\\Local\\Temp\\Acme\\SuperApp'
    +
    +On Linux:
    +
    +.. code-block:: pycon
    +
    +    >>> from platformdirs import *
    +    >>> appname = "SuperApp"
    +    >>> appauthor = "Acme"
    +    >>> user_data_dir(appname, appauthor)
    +    '/home/trentm/.local/share/SuperApp'
    +    >>> site_data_dir(appname, appauthor)
    +    '/usr/local/share/SuperApp'
    +    >>> site_data_dir(appname, appauthor, multipath=True)
    +    '/usr/local/share/SuperApp:/usr/share/SuperApp'
    +    >>> user_cache_dir(appname, appauthor)
    +    '/home/trentm/.cache/SuperApp'
    +    >>> user_log_dir(appname, appauthor)
    +    '/home/trentm/.local/state/SuperApp/log'
    +    >>> user_config_dir(appname)
    +    '/home/trentm/.config/SuperApp'
    +    >>> user_documents_dir()
    +    '/home/trentm/Documents'
    +    >>> user_downloads_dir()
    +    '/home/trentm/Downloads'
    +    >>> user_pictures_dir()
    +    '/home/trentm/Pictures'
    +    >>> user_videos_dir()
    +    '/home/trentm/Videos'
    +    >>> user_music_dir()
    +    '/home/trentm/Music'
    +    >>> user_desktop_dir()
    +    '/home/trentm/Desktop'
    +    >>> user_runtime_dir(appname, appauthor)
    +    '/run/user/{os.getuid()}/SuperApp'
    +    >>> site_config_dir(appname)
    +    '/etc/xdg/SuperApp'
    +    >>> os.environ["XDG_CONFIG_DIRS"] = "/etc:/usr/local/etc"
    +    >>> site_config_dir(appname, multipath=True)
    +    '/etc/SuperApp:/usr/local/etc/SuperApp'
    +
    +On Android::
    +
    +    >>> from platformdirs import *
    +    >>> appname = "SuperApp"
    +    >>> appauthor = "Acme"
    +    >>> user_data_dir(appname, appauthor)
    +    '/data/data/com.myApp/files/SuperApp'
    +    >>> user_cache_dir(appname, appauthor)
    +    '/data/data/com.myApp/cache/SuperApp'
    +    >>> user_log_dir(appname, appauthor)
    +    '/data/data/com.myApp/cache/SuperApp/log'
    +    >>> user_config_dir(appname)
    +    '/data/data/com.myApp/shared_prefs/SuperApp'
    +    >>> user_documents_dir()
    +    '/storage/emulated/0/Documents'
    +    >>> user_downloads_dir()
    +    '/storage/emulated/0/Downloads'
    +    >>> user_pictures_dir()
    +    '/storage/emulated/0/Pictures'
    +    >>> user_videos_dir()
    +    '/storage/emulated/0/DCIM/Camera'
    +    >>> user_music_dir()
    +    '/storage/emulated/0/Music'
    +    >>> user_desktop_dir()
    +    '/storage/emulated/0/Desktop'
    +    >>> user_runtime_dir(appname, appauthor)
    +    '/data/data/com.myApp/cache/SuperApp/tmp'
    +
    +Note: Some android apps like Termux and Pydroid are used as shells. These
    +apps are used by the end user to emulate Linux environment. Presence of
    +``SHELL`` environment variable is used by Platformdirs to differentiate
    +between general android apps and android apps used as shells. Shell android
    +apps also support ``XDG_*`` environment variables.
    +
    +
    +``PlatformDirs`` for convenience
    +================================
    +
    +.. code-block:: pycon
    +
    +    >>> from platformdirs import PlatformDirs
    +    >>> dirs = PlatformDirs("SuperApp", "Acme")
    +    >>> dirs.user_data_dir
    +    '/Users/trentm/Library/Application Support/SuperApp'
    +    >>> dirs.site_data_dir
    +    '/Library/Application Support/SuperApp'
    +    >>> dirs.user_cache_dir
    +    '/Users/trentm/Library/Caches/SuperApp'
    +    >>> dirs.user_log_dir
    +    '/Users/trentm/Library/Logs/SuperApp'
    +    >>> dirs.user_documents_dir
    +    '/Users/trentm/Documents'
    +    >>> dirs.user_downloads_dir
    +    '/Users/trentm/Downloads'
    +    >>> dirs.user_pictures_dir
    +    '/Users/trentm/Pictures'
    +    >>> dirs.user_videos_dir
    +    '/Users/trentm/Movies'
    +    >>> dirs.user_music_dir
    +    '/Users/trentm/Music'
    +    >>> dirs.user_desktop_dir
    +    '/Users/trentm/Desktop'
    +    >>> dirs.user_runtime_dir
    +    '/Users/trentm/Library/Caches/TemporaryItems/SuperApp'
    +
    +Per-version isolation
    +=====================
    +
    +If you have multiple versions of your app in use that you want to be
    +able to run side-by-side, then you may want version-isolation for these
    +dirs::
    +
    +    >>> from platformdirs import PlatformDirs
    +    >>> dirs = PlatformDirs("SuperApp", "Acme", version="1.0")
    +    >>> dirs.user_data_dir
    +    '/Users/trentm/Library/Application Support/SuperApp/1.0'
    +    >>> dirs.site_data_dir
    +    '/Library/Application Support/SuperApp/1.0'
    +    >>> dirs.user_cache_dir
    +    '/Users/trentm/Library/Caches/SuperApp/1.0'
    +    >>> dirs.user_log_dir
    +    '/Users/trentm/Library/Logs/SuperApp/1.0'
    +    >>> dirs.user_documents_dir
    +    '/Users/trentm/Documents'
    +    >>> dirs.user_downloads_dir
    +    '/Users/trentm/Downloads'
    +    >>> dirs.user_pictures_dir
    +    '/Users/trentm/Pictures'
    +    >>> dirs.user_videos_dir
    +    '/Users/trentm/Movies'
    +    >>> dirs.user_music_dir
    +    '/Users/trentm/Music'
    +    >>> dirs.user_desktop_dir
    +    '/Users/trentm/Desktop'
    +    >>> dirs.user_runtime_dir
    +    '/Users/trentm/Library/Caches/TemporaryItems/SuperApp/1.0'
    +
    +Be wary of using this for configuration files though; you'll need to handle
    +migrating configuration files manually.
    +
    +Why this Fork?
    +==============
    +
    +This repository is a friendly fork of the wonderful work started by
    +`ActiveState `_ who created
    +``appdirs``, this package's ancestor.
    +
    +Maintaining an open source project is no easy task, particularly
    +from within an organization, and the Python community is indebted
    +to ``appdirs`` (and to Trent Mick and Jeff Rouse in particular) for
    +creating an incredibly useful simple module, as evidenced by the wide
    +number of users it has attracted over the years.
    +
    +Nonetheless, given the number of long-standing open issues
    +and pull requests, and no clear path towards `ensuring
    +that maintenance of the package would continue or grow
    +`_, this fork was
    +created.
    +
    +Contributions are most welcome.
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/RECORD
    new file mode 100644
    index 000000000..684d8271c
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/RECORD
    @@ -0,0 +1,23 @@
    +platformdirs-4.2.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
    +platformdirs-4.2.2.dist-info/METADATA,sha256=zmsie01G1MtXR0wgIv5XpVeTO7idr0WWvfmxKsKWuGk,11429
    +platformdirs-4.2.2.dist-info/RECORD,,
    +platformdirs-4.2.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
    +platformdirs-4.2.2.dist-info/WHEEL,sha256=zEMcRr9Kr03x1ozGwg5v9NQBKn3kndp6LSoSlVg-jhU,87
    +platformdirs-4.2.2.dist-info/licenses/LICENSE,sha256=KeD9YukphQ6G6yjD_czwzv30-pSHkBHP-z0NS-1tTbY,1089
    +platformdirs/__init__.py,sha256=EMGE8qeHRR9CzDFr8kL3tA8hdZZniYjXBVZd0UGTWK0,22225
    +platformdirs/__main__.py,sha256=HnsUQHpiBaiTxwcmwVw-nFaPdVNZtQIdi1eWDtI-MzI,1493
    +platformdirs/__pycache__/__init__.cpython-312.pyc,,
    +platformdirs/__pycache__/__main__.cpython-312.pyc,,
    +platformdirs/__pycache__/android.cpython-312.pyc,,
    +platformdirs/__pycache__/api.cpython-312.pyc,,
    +platformdirs/__pycache__/macos.cpython-312.pyc,,
    +platformdirs/__pycache__/unix.cpython-312.pyc,,
    +platformdirs/__pycache__/version.cpython-312.pyc,,
    +platformdirs/__pycache__/windows.cpython-312.pyc,,
    +platformdirs/android.py,sha256=xZXY9Jd46WOsxT2U6-5HsNtDZ-IQqxcEUrBLl3hYk4o,9016
    +platformdirs/api.py,sha256=QBYdUac2eC521ek_y53uD1Dcq-lJX8IgSRVd4InC6uc,8996
    +platformdirs/macos.py,sha256=wftsbsvq6nZ0WORXSiCrZNkRHz_WKuktl0a6mC7MFkI,5580
    +platformdirs/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
    +platformdirs/unix.py,sha256=Cci9Wqt35dAMsg6HT9nRGHSBW5obb0pR3AE1JJnsCXg,10643
    +platformdirs/version.py,sha256=r7F76tZRjgQKzrpx_I0_ZMQOMU-PS7eGnHD7zEK3KB0,411
    +platformdirs/windows.py,sha256=IFpiohUBwxPtCzlyKwNtxyW4Jk8haa6W8o59mfrDXVo,10125
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/REQUESTED b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/REQUESTED
    new file mode 100644
    index 000000000..e69de29bb
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/WHEEL
    new file mode 100644
    index 000000000..516596c76
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/WHEEL
    @@ -0,0 +1,4 @@
    +Wheel-Version: 1.0
    +Generator: hatchling 1.24.2
    +Root-Is-Purelib: true
    +Tag: py3-none-any
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/licenses/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/licenses/LICENSE
    new file mode 100644
    index 000000000..f35fed919
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs-4.2.2.dist-info/licenses/LICENSE
    @@ -0,0 +1,21 @@
    +MIT License
    +
    +Copyright (c) 2010-202x The platformdirs developers
    +
    +Permission is hereby granted, free of charge, to any person obtaining a copy
    +of this software and associated documentation files (the "Software"), to deal
    +in the Software without restriction, including without limitation the rights
    +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
    +copies of the Software, and to permit persons to whom the Software is
    +furnished to do so, subject to the following conditions:
    +
    +The above copyright notice and this permission notice shall be included in all
    +copies or substantial portions of the Software.
    +
    +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
    +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
    +SOFTWARE.
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__init__.py
    new file mode 100644
    index 000000000..3f7d9490d
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__init__.py
    @@ -0,0 +1,627 @@
    +"""
    +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
    +
    +
    +def _set_platform_dir_class() -> type[PlatformDirsABC]:
    +    if sys.platform == "win32":
    +        from platformdirs.windows import Windows as Result  # noqa: PLC0415
    +    elif sys.platform == "darwin":
    +        from platformdirs.macos import MacOS as Result  # noqa: PLC0415
    +    else:
    +        from platformdirs.unix import Unix as Result  # noqa: PLC0415
    +
    +    if os.getenv("ANDROID_DATA") == "/data" and os.getenv("ANDROID_ROOT") == "/system":
    +        if os.getenv("SHELL") or os.getenv("PREFIX"):
    +            return Result
    +
    +        from platformdirs.android import _android_folder  # noqa: PLC0415
    +
    +        if _android_folder() is not None:
    +            from platformdirs.android import Android  # noqa: PLC0415
    +
    +            return Android  # return to avoid redefinition of a result
    +
    +    return Result
    +
    +
    +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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__main__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__main__.py
    new file mode 100644
    index 000000000..922c52135
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__main__.py
    @@ -0,0 +1,55 @@
    +"""Main entry point."""
    +
    +from __future__ import annotations
    +
    +from platformdirs import PlatformDirs, __version__
    +
    +PROPS = (
    +    "user_data_dir",
    +    "user_config_dir",
    +    "user_cache_dir",
    +    "user_state_dir",
    +    "user_log_dir",
    +    "user_documents_dir",
    +    "user_downloads_dir",
    +    "user_pictures_dir",
    +    "user_videos_dir",
    +    "user_music_dir",
    +    "user_runtime_dir",
    +    "site_data_dir",
    +    "site_config_dir",
    +    "site_cache_dir",
    +    "site_runtime_dir",
    +)
    +
    +
    +def main() -> None:
    +    """Run 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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__pycache__/__init__.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..1f399c27f3654d14af11fa331ecf1b43dc82a162
    GIT binary patch
    literal 19819
    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
    Sdu93o);?W6R1iLs@cji_a2B-y
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__pycache__/android.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__pycache__/android.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..2377d27129068df116e4b9d7b2c923aa4dc30bd5
    GIT binary patch
    literal 10745
    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
    Q?v_2LBjEUJFU`yRA8tDD4*&oF
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__pycache__/api.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/__pycache__/api.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..8c01f0b0b937c2e7f2530cd832f416cac2cdbfbe
    GIT binary patch
    literal 12969
    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
    g7o7N{lk)tj53W7o@V=)
    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%0DYsDeaAMl~b3i3i(T%NZBE&
    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
    MHdUG~*~w`B7ims0;{X5v
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/android.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/android.py
    new file mode 100644
    index 000000000..afd3141c7
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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, PLR0912
    +    """: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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/api.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/api.py
    new file mode 100644
    index 000000000..c50caa648
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/api.py
    @@ -0,0 +1,292 @@
    +"""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)
    +
    +    @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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/macos.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/macos.py
    new file mode 100644
    index 000000000..eb1ba5df1
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/macos.py
    @@ -0,0 +1,130 @@
    +"""macOS."""
    +
    +from __future__ import annotations
    +
    +import os.path
    +import sys
    +
    +from .api import PlatformDirsABC
    +
    +
    +class MacOS(PlatformDirsABC):
    +    """
    +    Platform directories for the macOS operating system.
    +
    +    Follows the guidance from
    +    `Apple documentation `_.
    +    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 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 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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/py.typed b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/py.typed
    new file mode 100644
    index 000000000..e69de29bb
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/unix.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/unix.py
    new file mode 100644
    index 000000000..9500ade61
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/unix.py
    @@ -0,0 +1,275 @@
    +"""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 _first_item_as_path_if_multipath(self, directory: str) -> Path:
    +        if self.multipath:
    +            # If multipath is True, the first path is returned.
    +            directory = directory.split(os.pathsep)[0]
    +        return Path(directory)
    +
    +    def iter_config_dirs(self) -> Iterator[str]:
    +        """:yield: all user and site configuration directories."""
    +        yield self.user_config_dir
    +        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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/version.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/version.py
    new file mode 100644
    index 000000000..6483ddce0
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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.2.2'
    +__version_tuple__ = version_tuple = (4, 2, 2)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/windows.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/platformdirs/windows.py
    new file mode 100644
    index 000000000..d7bc96091
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/INSTALLER
    new file mode 100644
    index 000000000..a1b589e38
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/INSTALLER
    @@ -0,0 +1 @@
    +pip
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/LICENSE
    new file mode 100644
    index 000000000..e859590f8
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/LICENSE
    @@ -0,0 +1,21 @@
    +MIT License
    +
    +Copyright (c) 2021 Taneli Hukkinen
    +
    +Permission is hereby granted, free of charge, to any person obtaining a copy
    +of this software and associated documentation files (the "Software"), to deal
    +in the Software without restriction, including without limitation the rights
    +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
    +copies of the Software, and to permit persons to whom the Software is
    +furnished to do so, subject to the following conditions:
    +
    +The above copyright notice and this permission notice shall be included in all
    +copies or substantial portions of the Software.
    +
    +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
    +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
    +SOFTWARE.
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/METADATA
    new file mode 100644
    index 000000000..efd87ecc1
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/METADATA
    @@ -0,0 +1,206 @@
    +Metadata-Version: 2.1
    +Name: tomli
    +Version: 2.0.1
    +Summary: A lil' TOML parser
    +Keywords: toml
    +Author-email: Taneli Hukkinen 
    +Requires-Python: >=3.7
    +Description-Content-Type: text/markdown
    +Classifier: License :: OSI Approved :: MIT License
    +Classifier: Operating System :: MacOS
    +Classifier: Operating System :: Microsoft :: Windows
    +Classifier: Operating System :: POSIX :: Linux
    +Classifier: Programming Language :: Python :: 3 :: Only
    +Classifier: Programming Language :: Python :: 3.7
    +Classifier: Programming Language :: Python :: 3.8
    +Classifier: Programming Language :: Python :: 3.9
    +Classifier: Programming Language :: Python :: 3.10
    +Classifier: Programming Language :: Python :: Implementation :: CPython
    +Classifier: Programming Language :: Python :: Implementation :: PyPy
    +Classifier: Topic :: Software Development :: Libraries :: Python Modules
    +Classifier: Typing :: Typed
    +Project-URL: Changelog, https://github.com/hukkin/tomli/blob/master/CHANGELOG.md
    +Project-URL: Homepage, https://github.com/hukkin/tomli
    +
    +[![Build Status](https://github.com/hukkin/tomli/workflows/Tests/badge.svg?branch=master)](https://github.com/hukkin/tomli/actions?query=workflow%3ATests+branch%3Amaster+event%3Apush)
    +[![codecov.io](https://codecov.io/gh/hukkin/tomli/branch/master/graph/badge.svg)](https://codecov.io/gh/hukkin/tomli)
    +[![PyPI version](https://img.shields.io/pypi/v/tomli)](https://pypi.org/project/tomli)
    +
    +# Tomli
    +
    +> A lil' TOML parser
    +
    +**Table of Contents**  *generated with [mdformat-toc](https://github.com/hukkin/mdformat-toc)*
    +
    +
    +
    +- [Intro](#intro)
    +- [Installation](#installation)
    +- [Usage](#usage)
    +  - [Parse a TOML string](#parse-a-toml-string)
    +  - [Parse a TOML file](#parse-a-toml-file)
    +  - [Handle invalid TOML](#handle-invalid-toml)
    +  - [Construct `decimal.Decimal`s from TOML floats](#construct-decimaldecimals-from-toml-floats)
    +- [FAQ](#faq)
    +  - [Why this parser?](#why-this-parser)
    +  - [Is comment preserving round-trip parsing supported?](#is-comment-preserving-round-trip-parsing-supported)
    +  - [Is there a `dumps`, `write` or `encode` function?](#is-there-a-dumps-write-or-encode-function)
    +  - [How do TOML types map into Python types?](#how-do-toml-types-map-into-python-types)
    +- [Performance](#performance)
    +
    +
    +
    +## Intro
    +
    +Tomli is a Python library for parsing [TOML](https://toml.io).
    +Tomli is fully compatible with [TOML v1.0.0](https://toml.io/en/v1.0.0).
    +
    +## Installation
    +
    +```bash
    +pip install tomli
    +```
    +
    +## Usage
    +
    +### Parse a TOML string
    +
    +```python
    +import tomli
    +
    +toml_str = """
    +           gretzky = 99
    +
    +           [kurri]
    +           jari = 17
    +           """
    +
    +toml_dict = tomli.loads(toml_str)
    +assert toml_dict == {"gretzky": 99, "kurri": {"jari": 17}}
    +```
    +
    +### Parse a TOML file
    +
    +```python
    +import tomli
    +
    +with open("path_to_file/conf.toml", "rb") as f:
    +    toml_dict = tomli.load(f)
    +```
    +
    +The file must be opened in binary mode (with the `"rb"` flag).
    +Binary mode will enforce decoding the file as UTF-8 with universal newlines disabled,
    +both of which are required to correctly parse TOML.
    +
    +### Handle invalid TOML
    +
    +```python
    +import tomli
    +
    +try:
    +    toml_dict = tomli.loads("]] this is invalid TOML [[")
    +except tomli.TOMLDecodeError:
    +    print("Yep, definitely not valid.")
    +```
    +
    +Note that error messages are considered informational only.
    +They should not be assumed to stay constant across Tomli versions.
    +
    +### Construct `decimal.Decimal`s from TOML floats
    +
    +```python
    +from decimal import Decimal
    +import tomli
    +
    +toml_dict = tomli.loads("precision-matters = 0.982492", parse_float=Decimal)
    +assert toml_dict["precision-matters"] == Decimal("0.982492")
    +```
    +
    +Note that `decimal.Decimal` can be replaced with another callable that converts a TOML float from string to a Python type.
    +The `decimal.Decimal` is, however, a practical choice for use cases where float inaccuracies can not be tolerated.
    +
    +Illegal types are `dict` and `list`, and their subtypes.
    +A `ValueError` will be raised if `parse_float` produces illegal types.
    +
    +## FAQ
    +
    +### Why this parser?
    +
    +- it's lil'
    +- pure Python with zero dependencies
    +- the fastest pure Python parser [\*](#performance):
    +  15x as fast as [tomlkit](https://pypi.org/project/tomlkit/),
    +  2.4x as fast as [toml](https://pypi.org/project/toml/)
    +- outputs [basic data types](#how-do-toml-types-map-into-python-types) only
    +- 100% spec compliant: passes all tests in
    +  [a test set](https://github.com/toml-lang/compliance/pull/8)
    +  soon to be merged to the official
    +  [compliance tests for TOML](https://github.com/toml-lang/compliance)
    +  repository
    +- thoroughly tested: 100% branch coverage
    +
    +### Is comment preserving round-trip parsing supported?
    +
    +No.
    +
    +The `tomli.loads` function returns a plain `dict` that is populated with builtin types and types from the standard library only.
    +Preserving comments requires a custom type to be returned so will not be supported,
    +at least not by the `tomli.loads` and `tomli.load` functions.
    +
    +Look into [TOML Kit](https://github.com/sdispater/tomlkit) if preservation of style is what you need.
    +
    +### Is there a `dumps`, `write` or `encode` function?
    +
    +[Tomli-W](https://github.com/hukkin/tomli-w) is the write-only counterpart of Tomli, providing `dump` and `dumps` functions.
    +
    +The core library does not include write capability, as most TOML use cases are read-only, and Tomli intends to be minimal.
    +
    +### How do TOML types map into Python types?
    +
    +| TOML type        | Python type         | Details                                                      |
    +| ---------------- | ------------------- | ------------------------------------------------------------ |
    +| Document Root    | `dict`              |                                                              |
    +| Key              | `str`               |                                                              |
    +| String           | `str`               |                                                              |
    +| Integer          | `int`               |                                                              |
    +| Float            | `float`             |                                                              |
    +| Boolean          | `bool`              |                                                              |
    +| Offset Date-Time | `datetime.datetime` | `tzinfo` attribute set to an instance of `datetime.timezone` |
    +| Local Date-Time  | `datetime.datetime` | `tzinfo` attribute set to `None`                             |
    +| Local Date       | `datetime.date`     |                                                              |
    +| Local Time       | `datetime.time`     |                                                              |
    +| Array            | `list`              |                                                              |
    +| Table            | `dict`              |                                                              |
    +| Inline Table     | `dict`              |                                                              |
    +
    +## Performance
    +
    +The `benchmark/` folder in this repository contains a performance benchmark for comparing the various Python TOML parsers.
    +The benchmark can be run with `tox -e benchmark-pypi`.
    +Running the benchmark on my personal computer output the following:
    +
    +```console
    +foo@bar:~/dev/tomli$ tox -e benchmark-pypi
    +benchmark-pypi installed: attrs==19.3.0,click==7.1.2,pytomlpp==1.0.2,qtoml==0.3.0,rtoml==0.7.0,toml==0.10.2,tomli==1.1.0,tomlkit==0.7.2
    +benchmark-pypi run-test-pre: PYTHONHASHSEED='2658546909'
    +benchmark-pypi run-test: commands[0] | python -c 'import datetime; print(datetime.date.today())'
    +2021-07-23
    +benchmark-pypi run-test: commands[1] | python --version
    +Python 3.8.10
    +benchmark-pypi run-test: commands[2] | python benchmark/run.py
    +Parsing data.toml 5000 times:
    +------------------------------------------------------
    +    parser |  exec time | performance (more is better)
    +-----------+------------+-----------------------------
    +     rtoml |    0.901 s | baseline (100%)
    +  pytomlpp |     1.08 s | 83.15%
    +     tomli |     3.89 s | 23.15%
    +      toml |     9.36 s | 9.63%
    +     qtoml |     11.5 s | 7.82%
    +   tomlkit |     56.8 s | 1.59%
    +```
    +
    +The parsers are ordered from fastest to slowest, using the fastest parser as baseline.
    +Tomli performed the best out of all pure Python TOML parsers,
    +losing only to pytomlpp (wraps C++) and rtoml (wraps Rust).
    +
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/RECORD
    new file mode 100644
    index 000000000..6cbc2b0cf
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/RECORD
    @@ -0,0 +1,15 @@
    +tomli-2.0.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
    +tomli-2.0.1.dist-info/LICENSE,sha256=uAgWsNUwuKzLTCIReDeQmEpuO2GSLCte6S8zcqsnQv4,1072
    +tomli-2.0.1.dist-info/METADATA,sha256=zPDceKmPwJGLWtZykrHixL7WVXWmJGzZ1jyRT5lCoPI,8875
    +tomli-2.0.1.dist-info/RECORD,,
    +tomli-2.0.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
    +tomli-2.0.1.dist-info/WHEEL,sha256=jPMR_Dzkc4X4icQtmz81lnNY_kAsfog7ry7qoRvYLXw,81
    +tomli/__init__.py,sha256=JhUwV66DB1g4Hvt1UQCVMdfCu-IgAV8FXmvDU9onxd4,396
    +tomli/__pycache__/__init__.cpython-312.pyc,,
    +tomli/__pycache__/_parser.cpython-312.pyc,,
    +tomli/__pycache__/_re.cpython-312.pyc,,
    +tomli/__pycache__/_types.cpython-312.pyc,,
    +tomli/_parser.py,sha256=g9-ENaALS-B8dokYpCuzUFalWlog7T-SIYMjLZSWrtM,22633
    +tomli/_re.py,sha256=dbjg5ChZT23Ka9z9DHOXfdtSpPwUfdgMXnj8NOoly-w,2943
    +tomli/_types.py,sha256=-GTG2VUqkpxwMqzmVO4F7ybKddIbAnuAHXfmWQcTi3Q,254
    +tomli/py.typed,sha256=8PjyZ1aVoQpRVvt71muvuq5qE-jTFZkK-GLHkhdebmc,26
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/REQUESTED b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/REQUESTED
    new file mode 100644
    index 000000000..e69de29bb
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/WHEEL
    new file mode 100644
    index 000000000..c727d1482
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli-2.0.1.dist-info/WHEEL
    @@ -0,0 +1,4 @@
    +Wheel-Version: 1.0
    +Generator: flit 3.6.0
    +Root-Is-Purelib: true
    +Tag: py3-none-any
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/__init__.py
    new file mode 100644
    index 000000000..4c6ec97ec
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/__init__.py
    @@ -0,0 +1,11 @@
    +# SPDX-License-Identifier: MIT
    +# SPDX-FileCopyrightText: 2021 Taneli Hukkinen
    +# Licensed to PSF under a Contributor Agreement.
    +
    +__all__ = ("loads", "load", "TOMLDecodeError")
    +__version__ = "2.0.1"  # DO NOT EDIT THIS LINE MANUALLY. LET bump2version UTILITY DO IT
    +
    +from ._parser import TOMLDecodeError, load, loads
    +
    +# Pretend this exception was created here.
    +TOMLDecodeError.__module__ = __name__
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/__pycache__/__init__.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..0a7f2d82b13f05e5215686dc7d94a84941cc3bdb
    GIT binary patch
    literal 423
    zcmZ9HF;Buk6vwYz3j_ov7Y7p;lMeJOuEq&WOazHKb$L0si&U?@=6V?GM4a9I41NZ8
    z7bgc3)78Pak+3m&4dUP%-uu1e{onh)*G8j;OuRhP$%BQ^XVI*q^a~5mz$0QPK+Fm(
    zR$^F`A{^kz4(!MY91HO>$52@dGuw4soI65NmgaU*^47&^|D?;ulJTBWQr$TnZ_o3;
    z%~9lHWt*aKk&3GWx0+V~s1N{o9pHwmG?cMvDv(f>a`jJ;R{>%gaWhc^h$Nc|!%t{o
    zmZ9Z6naGF}D)=qwXG0~g_*kc;cRp+njGq-9caPvqj-)1fs-+64Al@H|a72_9h2tR
    hvaERx)yb^#(cGNXzmWfi{COE|@6KB9XiIIFsUIWjc7p%_
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/__pycache__/_parser.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/__pycache__/_parser.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..dd80a7aa9ed34e5e1d2cfe2269a74c7596609925
    GIT binary patch
    literal 26966
    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
    OWBQmUA&%Ka{rMk$&6YR-
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/__pycache__/_types.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/__pycache__/_types.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..7764d4dc542eeb08132fbf9911c2fd3c2c1185cd
    GIT binary patch
    literal 405
    zcmX|*u}%U(5QcYe;RFm?n3z~vDFtlM&KMJe5{;1%vATvV+z5wzx0l_;cpY?<*Xb+x
    z4E8owbmUqqI}!>L3gccxCz*e~N#>uK_hPYtOuW6a{A*Vr<YiTFjHtbqJ7~5WgH&q
    zb<~t%09~!;y#%blBxYwa!r28T`tW*!E@-&n~*1cyv
    z<5r-Dp%#KG+J1n*6_RSYF2-U+W_Er|WYM^O0LAlk>i_@%
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/_parser.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/_parser.py
    new file mode 100644
    index 000000000..f1bb0aa19
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/_parser.py
    @@ -0,0 +1,691 @@
    +# 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
    +from types import MappingProxyType
    +from typing import Any, BinaryIO, NamedTuple
    +
    +from ._re import (
    +    RE_DATETIME,
    +    RE_LOCALTIME,
    +    RE_NUMBER,
    +    match_to_datetime,
    +    match_to_localtime,
    +    match_to_number,
    +)
    +from ._types import Key, ParseFloat, Pos
    +
    +ASCII_CTRL = 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 = ASCII_CTRL - frozenset("\t")
    +ILLEGAL_MULTILINE_BASIC_STR_CHARS = ASCII_CTRL - frozenset("\t\n")
    +
    +ILLEGAL_LITERAL_STR_CHARS = ILLEGAL_BASIC_STR_CHARS
    +ILLEGAL_MULTILINE_LITERAL_STR_CHARS = ILLEGAL_MULTILINE_BASIC_STR_CHARS
    +
    +ILLEGAL_COMMENT_CHARS = ILLEGAL_BASIC_STR_CHARS
    +
    +TOML_WS = frozenset(" \t")
    +TOML_WS_AND_NEWLINE = TOML_WS | frozenset("\n")
    +BARE_KEY_CHARS = frozenset(string.ascii_letters + string.digits + "-_")
    +KEY_INITIAL_CHARS = BARE_KEY_CHARS | frozenset("\"'")
    +HEXDIGIT_CHARS = frozenset(string.hexdigits)
    +
    +BASIC_STR_ESCAPE_REPLACEMENTS = MappingProxyType(
    +    {
    +        "\\b": "\u0008",  # backspace
    +        "\\t": "\u0009",  # tab
    +        "\\n": "\u000A",  # linefeed
    +        "\\f": "\u000C",  # form feed
    +        "\\r": "\u000D",  # carriage return
    +        '\\"': "\u0022",  # quote
    +        "\\\\": "\u005C",  # backslash
    +    }
    +)
    +
    +
    +class TOMLDecodeError(ValueError):
    +    """An error raised if a document is not valid TOML."""
    +
    +
    +def load(__fp: BinaryIO, *, 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.
    +    src = __s.replace("\r\n", "\n")
    +    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 suffixed_err(src, pos, "Invalid statement")
    +
    +        # 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 suffixed_err(
    +                src, pos, "Expected newline or end of document after a statement"
    +            )
    +        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 = 0
    +    # Marks a nest that has been explicitly created and can no longer
    +    # be opened using the "[table]" syntax.
    +    EXPLICIT_NEST = 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:
    +            cont = cont[key_stem]
    +            return flag in cont["flags"] or flag in 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 suffixed_err(src, new_pos, f"Expected {expect!r}") from None
    +
    +    if not error_on.isdisjoint(src[pos:new_pos]):
    +        while src[pos] not in error_on:
    +            pos += 1
    +        raise suffixed_err(src, pos, f"Found invalid character {src[pos]!r}")
    +    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 suffixed_err(src, pos, f"Cannot declare {key} twice")
    +    out.flags.set(key, Flags.EXPLICIT_NEST, recursive=False)
    +    try:
    +        out.data.get_or_create_nest(key)
    +    except KeyError:
    +        raise suffixed_err(src, pos, "Cannot overwrite a value") from None
    +
    +    if not src.startswith("]", pos):
    +        raise suffixed_err(src, pos, "Expected ']' at the end of a table declaration")
    +    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 suffixed_err(src, pos, f"Cannot mutate immutable namespace {key}")
    +    # 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 suffixed_err(src, pos, "Cannot overwrite a value") from None
    +
    +    if not src.startswith("]]", pos):
    +        raise suffixed_err(src, pos, "Expected ']]' at the end of an array declaration")
    +    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)
    +    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 suffixed_err(src, pos, f"Cannot redefine namespace {cont_key}")
    +        # 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 suffixed_err(
    +            src, pos, f"Cannot mutate immutable namespace {abs_key_parent}"
    +        )
    +
    +    try:
    +        nest = out.data.get_or_create_nest(abs_key_parent)
    +    except KeyError:
    +        raise suffixed_err(src, pos, "Cannot overwrite a value") from None
    +    if key_stem in nest:
    +        raise suffixed_err(src, pos, "Cannot overwrite a value")
    +    # 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
    +) -> tuple[Pos, Key, Any]:
    +    pos, key = parse_key(src, pos)
    +    try:
    +        char: str | None = src[pos]
    +    except IndexError:
    +        char = None
    +    if char != "=":
    +        raise suffixed_err(src, pos, "Expected '=' after a key in a key/value pair")
    +    pos += 1
    +    pos = skip_chars(src, pos, TOML_WS)
    +    pos, value = parse_value(src, pos, parse_float)
    +    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 suffixed_err(src, pos, "Invalid initial character for a key part")
    +
    +
    +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) -> 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)
    +        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 suffixed_err(src, pos, "Unclosed array")
    +        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) -> 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)
    +        key_parent, key_stem = key[:-1], key[-1]
    +        if flags.is_(key, Flags.FROZEN):
    +            raise suffixed_err(src, pos, f"Cannot mutate immutable namespace {key}")
    +        try:
    +            nest = nested_dict.get_or_create_nest(key_parent, access_lists=False)
    +        except KeyError:
    +            raise suffixed_err(src, pos, "Cannot overwrite a value") from None
    +        if key_stem in nest:
    +            raise suffixed_err(src, pos, f"Duplicate inline table key {key_stem!r}")
    +        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 suffixed_err(src, pos, "Unclosed inline table")
    +        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 suffixed_err(src, pos, "Unescaped '\\' in a string")
    +            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 suffixed_err(src, pos, "Unescaped '\\' in a string") 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 suffixed_err(src, pos, "Invalid hex value")
    +    pos += hex_len
    +    hex_int = int(hex_str, 16)
    +    if not is_unicode_scalar_value(hex_int):
    +        raise suffixed_err(src, pos, "Escaped character is not a Unicode scalar value")
    +    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 suffixed_err(src, pos, "Unterminated string") 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 suffixed_err(src, pos, f"Illegal character {char!r}")
    +        pos += 1
    +
    +
    +def parse_value(  # noqa: C901
    +    src: str, pos: Pos, parse_float: ParseFloat
    +) -> tuple[Pos, Any]:
    +    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)
    +
    +    # Inline tables
    +    if char == "{":
    +        return parse_inline_table(src, pos, parse_float)
    +
    +    # 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 suffixed_err(src, pos, "Invalid date or datetime") 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 suffixed_err(src, pos, "Invalid value")
    +
    +
    +def suffixed_err(src: str, pos: Pos, msg: str) -> TOMLDecodeError:
    +    """Return a `TOMLDecodeError` where error message is suffixed with
    +    coordinates in source."""
    +
    +    def coord_repr(src: str, pos: Pos) -> str:
    +        if pos >= len(src):
    +            return "end of document"
    +        line = src.count("\n", 0, pos) + 1
    +        if line == 1:
    +            column = pos + 1
    +        else:
    +            column = pos - src.rindex("\n", 0, pos)
    +        return f"line {line}, column {column}"
    +
    +    return TOMLDecodeError(f"{msg} (at {coord_repr(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:  # type: ignore[comparison-overlap]
    +        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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/_re.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/_re.py
    new file mode 100644
    index 000000000..994bb7493
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/_re.py
    @@ -0,0 +1,107 @@
    +# 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
    +
    +from ._types import ParseFloat
    +
    +# E.g.
    +# - 00:32:00.999999
    +# - 00:32:00
    +_TIME_RE_STR = r"([01][0-9]|2[0-3]):([0-5][0-9]):([0-5][0-9])(?:\.([0-9]{1,6})[0-9]*)?"
    +
    +RE_NUMBER = 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 = re.compile(_TIME_RE_STR)
    +RE_DATETIME = 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)
    +
    +
    +@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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/_types.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/_types.py
    new file mode 100644
    index 000000000..d949412e0
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/py.typed b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/py.typed
    new file mode 100644
    index 000000000..7632ecf77
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/tomli/py.typed
    @@ -0,0 +1 @@
    +# Marker file for PEP 561
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/INSTALLER
    new file mode 100644
    index 000000000..a1b589e38
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/INSTALLER
    @@ -0,0 +1 @@
    +pip
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/LICENSE
    new file mode 100644
    index 000000000..07806f8af
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/LICENSE
    @@ -0,0 +1,19 @@
    +This is the MIT license: http://www.opensource.org/licenses/mit-license.php
    +
    +Copyright (c) Alex Grönholm
    +
    +Permission is hereby granted, free of charge, to any person obtaining a copy of this
    +software and associated documentation files (the "Software"), to deal in the Software
    +without restriction, including without limitation the rights to use, copy, modify, merge,
    +publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons
    +to whom the Software is furnished to do so, subject to the following conditions:
    +
    +The above copyright notice and this permission notice shall be included in all copies or
    +substantial portions of the Software.
    +
    +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
    +INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
    +PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
    +FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
    +OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
    +DEALINGS IN THE SOFTWARE.
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/METADATA
    new file mode 100644
    index 000000000..6e5750b48
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/METADATA
    @@ -0,0 +1,81 @@
    +Metadata-Version: 2.1
    +Name: typeguard
    +Version: 4.3.0
    +Summary: Run-time type checker for Python
    +Author-email: Alex Grönholm 
    +License: MIT
    +Project-URL: Documentation, https://typeguard.readthedocs.io/en/latest/
    +Project-URL: Change log, https://typeguard.readthedocs.io/en/latest/versionhistory.html
    +Project-URL: Source code, https://github.com/agronholm/typeguard
    +Project-URL: Issue tracker, https://github.com/agronholm/typeguard/issues
    +Classifier: Development Status :: 5 - Production/Stable
    +Classifier: Intended Audience :: Developers
    +Classifier: License :: OSI Approved :: MIT License
    +Classifier: Programming Language :: Python
    +Classifier: Programming Language :: Python :: 3
    +Classifier: Programming Language :: Python :: 3.8
    +Classifier: Programming Language :: Python :: 3.9
    +Classifier: Programming Language :: Python :: 3.10
    +Classifier: Programming Language :: Python :: 3.11
    +Classifier: Programming Language :: Python :: 3.12
    +Requires-Python: >=3.8
    +Description-Content-Type: text/x-rst
    +License-File: LICENSE
    +Requires-Dist: typing-extensions >=4.10.0
    +Requires-Dist: importlib-metadata >=3.6 ; python_version < "3.10"
    +Provides-Extra: doc
    +Requires-Dist: packaging ; extra == 'doc'
    +Requires-Dist: Sphinx >=7 ; extra == 'doc'
    +Requires-Dist: sphinx-autodoc-typehints >=1.2.0 ; extra == 'doc'
    +Requires-Dist: sphinx-rtd-theme >=1.3.0 ; extra == 'doc'
    +Provides-Extra: test
    +Requires-Dist: coverage[toml] >=7 ; extra == 'test'
    +Requires-Dist: pytest >=7 ; extra == 'test'
    +Requires-Dist: mypy >=1.2.0 ; (platform_python_implementation != "PyPy") and extra == 'test'
    +
    +.. image:: https://github.com/agronholm/typeguard/actions/workflows/test.yml/badge.svg
    +  :target: https://github.com/agronholm/typeguard/actions/workflows/test.yml
    +  :alt: Build Status
    +.. image:: https://coveralls.io/repos/agronholm/typeguard/badge.svg?branch=master&service=github
    +  :target: https://coveralls.io/github/agronholm/typeguard?branch=master
    +  :alt: Code Coverage
    +.. image:: https://readthedocs.org/projects/typeguard/badge/?version=latest
    +  :target: https://typeguard.readthedocs.io/en/latest/?badge=latest
    +  :alt: Documentation
    +
    +This library provides run-time type checking for functions defined with
    +`PEP 484 `_ argument (and return) type
    +annotations, and any arbitrary objects. It can be used together with static type
    +checkers as an additional layer of type safety, to catch type violations that could only
    +be detected at run time.
    +
    +Two principal ways to do type checking are provided:
    +
    +#. The ``check_type`` function:
    +
    +   * like ``isinstance()``, but supports arbitrary type annotations (within limits)
    +   * can be used as a ``cast()`` replacement, but with actual checking of the value
    +#. Code instrumentation:
    +
    +   * entire modules, or individual functions (via ``@typechecked``) are recompiled, with
    +     type checking code injected into them
    +   * automatically checks function arguments, return values and assignments to annotated
    +     local variables
    +   * for generator functions (regular and async), checks yield and send values
    +   * requires the original source code of the instrumented module(s) to be accessible
    +
    +Two options are provided for code instrumentation:
    +
    +#. the ``@typechecked`` function:
    +
    +   * can be applied to functions individually
    +#. the import hook (``typeguard.install_import_hook()``):
    +
    +   * automatically instruments targeted modules on import
    +   * no manual code changes required in the target modules
    +   * requires the import hook to be installed before the targeted modules are imported
    +   * may clash with other import hooks
    +
    +See the documentation_ for further information.
    +
    +.. _documentation: https://typeguard.readthedocs.io/en/latest/
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/RECORD
    new file mode 100644
    index 000000000..b270d2850
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/RECORD
    @@ -0,0 +1,34 @@
    +typeguard-4.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
    +typeguard-4.3.0.dist-info/LICENSE,sha256=YWP3mH37ONa8MgzitwsvArhivEESZRbVUu8c1DJH51g,1130
    +typeguard-4.3.0.dist-info/METADATA,sha256=z2dcHAp0TwhYCFU5Deh8x31nazElgujUz9tbuP0pjSE,3717
    +typeguard-4.3.0.dist-info/RECORD,,
    +typeguard-4.3.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
    +typeguard-4.3.0.dist-info/entry_points.txt,sha256=qp7NQ1aLtiSgMQqo6gWlfGpy0IIXzoMJmeQTLpzqFZQ,48
    +typeguard-4.3.0.dist-info/top_level.txt,sha256=4z28AhuDodwRS_c1J_l8H51t5QuwfTseskYzlxp6grs,10
    +typeguard/__init__.py,sha256=Onh4w38elPCjtlcU3JY9k3h70NjsxXIkAflmQn-Z0FY,2071
    +typeguard/__pycache__/__init__.cpython-312.pyc,,
    +typeguard/__pycache__/_checkers.cpython-312.pyc,,
    +typeguard/__pycache__/_config.cpython-312.pyc,,
    +typeguard/__pycache__/_decorators.cpython-312.pyc,,
    +typeguard/__pycache__/_exceptions.cpython-312.pyc,,
    +typeguard/__pycache__/_functions.cpython-312.pyc,,
    +typeguard/__pycache__/_importhook.cpython-312.pyc,,
    +typeguard/__pycache__/_memo.cpython-312.pyc,,
    +typeguard/__pycache__/_pytest_plugin.cpython-312.pyc,,
    +typeguard/__pycache__/_suppression.cpython-312.pyc,,
    +typeguard/__pycache__/_transformer.cpython-312.pyc,,
    +typeguard/__pycache__/_union_transformer.cpython-312.pyc,,
    +typeguard/__pycache__/_utils.cpython-312.pyc,,
    +typeguard/_checkers.py,sha256=JRrgKicdOEfIBoNEtegYCEIlhpad-a1u1Em7GCj0WCI,31360
    +typeguard/_config.py,sha256=nIz8QwDa-oFO3L9O8_6srzlmd99pSby2wOM4Wb7F_B0,2846
    +typeguard/_decorators.py,sha256=v6dsIeWvPhExGLP_wXF-RmDUyjZf_Ak28g7gBJ_v0-0,9033
    +typeguard/_exceptions.py,sha256=ZIPeiV-FBd5Emw2EaWd2Fvlsrwi4ocwT2fVGBIAtHcQ,1121
    +typeguard/_functions.py,sha256=ibgSAKa5ptIm1eR9ARG0BSozAFJPFNASZqhPVyQeqig,10393
    +typeguard/_importhook.py,sha256=ugjCDvFcdWMU7UugqlJG91IpVNpEIxtRr-99s0h1k7M,6389
    +typeguard/_memo.py,sha256=1juQV_vxnD2JYKbSrebiQuj4oKHz6n67v9pYA-CCISg,1303
    +typeguard/_pytest_plugin.py,sha256=-fcSqkv54rIfIF8pDavY5YQPkj4OX8GMt_lL7CQSD4I,4416
    +typeguard/_suppression.py,sha256=VQfzxcwIbu3if0f7VBkKM7hkYOA7tNFw9a7jMBsmMg4,2266
    +typeguard/_transformer.py,sha256=9Ha7_QhdwoUni_6hvdY-hZbuEergowHrNL2vzHIakFY,44937
    +typeguard/_union_transformer.py,sha256=v_42r7-6HuRX2SoFwnyJ-E5PlxXpVeUJPJR1-HU9qSo,1354
    +typeguard/_utils.py,sha256=5HhO1rPn5f1M6ymkVAEv7Xmlz1cX-j0OnTMlyHqqrR8,5270
    +typeguard/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/WHEEL
    new file mode 100644
    index 000000000..bab98d675
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/WHEEL
    @@ -0,0 +1,5 @@
    +Wheel-Version: 1.0
    +Generator: bdist_wheel (0.43.0)
    +Root-Is-Purelib: true
    +Tag: py3-none-any
    +
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/entry_points.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/entry_points.txt
    new file mode 100644
    index 000000000..47c9d0bd9
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/entry_points.txt
    @@ -0,0 +1,2 @@
    +[pytest11]
    +typeguard = typeguard._pytest_plugin
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/top_level.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/top_level.txt
    new file mode 100644
    index 000000000..be5ec23ea
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard-4.3.0.dist-info/top_level.txt
    @@ -0,0 +1 @@
    +typeguard
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__init__.py
    new file mode 100644
    index 000000000..6781cad09
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__init__.py
    @@ -0,0 +1,48 @@
    +import os
    +from typing import Any
    +
    +from ._checkers import TypeCheckerCallable as TypeCheckerCallable
    +from ._checkers import TypeCheckLookupCallback as TypeCheckLookupCallback
    +from ._checkers import check_type_internal as check_type_internal
    +from ._checkers import checker_lookup_functions as checker_lookup_functions
    +from ._checkers import load_plugins as load_plugins
    +from ._config import CollectionCheckStrategy as CollectionCheckStrategy
    +from ._config import ForwardRefPolicy as ForwardRefPolicy
    +from ._config import TypeCheckConfiguration as TypeCheckConfiguration
    +from ._decorators import typechecked as typechecked
    +from ._decorators import typeguard_ignore as typeguard_ignore
    +from ._exceptions import InstrumentationWarning as InstrumentationWarning
    +from ._exceptions import TypeCheckError as TypeCheckError
    +from ._exceptions import TypeCheckWarning as TypeCheckWarning
    +from ._exceptions import TypeHintWarning as TypeHintWarning
    +from ._functions import TypeCheckFailCallback as TypeCheckFailCallback
    +from ._functions import check_type as check_type
    +from ._functions import warn_on_error as warn_on_error
    +from ._importhook import ImportHookManager as ImportHookManager
    +from ._importhook import TypeguardFinder as TypeguardFinder
    +from ._importhook import install_import_hook as install_import_hook
    +from ._memo import TypeCheckMemo as TypeCheckMemo
    +from ._suppression import suppress_type_checks as suppress_type_checks
    +from ._utils import Unset as Unset
    +
    +# Re-export imports so they look like they live directly in this package
    +for value in list(locals().values()):
    +    if getattr(value, "__module__", "").startswith(f"{__name__}."):
    +        value.__module__ = __name__
    +
    +
    +config: TypeCheckConfiguration
    +
    +
    +def __getattr__(name: str) -> Any:
    +    if name == "config":
    +        from ._config import global_config
    +
    +        return global_config
    +
    +    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
    +
    +
    +# Automatically load checker lookup functions unless explicitly disabled
    +if "TYPEGUARD_DISABLE_PLUGIN_AUTOLOAD" not in os.environ:
    +    load_plugins()
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/__init__.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..c88b97f0e64b32a084d455558877a07ba29c3ac0
    GIT binary patch
    literal 2118
    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
    E1>=Q2+n{
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_config.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_config.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..0d31bd8eca2d8b8f31c1c720a6dec53ea7168a86
    GIT binary patch
    literal 3892
    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
    F{{uLUGs*w}
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_decorators.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_decorators.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..db1e481ac84d640fdacfcd31c91e3c7062a47ceb
    GIT binary patch
    literal 10621
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_exceptions.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_exceptions.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..f236236eae3c31a9f239d30381ed5d1e5dd66c76
    GIT binary patch
    literal 2799
    zcmbtWO>7fK6rNr0+H1$*r*0EMi&(;6T?xBwDpi82>Q6$;ffSKesP194*&W9l*1KkA
    z4A{+qL!^>Qh;XQqo{H295f_juwNfuV_0kIwMWrh^wU^#P9R%Xk_hxOAM5YKa(!P27
    zX5QO*?|bjf{?^~0AuxXZ*{;|cA%EdZXXtIFC4gBVE^!r~RF#sVAg}srHBm|^L?s^)
    zH!(|GjcQjDu}(>sQXQnpHPWP%ra)?}k*1_H4bluXx)#!nzI^r{G?!N*-KD4M6q!+E
    zocJp-RoXADEx;@gN=k}LN~)`r5)CzL&zIi5oH$}x3
    zrpHZM^@O0Vd8R@G(>4XDnHA78y};yxfvQ;!S=DsHy6>7nD9lM}GRi~$G-!!XnzcdI
    z5p~;_`UNQ)&ufukS%F=pmK9|zs~Wm>ANj0hor1mXm6T<IhyOn>co0JalQy9T`1r9SI}I6-p(jj+Zm>i23bBz^Qi;u(GIY(-b95m3b5K{jfImwt(s>%0T6a|vHWba
    zTn`*Hf|a-?1$aS*{`s(FFMxL}hhzXq5Ab&OcBKm;s<9y?vMRPCw*yVBfng^Kk>H0O
    z!*JpWFyPL0FhG}`=L7KK>4hgccM-W7drxMF)k#PwO9@?GV=uz0EC+^*k#5y&
    zQF#)YgX_KSqKF~qh~m0J{N31fXV<>(2hVF4G7{b>MIlWgtD_`?PRfGu-syJ`EG@u!
    zr(xbWrn^2oURmF8V$W2D4Ju07wHh?)yvneA*t7pS-69`X72Q?<1Q3o%Z@up^mW%H3@G7KW5j|{Rl9eM$K86=Trvnife
    zWVB@sx8n>KHMBI#Y7T6OZCkz%l=)#G5YN8N7Y}}Y@OEx!;n1Z+i{iWHx6PZm*RD(~
    z=U)F|$c&
    zamMH2d#r%u6(k$`&M*p*Y=?)B0D<;@PgQke#ZdM9<-~mg(~61y3
    Y{!8SCCBOJZo8O}Bo&Wqkfk_(w50eOZ2mk;8
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_functions.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_functions.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..1d9dd2486238dc4e698e87c50c0f28780f71858c
    GIT binary patch
    literal 12305
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_importhook.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_importhook.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..ad22f9b4bdc3edfa3758cad28c49fde542fb7372
    GIT binary patch
    literal 9198
    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
    bdByX*AJN_~XzN#W@K
    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
    DINr0%
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_suppression.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_suppression.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..20eba754146bb06db9c16158094b71bcce847a65
    GIT binary patch
    literal 3484
    zcmcImU2I%O6`r|w@BaVTv12DGBon)iz0GE~X;TbVDQwde0j*_W3+R?;J-&DB-TMBl
    z=HAU_EeBa`By1X?N)@CMNXD_)2{+P8*5txZgnZAn+15+5)IF
    zz%oY0NL~(gIfKCIF;d$(F=X_{koXw~jPzx#G}u(KeRqY9EcO%BwjGapRmXNGvx*-*
    zOHGr`naq!Uh1rZ#&*31J)*ahp7d?yGbb(1uy=G94l^dMaYLXLr!O<79s-HgFmVL1;
    z>qlmqHTF%){it(+anqqjR=F$EaaUvul*gthr`B|h={}zF@r>SyfG|;hAdI&{Kwd>n
    zbRAD#7pp?^bz66ZD7pXrLdCIIftu`M;l<_@cV1z-=N8UQPo0`{4A!Q;`rPy7Z#Z*~
    zSMciKRh62Be3vq-bA?*dt2p+P`O{An+^WY;)u_G*-ns>sdG(s-IHp@DUtqT3@PY?E
    zEz~JD3T3xmt8wPK5W;+|>GucYvXCk36{at`d;shee^-NM1>Jo1+!hc>7tQu>hpYSm
    zO!2;MGbpHoq7kZOa|DP$=b3RXBzA;PL`~}aHW1$vz*kq%JT~y<$fiyE98=I
    zRhTWU*mv_BnGjx0%u0Wyf>}as1O81y0eu$ur$bblQd!k@JzlpM95JIC4wtx#)f(|C
    zj8NUH)7=pyGZp4SMB9fgaN8w1waFZldTr){#!jqvS={wCw>LWkvJ!X?7BwnWlSxCm
    zsj9ki175f7ZQ0zOVbZ8V(&1cyUywST5!-=$@_j6(zyueo7odX}fn3KpX2@NFT_MXL
    zxpU8F9Z2ymz(_H#!WlJAxpba&0-y%~7Ck%<=$N=x#B=aNd=+`!*{6Wzb?}YgnOI68
    zL@`{{@Oyy!HDyKl8hRDSkb>5fWmJWe@DBa~{uDiMIQQzAM#Jbda&be!=q1=0qbvD~
    z>Px7Bck`!Fz<=018hiF=bab^fURNgXio<_h@egmiw7NH2*@T
    z@M1&sydN~V;Ff!J#%b5dJNi4B^1lu>KlBkf4y()+Q3HN*k5`dgLSFg
    z2R$c#dVHhj+;_zn2b}|9tkF#FR5=wii7B9
    z@nS;zjaH0CS_!S#A8QRpieFS)N8`oQk=9sD(5JQHM56UM!QTVGCj|gM0fk?Ov_Cuq
    z;YCM3Qm#S;^RR$u?g7M=(EwaK!Pxx2f$ryO1M^3~dHz|^$X8B0Uv0=Jy0z53gZ4*@
    zZaoL$?j>mc_P?M4;P_**_tPPfdH{*!LqOu+E|hiX)ktvyuf@Nhz8MALC!u05x)uiN
    z-FQ(`e-Q)fms(MY{91^$G_9D9wBnNPjTFb#)}eUuWTZ6|6ZA=~cqY+$T=K_Nkk5uW
    zfi0H8Q+av7j*CHbD&IbDewagf!foCI?5x5^#Ox#8;_c;0$7VV5pgj*VVUXbwA+O5g
    z%7+BwQE24Boh4*fnQ>H1Jp~OM$$vbN&~jTx;#zL=5Q-*OmhWVaU-|A^bMIx2zn2+a
    zj}F6`jSarhxE6XpI&w2Ju$q=-Nj4<6x}Odz%$KKfWahlIm!AODf$jY}>qqIpd07f|
    zR4g6bse&v^_u8J1?3vq7UG|V4FPG=*5I9yYb8%bws@rt^jP95w6px}F&eJ)aivo&^
    zqRo$Yo?0jsWdQw{e3(R8C}Ziz+HVd#h+I4`ei$xHF^CBjqSoaJ!A?RIEQ-Z))t+~F
    zTCjTCl4Yo{nJwmAo)PjQr5v6q#6<$yRo~8oazFYs6iIcHJ;NUd5pj#VuS2t`VvKL2
    zp^s4fLsYnpMsA}=Z=)k0qB9%l%pEoS2eofQ?R%r~d-dp_LgcTZlYb7SR`u5=SMaS+
    zV)g86FRb7@hmWkIfm@#;KYo549fs>xiTmi>mJ0n%bgnZV?~KPcqiA?^Q~f+1ycs_x
    O`#aiWA8Rm{+5ZndvuPs$
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_transformer.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_transformer.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..5600c60c8a964f39f036a5a3a3c2a3af3bb1c407
    GIT binary patch
    literal 51987
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_union_transformer.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/__pycache__/_union_transformer.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..8173f8c78e52458805c2914b3da72108ed9a44dc
    GIT binary patch
    literal 2444
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_checkers.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_checkers.py
    new file mode 100644
    index 000000000..67dd5ad4d
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_checkers.py
    @@ -0,0 +1,993 @@
    +from __future__ import annotations
    +
    +import collections.abc
    +import inspect
    +import sys
    +import types
    +import typing
    +import warnings
    +from enum import Enum
    +from inspect import Parameter, isclass, isfunction
    +from io import BufferedIOBase, IOBase, RawIOBase, TextIOBase
    +from textwrap import indent
    +from typing import (
    +    IO,
    +    AbstractSet,
    +    Any,
    +    BinaryIO,
    +    Callable,
    +    Dict,
    +    ForwardRef,
    +    List,
    +    Mapping,
    +    MutableMapping,
    +    NewType,
    +    Optional,
    +    Sequence,
    +    Set,
    +    TextIO,
    +    Tuple,
    +    Type,
    +    TypeVar,
    +    Union,
    +)
    +from unittest.mock import Mock
    +from weakref import WeakKeyDictionary
    +
    +try:
    +    import typing_extensions
    +except ImportError:
    +    typing_extensions = None  # type: ignore[assignment]
    +
    +# Must use this because typing.is_typeddict does not recognize
    +# TypedDict from typing_extensions, and as of version 4.12.0
    +# typing_extensions.TypedDict is different from typing.TypedDict
    +# on all versions.
    +from typing_extensions import is_typeddict
    +
    +from ._config import ForwardRefPolicy
    +from ._exceptions import TypeCheckError, TypeHintWarning
    +from ._memo import TypeCheckMemo
    +from ._utils import evaluate_forwardref, get_stacklevel, get_type_name, qualified_name
    +
    +if sys.version_info >= (3, 11):
    +    from typing import (
    +        Annotated,
    +        NotRequired,
    +        TypeAlias,
    +        get_args,
    +        get_origin,
    +    )
    +
    +    SubclassableAny = Any
    +else:
    +    from typing_extensions import (
    +        Annotated,
    +        NotRequired,
    +        TypeAlias,
    +        get_args,
    +        get_origin,
    +    )
    +    from typing_extensions import Any as SubclassableAny
    +
    +if sys.version_info >= (3, 10):
    +    from importlib.metadata import entry_points
    +    from typing import ParamSpec
    +else:
    +    from importlib_metadata import entry_points
    +    from typing_extensions import ParamSpec
    +
    +TypeCheckerCallable: TypeAlias = Callable[
    +    [Any, Any, Tuple[Any, ...], TypeCheckMemo], Any
    +]
    +TypeCheckLookupCallback: TypeAlias = Callable[
    +    [Any, Tuple[Any, ...], Tuple[Any, ...]], Optional[TypeCheckerCallable]
    +]
    +
    +checker_lookup_functions: list[TypeCheckLookupCallback] = []
    +generic_alias_types: tuple[type, ...] = (type(List), type(List[Any]))
    +if sys.version_info >= (3, 9):
    +    generic_alias_types += (types.GenericAlias,)
    +
    +protocol_check_cache: WeakKeyDictionary[
    +    type[Any], dict[type[Any], TypeCheckError | None]
    +] = WeakKeyDictionary()
    +
    +# Sentinel
    +_missing = object()
    +
    +# Lifted from mypy.sharedparse
    +BINARY_MAGIC_METHODS = {
    +    "__add__",
    +    "__and__",
    +    "__cmp__",
    +    "__divmod__",
    +    "__div__",
    +    "__eq__",
    +    "__floordiv__",
    +    "__ge__",
    +    "__gt__",
    +    "__iadd__",
    +    "__iand__",
    +    "__idiv__",
    +    "__ifloordiv__",
    +    "__ilshift__",
    +    "__imatmul__",
    +    "__imod__",
    +    "__imul__",
    +    "__ior__",
    +    "__ipow__",
    +    "__irshift__",
    +    "__isub__",
    +    "__itruediv__",
    +    "__ixor__",
    +    "__le__",
    +    "__lshift__",
    +    "__lt__",
    +    "__matmul__",
    +    "__mod__",
    +    "__mul__",
    +    "__ne__",
    +    "__or__",
    +    "__pow__",
    +    "__radd__",
    +    "__rand__",
    +    "__rdiv__",
    +    "__rfloordiv__",
    +    "__rlshift__",
    +    "__rmatmul__",
    +    "__rmod__",
    +    "__rmul__",
    +    "__ror__",
    +    "__rpow__",
    +    "__rrshift__",
    +    "__rshift__",
    +    "__rsub__",
    +    "__rtruediv__",
    +    "__rxor__",
    +    "__sub__",
    +    "__truediv__",
    +    "__xor__",
    +}
    +
    +
    +def check_callable(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    if not callable(value):
    +        raise TypeCheckError("is not callable")
    +
    +    if args:
    +        try:
    +            signature = inspect.signature(value)
    +        except (TypeError, ValueError):
    +            return
    +
    +        argument_types = args[0]
    +        if isinstance(argument_types, list) and not any(
    +            type(item) is ParamSpec for item in argument_types
    +        ):
    +            # The callable must not have keyword-only arguments without defaults
    +            unfulfilled_kwonlyargs = [
    +                param.name
    +                for param in signature.parameters.values()
    +                if param.kind == Parameter.KEYWORD_ONLY
    +                and param.default == Parameter.empty
    +            ]
    +            if unfulfilled_kwonlyargs:
    +                raise TypeCheckError(
    +                    f"has mandatory keyword-only arguments in its declaration: "
    +                    f'{", ".join(unfulfilled_kwonlyargs)}'
    +                )
    +
    +            num_positional_args = num_mandatory_pos_args = 0
    +            has_varargs = False
    +            for param in signature.parameters.values():
    +                if param.kind in (
    +                    Parameter.POSITIONAL_ONLY,
    +                    Parameter.POSITIONAL_OR_KEYWORD,
    +                ):
    +                    num_positional_args += 1
    +                    if param.default is Parameter.empty:
    +                        num_mandatory_pos_args += 1
    +                elif param.kind == Parameter.VAR_POSITIONAL:
    +                    has_varargs = True
    +
    +            if num_mandatory_pos_args > len(argument_types):
    +                raise TypeCheckError(
    +                    f"has too many mandatory positional arguments in its declaration; "
    +                    f"expected {len(argument_types)} but {num_mandatory_pos_args} "
    +                    f"mandatory positional argument(s) declared"
    +                )
    +            elif not has_varargs and num_positional_args < len(argument_types):
    +                raise TypeCheckError(
    +                    f"has too few arguments in its declaration; expected "
    +                    f"{len(argument_types)} but {num_positional_args} argument(s) "
    +                    f"declared"
    +                )
    +
    +
    +def check_mapping(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    if origin_type is Dict or origin_type is dict:
    +        if not isinstance(value, dict):
    +            raise TypeCheckError("is not a dict")
    +    if origin_type is MutableMapping or origin_type is collections.abc.MutableMapping:
    +        if not isinstance(value, collections.abc.MutableMapping):
    +            raise TypeCheckError("is not a mutable mapping")
    +    elif not isinstance(value, collections.abc.Mapping):
    +        raise TypeCheckError("is not a mapping")
    +
    +    if args:
    +        key_type, value_type = args
    +        if key_type is not Any or value_type is not Any:
    +            samples = memo.config.collection_check_strategy.iterate_samples(
    +                value.items()
    +            )
    +            for k, v in samples:
    +                try:
    +                    check_type_internal(k, key_type, memo)
    +                except TypeCheckError as exc:
    +                    exc.append_path_element(f"key {k!r}")
    +                    raise
    +
    +                try:
    +                    check_type_internal(v, value_type, memo)
    +                except TypeCheckError as exc:
    +                    exc.append_path_element(f"value of key {k!r}")
    +                    raise
    +
    +
    +def check_typed_dict(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    if not isinstance(value, dict):
    +        raise TypeCheckError("is not a dict")
    +
    +    declared_keys = frozenset(origin_type.__annotations__)
    +    if hasattr(origin_type, "__required_keys__"):
    +        required_keys = set(origin_type.__required_keys__)
    +    else:  # py3.8 and lower
    +        required_keys = set(declared_keys) if origin_type.__total__ else set()
    +
    +    existing_keys = set(value)
    +    extra_keys = existing_keys - declared_keys
    +    if extra_keys:
    +        keys_formatted = ", ".join(f'"{key}"' for key in sorted(extra_keys, key=repr))
    +        raise TypeCheckError(f"has unexpected extra key(s): {keys_formatted}")
    +
    +    # Detect NotRequired fields which are hidden by get_type_hints()
    +    type_hints: dict[str, type] = {}
    +    for key, annotation in origin_type.__annotations__.items():
    +        if isinstance(annotation, ForwardRef):
    +            annotation = evaluate_forwardref(annotation, memo)
    +            if get_origin(annotation) is NotRequired:
    +                required_keys.discard(key)
    +                annotation = get_args(annotation)[0]
    +
    +        type_hints[key] = annotation
    +
    +    missing_keys = required_keys - existing_keys
    +    if missing_keys:
    +        keys_formatted = ", ".join(f'"{key}"' for key in sorted(missing_keys, key=repr))
    +        raise TypeCheckError(f"is missing required key(s): {keys_formatted}")
    +
    +    for key, argtype in type_hints.items():
    +        argvalue = value.get(key, _missing)
    +        if argvalue is not _missing:
    +            try:
    +                check_type_internal(argvalue, argtype, memo)
    +            except TypeCheckError as exc:
    +                exc.append_path_element(f"value of key {key!r}")
    +                raise
    +
    +
    +def check_list(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    if not isinstance(value, list):
    +        raise TypeCheckError("is not a list")
    +
    +    if args and args != (Any,):
    +        samples = memo.config.collection_check_strategy.iterate_samples(value)
    +        for i, v in enumerate(samples):
    +            try:
    +                check_type_internal(v, args[0], memo)
    +            except TypeCheckError as exc:
    +                exc.append_path_element(f"item {i}")
    +                raise
    +
    +
    +def check_sequence(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    if not isinstance(value, collections.abc.Sequence):
    +        raise TypeCheckError("is not a sequence")
    +
    +    if args and args != (Any,):
    +        samples = memo.config.collection_check_strategy.iterate_samples(value)
    +        for i, v in enumerate(samples):
    +            try:
    +                check_type_internal(v, args[0], memo)
    +            except TypeCheckError as exc:
    +                exc.append_path_element(f"item {i}")
    +                raise
    +
    +
    +def check_set(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    if origin_type is frozenset:
    +        if not isinstance(value, frozenset):
    +            raise TypeCheckError("is not a frozenset")
    +    elif not isinstance(value, AbstractSet):
    +        raise TypeCheckError("is not a set")
    +
    +    if args and args != (Any,):
    +        samples = memo.config.collection_check_strategy.iterate_samples(value)
    +        for v in samples:
    +            try:
    +                check_type_internal(v, args[0], memo)
    +            except TypeCheckError as exc:
    +                exc.append_path_element(f"[{v}]")
    +                raise
    +
    +
    +def check_tuple(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    # Specialized check for NamedTuples
    +    if field_types := getattr(origin_type, "__annotations__", None):
    +        if not isinstance(value, origin_type):
    +            raise TypeCheckError(
    +                f"is not a named tuple of type {qualified_name(origin_type)}"
    +            )
    +
    +        for name, field_type in field_types.items():
    +            try:
    +                check_type_internal(getattr(value, name), field_type, memo)
    +            except TypeCheckError as exc:
    +                exc.append_path_element(f"attribute {name!r}")
    +                raise
    +
    +        return
    +    elif not isinstance(value, tuple):
    +        raise TypeCheckError("is not a tuple")
    +
    +    if args:
    +        use_ellipsis = args[-1] is Ellipsis
    +        tuple_params = args[: -1 if use_ellipsis else None]
    +    else:
    +        # Unparametrized Tuple or plain tuple
    +        return
    +
    +    if use_ellipsis:
    +        element_type = tuple_params[0]
    +        samples = memo.config.collection_check_strategy.iterate_samples(value)
    +        for i, element in enumerate(samples):
    +            try:
    +                check_type_internal(element, element_type, memo)
    +            except TypeCheckError as exc:
    +                exc.append_path_element(f"item {i}")
    +                raise
    +    elif tuple_params == ((),):
    +        if value != ():
    +            raise TypeCheckError("is not an empty tuple")
    +    else:
    +        if len(value) != len(tuple_params):
    +            raise TypeCheckError(
    +                f"has wrong number of elements (expected {len(tuple_params)}, got "
    +                f"{len(value)} instead)"
    +            )
    +
    +        for i, (element, element_type) in enumerate(zip(value, tuple_params)):
    +            try:
    +                check_type_internal(element, element_type, memo)
    +            except TypeCheckError as exc:
    +                exc.append_path_element(f"item {i}")
    +                raise
    +
    +
    +def check_union(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    errors: dict[str, TypeCheckError] = {}
    +    try:
    +        for type_ in args:
    +            try:
    +                check_type_internal(value, type_, memo)
    +                return
    +            except TypeCheckError as exc:
    +                errors[get_type_name(type_)] = exc
    +
    +        formatted_errors = indent(
    +            "\n".join(f"{key}: {error}" for key, error in errors.items()), "  "
    +        )
    +    finally:
    +        del errors  # avoid creating ref cycle
    +    raise TypeCheckError(f"did not match any element in the union:\n{formatted_errors}")
    +
    +
    +def check_uniontype(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    errors: dict[str, TypeCheckError] = {}
    +    for type_ in args:
    +        try:
    +            check_type_internal(value, type_, memo)
    +            return
    +        except TypeCheckError as exc:
    +            errors[get_type_name(type_)] = exc
    +
    +    formatted_errors = indent(
    +        "\n".join(f"{key}: {error}" for key, error in errors.items()), "  "
    +    )
    +    raise TypeCheckError(f"did not match any element in the union:\n{formatted_errors}")
    +
    +
    +def check_class(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    if not isclass(value) and not isinstance(value, generic_alias_types):
    +        raise TypeCheckError("is not a class")
    +
    +    if not args:
    +        return
    +
    +    if isinstance(args[0], ForwardRef):
    +        expected_class = evaluate_forwardref(args[0], memo)
    +    else:
    +        expected_class = args[0]
    +
    +    if expected_class is Any:
    +        return
    +    elif getattr(expected_class, "_is_protocol", False):
    +        check_protocol(value, expected_class, (), memo)
    +    elif isinstance(expected_class, TypeVar):
    +        check_typevar(value, expected_class, (), memo, subclass_check=True)
    +    elif get_origin(expected_class) is Union:
    +        errors: dict[str, TypeCheckError] = {}
    +        for arg in get_args(expected_class):
    +            if arg is Any:
    +                return
    +
    +            try:
    +                check_class(value, type, (arg,), memo)
    +                return
    +            except TypeCheckError as exc:
    +                errors[get_type_name(arg)] = exc
    +        else:
    +            formatted_errors = indent(
    +                "\n".join(f"{key}: {error}" for key, error in errors.items()), "  "
    +            )
    +            raise TypeCheckError(
    +                f"did not match any element in the union:\n{formatted_errors}"
    +            )
    +    elif not issubclass(value, expected_class):  # type: ignore[arg-type]
    +        raise TypeCheckError(f"is not a subclass of {qualified_name(expected_class)}")
    +
    +
    +def check_newtype(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    check_type_internal(value, origin_type.__supertype__, memo)
    +
    +
    +def check_instance(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    if not isinstance(value, origin_type):
    +        raise TypeCheckError(f"is not an instance of {qualified_name(origin_type)}")
    +
    +
    +def check_typevar(
    +    value: Any,
    +    origin_type: TypeVar,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +    *,
    +    subclass_check: bool = False,
    +) -> None:
    +    if origin_type.__bound__ is not None:
    +        annotation = (
    +            Type[origin_type.__bound__] if subclass_check else origin_type.__bound__
    +        )
    +        check_type_internal(value, annotation, memo)
    +    elif origin_type.__constraints__:
    +        for constraint in origin_type.__constraints__:
    +            annotation = Type[constraint] if subclass_check else constraint
    +            try:
    +                check_type_internal(value, annotation, memo)
    +            except TypeCheckError:
    +                pass
    +            else:
    +                break
    +        else:
    +            formatted_constraints = ", ".join(
    +                get_type_name(constraint) for constraint in origin_type.__constraints__
    +            )
    +            raise TypeCheckError(
    +                f"does not match any of the constraints " f"({formatted_constraints})"
    +            )
    +
    +
    +if typing_extensions is None:
    +
    +    def _is_literal_type(typ: object) -> bool:
    +        return typ is typing.Literal
    +
    +else:
    +
    +    def _is_literal_type(typ: object) -> bool:
    +        return typ is typing.Literal or typ is typing_extensions.Literal
    +
    +
    +def check_literal(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    def get_literal_args(literal_args: tuple[Any, ...]) -> tuple[Any, ...]:
    +        retval: list[Any] = []
    +        for arg in literal_args:
    +            if _is_literal_type(get_origin(arg)):
    +                retval.extend(get_literal_args(arg.__args__))
    +            elif arg is None or isinstance(arg, (int, str, bytes, bool, Enum)):
    +                retval.append(arg)
    +            else:
    +                raise TypeError(
    +                    f"Illegal literal value: {arg}"
    +                )  # TypeError here is deliberate
    +
    +        return tuple(retval)
    +
    +    final_args = tuple(get_literal_args(args))
    +    try:
    +        index = final_args.index(value)
    +    except ValueError:
    +        pass
    +    else:
    +        if type(final_args[index]) is type(value):
    +            return
    +
    +    formatted_args = ", ".join(repr(arg) for arg in final_args)
    +    raise TypeCheckError(f"is not any of ({formatted_args})") from None
    +
    +
    +def check_literal_string(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    check_type_internal(value, str, memo)
    +
    +
    +def check_typeguard(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    check_type_internal(value, bool, memo)
    +
    +
    +def check_none(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    if value is not None:
    +        raise TypeCheckError("is not None")
    +
    +
    +def check_number(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    if origin_type is complex and not isinstance(value, (complex, float, int)):
    +        raise TypeCheckError("is neither complex, float or int")
    +    elif origin_type is float and not isinstance(value, (float, int)):
    +        raise TypeCheckError("is neither float or int")
    +
    +
    +def check_io(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    if origin_type is TextIO or (origin_type is IO and args == (str,)):
    +        if not isinstance(value, TextIOBase):
    +            raise TypeCheckError("is not a text based I/O object")
    +    elif origin_type is BinaryIO or (origin_type is IO and args == (bytes,)):
    +        if not isinstance(value, (RawIOBase, BufferedIOBase)):
    +            raise TypeCheckError("is not a binary I/O object")
    +    elif not isinstance(value, IOBase):
    +        raise TypeCheckError("is not an I/O object")
    +
    +
    +def check_protocol(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    subject: type[Any] = value if isclass(value) else type(value)
    +
    +    if subject in protocol_check_cache:
    +        result_map = protocol_check_cache[subject]
    +        if origin_type in result_map:
    +            if exc := result_map[origin_type]:
    +                raise exc
    +            else:
    +                return
    +
    +    # Collect a set of methods and non-method attributes present in the protocol
    +    ignored_attrs = set(dir(typing.Protocol)) | {
    +        "__annotations__",
    +        "__non_callable_proto_members__",
    +    }
    +    expected_methods: dict[str, tuple[Any, Any]] = {}
    +    expected_noncallable_members: dict[str, Any] = {}
    +    for attrname in dir(origin_type):
    +        # Skip attributes present in typing.Protocol
    +        if attrname in ignored_attrs:
    +            continue
    +
    +        member = getattr(origin_type, attrname)
    +        if callable(member):
    +            signature = inspect.signature(member)
    +            argtypes = [
    +                (p.annotation if p.annotation is not Parameter.empty else Any)
    +                for p in signature.parameters.values()
    +                if p.kind is not Parameter.KEYWORD_ONLY
    +            ] or Ellipsis
    +            return_annotation = (
    +                signature.return_annotation
    +                if signature.return_annotation is not Parameter.empty
    +                else Any
    +            )
    +            expected_methods[attrname] = argtypes, return_annotation
    +        else:
    +            expected_noncallable_members[attrname] = member
    +
    +    for attrname, annotation in typing.get_type_hints(origin_type).items():
    +        expected_noncallable_members[attrname] = annotation
    +
    +    subject_annotations = typing.get_type_hints(subject)
    +
    +    # Check that all required methods are present and their signatures are compatible
    +    result_map = protocol_check_cache.setdefault(subject, {})
    +    try:
    +        for attrname, callable_args in expected_methods.items():
    +            try:
    +                method = getattr(subject, attrname)
    +            except AttributeError:
    +                if attrname in subject_annotations:
    +                    raise TypeCheckError(
    +                        f"is not compatible with the {origin_type.__qualname__} protocol "
    +                        f"because its {attrname!r} attribute is not a method"
    +                    ) from None
    +                else:
    +                    raise TypeCheckError(
    +                        f"is not compatible with the {origin_type.__qualname__} protocol "
    +                        f"because it has no method named {attrname!r}"
    +                    ) from None
    +
    +            if not callable(method):
    +                raise TypeCheckError(
    +                    f"is not compatible with the {origin_type.__qualname__} protocol "
    +                    f"because its {attrname!r} attribute is not a callable"
    +                )
    +
    +            # TODO: raise exception on added keyword-only arguments without defaults
    +            try:
    +                check_callable(method, Callable, callable_args, memo)
    +            except TypeCheckError as exc:
    +                raise TypeCheckError(
    +                    f"is not compatible with the {origin_type.__qualname__} protocol "
    +                    f"because its {attrname!r} method {exc}"
    +                ) from None
    +
    +        # Check that all required non-callable members are present
    +        for attrname in expected_noncallable_members:
    +            # TODO: implement assignability checks for non-callable members
    +            if attrname not in subject_annotations and not hasattr(subject, attrname):
    +                raise TypeCheckError(
    +                    f"is not compatible with the {origin_type.__qualname__} protocol "
    +                    f"because it has no attribute named {attrname!r}"
    +                )
    +    except TypeCheckError as exc:
    +        result_map[origin_type] = exc
    +        raise
    +    else:
    +        result_map[origin_type] = None
    +
    +
    +def check_byteslike(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    if not isinstance(value, (bytearray, bytes, memoryview)):
    +        raise TypeCheckError("is not bytes-like")
    +
    +
    +def check_self(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    if memo.self_type is None:
    +        raise TypeCheckError("cannot be checked against Self outside of a method call")
    +
    +    if isclass(value):
    +        if not issubclass(value, memo.self_type):
    +            raise TypeCheckError(
    +                f"is not an instance of the self type "
    +                f"({qualified_name(memo.self_type)})"
    +            )
    +    elif not isinstance(value, memo.self_type):
    +        raise TypeCheckError(
    +            f"is not an instance of the self type ({qualified_name(memo.self_type)})"
    +        )
    +
    +
    +def check_paramspec(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    pass  # No-op for now
    +
    +
    +def check_instanceof(
    +    value: Any,
    +    origin_type: Any,
    +    args: tuple[Any, ...],
    +    memo: TypeCheckMemo,
    +) -> None:
    +    if not isinstance(value, origin_type):
    +        raise TypeCheckError(f"is not an instance of {qualified_name(origin_type)}")
    +
    +
    +def check_type_internal(
    +    value: Any,
    +    annotation: Any,
    +    memo: TypeCheckMemo,
    +) -> None:
    +    """
    +    Check that the given object is compatible with the given type annotation.
    +
    +    This function should only be used by type checker callables. Applications should use
    +    :func:`~.check_type` instead.
    +
    +    :param value: the value to check
    +    :param annotation: the type annotation to check against
    +    :param memo: a memo object containing configuration and information necessary for
    +        looking up forward references
    +    """
    +
    +    if isinstance(annotation, ForwardRef):
    +        try:
    +            annotation = evaluate_forwardref(annotation, memo)
    +        except NameError:
    +            if memo.config.forward_ref_policy is ForwardRefPolicy.ERROR:
    +                raise
    +            elif memo.config.forward_ref_policy is ForwardRefPolicy.WARN:
    +                warnings.warn(
    +                    f"Cannot resolve forward reference {annotation.__forward_arg__!r}",
    +                    TypeHintWarning,
    +                    stacklevel=get_stacklevel(),
    +                )
    +
    +            return
    +
    +    if annotation is Any or annotation is SubclassableAny or isinstance(value, Mock):
    +        return
    +
    +    # Skip type checks if value is an instance of a class that inherits from Any
    +    if not isclass(value) and SubclassableAny in type(value).__bases__:
    +        return
    +
    +    extras: tuple[Any, ...]
    +    origin_type = get_origin(annotation)
    +    if origin_type is Annotated:
    +        annotation, *extras_ = get_args(annotation)
    +        extras = tuple(extras_)
    +        origin_type = get_origin(annotation)
    +    else:
    +        extras = ()
    +
    +    if origin_type is not None:
    +        args = get_args(annotation)
    +
    +        # Compatibility hack to distinguish between unparametrized and empty tuple
    +        # (tuple[()]), necessary due to https://github.com/python/cpython/issues/91137
    +        if origin_type in (tuple, Tuple) and annotation is not Tuple and not args:
    +            args = ((),)
    +    else:
    +        origin_type = annotation
    +        args = ()
    +
    +    for lookup_func in checker_lookup_functions:
    +        checker = lookup_func(origin_type, args, extras)
    +        if checker:
    +            checker(value, origin_type, args, memo)
    +            return
    +
    +    if isclass(origin_type):
    +        if not isinstance(value, origin_type):
    +            raise TypeCheckError(f"is not an instance of {qualified_name(origin_type)}")
    +    elif type(origin_type) is str:  # noqa: E721
    +        warnings.warn(
    +            f"Skipping type check against {origin_type!r}; this looks like a "
    +            f"string-form forward reference imported from another module",
    +            TypeHintWarning,
    +            stacklevel=get_stacklevel(),
    +        )
    +
    +
    +# Equality checks are applied to these
    +origin_type_checkers = {
    +    bytes: check_byteslike,
    +    AbstractSet: check_set,
    +    BinaryIO: check_io,
    +    Callable: check_callable,
    +    collections.abc.Callable: check_callable,
    +    complex: check_number,
    +    dict: check_mapping,
    +    Dict: check_mapping,
    +    float: check_number,
    +    frozenset: check_set,
    +    IO: check_io,
    +    list: check_list,
    +    List: check_list,
    +    typing.Literal: check_literal,
    +    Mapping: check_mapping,
    +    MutableMapping: check_mapping,
    +    None: check_none,
    +    collections.abc.Mapping: check_mapping,
    +    collections.abc.MutableMapping: check_mapping,
    +    Sequence: check_sequence,
    +    collections.abc.Sequence: check_sequence,
    +    collections.abc.Set: check_set,
    +    set: check_set,
    +    Set: check_set,
    +    TextIO: check_io,
    +    tuple: check_tuple,
    +    Tuple: check_tuple,
    +    type: check_class,
    +    Type: check_class,
    +    Union: check_union,
    +}
    +if sys.version_info >= (3, 10):
    +    origin_type_checkers[types.UnionType] = check_uniontype
    +    origin_type_checkers[typing.TypeGuard] = check_typeguard
    +if sys.version_info >= (3, 11):
    +    origin_type_checkers.update(
    +        {typing.LiteralString: check_literal_string, typing.Self: check_self}
    +    )
    +if typing_extensions is not None:
    +    # On some Python versions, these may simply be re-exports from typing,
    +    # but exactly which Python versions is subject to change,
    +    # so it's best to err on the safe side
    +    # and update the dictionary on all Python versions
    +    # if typing_extensions is installed
    +    origin_type_checkers[typing_extensions.Literal] = check_literal
    +    origin_type_checkers[typing_extensions.LiteralString] = check_literal_string
    +    origin_type_checkers[typing_extensions.Self] = check_self
    +    origin_type_checkers[typing_extensions.TypeGuard] = check_typeguard
    +
    +
    +def builtin_checker_lookup(
    +    origin_type: Any, args: tuple[Any, ...], extras: tuple[Any, ...]
    +) -> TypeCheckerCallable | None:
    +    checker = origin_type_checkers.get(origin_type)
    +    if checker is not None:
    +        return checker
    +    elif is_typeddict(origin_type):
    +        return check_typed_dict
    +    elif isclass(origin_type) and issubclass(
    +        origin_type,
    +        Tuple,  # type: ignore[arg-type]
    +    ):
    +        # NamedTuple
    +        return check_tuple
    +    elif getattr(origin_type, "_is_protocol", False):
    +        return check_protocol
    +    elif isinstance(origin_type, ParamSpec):
    +        return check_paramspec
    +    elif isinstance(origin_type, TypeVar):
    +        return check_typevar
    +    elif origin_type.__class__ is NewType:
    +        # typing.NewType on Python 3.10+
    +        return check_newtype
    +    elif (
    +        isfunction(origin_type)
    +        and getattr(origin_type, "__module__", None) == "typing"
    +        and getattr(origin_type, "__qualname__", "").startswith("NewType.")
    +        and hasattr(origin_type, "__supertype__")
    +    ):
    +        # typing.NewType on Python 3.9 and below
    +        return check_newtype
    +
    +    return None
    +
    +
    +checker_lookup_functions.append(builtin_checker_lookup)
    +
    +
    +def load_plugins() -> None:
    +    """
    +    Load all type checker lookup functions from entry points.
    +
    +    All entry points from the ``typeguard.checker_lookup`` group are loaded, and the
    +    returned lookup functions are added to :data:`typeguard.checker_lookup_functions`.
    +
    +    .. note:: This function is called implicitly on import, unless the
    +        ``TYPEGUARD_DISABLE_PLUGIN_AUTOLOAD`` environment variable is present.
    +    """
    +
    +    for ep in entry_points(group="typeguard.checker_lookup"):
    +        try:
    +            plugin = ep.load()
    +        except Exception as exc:
    +            warnings.warn(
    +                f"Failed to load plugin {ep.name!r}: " f"{qualified_name(exc)}: {exc}",
    +                stacklevel=2,
    +            )
    +            continue
    +
    +        if not callable(plugin):
    +            warnings.warn(
    +                f"Plugin {ep} returned a non-callable object: {plugin!r}", stacklevel=2
    +            )
    +            continue
    +
    +        checker_lookup_functions.insert(0, plugin)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_config.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_config.py
    new file mode 100644
    index 000000000..36efad539
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_config.py
    @@ -0,0 +1,108 @@
    +from __future__ import annotations
    +
    +from collections.abc import Iterable
    +from dataclasses import dataclass
    +from enum import Enum, auto
    +from typing import TYPE_CHECKING, TypeVar
    +
    +if TYPE_CHECKING:
    +    from ._functions import TypeCheckFailCallback
    +
    +T = TypeVar("T")
    +
    +
    +class ForwardRefPolicy(Enum):
    +    """
    +    Defines how unresolved forward references are handled.
    +
    +    Members:
    +
    +    * ``ERROR``: propagate the :exc:`NameError` when the forward reference lookup fails
    +    * ``WARN``: emit a :class:`~.TypeHintWarning` if the forward reference lookup fails
    +    * ``IGNORE``: silently skip checks for unresolveable forward references
    +    """
    +
    +    ERROR = auto()
    +    WARN = auto()
    +    IGNORE = auto()
    +
    +
    +class CollectionCheckStrategy(Enum):
    +    """
    +    Specifies how thoroughly the contents of collections are type checked.
    +
    +    This has an effect on the following built-in checkers:
    +
    +    * ``AbstractSet``
    +    * ``Dict``
    +    * ``List``
    +    * ``Mapping``
    +    * ``Set``
    +    * ``Tuple[, ...]`` (arbitrarily sized tuples)
    +
    +    Members:
    +
    +    * ``FIRST_ITEM``: check only the first item
    +    * ``ALL_ITEMS``: check all items
    +    """
    +
    +    FIRST_ITEM = auto()
    +    ALL_ITEMS = auto()
    +
    +    def iterate_samples(self, collection: Iterable[T]) -> Iterable[T]:
    +        if self is CollectionCheckStrategy.FIRST_ITEM:
    +            try:
    +                return [next(iter(collection))]
    +            except StopIteration:
    +                return ()
    +        else:
    +            return collection
    +
    +
    +@dataclass
    +class TypeCheckConfiguration:
    +    """
    +     You can change Typeguard's behavior with these settings.
    +
    +    .. attribute:: typecheck_fail_callback
    +       :type: Callable[[TypeCheckError, TypeCheckMemo], Any]
    +
    +         Callable that is called when type checking fails.
    +
    +         Default: ``None`` (the :exc:`~.TypeCheckError` is raised directly)
    +
    +    .. attribute:: forward_ref_policy
    +       :type: ForwardRefPolicy
    +
    +         Specifies what to do when a forward reference fails to resolve.
    +
    +         Default: ``WARN``
    +
    +    .. attribute:: collection_check_strategy
    +       :type: CollectionCheckStrategy
    +
    +         Specifies how thoroughly the contents of collections (list, dict, etc.) are
    +         type checked.
    +
    +         Default: ``FIRST_ITEM``
    +
    +    .. attribute:: debug_instrumentation
    +       :type: bool
    +
    +         If set to ``True``, the code of modules or functions instrumented by typeguard
    +         is printed to ``sys.stderr`` after the instrumentation is done
    +
    +         Requires Python 3.9 or newer.
    +
    +         Default: ``False``
    +    """
    +
    +    forward_ref_policy: ForwardRefPolicy = ForwardRefPolicy.WARN
    +    typecheck_fail_callback: TypeCheckFailCallback | None = None
    +    collection_check_strategy: CollectionCheckStrategy = (
    +        CollectionCheckStrategy.FIRST_ITEM
    +    )
    +    debug_instrumentation: bool = False
    +
    +
    +global_config = TypeCheckConfiguration()
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_decorators.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_decorators.py
    new file mode 100644
    index 000000000..cf3253351
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_decorators.py
    @@ -0,0 +1,235 @@
    +from __future__ import annotations
    +
    +import ast
    +import inspect
    +import sys
    +from collections.abc import Sequence
    +from functools import partial
    +from inspect import isclass, isfunction
    +from types import CodeType, FrameType, FunctionType
    +from typing import TYPE_CHECKING, Any, Callable, ForwardRef, TypeVar, cast, overload
    +from warnings import warn
    +
    +from ._config import CollectionCheckStrategy, ForwardRefPolicy, global_config
    +from ._exceptions import InstrumentationWarning
    +from ._functions import TypeCheckFailCallback
    +from ._transformer import TypeguardTransformer
    +from ._utils import Unset, function_name, get_stacklevel, is_method_of, unset
    +
    +if TYPE_CHECKING:
    +    from typeshed.stdlib.types import _Cell
    +
    +    _F = TypeVar("_F")
    +
    +    def typeguard_ignore(f: _F) -> _F:
    +        """This decorator is a noop during static type-checking."""
    +        return f
    +
    +else:
    +    from typing import no_type_check as typeguard_ignore  # noqa: F401
    +
    +T_CallableOrType = TypeVar("T_CallableOrType", bound=Callable[..., Any])
    +
    +
    +def make_cell(value: object) -> _Cell:
    +    return (lambda: value).__closure__[0]  # type: ignore[index]
    +
    +
    +def find_target_function(
    +    new_code: CodeType, target_path: Sequence[str], firstlineno: int
    +) -> CodeType | None:
    +    target_name = target_path[0]
    +    for const in new_code.co_consts:
    +        if isinstance(const, CodeType):
    +            if const.co_name == target_name:
    +                if const.co_firstlineno == firstlineno:
    +                    return const
    +                elif len(target_path) > 1:
    +                    target_code = find_target_function(
    +                        const, target_path[1:], firstlineno
    +                    )
    +                    if target_code:
    +                        return target_code
    +
    +    return None
    +
    +
    +def instrument(f: T_CallableOrType) -> FunctionType | str:
    +    if not getattr(f, "__code__", None):
    +        return "no code associated"
    +    elif not getattr(f, "__module__", None):
    +        return "__module__ attribute is not set"
    +    elif f.__code__.co_filename == "":
    +        return "cannot instrument functions defined in a REPL"
    +    elif hasattr(f, "__wrapped__"):
    +        return (
    +            "@typechecked only supports instrumenting functions wrapped with "
    +            "@classmethod, @staticmethod or @property"
    +        )
    +
    +    target_path = [item for item in f.__qualname__.split(".") if item != ""]
    +    module_source = inspect.getsource(sys.modules[f.__module__])
    +    module_ast = ast.parse(module_source)
    +    instrumentor = TypeguardTransformer(target_path, f.__code__.co_firstlineno)
    +    instrumentor.visit(module_ast)
    +
    +    if not instrumentor.target_node or instrumentor.target_lineno is None:
    +        return "instrumentor did not find the target function"
    +
    +    module_code = compile(module_ast, f.__code__.co_filename, "exec", dont_inherit=True)
    +    new_code = find_target_function(
    +        module_code, target_path, instrumentor.target_lineno
    +    )
    +    if not new_code:
    +        return "cannot find the target function in the AST"
    +
    +    if global_config.debug_instrumentation and sys.version_info >= (3, 9):
    +        # Find the matching AST node, then unparse it to source and print to stdout
    +        print(
    +            f"Source code of {f.__qualname__}() after instrumentation:"
    +            "\n----------------------------------------------",
    +            file=sys.stderr,
    +        )
    +        print(ast.unparse(instrumentor.target_node), file=sys.stderr)
    +        print(
    +            "----------------------------------------------",
    +            file=sys.stderr,
    +        )
    +
    +    closure = f.__closure__
    +    if new_code.co_freevars != f.__code__.co_freevars:
    +        # Create a new closure and find values for the new free variables
    +        frame = cast(FrameType, inspect.currentframe())
    +        frame = cast(FrameType, frame.f_back)
    +        frame_locals = cast(FrameType, frame.f_back).f_locals
    +        cells: list[_Cell] = []
    +        for key in new_code.co_freevars:
    +            if key in instrumentor.names_used_in_annotations:
    +                # Find the value and make a new cell from it
    +                value = frame_locals.get(key) or ForwardRef(key)
    +                cells.append(make_cell(value))
    +            else:
    +                # Reuse the cell from the existing closure
    +                assert f.__closure__
    +                cells.append(f.__closure__[f.__code__.co_freevars.index(key)])
    +
    +        closure = tuple(cells)
    +
    +    new_function = FunctionType(new_code, f.__globals__, f.__name__, closure=closure)
    +    new_function.__module__ = f.__module__
    +    new_function.__name__ = f.__name__
    +    new_function.__qualname__ = f.__qualname__
    +    new_function.__annotations__ = f.__annotations__
    +    new_function.__doc__ = f.__doc__
    +    new_function.__defaults__ = f.__defaults__
    +    new_function.__kwdefaults__ = f.__kwdefaults__
    +    return new_function
    +
    +
    +@overload
    +def typechecked(
    +    *,
    +    forward_ref_policy: ForwardRefPolicy | Unset = unset,
    +    typecheck_fail_callback: TypeCheckFailCallback | Unset = unset,
    +    collection_check_strategy: CollectionCheckStrategy | Unset = unset,
    +    debug_instrumentation: bool | Unset = unset,
    +) -> Callable[[T_CallableOrType], T_CallableOrType]: ...
    +
    +
    +@overload
    +def typechecked(target: T_CallableOrType) -> T_CallableOrType: ...
    +
    +
    +def typechecked(
    +    target: T_CallableOrType | None = None,
    +    *,
    +    forward_ref_policy: ForwardRefPolicy | Unset = unset,
    +    typecheck_fail_callback: TypeCheckFailCallback | Unset = unset,
    +    collection_check_strategy: CollectionCheckStrategy | Unset = unset,
    +    debug_instrumentation: bool | Unset = unset,
    +) -> Any:
    +    """
    +    Instrument the target function to perform run-time type checking.
    +
    +    This decorator recompiles the target function, injecting code to type check
    +    arguments, return values, yield values (excluding ``yield from``) and assignments to
    +    annotated local variables.
    +
    +    This can also be used as a class decorator. This will instrument all type annotated
    +    methods, including :func:`@classmethod `,
    +    :func:`@staticmethod `,  and :class:`@property ` decorated
    +    methods in the class.
    +
    +    .. note:: When Python is run in optimized mode (``-O`` or ``-OO``, this decorator
    +        is a no-op). This is a feature meant for selectively introducing type checking
    +        into a code base where the checks aren't meant to be run in production.
    +
    +    :param target: the function or class to enable type checking for
    +    :param forward_ref_policy: override for
    +        :attr:`.TypeCheckConfiguration.forward_ref_policy`
    +    :param typecheck_fail_callback: override for
    +        :attr:`.TypeCheckConfiguration.typecheck_fail_callback`
    +    :param collection_check_strategy: override for
    +        :attr:`.TypeCheckConfiguration.collection_check_strategy`
    +    :param debug_instrumentation: override for
    +        :attr:`.TypeCheckConfiguration.debug_instrumentation`
    +
    +    """
    +    if target is None:
    +        return partial(
    +            typechecked,
    +            forward_ref_policy=forward_ref_policy,
    +            typecheck_fail_callback=typecheck_fail_callback,
    +            collection_check_strategy=collection_check_strategy,
    +            debug_instrumentation=debug_instrumentation,
    +        )
    +
    +    if not __debug__:
    +        return target
    +
    +    if isclass(target):
    +        for key, attr in target.__dict__.items():
    +            if is_method_of(attr, target):
    +                retval = instrument(attr)
    +                if isfunction(retval):
    +                    setattr(target, key, retval)
    +            elif isinstance(attr, (classmethod, staticmethod)):
    +                if is_method_of(attr.__func__, target):
    +                    retval = instrument(attr.__func__)
    +                    if isfunction(retval):
    +                        wrapper = attr.__class__(retval)
    +                        setattr(target, key, wrapper)
    +            elif isinstance(attr, property):
    +                kwargs: dict[str, Any] = dict(doc=attr.__doc__)
    +                for name in ("fset", "fget", "fdel"):
    +                    property_func = kwargs[name] = getattr(attr, name)
    +                    if is_method_of(property_func, target):
    +                        retval = instrument(property_func)
    +                        if isfunction(retval):
    +                            kwargs[name] = retval
    +
    +                setattr(target, key, attr.__class__(**kwargs))
    +
    +        return target
    +
    +    # Find either the first Python wrapper or the actual function
    +    wrapper_class: (
    +        type[classmethod[Any, Any, Any]] | type[staticmethod[Any, Any]] | None
    +    ) = None
    +    if isinstance(target, (classmethod, staticmethod)):
    +        wrapper_class = target.__class__
    +        target = target.__func__
    +
    +    retval = instrument(target)
    +    if isinstance(retval, str):
    +        warn(
    +            f"{retval} -- not typechecking {function_name(target)}",
    +            InstrumentationWarning,
    +            stacklevel=get_stacklevel(),
    +        )
    +        return target
    +
    +    if wrapper_class is None:
    +        return retval
    +    else:
    +        return wrapper_class(retval)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_exceptions.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_exceptions.py
    new file mode 100644
    index 000000000..625437a64
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_exceptions.py
    @@ -0,0 +1,42 @@
    +from collections import deque
    +from typing import Deque
    +
    +
    +class TypeHintWarning(UserWarning):
    +    """
    +    A warning that is emitted when a type hint in string form could not be resolved to
    +    an actual type.
    +    """
    +
    +
    +class TypeCheckWarning(UserWarning):
    +    """Emitted by typeguard's type checkers when a type mismatch is detected."""
    +
    +    def __init__(self, message: str):
    +        super().__init__(message)
    +
    +
    +class InstrumentationWarning(UserWarning):
    +    """Emitted when there's a problem with instrumenting a function for type checks."""
    +
    +    def __init__(self, message: str):
    +        super().__init__(message)
    +
    +
    +class TypeCheckError(Exception):
    +    """
    +    Raised by typeguard's type checkers when a type mismatch is detected.
    +    """
    +
    +    def __init__(self, message: str):
    +        super().__init__(message)
    +        self._path: Deque[str] = deque()
    +
    +    def append_path_element(self, element: str) -> None:
    +        self._path.append(element)
    +
    +    def __str__(self) -> str:
    +        if self._path:
    +            return " of ".join(self._path) + " " + str(self.args[0])
    +        else:
    +            return str(self.args[0])
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_functions.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_functions.py
    new file mode 100644
    index 000000000..28497856a
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_functions.py
    @@ -0,0 +1,308 @@
    +from __future__ import annotations
    +
    +import sys
    +import warnings
    +from typing import Any, Callable, NoReturn, TypeVar, Union, overload
    +
    +from . import _suppression
    +from ._checkers import BINARY_MAGIC_METHODS, check_type_internal
    +from ._config import (
    +    CollectionCheckStrategy,
    +    ForwardRefPolicy,
    +    TypeCheckConfiguration,
    +)
    +from ._exceptions import TypeCheckError, TypeCheckWarning
    +from ._memo import TypeCheckMemo
    +from ._utils import get_stacklevel, qualified_name
    +
    +if sys.version_info >= (3, 11):
    +    from typing import Literal, Never, TypeAlias
    +else:
    +    from typing_extensions import Literal, Never, TypeAlias
    +
    +T = TypeVar("T")
    +TypeCheckFailCallback: TypeAlias = Callable[[TypeCheckError, TypeCheckMemo], Any]
    +
    +
    +@overload
    +def check_type(
    +    value: object,
    +    expected_type: type[T],
    +    *,
    +    forward_ref_policy: ForwardRefPolicy = ...,
    +    typecheck_fail_callback: TypeCheckFailCallback | None = ...,
    +    collection_check_strategy: CollectionCheckStrategy = ...,
    +) -> T: ...
    +
    +
    +@overload
    +def check_type(
    +    value: object,
    +    expected_type: Any,
    +    *,
    +    forward_ref_policy: ForwardRefPolicy = ...,
    +    typecheck_fail_callback: TypeCheckFailCallback | None = ...,
    +    collection_check_strategy: CollectionCheckStrategy = ...,
    +) -> Any: ...
    +
    +
    +def check_type(
    +    value: object,
    +    expected_type: Any,
    +    *,
    +    forward_ref_policy: ForwardRefPolicy = TypeCheckConfiguration().forward_ref_policy,
    +    typecheck_fail_callback: TypeCheckFailCallback | None = (
    +        TypeCheckConfiguration().typecheck_fail_callback
    +    ),
    +    collection_check_strategy: CollectionCheckStrategy = (
    +        TypeCheckConfiguration().collection_check_strategy
    +    ),
    +) -> Any:
    +    """
    +    Ensure that ``value`` matches ``expected_type``.
    +
    +    The types from the :mod:`typing` module do not support :func:`isinstance` or
    +    :func:`issubclass` so a number of type specific checks are required. This function
    +    knows which checker to call for which type.
    +
    +    This function wraps :func:`~.check_type_internal` in the following ways:
    +
    +    * Respects type checking suppression (:func:`~.suppress_type_checks`)
    +    * Forms a :class:`~.TypeCheckMemo` from the current stack frame
    +    * Calls the configured type check fail callback if the check fails
    +
    +    Note that this function is independent of the globally shared configuration in
    +    :data:`typeguard.config`. This means that usage within libraries is safe from being
    +    affected configuration changes made by other libraries or by the integrating
    +    application. Instead, configuration options have the same default values as their
    +    corresponding fields in :class:`TypeCheckConfiguration`.
    +
    +    :param value: value to be checked against ``expected_type``
    +    :param expected_type: a class or generic type instance, or a tuple of such things
    +    :param forward_ref_policy: see :attr:`TypeCheckConfiguration.forward_ref_policy`
    +    :param typecheck_fail_callback:
    +        see :attr`TypeCheckConfiguration.typecheck_fail_callback`
    +    :param collection_check_strategy:
    +        see :attr:`TypeCheckConfiguration.collection_check_strategy`
    +    :return: ``value``, unmodified
    +    :raises TypeCheckError: if there is a type mismatch
    +
    +    """
    +    if type(expected_type) is tuple:
    +        expected_type = Union[expected_type]
    +
    +    config = TypeCheckConfiguration(
    +        forward_ref_policy=forward_ref_policy,
    +        typecheck_fail_callback=typecheck_fail_callback,
    +        collection_check_strategy=collection_check_strategy,
    +    )
    +
    +    if _suppression.type_checks_suppressed or expected_type is Any:
    +        return value
    +
    +    frame = sys._getframe(1)
    +    memo = TypeCheckMemo(frame.f_globals, frame.f_locals, config=config)
    +    try:
    +        check_type_internal(value, expected_type, memo)
    +    except TypeCheckError as exc:
    +        exc.append_path_element(qualified_name(value, add_class_prefix=True))
    +        if config.typecheck_fail_callback:
    +            config.typecheck_fail_callback(exc, memo)
    +        else:
    +            raise
    +
    +    return value
    +
    +
    +def check_argument_types(
    +    func_name: str,
    +    arguments: dict[str, tuple[Any, Any]],
    +    memo: TypeCheckMemo,
    +) -> Literal[True]:
    +    if _suppression.type_checks_suppressed:
    +        return True
    +
    +    for argname, (value, annotation) in arguments.items():
    +        if annotation is NoReturn or annotation is Never:
    +            exc = TypeCheckError(
    +                f"{func_name}() was declared never to be called but it was"
    +            )
    +            if memo.config.typecheck_fail_callback:
    +                memo.config.typecheck_fail_callback(exc, memo)
    +            else:
    +                raise exc
    +
    +        try:
    +            check_type_internal(value, annotation, memo)
    +        except TypeCheckError as exc:
    +            qualname = qualified_name(value, add_class_prefix=True)
    +            exc.append_path_element(f'argument "{argname}" ({qualname})')
    +            if memo.config.typecheck_fail_callback:
    +                memo.config.typecheck_fail_callback(exc, memo)
    +            else:
    +                raise
    +
    +    return True
    +
    +
    +def check_return_type(
    +    func_name: str,
    +    retval: T,
    +    annotation: Any,
    +    memo: TypeCheckMemo,
    +) -> T:
    +    if _suppression.type_checks_suppressed:
    +        return retval
    +
    +    if annotation is NoReturn or annotation is Never:
    +        exc = TypeCheckError(f"{func_name}() was declared never to return but it did")
    +        if memo.config.typecheck_fail_callback:
    +            memo.config.typecheck_fail_callback(exc, memo)
    +        else:
    +            raise exc
    +
    +    try:
    +        check_type_internal(retval, annotation, memo)
    +    except TypeCheckError as exc:
    +        # Allow NotImplemented if this is a binary magic method (__eq__() et al)
    +        if retval is NotImplemented and annotation is bool:
    +            # This does (and cannot) not check if it's actually a method
    +            func_name = func_name.rsplit(".", 1)[-1]
    +            if func_name in BINARY_MAGIC_METHODS:
    +                return retval
    +
    +        qualname = qualified_name(retval, add_class_prefix=True)
    +        exc.append_path_element(f"the return value ({qualname})")
    +        if memo.config.typecheck_fail_callback:
    +            memo.config.typecheck_fail_callback(exc, memo)
    +        else:
    +            raise
    +
    +    return retval
    +
    +
    +def check_send_type(
    +    func_name: str,
    +    sendval: T,
    +    annotation: Any,
    +    memo: TypeCheckMemo,
    +) -> T:
    +    if _suppression.type_checks_suppressed:
    +        return sendval
    +
    +    if annotation is NoReturn or annotation is Never:
    +        exc = TypeCheckError(
    +            f"{func_name}() was declared never to be sent a value to but it was"
    +        )
    +        if memo.config.typecheck_fail_callback:
    +            memo.config.typecheck_fail_callback(exc, memo)
    +        else:
    +            raise exc
    +
    +    try:
    +        check_type_internal(sendval, annotation, memo)
    +    except TypeCheckError as exc:
    +        qualname = qualified_name(sendval, add_class_prefix=True)
    +        exc.append_path_element(f"the value sent to generator ({qualname})")
    +        if memo.config.typecheck_fail_callback:
    +            memo.config.typecheck_fail_callback(exc, memo)
    +        else:
    +            raise
    +
    +    return sendval
    +
    +
    +def check_yield_type(
    +    func_name: str,
    +    yieldval: T,
    +    annotation: Any,
    +    memo: TypeCheckMemo,
    +) -> T:
    +    if _suppression.type_checks_suppressed:
    +        return yieldval
    +
    +    if annotation is NoReturn or annotation is Never:
    +        exc = TypeCheckError(f"{func_name}() was declared never to yield but it did")
    +        if memo.config.typecheck_fail_callback:
    +            memo.config.typecheck_fail_callback(exc, memo)
    +        else:
    +            raise exc
    +
    +    try:
    +        check_type_internal(yieldval, annotation, memo)
    +    except TypeCheckError as exc:
    +        qualname = qualified_name(yieldval, add_class_prefix=True)
    +        exc.append_path_element(f"the yielded value ({qualname})")
    +        if memo.config.typecheck_fail_callback:
    +            memo.config.typecheck_fail_callback(exc, memo)
    +        else:
    +            raise
    +
    +    return yieldval
    +
    +
    +def check_variable_assignment(
    +    value: object, varname: str, annotation: Any, memo: TypeCheckMemo
    +) -> Any:
    +    if _suppression.type_checks_suppressed:
    +        return value
    +
    +    try:
    +        check_type_internal(value, annotation, memo)
    +    except TypeCheckError as exc:
    +        qualname = qualified_name(value, add_class_prefix=True)
    +        exc.append_path_element(f"value assigned to {varname} ({qualname})")
    +        if memo.config.typecheck_fail_callback:
    +            memo.config.typecheck_fail_callback(exc, memo)
    +        else:
    +            raise
    +
    +    return value
    +
    +
    +def check_multi_variable_assignment(
    +    value: Any, targets: list[dict[str, Any]], memo: TypeCheckMemo
    +) -> Any:
    +    if max(len(target) for target in targets) == 1:
    +        iterated_values = [value]
    +    else:
    +        iterated_values = list(value)
    +
    +    if not _suppression.type_checks_suppressed:
    +        for expected_types in targets:
    +            value_index = 0
    +            for ann_index, (varname, expected_type) in enumerate(
    +                expected_types.items()
    +            ):
    +                if varname.startswith("*"):
    +                    varname = varname[1:]
    +                    keys_left = len(expected_types) - 1 - ann_index
    +                    next_value_index = len(iterated_values) - keys_left
    +                    obj: object = iterated_values[value_index:next_value_index]
    +                    value_index = next_value_index
    +                else:
    +                    obj = iterated_values[value_index]
    +                    value_index += 1
    +
    +                try:
    +                    check_type_internal(obj, expected_type, memo)
    +                except TypeCheckError as exc:
    +                    qualname = qualified_name(obj, add_class_prefix=True)
    +                    exc.append_path_element(f"value assigned to {varname} ({qualname})")
    +                    if memo.config.typecheck_fail_callback:
    +                        memo.config.typecheck_fail_callback(exc, memo)
    +                    else:
    +                        raise
    +
    +    return iterated_values[0] if len(iterated_values) == 1 else iterated_values
    +
    +
    +def warn_on_error(exc: TypeCheckError, memo: TypeCheckMemo) -> None:
    +    """
    +    Emit a warning on a type mismatch.
    +
    +    This is intended to be used as an error handler in
    +    :attr:`TypeCheckConfiguration.typecheck_fail_callback`.
    +
    +    """
    +    warnings.warn(TypeCheckWarning(str(exc)), stacklevel=get_stacklevel())
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_importhook.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_importhook.py
    new file mode 100644
    index 000000000..8590540a5
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_importhook.py
    @@ -0,0 +1,213 @@
    +from __future__ import annotations
    +
    +import ast
    +import sys
    +import types
    +from collections.abc import Callable, Iterable
    +from importlib.abc import MetaPathFinder
    +from importlib.machinery import ModuleSpec, SourceFileLoader
    +from importlib.util import cache_from_source, decode_source
    +from inspect import isclass
    +from os import PathLike
    +from types import CodeType, ModuleType, TracebackType
    +from typing import Sequence, TypeVar
    +from unittest.mock import patch
    +
    +from ._config import global_config
    +from ._transformer import TypeguardTransformer
    +
    +if sys.version_info >= (3, 12):
    +    from collections.abc import Buffer
    +else:
    +    from typing_extensions import Buffer
    +
    +if sys.version_info >= (3, 11):
    +    from typing import ParamSpec
    +else:
    +    from typing_extensions import ParamSpec
    +
    +if sys.version_info >= (3, 10):
    +    from importlib.metadata import PackageNotFoundError, version
    +else:
    +    from importlib_metadata import PackageNotFoundError, version
    +
    +try:
    +    OPTIMIZATION = "typeguard" + "".join(version("typeguard").split(".")[:3])
    +except PackageNotFoundError:
    +    OPTIMIZATION = "typeguard"
    +
    +P = ParamSpec("P")
    +T = TypeVar("T")
    +
    +
    +# The name of this function is magical
    +def _call_with_frames_removed(
    +    f: Callable[P, T], *args: P.args, **kwargs: P.kwargs
    +) -> T:
    +    return f(*args, **kwargs)
    +
    +
    +def optimized_cache_from_source(path: str, debug_override: bool | None = None) -> str:
    +    return cache_from_source(path, debug_override, optimization=OPTIMIZATION)
    +
    +
    +class TypeguardLoader(SourceFileLoader):
    +    @staticmethod
    +    def source_to_code(
    +        data: Buffer | str | ast.Module | ast.Expression | ast.Interactive,
    +        path: Buffer | str | PathLike[str] = "",
    +    ) -> CodeType:
    +        if isinstance(data, (ast.Module, ast.Expression, ast.Interactive)):
    +            tree = data
    +        else:
    +            if isinstance(data, str):
    +                source = data
    +            else:
    +                source = decode_source(data)
    +
    +            tree = _call_with_frames_removed(
    +                ast.parse,
    +                source,
    +                path,
    +                "exec",
    +            )
    +
    +        tree = TypeguardTransformer().visit(tree)
    +        ast.fix_missing_locations(tree)
    +
    +        if global_config.debug_instrumentation and sys.version_info >= (3, 9):
    +            print(
    +                f"Source code of {path!r} after instrumentation:\n"
    +                "----------------------------------------------",
    +                file=sys.stderr,
    +            )
    +            print(ast.unparse(tree), file=sys.stderr)
    +            print("----------------------------------------------", file=sys.stderr)
    +
    +        return _call_with_frames_removed(
    +            compile, tree, path, "exec", 0, dont_inherit=True
    +        )
    +
    +    def exec_module(self, module: ModuleType) -> None:
    +        # Use a custom optimization marker – the import lock should make this monkey
    +        # patch safe
    +        with patch(
    +            "importlib._bootstrap_external.cache_from_source",
    +            optimized_cache_from_source,
    +        ):
    +            super().exec_module(module)
    +
    +
    +class TypeguardFinder(MetaPathFinder):
    +    """
    +    Wraps another path finder and instruments the module with
    +    :func:`@typechecked ` if :meth:`should_instrument` returns
    +    ``True``.
    +
    +    Should not be used directly, but rather via :func:`~.install_import_hook`.
    +
    +    .. versionadded:: 2.6
    +    """
    +
    +    def __init__(self, packages: list[str] | None, original_pathfinder: MetaPathFinder):
    +        self.packages = packages
    +        self._original_pathfinder = original_pathfinder
    +
    +    def find_spec(
    +        self,
    +        fullname: str,
    +        path: Sequence[str] | None,
    +        target: types.ModuleType | None = None,
    +    ) -> ModuleSpec | None:
    +        if self.should_instrument(fullname):
    +            spec = self._original_pathfinder.find_spec(fullname, path, target)
    +            if spec is not None and isinstance(spec.loader, SourceFileLoader):
    +                spec.loader = TypeguardLoader(spec.loader.name, spec.loader.path)
    +                return spec
    +
    +        return None
    +
    +    def should_instrument(self, module_name: str) -> bool:
    +        """
    +        Determine whether the module with the given name should be instrumented.
    +
    +        :param module_name: full name of the module that is about to be imported (e.g.
    +            ``xyz.abc``)
    +
    +        """
    +        if self.packages is None:
    +            return True
    +
    +        for package in self.packages:
    +            if module_name == package or module_name.startswith(package + "."):
    +                return True
    +
    +        return False
    +
    +
    +class ImportHookManager:
    +    """
    +    A handle that can be used to uninstall the Typeguard import hook.
    +    """
    +
    +    def __init__(self, hook: MetaPathFinder):
    +        self.hook = hook
    +
    +    def __enter__(self) -> None:
    +        pass
    +
    +    def __exit__(
    +        self,
    +        exc_type: type[BaseException],
    +        exc_val: BaseException,
    +        exc_tb: TracebackType,
    +    ) -> None:
    +        self.uninstall()
    +
    +    def uninstall(self) -> None:
    +        """Uninstall the import hook."""
    +        try:
    +            sys.meta_path.remove(self.hook)
    +        except ValueError:
    +            pass  # already removed
    +
    +
    +def install_import_hook(
    +    packages: Iterable[str] | None = None,
    +    *,
    +    cls: type[TypeguardFinder] = TypeguardFinder,
    +) -> ImportHookManager:
    +    """
    +    Install an import hook that instruments functions for automatic type checking.
    +
    +    This only affects modules loaded **after** this hook has been installed.
    +
    +    :param packages: an iterable of package names to instrument, or ``None`` to
    +        instrument all packages
    +    :param cls: a custom meta path finder class
    +    :return: a context manager that uninstalls the hook on exit (or when you call
    +        ``.uninstall()``)
    +
    +    .. versionadded:: 2.6
    +
    +    """
    +    if packages is None:
    +        target_packages: list[str] | None = None
    +    elif isinstance(packages, str):
    +        target_packages = [packages]
    +    else:
    +        target_packages = list(packages)
    +
    +    for finder in sys.meta_path:
    +        if (
    +            isclass(finder)
    +            and finder.__name__ == "PathFinder"
    +            and hasattr(finder, "find_spec")
    +        ):
    +            break
    +    else:
    +        raise RuntimeError("Cannot find a PathFinder in sys.meta_path")
    +
    +    hook = cls(target_packages, finder)
    +    sys.meta_path.insert(0, hook)
    +    return ImportHookManager(hook)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_memo.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_memo.py
    new file mode 100644
    index 000000000..1d0d80c66
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_memo.py
    @@ -0,0 +1,48 @@
    +from __future__ import annotations
    +
    +from typing import Any
    +
    +from typeguard._config import TypeCheckConfiguration, global_config
    +
    +
    +class TypeCheckMemo:
    +    """
    +    Contains information necessary for type checkers to do their work.
    +
    +    .. attribute:: globals
    +       :type: dict[str, Any]
    +
    +        Dictionary of global variables to use for resolving forward references.
    +
    +    .. attribute:: locals
    +       :type: dict[str, Any]
    +
    +        Dictionary of local variables to use for resolving forward references.
    +
    +    .. attribute:: self_type
    +       :type: type | None
    +
    +        When running type checks within an instance method or class method, this is the
    +        class object that the first argument (usually named ``self`` or ``cls``) refers
    +        to.
    +
    +    .. attribute:: config
    +       :type: TypeCheckConfiguration
    +
    +         Contains the configuration for a particular set of type checking operations.
    +    """
    +
    +    __slots__ = "globals", "locals", "self_type", "config"
    +
    +    def __init__(
    +        self,
    +        globals: dict[str, Any],
    +        locals: dict[str, Any],
    +        *,
    +        self_type: type | None = None,
    +        config: TypeCheckConfiguration = global_config,
    +    ):
    +        self.globals = globals
    +        self.locals = locals
    +        self.self_type = self_type
    +        self.config = config
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_pytest_plugin.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_pytest_plugin.py
    new file mode 100644
    index 000000000..7b2f494ec
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_pytest_plugin.py
    @@ -0,0 +1,127 @@
    +from __future__ import annotations
    +
    +import sys
    +import warnings
    +from typing import TYPE_CHECKING, Any, Literal
    +
    +from typeguard._config import CollectionCheckStrategy, ForwardRefPolicy, global_config
    +from typeguard._exceptions import InstrumentationWarning
    +from typeguard._importhook import install_import_hook
    +from typeguard._utils import qualified_name, resolve_reference
    +
    +if TYPE_CHECKING:
    +    from pytest import Config, Parser
    +
    +
    +def pytest_addoption(parser: Parser) -> None:
    +    def add_ini_option(
    +        opt_type: (
    +            Literal["string", "paths", "pathlist", "args", "linelist", "bool"] | None
    +        ),
    +    ) -> None:
    +        parser.addini(
    +            group.options[-1].names()[0][2:],
    +            group.options[-1].attrs()["help"],
    +            opt_type,
    +        )
    +
    +    group = parser.getgroup("typeguard")
    +    group.addoption(
    +        "--typeguard-packages",
    +        action="store",
    +        help="comma separated name list of packages and modules to instrument for "
    +        "type checking, or :all: to instrument all modules loaded after typeguard",
    +    )
    +    add_ini_option("linelist")
    +
    +    group.addoption(
    +        "--typeguard-debug-instrumentation",
    +        action="store_true",
    +        help="print all instrumented code to stderr",
    +    )
    +    add_ini_option("bool")
    +
    +    group.addoption(
    +        "--typeguard-typecheck-fail-callback",
    +        action="store",
    +        help=(
    +            "a module:varname (e.g. typeguard:warn_on_error) reference to a function "
    +            "that is called (with the exception, and memo object as arguments) to "
    +            "handle a TypeCheckError"
    +        ),
    +    )
    +    add_ini_option("string")
    +
    +    group.addoption(
    +        "--typeguard-forward-ref-policy",
    +        action="store",
    +        choices=list(ForwardRefPolicy.__members__),
    +        help=(
    +            "determines how to deal with unresolveable forward references in type "
    +            "annotations"
    +        ),
    +    )
    +    add_ini_option("string")
    +
    +    group.addoption(
    +        "--typeguard-collection-check-strategy",
    +        action="store",
    +        choices=list(CollectionCheckStrategy.__members__),
    +        help="determines how thoroughly to check collections (list, dict, etc)",
    +    )
    +    add_ini_option("string")
    +
    +
    +def pytest_configure(config: Config) -> None:
    +    def getoption(name: str) -> Any:
    +        return config.getoption(name.replace("-", "_")) or config.getini(name)
    +
    +    packages: list[str] | None = []
    +    if packages_option := config.getoption("typeguard_packages"):
    +        packages = [pkg.strip() for pkg in packages_option.split(",")]
    +    elif packages_ini := config.getini("typeguard-packages"):
    +        packages = packages_ini
    +
    +    if packages:
    +        if packages == [":all:"]:
    +            packages = None
    +        else:
    +            already_imported_packages = sorted(
    +                package for package in packages if package in sys.modules
    +            )
    +            if already_imported_packages:
    +                warnings.warn(
    +                    f"typeguard cannot check these packages because they are already "
    +                    f"imported: {', '.join(already_imported_packages)}",
    +                    InstrumentationWarning,
    +                    stacklevel=1,
    +                )
    +
    +        install_import_hook(packages=packages)
    +
    +    debug_option = getoption("typeguard-debug-instrumentation")
    +    if debug_option:
    +        global_config.debug_instrumentation = True
    +
    +    fail_callback_option = getoption("typeguard-typecheck-fail-callback")
    +    if fail_callback_option:
    +        callback = resolve_reference(fail_callback_option)
    +        if not callable(callback):
    +            raise TypeError(
    +                f"{fail_callback_option} ({qualified_name(callback.__class__)}) is not "
    +                f"a callable"
    +            )
    +
    +        global_config.typecheck_fail_callback = callback
    +
    +    forward_ref_policy_option = getoption("typeguard-forward-ref-policy")
    +    if forward_ref_policy_option:
    +        forward_ref_policy = ForwardRefPolicy.__members__[forward_ref_policy_option]
    +        global_config.forward_ref_policy = forward_ref_policy
    +
    +    collection_check_strategy_option = getoption("typeguard-collection-check-strategy")
    +    if collection_check_strategy_option:
    +        collection_check_strategy = CollectionCheckStrategy.__members__[
    +            collection_check_strategy_option
    +        ]
    +        global_config.collection_check_strategy = collection_check_strategy
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_suppression.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_suppression.py
    new file mode 100644
    index 000000000..bbbfbfbe8
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_suppression.py
    @@ -0,0 +1,86 @@
    +from __future__ import annotations
    +
    +import sys
    +from collections.abc import Callable, Generator
    +from contextlib import contextmanager
    +from functools import update_wrapper
    +from threading import Lock
    +from typing import ContextManager, TypeVar, overload
    +
    +if sys.version_info >= (3, 10):
    +    from typing import ParamSpec
    +else:
    +    from typing_extensions import ParamSpec
    +
    +P = ParamSpec("P")
    +T = TypeVar("T")
    +
    +type_checks_suppressed = 0
    +type_checks_suppress_lock = Lock()
    +
    +
    +@overload
    +def suppress_type_checks(func: Callable[P, T]) -> Callable[P, T]: ...
    +
    +
    +@overload
    +def suppress_type_checks() -> ContextManager[None]: ...
    +
    +
    +def suppress_type_checks(
    +    func: Callable[P, T] | None = None,
    +) -> Callable[P, T] | ContextManager[None]:
    +    """
    +    Temporarily suppress all type checking.
    +
    +    This function has two operating modes, based on how it's used:
    +
    +    #. as a context manager (``with suppress_type_checks(): ...``)
    +    #. as a decorator (``@suppress_type_checks``)
    +
    +    When used as a context manager, :func:`check_type` and any automatically
    +    instrumented functions skip the actual type checking. These context managers can be
    +    nested.
    +
    +    When used as a decorator, all type checking is suppressed while the function is
    +    running.
    +
    +    Type checking will resume once no more context managers are active and no decorated
    +    functions are running.
    +
    +    Both operating modes are thread-safe.
    +
    +    """
    +
    +    def wrapper(*args: P.args, **kwargs: P.kwargs) -> T:
    +        global type_checks_suppressed
    +
    +        with type_checks_suppress_lock:
    +            type_checks_suppressed += 1
    +
    +        assert func is not None
    +        try:
    +            return func(*args, **kwargs)
    +        finally:
    +            with type_checks_suppress_lock:
    +                type_checks_suppressed -= 1
    +
    +    def cm() -> Generator[None, None, None]:
    +        global type_checks_suppressed
    +
    +        with type_checks_suppress_lock:
    +            type_checks_suppressed += 1
    +
    +        try:
    +            yield
    +        finally:
    +            with type_checks_suppress_lock:
    +                type_checks_suppressed -= 1
    +
    +    if func is None:
    +        # Context manager mode
    +        return contextmanager(cm)()
    +    else:
    +        # Decorator mode
    +        update_wrapper(wrapper, func)
    +        return wrapper
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_transformer.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_transformer.py
    new file mode 100644
    index 000000000..13ac3630e
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_transformer.py
    @@ -0,0 +1,1229 @@
    +from __future__ import annotations
    +
    +import ast
    +import builtins
    +import sys
    +import typing
    +from ast import (
    +    AST,
    +    Add,
    +    AnnAssign,
    +    Assign,
    +    AsyncFunctionDef,
    +    Attribute,
    +    AugAssign,
    +    BinOp,
    +    BitAnd,
    +    BitOr,
    +    BitXor,
    +    Call,
    +    ClassDef,
    +    Constant,
    +    Dict,
    +    Div,
    +    Expr,
    +    Expression,
    +    FloorDiv,
    +    FunctionDef,
    +    If,
    +    Import,
    +    ImportFrom,
    +    Index,
    +    List,
    +    Load,
    +    LShift,
    +    MatMult,
    +    Mod,
    +    Module,
    +    Mult,
    +    Name,
    +    NamedExpr,
    +    NodeTransformer,
    +    NodeVisitor,
    +    Pass,
    +    Pow,
    +    Return,
    +    RShift,
    +    Starred,
    +    Store,
    +    Sub,
    +    Subscript,
    +    Tuple,
    +    Yield,
    +    YieldFrom,
    +    alias,
    +    copy_location,
    +    expr,
    +    fix_missing_locations,
    +    keyword,
    +    walk,
    +)
    +from collections import defaultdict
    +from collections.abc import Generator, Sequence
    +from contextlib import contextmanager
    +from copy import deepcopy
    +from dataclasses import dataclass, field
    +from typing import Any, ClassVar, cast, overload
    +
    +generator_names = (
    +    "typing.Generator",
    +    "collections.abc.Generator",
    +    "typing.Iterator",
    +    "collections.abc.Iterator",
    +    "typing.Iterable",
    +    "collections.abc.Iterable",
    +    "typing.AsyncIterator",
    +    "collections.abc.AsyncIterator",
    +    "typing.AsyncIterable",
    +    "collections.abc.AsyncIterable",
    +    "typing.AsyncGenerator",
    +    "collections.abc.AsyncGenerator",
    +)
    +anytype_names = (
    +    "typing.Any",
    +    "typing_extensions.Any",
    +)
    +literal_names = (
    +    "typing.Literal",
    +    "typing_extensions.Literal",
    +)
    +annotated_names = (
    +    "typing.Annotated",
    +    "typing_extensions.Annotated",
    +)
    +ignore_decorators = (
    +    "typing.no_type_check",
    +    "typeguard.typeguard_ignore",
    +)
    +aug_assign_functions = {
    +    Add: "iadd",
    +    Sub: "isub",
    +    Mult: "imul",
    +    MatMult: "imatmul",
    +    Div: "itruediv",
    +    FloorDiv: "ifloordiv",
    +    Mod: "imod",
    +    Pow: "ipow",
    +    LShift: "ilshift",
    +    RShift: "irshift",
    +    BitAnd: "iand",
    +    BitXor: "ixor",
    +    BitOr: "ior",
    +}
    +
    +
    +@dataclass
    +class TransformMemo:
    +    node: Module | ClassDef | FunctionDef | AsyncFunctionDef | None
    +    parent: TransformMemo | None
    +    path: tuple[str, ...]
    +    joined_path: Constant = field(init=False)
    +    return_annotation: expr | None = None
    +    yield_annotation: expr | None = None
    +    send_annotation: expr | None = None
    +    is_async: bool = False
    +    local_names: set[str] = field(init=False, default_factory=set)
    +    imported_names: dict[str, str] = field(init=False, default_factory=dict)
    +    ignored_names: set[str] = field(init=False, default_factory=set)
    +    load_names: defaultdict[str, dict[str, Name]] = field(
    +        init=False, default_factory=lambda: defaultdict(dict)
    +    )
    +    has_yield_expressions: bool = field(init=False, default=False)
    +    has_return_expressions: bool = field(init=False, default=False)
    +    memo_var_name: Name | None = field(init=False, default=None)
    +    should_instrument: bool = field(init=False, default=True)
    +    variable_annotations: dict[str, expr] = field(init=False, default_factory=dict)
    +    configuration_overrides: dict[str, Any] = field(init=False, default_factory=dict)
    +    code_inject_index: int = field(init=False, default=0)
    +
    +    def __post_init__(self) -> None:
    +        elements: list[str] = []
    +        memo = self
    +        while isinstance(memo.node, (ClassDef, FunctionDef, AsyncFunctionDef)):
    +            elements.insert(0, memo.node.name)
    +            if not memo.parent:
    +                break
    +
    +            memo = memo.parent
    +            if isinstance(memo.node, (FunctionDef, AsyncFunctionDef)):
    +                elements.insert(0, "")
    +
    +        self.joined_path = Constant(".".join(elements))
    +
    +        # Figure out where to insert instrumentation code
    +        if self.node:
    +            for index, child in enumerate(self.node.body):
    +                if isinstance(child, ImportFrom) and child.module == "__future__":
    +                    # (module only) __future__ imports must come first
    +                    continue
    +                elif (
    +                    isinstance(child, Expr)
    +                    and isinstance(child.value, Constant)
    +                    and isinstance(child.value.value, str)
    +                ):
    +                    continue  # docstring
    +
    +                self.code_inject_index = index
    +                break
    +
    +    def get_unused_name(self, name: str) -> str:
    +        memo: TransformMemo | None = self
    +        while memo is not None:
    +            if name in memo.local_names:
    +                memo = self
    +                name += "_"
    +            else:
    +                memo = memo.parent
    +
    +        self.local_names.add(name)
    +        return name
    +
    +    def is_ignored_name(self, expression: expr | Expr | None) -> bool:
    +        top_expression = (
    +            expression.value if isinstance(expression, Expr) else expression
    +        )
    +
    +        if isinstance(top_expression, Attribute) and isinstance(
    +            top_expression.value, Name
    +        ):
    +            name = top_expression.value.id
    +        elif isinstance(top_expression, Name):
    +            name = top_expression.id
    +        else:
    +            return False
    +
    +        memo: TransformMemo | None = self
    +        while memo is not None:
    +            if name in memo.ignored_names:
    +                return True
    +
    +            memo = memo.parent
    +
    +        return False
    +
    +    def get_memo_name(self) -> Name:
    +        if not self.memo_var_name:
    +            self.memo_var_name = Name(id="memo", ctx=Load())
    +
    +        return self.memo_var_name
    +
    +    def get_import(self, module: str, name: str) -> Name:
    +        if module in self.load_names and name in self.load_names[module]:
    +            return self.load_names[module][name]
    +
    +        qualified_name = f"{module}.{name}"
    +        if name in self.imported_names and self.imported_names[name] == qualified_name:
    +            return Name(id=name, ctx=Load())
    +
    +        alias = self.get_unused_name(name)
    +        node = self.load_names[module][name] = Name(id=alias, ctx=Load())
    +        self.imported_names[name] = qualified_name
    +        return node
    +
    +    def insert_imports(self, node: Module | FunctionDef | AsyncFunctionDef) -> None:
    +        """Insert imports needed by injected code."""
    +        if not self.load_names:
    +            return
    +
    +        # Insert imports after any "from __future__ ..." imports and any docstring
    +        for modulename, names in self.load_names.items():
    +            aliases = [
    +                alias(orig_name, new_name.id if orig_name != new_name.id else None)
    +                for orig_name, new_name in sorted(names.items())
    +            ]
    +            node.body.insert(self.code_inject_index, ImportFrom(modulename, aliases, 0))
    +
    +    def name_matches(self, expression: expr | Expr | None, *names: str) -> bool:
    +        if expression is None:
    +            return False
    +
    +        path: list[str] = []
    +        top_expression = (
    +            expression.value if isinstance(expression, Expr) else expression
    +        )
    +
    +        if isinstance(top_expression, Subscript):
    +            top_expression = top_expression.value
    +        elif isinstance(top_expression, Call):
    +            top_expression = top_expression.func
    +
    +        while isinstance(top_expression, Attribute):
    +            path.insert(0, top_expression.attr)
    +            top_expression = top_expression.value
    +
    +        if not isinstance(top_expression, Name):
    +            return False
    +
    +        if top_expression.id in self.imported_names:
    +            translated = self.imported_names[top_expression.id]
    +        elif hasattr(builtins, top_expression.id):
    +            translated = "builtins." + top_expression.id
    +        else:
    +            translated = top_expression.id
    +
    +        path.insert(0, translated)
    +        joined_path = ".".join(path)
    +        if joined_path in names:
    +            return True
    +        elif self.parent:
    +            return self.parent.name_matches(expression, *names)
    +        else:
    +            return False
    +
    +    def get_config_keywords(self) -> list[keyword]:
    +        if self.parent and isinstance(self.parent.node, ClassDef):
    +            overrides = self.parent.configuration_overrides.copy()
    +        else:
    +            overrides = {}
    +
    +        overrides.update(self.configuration_overrides)
    +        return [keyword(key, value) for key, value in overrides.items()]
    +
    +
    +class NameCollector(NodeVisitor):
    +    def __init__(self) -> None:
    +        self.names: set[str] = set()
    +
    +    def visit_Import(self, node: Import) -> None:
    +        for name in node.names:
    +            self.names.add(name.asname or name.name)
    +
    +    def visit_ImportFrom(self, node: ImportFrom) -> None:
    +        for name in node.names:
    +            self.names.add(name.asname or name.name)
    +
    +    def visit_Assign(self, node: Assign) -> None:
    +        for target in node.targets:
    +            if isinstance(target, Name):
    +                self.names.add(target.id)
    +
    +    def visit_NamedExpr(self, node: NamedExpr) -> Any:
    +        if isinstance(node.target, Name):
    +            self.names.add(node.target.id)
    +
    +    def visit_FunctionDef(self, node: FunctionDef) -> None:
    +        pass
    +
    +    def visit_ClassDef(self, node: ClassDef) -> None:
    +        pass
    +
    +
    +class GeneratorDetector(NodeVisitor):
    +    """Detects if a function node is a generator function."""
    +
    +    contains_yields: bool = False
    +    in_root_function: bool = False
    +
    +    def visit_Yield(self, node: Yield) -> Any:
    +        self.contains_yields = True
    +
    +    def visit_YieldFrom(self, node: YieldFrom) -> Any:
    +        self.contains_yields = True
    +
    +    def visit_ClassDef(self, node: ClassDef) -> Any:
    +        pass
    +
    +    def visit_FunctionDef(self, node: FunctionDef | AsyncFunctionDef) -> Any:
    +        if not self.in_root_function:
    +            self.in_root_function = True
    +            self.generic_visit(node)
    +            self.in_root_function = False
    +
    +    def visit_AsyncFunctionDef(self, node: AsyncFunctionDef) -> Any:
    +        self.visit_FunctionDef(node)
    +
    +
    +class AnnotationTransformer(NodeTransformer):
    +    type_substitutions: ClassVar[dict[str, tuple[str, str]]] = {
    +        "builtins.dict": ("typing", "Dict"),
    +        "builtins.list": ("typing", "List"),
    +        "builtins.tuple": ("typing", "Tuple"),
    +        "builtins.set": ("typing", "Set"),
    +        "builtins.frozenset": ("typing", "FrozenSet"),
    +    }
    +
    +    def __init__(self, transformer: TypeguardTransformer):
    +        self.transformer = transformer
    +        self._memo = transformer._memo
    +        self._level = 0
    +
    +    def visit(self, node: AST) -> Any:
    +        # Don't process Literals
    +        if isinstance(node, expr) and self._memo.name_matches(node, *literal_names):
    +            return node
    +
    +        self._level += 1
    +        new_node = super().visit(node)
    +        self._level -= 1
    +
    +        if isinstance(new_node, Expression) and not hasattr(new_node, "body"):
    +            return None
    +
    +        # Return None if this new node matches a variation of typing.Any
    +        if (
    +            self._level == 0
    +            and isinstance(new_node, expr)
    +            and self._memo.name_matches(new_node, *anytype_names)
    +        ):
    +            return None
    +
    +        return new_node
    +
    +    def visit_BinOp(self, node: BinOp) -> Any:
    +        self.generic_visit(node)
    +
    +        if isinstance(node.op, BitOr):
    +            # If either branch of the BinOp has been transformed to `None`, it means
    +            # that a type in the union was ignored, so the entire annotation should e
    +            # ignored
    +            if not hasattr(node, "left") or not hasattr(node, "right"):
    +                return None
    +
    +            # Return Any if either side is Any
    +            if self._memo.name_matches(node.left, *anytype_names):
    +                return node.left
    +            elif self._memo.name_matches(node.right, *anytype_names):
    +                return node.right
    +
    +            if sys.version_info < (3, 10):
    +                union_name = self.transformer._get_import("typing", "Union")
    +                return Subscript(
    +                    value=union_name,
    +                    slice=Index(
    +                        Tuple(elts=[node.left, node.right], ctx=Load()), ctx=Load()
    +                    ),
    +                    ctx=Load(),
    +                )
    +
    +        return node
    +
    +    def visit_Attribute(self, node: Attribute) -> Any:
    +        if self._memo.is_ignored_name(node):
    +            return None
    +
    +        return node
    +
    +    def visit_Subscript(self, node: Subscript) -> Any:
    +        if self._memo.is_ignored_name(node.value):
    +            return None
    +
    +        # The subscript of typing(_extensions).Literal can be any arbitrary string, so
    +        # don't try to evaluate it as code
    +        if node.slice:
    +            if isinstance(node.slice, Index):
    +                # Python 3.8
    +                slice_value = node.slice.value  # type: ignore[attr-defined]
    +            else:
    +                slice_value = node.slice
    +
    +            if isinstance(slice_value, Tuple):
    +                if self._memo.name_matches(node.value, *annotated_names):
    +                    # Only treat the first argument to typing.Annotated as a potential
    +                    # forward reference
    +                    items = cast(
    +                        typing.List[expr],
    +                        [self.visit(slice_value.elts[0])] + slice_value.elts[1:],
    +                    )
    +                else:
    +                    items = cast(
    +                        typing.List[expr],
    +                        [self.visit(item) for item in slice_value.elts],
    +                    )
    +
    +                # If this is a Union and any of the items is Any, erase the entire
    +                # annotation
    +                if self._memo.name_matches(node.value, "typing.Union") and any(
    +                    item is None
    +                    or (
    +                        isinstance(item, expr)
    +                        and self._memo.name_matches(item, *anytype_names)
    +                    )
    +                    for item in items
    +                ):
    +                    return None
    +
    +                # If all items in the subscript were Any, erase the subscript entirely
    +                if all(item is None for item in items):
    +                    return node.value
    +
    +                for index, item in enumerate(items):
    +                    if item is None:
    +                        items[index] = self.transformer._get_import("typing", "Any")
    +
    +                slice_value.elts = items
    +            else:
    +                self.generic_visit(node)
    +
    +                # If the transformer erased the slice entirely, just return the node
    +                # value without the subscript (unless it's Optional, in which case erase
    +                # the node entirely
    +                if self._memo.name_matches(
    +                    node.value, "typing.Optional"
    +                ) and not hasattr(node, "slice"):
    +                    return None
    +                if sys.version_info >= (3, 9) and not hasattr(node, "slice"):
    +                    return node.value
    +                elif sys.version_info < (3, 9) and not hasattr(node.slice, "value"):
    +                    return node.value
    +
    +        return node
    +
    +    def visit_Name(self, node: Name) -> Any:
    +        if self._memo.is_ignored_name(node):
    +            return None
    +
    +        if sys.version_info < (3, 9):
    +            for typename, substitute in self.type_substitutions.items():
    +                if self._memo.name_matches(node, typename):
    +                    new_node = self.transformer._get_import(*substitute)
    +                    return copy_location(new_node, node)
    +
    +        return node
    +
    +    def visit_Call(self, node: Call) -> Any:
    +        # Don't recurse into calls
    +        return node
    +
    +    def visit_Constant(self, node: Constant) -> Any:
    +        if isinstance(node.value, str):
    +            expression = ast.parse(node.value, mode="eval")
    +            new_node = self.visit(expression)
    +            if new_node:
    +                return copy_location(new_node.body, node)
    +            else:
    +                return None
    +
    +        return node
    +
    +
    +class TypeguardTransformer(NodeTransformer):
    +    def __init__(
    +        self, target_path: Sequence[str] | None = None, target_lineno: int | None = None
    +    ) -> None:
    +        self._target_path = tuple(target_path) if target_path else None
    +        self._memo = self._module_memo = TransformMemo(None, None, ())
    +        self.names_used_in_annotations: set[str] = set()
    +        self.target_node: FunctionDef | AsyncFunctionDef | None = None
    +        self.target_lineno = target_lineno
    +
    +    def generic_visit(self, node: AST) -> AST:
    +        has_non_empty_body_initially = bool(getattr(node, "body", None))
    +        initial_type = type(node)
    +
    +        node = super().generic_visit(node)
    +
    +        if (
    +            type(node) is initial_type
    +            and has_non_empty_body_initially
    +            and hasattr(node, "body")
    +            and not node.body
    +        ):
    +            # If we have still the same node type after transformation
    +            # but we've optimised it's body away, we add a `pass` statement.
    +            node.body = [Pass()]
    +
    +        return node
    +
    +    @contextmanager
    +    def _use_memo(
    +        self, node: ClassDef | FunctionDef | AsyncFunctionDef
    +    ) -> Generator[None, Any, None]:
    +        new_memo = TransformMemo(node, self._memo, self._memo.path + (node.name,))
    +        old_memo = self._memo
    +        self._memo = new_memo
    +
    +        if isinstance(node, (FunctionDef, AsyncFunctionDef)):
    +            new_memo.should_instrument = (
    +                self._target_path is None or new_memo.path == self._target_path
    +            )
    +            if new_memo.should_instrument:
    +                # Check if the function is a generator function
    +                detector = GeneratorDetector()
    +                detector.visit(node)
    +
    +                # Extract yield, send and return types where possible from a subscripted
    +                # annotation like Generator[int, str, bool]
    +                return_annotation = deepcopy(node.returns)
    +                if detector.contains_yields and new_memo.name_matches(
    +                    return_annotation, *generator_names
    +                ):
    +                    if isinstance(return_annotation, Subscript):
    +                        annotation_slice = return_annotation.slice
    +
    +                        # Python < 3.9
    +                        if isinstance(annotation_slice, Index):
    +                            annotation_slice = (
    +                                annotation_slice.value  # type: ignore[attr-defined]
    +                            )
    +
    +                        if isinstance(annotation_slice, Tuple):
    +                            items = annotation_slice.elts
    +                        else:
    +                            items = [annotation_slice]
    +
    +                        if len(items) > 0:
    +                            new_memo.yield_annotation = self._convert_annotation(
    +                                items[0]
    +                            )
    +
    +                        if len(items) > 1:
    +                            new_memo.send_annotation = self._convert_annotation(
    +                                items[1]
    +                            )
    +
    +                        if len(items) > 2:
    +                            new_memo.return_annotation = self._convert_annotation(
    +                                items[2]
    +                            )
    +                else:
    +                    new_memo.return_annotation = self._convert_annotation(
    +                        return_annotation
    +                    )
    +
    +        if isinstance(node, AsyncFunctionDef):
    +            new_memo.is_async = True
    +
    +        yield
    +        self._memo = old_memo
    +
    +    def _get_import(self, module: str, name: str) -> Name:
    +        memo = self._memo if self._target_path else self._module_memo
    +        return memo.get_import(module, name)
    +
    +    @overload
    +    def _convert_annotation(self, annotation: None) -> None: ...
    +
    +    @overload
    +    def _convert_annotation(self, annotation: expr) -> expr: ...
    +
    +    def _convert_annotation(self, annotation: expr | None) -> expr | None:
    +        if annotation is None:
    +            return None
    +
    +        # Convert PEP 604 unions (x | y) and generic built-in collections where
    +        # necessary, and undo forward references
    +        new_annotation = cast(expr, AnnotationTransformer(self).visit(annotation))
    +        if isinstance(new_annotation, expr):
    +            new_annotation = ast.copy_location(new_annotation, annotation)
    +
    +            # Store names used in the annotation
    +            names = {node.id for node in walk(new_annotation) if isinstance(node, Name)}
    +            self.names_used_in_annotations.update(names)
    +
    +        return new_annotation
    +
    +    def visit_Name(self, node: Name) -> Name:
    +        self._memo.local_names.add(node.id)
    +        return node
    +
    +    def visit_Module(self, node: Module) -> Module:
    +        self._module_memo = self._memo = TransformMemo(node, None, ())
    +        self.generic_visit(node)
    +        self._module_memo.insert_imports(node)
    +
    +        fix_missing_locations(node)
    +        return node
    +
    +    def visit_Import(self, node: Import) -> Import:
    +        for name in node.names:
    +            self._memo.local_names.add(name.asname or name.name)
    +            self._memo.imported_names[name.asname or name.name] = name.name
    +
    +        return node
    +
    +    def visit_ImportFrom(self, node: ImportFrom) -> ImportFrom:
    +        for name in node.names:
    +            if name.name != "*":
    +                alias = name.asname or name.name
    +                self._memo.local_names.add(alias)
    +                self._memo.imported_names[alias] = f"{node.module}.{name.name}"
    +
    +        return node
    +
    +    def visit_ClassDef(self, node: ClassDef) -> ClassDef | None:
    +        self._memo.local_names.add(node.name)
    +
    +        # Eliminate top level classes not belonging to the target path
    +        if (
    +            self._target_path is not None
    +            and not self._memo.path
    +            and node.name != self._target_path[0]
    +        ):
    +            return None
    +
    +        with self._use_memo(node):
    +            for decorator in node.decorator_list.copy():
    +                if self._memo.name_matches(decorator, "typeguard.typechecked"):
    +                    # Remove the decorator to prevent duplicate instrumentation
    +                    node.decorator_list.remove(decorator)
    +
    +                    # Store any configuration overrides
    +                    if isinstance(decorator, Call) and decorator.keywords:
    +                        self._memo.configuration_overrides.update(
    +                            {kw.arg: kw.value for kw in decorator.keywords if kw.arg}
    +                        )
    +
    +            self.generic_visit(node)
    +            return node
    +
    +    def visit_FunctionDef(
    +        self, node: FunctionDef | AsyncFunctionDef
    +    ) -> FunctionDef | AsyncFunctionDef | None:
    +        """
    +        Injects type checks for function arguments, and for a return of None if the
    +        function is annotated to return something else than Any or None, and the body
    +        ends without an explicit "return".
    +
    +        """
    +        self._memo.local_names.add(node.name)
    +
    +        # Eliminate top level functions not belonging to the target path
    +        if (
    +            self._target_path is not None
    +            and not self._memo.path
    +            and node.name != self._target_path[0]
    +        ):
    +            return None
    +
    +        # Skip instrumentation if we're instrumenting the whole module and the function
    +        # contains either @no_type_check or @typeguard_ignore
    +        if self._target_path is None:
    +            for decorator in node.decorator_list:
    +                if self._memo.name_matches(decorator, *ignore_decorators):
    +                    return node
    +
    +        with self._use_memo(node):
    +            arg_annotations: dict[str, Any] = {}
    +            if self._target_path is None or self._memo.path == self._target_path:
    +                # Find line number we're supposed to match against
    +                if node.decorator_list:
    +                    first_lineno = node.decorator_list[0].lineno
    +                else:
    +                    first_lineno = node.lineno
    +
    +                for decorator in node.decorator_list.copy():
    +                    if self._memo.name_matches(decorator, "typing.overload"):
    +                        # Remove overloads entirely
    +                        return None
    +                    elif self._memo.name_matches(decorator, "typeguard.typechecked"):
    +                        # Remove the decorator to prevent duplicate instrumentation
    +                        node.decorator_list.remove(decorator)
    +
    +                        # Store any configuration overrides
    +                        if isinstance(decorator, Call) and decorator.keywords:
    +                            self._memo.configuration_overrides = {
    +                                kw.arg: kw.value for kw in decorator.keywords if kw.arg
    +                            }
    +
    +                if self.target_lineno == first_lineno:
    +                    assert self.target_node is None
    +                    self.target_node = node
    +                    if node.decorator_list:
    +                        self.target_lineno = node.decorator_list[0].lineno
    +                    else:
    +                        self.target_lineno = node.lineno
    +
    +                all_args = node.args.args + node.args.kwonlyargs + node.args.posonlyargs
    +
    +                # Ensure that any type shadowed by the positional or keyword-only
    +                # argument names are ignored in this function
    +                for arg in all_args:
    +                    self._memo.ignored_names.add(arg.arg)
    +
    +                # Ensure that any type shadowed by the variable positional argument name
    +                # (e.g. "args" in *args) is ignored this function
    +                if node.args.vararg:
    +                    self._memo.ignored_names.add(node.args.vararg.arg)
    +
    +                # Ensure that any type shadowed by the variable keywrod argument name
    +                # (e.g. "kwargs" in *kwargs) is ignored this function
    +                if node.args.kwarg:
    +                    self._memo.ignored_names.add(node.args.kwarg.arg)
    +
    +                for arg in all_args:
    +                    annotation = self._convert_annotation(deepcopy(arg.annotation))
    +                    if annotation:
    +                        arg_annotations[arg.arg] = annotation
    +
    +                if node.args.vararg:
    +                    annotation_ = self._convert_annotation(node.args.vararg.annotation)
    +                    if annotation_:
    +                        if sys.version_info >= (3, 9):
    +                            container = Name("tuple", ctx=Load())
    +                        else:
    +                            container = self._get_import("typing", "Tuple")
    +
    +                        subscript_slice: Tuple | Index = Tuple(
    +                            [
    +                                annotation_,
    +                                Constant(Ellipsis),
    +                            ],
    +                            ctx=Load(),
    +                        )
    +                        if sys.version_info < (3, 9):
    +                            subscript_slice = Index(subscript_slice, ctx=Load())
    +
    +                        arg_annotations[node.args.vararg.arg] = Subscript(
    +                            container, subscript_slice, ctx=Load()
    +                        )
    +
    +                if node.args.kwarg:
    +                    annotation_ = self._convert_annotation(node.args.kwarg.annotation)
    +                    if annotation_:
    +                        if sys.version_info >= (3, 9):
    +                            container = Name("dict", ctx=Load())
    +                        else:
    +                            container = self._get_import("typing", "Dict")
    +
    +                        subscript_slice = Tuple(
    +                            [
    +                                Name("str", ctx=Load()),
    +                                annotation_,
    +                            ],
    +                            ctx=Load(),
    +                        )
    +                        if sys.version_info < (3, 9):
    +                            subscript_slice = Index(subscript_slice, ctx=Load())
    +
    +                        arg_annotations[node.args.kwarg.arg] = Subscript(
    +                            container, subscript_slice, ctx=Load()
    +                        )
    +
    +                if arg_annotations:
    +                    self._memo.variable_annotations.update(arg_annotations)
    +
    +            self.generic_visit(node)
    +
    +            if arg_annotations:
    +                annotations_dict = Dict(
    +                    keys=[Constant(key) for key in arg_annotations.keys()],
    +                    values=[
    +                        Tuple([Name(key, ctx=Load()), annotation], ctx=Load())
    +                        for key, annotation in arg_annotations.items()
    +                    ],
    +                )
    +                func_name = self._get_import(
    +                    "typeguard._functions", "check_argument_types"
    +                )
    +                args = [
    +                    self._memo.joined_path,
    +                    annotations_dict,
    +                    self._memo.get_memo_name(),
    +                ]
    +                node.body.insert(
    +                    self._memo.code_inject_index, Expr(Call(func_name, args, []))
    +                )
    +
    +            # Add a checked "return None" to the end if there's no explicit return
    +            # Skip if the return annotation is None or Any
    +            if (
    +                self._memo.return_annotation
    +                and (not self._memo.is_async or not self._memo.has_yield_expressions)
    +                and not isinstance(node.body[-1], Return)
    +                and (
    +                    not isinstance(self._memo.return_annotation, Constant)
    +                    or self._memo.return_annotation.value is not None
    +                )
    +            ):
    +                func_name = self._get_import(
    +                    "typeguard._functions", "check_return_type"
    +                )
    +                return_node = Return(
    +                    Call(
    +                        func_name,
    +                        [
    +                            self._memo.joined_path,
    +                            Constant(None),
    +                            self._memo.return_annotation,
    +                            self._memo.get_memo_name(),
    +                        ],
    +                        [],
    +                    )
    +                )
    +
    +                # Replace a placeholder "pass" at the end
    +                if isinstance(node.body[-1], Pass):
    +                    copy_location(return_node, node.body[-1])
    +                    del node.body[-1]
    +
    +                node.body.append(return_node)
    +
    +            # Insert code to create the call memo, if it was ever needed for this
    +            # function
    +            if self._memo.memo_var_name:
    +                memo_kwargs: dict[str, Any] = {}
    +                if self._memo.parent and isinstance(self._memo.parent.node, ClassDef):
    +                    for decorator in node.decorator_list:
    +                        if (
    +                            isinstance(decorator, Name)
    +                            and decorator.id == "staticmethod"
    +                        ):
    +                            break
    +                        elif (
    +                            isinstance(decorator, Name)
    +                            and decorator.id == "classmethod"
    +                        ):
    +                            memo_kwargs["self_type"] = Name(
    +                                id=node.args.args[0].arg, ctx=Load()
    +                            )
    +                            break
    +                    else:
    +                        if node.args.args:
    +                            if node.name == "__new__":
    +                                memo_kwargs["self_type"] = Name(
    +                                    id=node.args.args[0].arg, ctx=Load()
    +                                )
    +                            else:
    +                                memo_kwargs["self_type"] = Attribute(
    +                                    Name(id=node.args.args[0].arg, ctx=Load()),
    +                                    "__class__",
    +                                    ctx=Load(),
    +                                )
    +
    +                # Construct the function reference
    +                # Nested functions get special treatment: the function name is added
    +                # to free variables (and the closure of the resulting function)
    +                names: list[str] = [node.name]
    +                memo = self._memo.parent
    +                while memo:
    +                    if isinstance(memo.node, (FunctionDef, AsyncFunctionDef)):
    +                        # This is a nested function. Use the function name as-is.
    +                        del names[:-1]
    +                        break
    +                    elif not isinstance(memo.node, ClassDef):
    +                        break
    +
    +                    names.insert(0, memo.node.name)
    +                    memo = memo.parent
    +
    +                config_keywords = self._memo.get_config_keywords()
    +                if config_keywords:
    +                    memo_kwargs["config"] = Call(
    +                        self._get_import("dataclasses", "replace"),
    +                        [self._get_import("typeguard._config", "global_config")],
    +                        config_keywords,
    +                    )
    +
    +                self._memo.memo_var_name.id = self._memo.get_unused_name("memo")
    +                memo_store_name = Name(id=self._memo.memo_var_name.id, ctx=Store())
    +                globals_call = Call(Name(id="globals", ctx=Load()), [], [])
    +                locals_call = Call(Name(id="locals", ctx=Load()), [], [])
    +                memo_expr = Call(
    +                    self._get_import("typeguard", "TypeCheckMemo"),
    +                    [globals_call, locals_call],
    +                    [keyword(key, value) for key, value in memo_kwargs.items()],
    +                )
    +                node.body.insert(
    +                    self._memo.code_inject_index,
    +                    Assign([memo_store_name], memo_expr),
    +                )
    +
    +                self._memo.insert_imports(node)
    +
    +                # Special case the __new__() method to create a local alias from the
    +                # class name to the first argument (usually "cls")
    +                if (
    +                    isinstance(node, FunctionDef)
    +                    and node.args
    +                    and self._memo.parent is not None
    +                    and isinstance(self._memo.parent.node, ClassDef)
    +                    and node.name == "__new__"
    +                ):
    +                    first_args_expr = Name(node.args.args[0].arg, ctx=Load())
    +                    cls_name = Name(self._memo.parent.node.name, ctx=Store())
    +                    node.body.insert(
    +                        self._memo.code_inject_index,
    +                        Assign([cls_name], first_args_expr),
    +                    )
    +
    +                # Rmove any placeholder "pass" at the end
    +                if isinstance(node.body[-1], Pass):
    +                    del node.body[-1]
    +
    +        return node
    +
    +    def visit_AsyncFunctionDef(
    +        self, node: AsyncFunctionDef
    +    ) -> FunctionDef | AsyncFunctionDef | None:
    +        return self.visit_FunctionDef(node)
    +
    +    def visit_Return(self, node: Return) -> Return:
    +        """This injects type checks into "return" statements."""
    +        self.generic_visit(node)
    +        if (
    +            self._memo.return_annotation
    +            and self._memo.should_instrument
    +            and not self._memo.is_ignored_name(self._memo.return_annotation)
    +        ):
    +            func_name = self._get_import("typeguard._functions", "check_return_type")
    +            old_node = node
    +            retval = old_node.value or Constant(None)
    +            node = Return(
    +                Call(
    +                    func_name,
    +                    [
    +                        self._memo.joined_path,
    +                        retval,
    +                        self._memo.return_annotation,
    +                        self._memo.get_memo_name(),
    +                    ],
    +                    [],
    +                )
    +            )
    +            copy_location(node, old_node)
    +
    +        return node
    +
    +    def visit_Yield(self, node: Yield) -> Yield | Call:
    +        """
    +        This injects type checks into "yield" expressions, checking both the yielded
    +        value and the value sent back to the generator, when appropriate.
    +
    +        """
    +        self._memo.has_yield_expressions = True
    +        self.generic_visit(node)
    +
    +        if (
    +            self._memo.yield_annotation
    +            and self._memo.should_instrument
    +            and not self._memo.is_ignored_name(self._memo.yield_annotation)
    +        ):
    +            func_name = self._get_import("typeguard._functions", "check_yield_type")
    +            yieldval = node.value or Constant(None)
    +            node.value = Call(
    +                func_name,
    +                [
    +                    self._memo.joined_path,
    +                    yieldval,
    +                    self._memo.yield_annotation,
    +                    self._memo.get_memo_name(),
    +                ],
    +                [],
    +            )
    +
    +        if (
    +            self._memo.send_annotation
    +            and self._memo.should_instrument
    +            and not self._memo.is_ignored_name(self._memo.send_annotation)
    +        ):
    +            func_name = self._get_import("typeguard._functions", "check_send_type")
    +            old_node = node
    +            call_node = Call(
    +                func_name,
    +                [
    +                    self._memo.joined_path,
    +                    old_node,
    +                    self._memo.send_annotation,
    +                    self._memo.get_memo_name(),
    +                ],
    +                [],
    +            )
    +            copy_location(call_node, old_node)
    +            return call_node
    +
    +        return node
    +
    +    def visit_AnnAssign(self, node: AnnAssign) -> Any:
    +        """
    +        This injects a type check into a local variable annotation-assignment within a
    +        function body.
    +
    +        """
    +        self.generic_visit(node)
    +
    +        if (
    +            isinstance(self._memo.node, (FunctionDef, AsyncFunctionDef))
    +            and node.annotation
    +            and isinstance(node.target, Name)
    +        ):
    +            self._memo.ignored_names.add(node.target.id)
    +            annotation = self._convert_annotation(deepcopy(node.annotation))
    +            if annotation:
    +                self._memo.variable_annotations[node.target.id] = annotation
    +                if node.value:
    +                    func_name = self._get_import(
    +                        "typeguard._functions", "check_variable_assignment"
    +                    )
    +                    node.value = Call(
    +                        func_name,
    +                        [
    +                            node.value,
    +                            Constant(node.target.id),
    +                            annotation,
    +                            self._memo.get_memo_name(),
    +                        ],
    +                        [],
    +                    )
    +
    +        return node
    +
    +    def visit_Assign(self, node: Assign) -> Any:
    +        """
    +        This injects a type check into a local variable assignment within a function
    +        body. The variable must have been annotated earlier in the function body.
    +
    +        """
    +        self.generic_visit(node)
    +
    +        # Only instrument function-local assignments
    +        if isinstance(self._memo.node, (FunctionDef, AsyncFunctionDef)):
    +            targets: list[dict[Constant, expr | None]] = []
    +            check_required = False
    +            for target in node.targets:
    +                elts: Sequence[expr]
    +                if isinstance(target, Name):
    +                    elts = [target]
    +                elif isinstance(target, Tuple):
    +                    elts = target.elts
    +                else:
    +                    continue
    +
    +                annotations_: dict[Constant, expr | None] = {}
    +                for exp in elts:
    +                    prefix = ""
    +                    if isinstance(exp, Starred):
    +                        exp = exp.value
    +                        prefix = "*"
    +
    +                    if isinstance(exp, Name):
    +                        self._memo.ignored_names.add(exp.id)
    +                        name = prefix + exp.id
    +                        annotation = self._memo.variable_annotations.get(exp.id)
    +                        if annotation:
    +                            annotations_[Constant(name)] = annotation
    +                            check_required = True
    +                        else:
    +                            annotations_[Constant(name)] = None
    +
    +                targets.append(annotations_)
    +
    +            if check_required:
    +                # Replace missing annotations with typing.Any
    +                for item in targets:
    +                    for key, expression in item.items():
    +                        if expression is None:
    +                            item[key] = self._get_import("typing", "Any")
    +
    +                if len(targets) == 1 and len(targets[0]) == 1:
    +                    func_name = self._get_import(
    +                        "typeguard._functions", "check_variable_assignment"
    +                    )
    +                    target_varname = next(iter(targets[0]))
    +                    node.value = Call(
    +                        func_name,
    +                        [
    +                            node.value,
    +                            target_varname,
    +                            targets[0][target_varname],
    +                            self._memo.get_memo_name(),
    +                        ],
    +                        [],
    +                    )
    +                elif targets:
    +                    func_name = self._get_import(
    +                        "typeguard._functions", "check_multi_variable_assignment"
    +                    )
    +                    targets_arg = List(
    +                        [
    +                            Dict(keys=list(target), values=list(target.values()))
    +                            for target in targets
    +                        ],
    +                        ctx=Load(),
    +                    )
    +                    node.value = Call(
    +                        func_name,
    +                        [node.value, targets_arg, self._memo.get_memo_name()],
    +                        [],
    +                    )
    +
    +        return node
    +
    +    def visit_NamedExpr(self, node: NamedExpr) -> Any:
    +        """This injects a type check into an assignment expression (a := foo())."""
    +        self.generic_visit(node)
    +
    +        # Only instrument function-local assignments
    +        if isinstance(self._memo.node, (FunctionDef, AsyncFunctionDef)) and isinstance(
    +            node.target, Name
    +        ):
    +            self._memo.ignored_names.add(node.target.id)
    +
    +            # Bail out if no matching annotation is found
    +            annotation = self._memo.variable_annotations.get(node.target.id)
    +            if annotation is None:
    +                return node
    +
    +            func_name = self._get_import(
    +                "typeguard._functions", "check_variable_assignment"
    +            )
    +            node.value = Call(
    +                func_name,
    +                [
    +                    node.value,
    +                    Constant(node.target.id),
    +                    annotation,
    +                    self._memo.get_memo_name(),
    +                ],
    +                [],
    +            )
    +
    +        return node
    +
    +    def visit_AugAssign(self, node: AugAssign) -> Any:
    +        """
    +        This injects a type check into an augmented assignment expression (a += 1).
    +
    +        """
    +        self.generic_visit(node)
    +
    +        # Only instrument function-local assignments
    +        if isinstance(self._memo.node, (FunctionDef, AsyncFunctionDef)) and isinstance(
    +            node.target, Name
    +        ):
    +            # Bail out if no matching annotation is found
    +            annotation = self._memo.variable_annotations.get(node.target.id)
    +            if annotation is None:
    +                return node
    +
    +            # Bail out if the operator is not found (newer Python version?)
    +            try:
    +                operator_func_name = aug_assign_functions[node.op.__class__]
    +            except KeyError:
    +                return node
    +
    +            operator_func = self._get_import("operator", operator_func_name)
    +            operator_call = Call(
    +                operator_func, [Name(node.target.id, ctx=Load()), node.value], []
    +            )
    +            check_call = Call(
    +                self._get_import("typeguard._functions", "check_variable_assignment"),
    +                [
    +                    operator_call,
    +                    Constant(node.target.id),
    +                    annotation,
    +                    self._memo.get_memo_name(),
    +                ],
    +                [],
    +            )
    +            return Assign(targets=[node.target], value=check_call)
    +
    +        return node
    +
    +    def visit_If(self, node: If) -> Any:
    +        """
    +        This blocks names from being collected from a module-level
    +        "if typing.TYPE_CHECKING:" block, so that they won't be type checked.
    +
    +        """
    +        self.generic_visit(node)
    +
    +        if (
    +            self._memo is self._module_memo
    +            and isinstance(node.test, Name)
    +            and self._memo.name_matches(node.test, "typing.TYPE_CHECKING")
    +        ):
    +            collector = NameCollector()
    +            collector.visit(node)
    +            self._memo.ignored_names.update(collector.names)
    +
    +        return node
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_union_transformer.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_union_transformer.py
    new file mode 100644
    index 000000000..19617e6af
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_union_transformer.py
    @@ -0,0 +1,55 @@
    +"""
    +Transforms lazily evaluated PEP 604 unions into typing.Unions, for compatibility with
    +Python versions older than 3.10.
    +"""
    +
    +from __future__ import annotations
    +
    +from ast import (
    +    BinOp,
    +    BitOr,
    +    Index,
    +    Load,
    +    Name,
    +    NodeTransformer,
    +    Subscript,
    +    fix_missing_locations,
    +    parse,
    +)
    +from ast import Tuple as ASTTuple
    +from types import CodeType
    +from typing import Any, Dict, FrozenSet, List, Set, Tuple, Union
    +
    +type_substitutions = {
    +    "dict": Dict,
    +    "list": List,
    +    "tuple": Tuple,
    +    "set": Set,
    +    "frozenset": FrozenSet,
    +    "Union": Union,
    +}
    +
    +
    +class UnionTransformer(NodeTransformer):
    +    def __init__(self, union_name: Name | None = None):
    +        self.union_name = union_name or Name(id="Union", ctx=Load())
    +
    +    def visit_BinOp(self, node: BinOp) -> Any:
    +        self.generic_visit(node)
    +        if isinstance(node.op, BitOr):
    +            return Subscript(
    +                value=self.union_name,
    +                slice=Index(
    +                    ASTTuple(elts=[node.left, node.right], ctx=Load()), ctx=Load()
    +                ),
    +                ctx=Load(),
    +            )
    +
    +        return node
    +
    +
    +def compile_type_hint(hint: str) -> CodeType:
    +    parsed = parse(hint, "", "eval")
    +    UnionTransformer().visit(parsed)
    +    fix_missing_locations(parsed)
    +    return compile(parsed, "", "eval", flags=0)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_utils.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_utils.py
    new file mode 100644
    index 000000000..9bcc8417f
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/_utils.py
    @@ -0,0 +1,173 @@
    +from __future__ import annotations
    +
    +import inspect
    +import sys
    +from importlib import import_module
    +from inspect import currentframe
    +from types import CodeType, FrameType, FunctionType
    +from typing import TYPE_CHECKING, Any, Callable, ForwardRef, Union, cast, final
    +from weakref import WeakValueDictionary
    +
    +if TYPE_CHECKING:
    +    from ._memo import TypeCheckMemo
    +
    +if sys.version_info >= (3, 13):
    +    from typing import get_args, get_origin
    +
    +    def evaluate_forwardref(forwardref: ForwardRef, memo: TypeCheckMemo) -> Any:
    +        return forwardref._evaluate(
    +            memo.globals, memo.locals, type_params=(), recursive_guard=frozenset()
    +        )
    +
    +elif sys.version_info >= (3, 10):
    +    from typing import get_args, get_origin
    +
    +    def evaluate_forwardref(forwardref: ForwardRef, memo: TypeCheckMemo) -> Any:
    +        return forwardref._evaluate(
    +            memo.globals, memo.locals, recursive_guard=frozenset()
    +        )
    +
    +else:
    +    from typing_extensions import get_args, get_origin
    +
    +    evaluate_extra_args: tuple[frozenset[Any], ...] = (
    +        (frozenset(),) if sys.version_info >= (3, 9) else ()
    +    )
    +
    +    def evaluate_forwardref(forwardref: ForwardRef, memo: TypeCheckMemo) -> Any:
    +        from ._union_transformer import compile_type_hint, type_substitutions
    +
    +        if not forwardref.__forward_evaluated__:
    +            forwardref.__forward_code__ = compile_type_hint(forwardref.__forward_arg__)
    +
    +        try:
    +            return forwardref._evaluate(memo.globals, memo.locals, *evaluate_extra_args)
    +        except NameError:
    +            if sys.version_info < (3, 10):
    +                # Try again, with the type substitutions (list -> List etc.) in place
    +                new_globals = memo.globals.copy()
    +                new_globals.setdefault("Union", Union)
    +                if sys.version_info < (3, 9):
    +                    new_globals.update(type_substitutions)
    +
    +                return forwardref._evaluate(
    +                    new_globals, memo.locals or new_globals, *evaluate_extra_args
    +                )
    +
    +            raise
    +
    +
    +_functions_map: WeakValueDictionary[CodeType, FunctionType] = WeakValueDictionary()
    +
    +
    +def get_type_name(type_: Any) -> str:
    +    name: str
    +    for attrname in "__name__", "_name", "__forward_arg__":
    +        candidate = getattr(type_, attrname, None)
    +        if isinstance(candidate, str):
    +            name = candidate
    +            break
    +    else:
    +        origin = get_origin(type_)
    +        candidate = getattr(origin, "_name", None)
    +        if candidate is None:
    +            candidate = type_.__class__.__name__.strip("_")
    +
    +        if isinstance(candidate, str):
    +            name = candidate
    +        else:
    +            return "(unknown)"
    +
    +    args = get_args(type_)
    +    if args:
    +        if name == "Literal":
    +            formatted_args = ", ".join(repr(arg) for arg in args)
    +        else:
    +            formatted_args = ", ".join(get_type_name(arg) for arg in args)
    +
    +        name += f"[{formatted_args}]"
    +
    +    module = getattr(type_, "__module__", None)
    +    if module and module not in (None, "typing", "typing_extensions", "builtins"):
    +        name = module + "." + name
    +
    +    return name
    +
    +
    +def qualified_name(obj: Any, *, add_class_prefix: bool = False) -> str:
    +    """
    +    Return the qualified name (e.g. package.module.Type) for the given object.
    +
    +    Builtins and types from the :mod:`typing` package get special treatment by having
    +    the module name stripped from the generated name.
    +
    +    """
    +    if obj is None:
    +        return "None"
    +    elif inspect.isclass(obj):
    +        prefix = "class " if add_class_prefix else ""
    +        type_ = obj
    +    else:
    +        prefix = ""
    +        type_ = type(obj)
    +
    +    module = type_.__module__
    +    qualname = type_.__qualname__
    +    name = qualname if module in ("typing", "builtins") else f"{module}.{qualname}"
    +    return prefix + name
    +
    +
    +def function_name(func: Callable[..., Any]) -> str:
    +    """
    +    Return the qualified name of the given function.
    +
    +    Builtins and types from the :mod:`typing` package get special treatment by having
    +    the module name stripped from the generated name.
    +
    +    """
    +    # For partial functions and objects with __call__ defined, __qualname__ does not
    +    # exist
    +    module = getattr(func, "__module__", "")
    +    qualname = (module + ".") if module not in ("builtins", "") else ""
    +    return qualname + getattr(func, "__qualname__", repr(func))
    +
    +
    +def resolve_reference(reference: str) -> Any:
    +    modulename, varname = reference.partition(":")[::2]
    +    if not modulename or not varname:
    +        raise ValueError(f"{reference!r} is not a module:varname reference")
    +
    +    obj = import_module(modulename)
    +    for attr in varname.split("."):
    +        obj = getattr(obj, attr)
    +
    +    return obj
    +
    +
    +def is_method_of(obj: object, cls: type) -> bool:
    +    return (
    +        inspect.isfunction(obj)
    +        and obj.__module__ == cls.__module__
    +        and obj.__qualname__.startswith(cls.__qualname__ + ".")
    +    )
    +
    +
    +def get_stacklevel() -> int:
    +    level = 1
    +    frame = cast(FrameType, currentframe()).f_back
    +    while frame and frame.f_globals.get("__name__", "").startswith("typeguard."):
    +        level += 1
    +        frame = frame.f_back
    +
    +    return level
    +
    +
    +@final
    +class Unset:
    +    __slots__ = ()
    +
    +    def __repr__(self) -> str:
    +        return ""
    +
    +
    +unset = Unset()
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/py.typed b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typeguard/py.typed
    new file mode 100644
    index 000000000..e69de29bb
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/INSTALLER
    new file mode 100644
    index 000000000..a1b589e38
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/INSTALLER
    @@ -0,0 +1 @@
    +pip
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/LICENSE
    new file mode 100644
    index 000000000..f26bcf4d2
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/LICENSE
    @@ -0,0 +1,279 @@
    +A. HISTORY OF THE SOFTWARE
    +==========================
    +
    +Python was created in the early 1990s by Guido van Rossum at Stichting
    +Mathematisch Centrum (CWI, see https://www.cwi.nl) in the Netherlands
    +as a successor of a language called ABC.  Guido remains Python's
    +principal author, although it includes many contributions from others.
    +
    +In 1995, Guido continued his work on Python at the Corporation for
    +National Research Initiatives (CNRI, see https://www.cnri.reston.va.us)
    +in Reston, Virginia where he released several versions of the
    +software.
    +
    +In May 2000, Guido and the Python core development team moved to
    +BeOpen.com to form the BeOpen PythonLabs team.  In October of the same
    +year, the PythonLabs team moved to Digital Creations, which became
    +Zope Corporation.  In 2001, the Python Software Foundation (PSF, see
    +https://www.python.org/psf/) was formed, a non-profit organization
    +created specifically to own Python-related Intellectual Property.
    +Zope Corporation was a sponsoring member of the PSF.
    +
    +All Python releases are Open Source (see https://opensource.org for
    +the Open Source Definition).  Historically, most, but not all, Python
    +releases have also been GPL-compatible; the table below summarizes
    +the various releases.
    +
    +    Release         Derived     Year        Owner       GPL-
    +                    from                                compatible? (1)
    +
    +    0.9.0 thru 1.2              1991-1995   CWI         yes
    +    1.3 thru 1.5.2  1.2         1995-1999   CNRI        yes
    +    1.6             1.5.2       2000        CNRI        no
    +    2.0             1.6         2000        BeOpen.com  no
    +    1.6.1           1.6         2001        CNRI        yes (2)
    +    2.1             2.0+1.6.1   2001        PSF         no
    +    2.0.1           2.0+1.6.1   2001        PSF         yes
    +    2.1.1           2.1+2.0.1   2001        PSF         yes
    +    2.1.2           2.1.1       2002        PSF         yes
    +    2.1.3           2.1.2       2002        PSF         yes
    +    2.2 and above   2.1.1       2001-now    PSF         yes
    +
    +Footnotes:
    +
    +(1) GPL-compatible doesn't mean that we're distributing Python under
    +    the GPL.  All Python licenses, unlike the GPL, let you distribute
    +    a modified version without making your changes open source.  The
    +    GPL-compatible licenses make it possible to combine Python with
    +    other software that is released under the GPL; the others don't.
    +
    +(2) According to Richard Stallman, 1.6.1 is not GPL-compatible,
    +    because its license has a choice of law clause.  According to
    +    CNRI, however, Stallman's lawyer has told CNRI's lawyer that 1.6.1
    +    is "not incompatible" with the GPL.
    +
    +Thanks to the many outside volunteers who have worked under Guido's
    +direction to make these releases possible.
    +
    +
    +B. TERMS AND CONDITIONS FOR ACCESSING OR OTHERWISE USING PYTHON
    +===============================================================
    +
    +Python software and documentation are licensed under the
    +Python Software Foundation License Version 2.
    +
    +Starting with Python 3.8.6, examples, recipes, and other code in
    +the documentation are dual licensed under the PSF License Version 2
    +and the Zero-Clause BSD license.
    +
    +Some software incorporated into Python is under different licenses.
    +The licenses are listed with code falling under that license.
    +
    +
    +PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
    +--------------------------------------------
    +
    +1. This LICENSE AGREEMENT is between the Python Software Foundation
    +("PSF"), and the Individual or Organization ("Licensee") accessing and
    +otherwise using this software ("Python") in source or binary form and
    +its associated documentation.
    +
    +2. Subject to the terms and conditions of this License Agreement, PSF hereby
    +grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce,
    +analyze, test, perform and/or display publicly, prepare derivative works,
    +distribute, and otherwise use Python alone or in any derivative version,
    +provided, however, that PSF's License Agreement and PSF's notice of copyright,
    +i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
    +2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023 Python Software Foundation;
    +All Rights Reserved" are retained in Python alone or in any derivative version
    +prepared by Licensee.
    +
    +3. In the event Licensee prepares a derivative work that is based on
    +or incorporates Python or any part thereof, and wants to make
    +the derivative work available to others as provided herein, then
    +Licensee hereby agrees to include in any such work a brief summary of
    +the changes made to Python.
    +
    +4. PSF is making Python available to Licensee on an "AS IS"
    +basis.  PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
    +IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND
    +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
    +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT
    +INFRINGE ANY THIRD PARTY RIGHTS.
    +
    +5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
    +FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
    +A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON,
    +OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
    +
    +6. This License Agreement will automatically terminate upon a material
    +breach of its terms and conditions.
    +
    +7. Nothing in this License Agreement shall be deemed to create any
    +relationship of agency, partnership, or joint venture between PSF and
    +Licensee.  This License Agreement does not grant permission to use PSF
    +trademarks or trade name in a trademark sense to endorse or promote
    +products or services of Licensee, or any third party.
    +
    +8. By copying, installing or otherwise using Python, Licensee
    +agrees to be bound by the terms and conditions of this License
    +Agreement.
    +
    +
    +BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0
    +-------------------------------------------
    +
    +BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1
    +
    +1. This LICENSE AGREEMENT is between BeOpen.com ("BeOpen"), having an
    +office at 160 Saratoga Avenue, Santa Clara, CA 95051, and the
    +Individual or Organization ("Licensee") accessing and otherwise using
    +this software in source or binary form and its associated
    +documentation ("the Software").
    +
    +2. Subject to the terms and conditions of this BeOpen Python License
    +Agreement, BeOpen hereby grants Licensee a non-exclusive,
    +royalty-free, world-wide license to reproduce, analyze, test, perform
    +and/or display publicly, prepare derivative works, distribute, and
    +otherwise use the Software alone or in any derivative version,
    +provided, however, that the BeOpen Python License is retained in the
    +Software, alone or in any derivative version prepared by Licensee.
    +
    +3. BeOpen is making the Software available to Licensee on an "AS IS"
    +basis.  BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
    +IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, BEOPEN MAKES NO AND
    +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
    +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE WILL NOT
    +INFRINGE ANY THIRD PARTY RIGHTS.
    +
    +4. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE
    +SOFTWARE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS
    +AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY
    +DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
    +
    +5. This License Agreement will automatically terminate upon a material
    +breach of its terms and conditions.
    +
    +6. This License Agreement shall be governed by and interpreted in all
    +respects by the law of the State of California, excluding conflict of
    +law provisions.  Nothing in this License Agreement shall be deemed to
    +create any relationship of agency, partnership, or joint venture
    +between BeOpen and Licensee.  This License Agreement does not grant
    +permission to use BeOpen trademarks or trade names in a trademark
    +sense to endorse or promote products or services of Licensee, or any
    +third party.  As an exception, the "BeOpen Python" logos available at
    +http://www.pythonlabs.com/logos.html may be used according to the
    +permissions granted on that web page.
    +
    +7. By copying, installing or otherwise using the software, Licensee
    +agrees to be bound by the terms and conditions of this License
    +Agreement.
    +
    +
    +CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1
    +---------------------------------------
    +
    +1. This LICENSE AGREEMENT is between the Corporation for National
    +Research Initiatives, having an office at 1895 Preston White Drive,
    +Reston, VA 20191 ("CNRI"), and the Individual or Organization
    +("Licensee") accessing and otherwise using Python 1.6.1 software in
    +source or binary form and its associated documentation.
    +
    +2. Subject to the terms and conditions of this License Agreement, CNRI
    +hereby grants Licensee a nonexclusive, royalty-free, world-wide
    +license to reproduce, analyze, test, perform and/or display publicly,
    +prepare derivative works, distribute, and otherwise use Python 1.6.1
    +alone or in any derivative version, provided, however, that CNRI's
    +License Agreement and CNRI's notice of copyright, i.e., "Copyright (c)
    +1995-2001 Corporation for National Research Initiatives; All Rights
    +Reserved" are retained in Python 1.6.1 alone or in any derivative
    +version prepared by Licensee.  Alternately, in lieu of CNRI's License
    +Agreement, Licensee may substitute the following text (omitting the
    +quotes): "Python 1.6.1 is made available subject to the terms and
    +conditions in CNRI's License Agreement.  This Agreement together with
    +Python 1.6.1 may be located on the internet using the following
    +unique, persistent identifier (known as a handle): 1895.22/1013.  This
    +Agreement may also be obtained from a proxy server on the internet
    +using the following URL: http://hdl.handle.net/1895.22/1013".
    +
    +3. In the event Licensee prepares a derivative work that is based on
    +or incorporates Python 1.6.1 or any part thereof, and wants to make
    +the derivative work available to others as provided herein, then
    +Licensee hereby agrees to include in any such work a brief summary of
    +the changes made to Python 1.6.1.
    +
    +4. CNRI is making Python 1.6.1 available to Licensee on an "AS IS"
    +basis.  CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
    +IMPLIED.  BY WAY OF EXAMPLE, BUT NOT LIMITATION, CNRI MAKES NO AND
    +DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
    +FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 1.6.1 WILL NOT
    +INFRINGE ANY THIRD PARTY RIGHTS.
    +
    +5. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
    +1.6.1 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
    +A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1,
    +OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
    +
    +6. This License Agreement will automatically terminate upon a material
    +breach of its terms and conditions.
    +
    +7. This License Agreement shall be governed by the federal
    +intellectual property law of the United States, including without
    +limitation the federal copyright law, and, to the extent such
    +U.S. federal law does not apply, by the law of the Commonwealth of
    +Virginia, excluding Virginia's conflict of law provisions.
    +Notwithstanding the foregoing, with regard to derivative works based
    +on Python 1.6.1 that incorporate non-separable material that was
    +previously distributed under the GNU General Public License (GPL), the
    +law of the Commonwealth of Virginia shall govern this License
    +Agreement only as to issues arising under or with respect to
    +Paragraphs 4, 5, and 7 of this License Agreement.  Nothing in this
    +License Agreement shall be deemed to create any relationship of
    +agency, partnership, or joint venture between CNRI and Licensee.  This
    +License Agreement does not grant permission to use CNRI trademarks or
    +trade name in a trademark sense to endorse or promote products or
    +services of Licensee, or any third party.
    +
    +8. By clicking on the "ACCEPT" button where indicated, or by copying,
    +installing or otherwise using Python 1.6.1, Licensee agrees to be
    +bound by the terms and conditions of this License Agreement.
    +
    +        ACCEPT
    +
    +
    +CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2
    +--------------------------------------------------
    +
    +Copyright (c) 1991 - 1995, Stichting Mathematisch Centrum Amsterdam,
    +The Netherlands.  All rights reserved.
    +
    +Permission to use, copy, modify, and distribute this software and its
    +documentation for any purpose and without fee is hereby granted,
    +provided that the above copyright notice appear in all copies and that
    +both that copyright notice and this permission notice appear in
    +supporting documentation, and that the name of Stichting Mathematisch
    +Centrum or CWI not be used in advertising or publicity pertaining to
    +distribution of the software without specific, written prior
    +permission.
    +
    +STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
    +THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
    +FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
    +FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
    +WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
    +ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
    +OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
    +
    +ZERO-CLAUSE BSD LICENSE FOR CODE IN THE PYTHON DOCUMENTATION
    +----------------------------------------------------------------------
    +
    +Permission to use, copy, modify, and/or distribute this software for any
    +purpose with or without fee is hereby granted.
    +
    +THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
    +REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
    +AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
    +INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
    +LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
    +OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
    +PERFORMANCE OF THIS SOFTWARE.
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/METADATA
    new file mode 100644
    index 000000000..f15e2b387
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/METADATA
    @@ -0,0 +1,67 @@
    +Metadata-Version: 2.1
    +Name: typing_extensions
    +Version: 4.12.2
    +Summary: Backported and Experimental Type Hints for Python 3.8+
    +Keywords: annotations,backport,checker,checking,function,hinting,hints,type,typechecking,typehinting,typehints,typing
    +Author-email: "Guido van Rossum, Jukka Lehtosalo, Łukasz Langa, Michael Lee" 
    +Requires-Python: >=3.8
    +Description-Content-Type: text/markdown
    +Classifier: Development Status :: 5 - Production/Stable
    +Classifier: Environment :: Console
    +Classifier: Intended Audience :: Developers
    +Classifier: License :: OSI Approved :: Python Software Foundation License
    +Classifier: Operating System :: OS Independent
    +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: Topic :: Software Development
    +Project-URL: Bug Tracker, https://github.com/python/typing_extensions/issues
    +Project-URL: Changes, https://github.com/python/typing_extensions/blob/main/CHANGELOG.md
    +Project-URL: Documentation, https://typing-extensions.readthedocs.io/
    +Project-URL: Home, https://github.com/python/typing_extensions
    +Project-URL: Q & A, https://github.com/python/typing/discussions
    +Project-URL: Repository, https://github.com/python/typing_extensions
    +
    +# Typing Extensions
    +
    +[![Chat at https://gitter.im/python/typing](https://badges.gitter.im/python/typing.svg)](https://gitter.im/python/typing)
    +
    +[Documentation](https://typing-extensions.readthedocs.io/en/latest/#) –
    +[PyPI](https://pypi.org/project/typing-extensions/)
    +
    +## Overview
    +
    +The `typing_extensions` module serves two related purposes:
    +
    +- Enable use of new type system features on older Python versions. For example,
    +  `typing.TypeGuard` is new in Python 3.10, but `typing_extensions` allows
    +  users on previous Python versions to use it too.
    +- Enable experimentation with new type system PEPs before they are accepted and
    +  added to the `typing` module.
    +
    +`typing_extensions` is treated specially by static type checkers such as
    +mypy and pyright. Objects defined in `typing_extensions` are treated the same
    +way as equivalent forms in `typing`.
    +
    +`typing_extensions` uses
    +[Semantic Versioning](https://semver.org/). The
    +major version will be incremented only for backwards-incompatible changes.
    +Therefore, it's safe to depend
    +on `typing_extensions` like this: `typing_extensions >=x.y, <(x+1)`,
    +where `x.y` is the first version that includes all features you need.
    +
    +## Included items
    +
    +See [the documentation](https://typing-extensions.readthedocs.io/en/latest/#) for a
    +complete listing of module contents.
    +
    +## Contributing
    +
    +See [CONTRIBUTING.md](https://github.com/python/typing_extensions/blob/main/CONTRIBUTING.md)
    +for how to contribute to `typing_extensions`.
    +
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/RECORD
    new file mode 100644
    index 000000000..775e17e76
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/RECORD
    @@ -0,0 +1,7 @@
    +__pycache__/typing_extensions.cpython-312.pyc,,
    +typing_extensions-4.12.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
    +typing_extensions-4.12.2.dist-info/LICENSE,sha256=Oy-B_iHRgcSZxZolbI4ZaEVdZonSaaqFNzv7avQdo78,13936
    +typing_extensions-4.12.2.dist-info/METADATA,sha256=BeUQIa8cnYbrjWx-N8TOznM9UGW5Gm2DicVpDtRA8W0,3018
    +typing_extensions-4.12.2.dist-info/RECORD,,
    +typing_extensions-4.12.2.dist-info/WHEEL,sha256=EZbGkh7Ie4PoZfRQ8I0ZuP9VklN_TvcZ6DSE5Uar4z4,81
    +typing_extensions.py,sha256=gwekpyG9DVG3lxWKX4ni8u7nk3We5slG98mA9F3DJQw,134451
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/WHEEL
    new file mode 100644
    index 000000000..3b5e64b5e
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions-4.12.2.dist-info/WHEEL
    @@ -0,0 +1,4 @@
    +Wheel-Version: 1.0
    +Generator: flit 3.9.0
    +Root-Is-Purelib: true
    +Tag: py3-none-any
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/typing_extensions.py
    new file mode 100644
    index 000000000..dec429ca8
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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 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 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 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 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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/INSTALLER
    new file mode 100644
    index 000000000..a1b589e38
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/INSTALLER
    @@ -0,0 +1 @@
    +pip
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/LICENSE.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/LICENSE.txt
    new file mode 100644
    index 000000000..a31470f14
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/LICENSE.txt
    @@ -0,0 +1,21 @@
    +MIT License
    +
    +Copyright (c) 2012 Daniel Holth  and contributors
    +
    +Permission is hereby granted, free of charge, to any person obtaining a
    +copy of this software and associated documentation files (the "Software"),
    +to deal in the Software without restriction, including without limitation
    +the rights to use, copy, modify, merge, publish, distribute, sublicense,
    +and/or sell copies of the Software, and to permit persons to whom the
    +Software is furnished to do so, subject to the following conditions:
    +
    +The above copyright notice and this permission notice shall be included
    +in all copies or substantial portions of the Software.
    +
    +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
    +THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
    +OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
    +ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
    +OTHER DEALINGS IN THE SOFTWARE.
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/METADATA
    new file mode 100644
    index 000000000..f645dcb67
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/METADATA
    @@ -0,0 +1,66 @@
    +Metadata-Version: 2.3
    +Name: wheel
    +Version: 0.45.1
    +Summary: A built-package format for Python
    +Keywords: wheel,packaging
    +Author-email: Daniel Holth 
    +Maintainer-email: Alex Grönholm 
    +Requires-Python: >=3.8
    +Description-Content-Type: text/x-rst
    +Classifier: Development Status :: 5 - Production/Stable
    +Classifier: Intended Audience :: Developers
    +Classifier: Topic :: System :: Archiving :: Packaging
    +Classifier: License :: OSI Approved :: MIT License
    +Classifier: Programming Language :: Python
    +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
    +Requires-Dist: pytest >= 6.0.0 ; extra == "test"
    +Requires-Dist: setuptools >= 65 ; extra == "test"
    +Project-URL: Changelog, https://wheel.readthedocs.io/en/stable/news.html
    +Project-URL: Documentation, https://wheel.readthedocs.io/
    +Project-URL: Issue Tracker, https://github.com/pypa/wheel/issues
    +Project-URL: Source, https://github.com/pypa/wheel
    +Provides-Extra: test
    +
    +wheel
    +=====
    +
    +This is a command line tool for manipulating Python wheel files, as defined in
    +`PEP 427`_. It contains the following functionality:
    +
    +* Convert ``.egg`` archives into ``.whl``
    +* Unpack wheel archives
    +* Repack wheel archives
    +* Add or remove tags in existing wheel archives
    +
    +.. _PEP 427: https://www.python.org/dev/peps/pep-0427/
    +
    +Historical note
    +---------------
    +
    +This project used to contain the implementation of the setuptools_ ``bdist_wheel``
    +command, but as of setuptools v70.1, it no longer needs ``wheel`` installed for that to
    +work. Thus, you should install this **only** if you intend to use the ``wheel`` command
    +line tool!
    +
    +.. _setuptools: https://pypi.org/project/setuptools/
    +
    +Documentation
    +-------------
    +
    +The documentation_ can be found on Read The Docs.
    +
    +.. _documentation: https://wheel.readthedocs.io/
    +
    +Code of Conduct
    +---------------
    +
    +Everyone interacting in the wheel project's codebases, issue trackers, chat
    +rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_.
    +
    +.. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md
    +
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/RECORD
    new file mode 100644
    index 000000000..c1535b697
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/RECORD
    @@ -0,0 +1,68 @@
    +../../bin/wheel,sha256=pBhV19bQIgjS-r541fG3kLU6QtcyKaKdQ2RE9YIzeiU,249
    +wheel-0.45.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
    +wheel-0.45.1.dist-info/LICENSE.txt,sha256=MMI2GGeRCPPo6h0qZYx8pBe9_IkcmO8aifpP8MmChlQ,1107
    +wheel-0.45.1.dist-info/METADATA,sha256=mKz84H7m7jsxJyzeIcTVORiTb0NPMV39KvOIYhGgmjA,2313
    +wheel-0.45.1.dist-info/RECORD,,
    +wheel-0.45.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
    +wheel-0.45.1.dist-info/WHEEL,sha256=CpUCUxeHQbRN5UGRQHYRJorO5Af-Qy_fHMctcQ8DSGI,82
    +wheel-0.45.1.dist-info/entry_points.txt,sha256=rTY1BbkPHhkGMm4Q3F0pIzJBzW2kMxoG1oriffvGdA0,104
    +wheel/__init__.py,sha256=mrxMnvdXACur_LWegbUfh5g5ysWZrd63UJn890wvGNk,59
    +wheel/__main__.py,sha256=NkMUnuTCGcOkgY0IBLgBCVC_BGGcWORx2K8jYGS12UE,455
    +wheel/__pycache__/__init__.cpython-311.pyc,,
    +wheel/__pycache__/__main__.cpython-311.pyc,,
    +wheel/__pycache__/_bdist_wheel.cpython-311.pyc,,
    +wheel/__pycache__/_setuptools_logging.cpython-311.pyc,,
    +wheel/__pycache__/bdist_wheel.cpython-311.pyc,,
    +wheel/__pycache__/macosx_libfile.cpython-311.pyc,,
    +wheel/__pycache__/metadata.cpython-311.pyc,,
    +wheel/__pycache__/util.cpython-311.pyc,,
    +wheel/__pycache__/wheelfile.cpython-311.pyc,,
    +wheel/_bdist_wheel.py,sha256=UghCQjSH_pVfcZh6oRjzSw_TQhcf3anSx1OkiLSL82M,21694
    +wheel/_setuptools_logging.py,sha256=-5KC-lne0ilOUWIDfOkqapUWGMFZhuKYDIavIZiB5kM,781
    +wheel/bdist_wheel.py,sha256=tpf9WufiSO1RuEMg5oPhIfSG8DMziCZ_4muCKF69Cqo,1107
    +wheel/cli/__init__.py,sha256=Npq6_jKi03dhIcRnmbuFhwviVJxwO0tYEnEhWMv9cJo,4402
    +wheel/cli/__pycache__/__init__.cpython-311.pyc,,
    +wheel/cli/__pycache__/convert.cpython-311.pyc,,
    +wheel/cli/__pycache__/pack.cpython-311.pyc,,
    +wheel/cli/__pycache__/tags.cpython-311.pyc,,
    +wheel/cli/__pycache__/unpack.cpython-311.pyc,,
    +wheel/cli/convert.py,sha256=Bi0ntEXb9nTllCxWeTRQ4j-nPs3szWSEKipG_GgnMkQ,12634
    +wheel/cli/pack.py,sha256=CAFcHdBVulvsHYJlndKVO7KMI9JqBTZz5ii0PKxxCOs,3103
    +wheel/cli/tags.py,sha256=lHw-LaWrkS5Jy_qWcw-6pSjeNM6yAjDnqKI3E5JTTCU,4760
    +wheel/cli/unpack.py,sha256=Y_J7ynxPSoFFTT7H0fMgbBlVErwyDGcObgme5MBuz58,1021
    +wheel/macosx_libfile.py,sha256=k1x7CE3LPtOVGqj6NXQ1nTGYVPaeRrhVzUG_KPq3zDs,16572
    +wheel/metadata.py,sha256=JC4p7jlQZu2bUTAQ2fevkqLjg_X6gnNyRhLn6OUO1tc,6171
    +wheel/util.py,sha256=aL7aibHwYUgfc8WlolL5tXdkV4DatbJxZHb1kwHFJAU,423
    +wheel/vendored/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
    +wheel/vendored/__pycache__/__init__.cpython-311.pyc,,
    +wheel/vendored/packaging/LICENSE,sha256=ytHvW9NA1z4HS6YU0m996spceUDD2MNIUuZcSQlobEg,197
    +wheel/vendored/packaging/LICENSE.APACHE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174
    +wheel/vendored/packaging/LICENSE.BSD,sha256=tw5-m3QvHMb5SLNMFqo5_-zpQZY2S8iP8NIYDwAo-sU,1344
    +wheel/vendored/packaging/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
    +wheel/vendored/packaging/__pycache__/__init__.cpython-311.pyc,,
    +wheel/vendored/packaging/__pycache__/_elffile.cpython-311.pyc,,
    +wheel/vendored/packaging/__pycache__/_manylinux.cpython-311.pyc,,
    +wheel/vendored/packaging/__pycache__/_musllinux.cpython-311.pyc,,
    +wheel/vendored/packaging/__pycache__/_parser.cpython-311.pyc,,
    +wheel/vendored/packaging/__pycache__/_structures.cpython-311.pyc,,
    +wheel/vendored/packaging/__pycache__/_tokenizer.cpython-311.pyc,,
    +wheel/vendored/packaging/__pycache__/markers.cpython-311.pyc,,
    +wheel/vendored/packaging/__pycache__/requirements.cpython-311.pyc,,
    +wheel/vendored/packaging/__pycache__/specifiers.cpython-311.pyc,,
    +wheel/vendored/packaging/__pycache__/tags.cpython-311.pyc,,
    +wheel/vendored/packaging/__pycache__/utils.cpython-311.pyc,,
    +wheel/vendored/packaging/__pycache__/version.cpython-311.pyc,,
    +wheel/vendored/packaging/_elffile.py,sha256=hbmK8OD6Z7fY6hwinHEUcD1by7czkGiNYu7ShnFEk2k,3266
    +wheel/vendored/packaging/_manylinux.py,sha256=P7sdR5_7XBY09LVYYPhHmydMJIIwPXWsh4olk74Uuj4,9588
    +wheel/vendored/packaging/_musllinux.py,sha256=z1s8To2hQ0vpn_d-O2i5qxGwEK8WmGlLt3d_26V7NeY,2674
    +wheel/vendored/packaging/_parser.py,sha256=4tT4emSl2qTaU7VTQE1Xa9o1jMPCsBezsYBxyNMUN-s,10347
    +wheel/vendored/packaging/_structures.py,sha256=q3eVNmbWJGG_S0Dit_S3Ao8qQqz_5PYTXFAKBZe5yr4,1431
    +wheel/vendored/packaging/_tokenizer.py,sha256=alCtbwXhOFAmFGZ6BQ-wCTSFoRAJ2z-ysIf7__MTJ_k,5292
    +wheel/vendored/packaging/markers.py,sha256=_TSPI1BhJYO7Bp9AzTmHQxIqHEVXaTjmDh9G-w8qzPA,8232
    +wheel/vendored/packaging/requirements.py,sha256=dgoBeVprPu2YE6Q8nGfwOPTjATHbRa_ZGLyXhFEln6Q,2933
    +wheel/vendored/packaging/specifiers.py,sha256=IWSt0SrLSP72heWhAC8UL0eGvas7XIQHjqiViVfmPKE,39778
    +wheel/vendored/packaging/tags.py,sha256=fedHXiOHkBxNZTXotXv8uXPmMFU9ae-TKBujgYHigcA,18950
    +wheel/vendored/packaging/utils.py,sha256=XgdmP3yx9-wQEFjO7OvMj9RjEf5JlR5HFFR69v7SQ9E,5268
    +wheel/vendored/packaging/version.py,sha256=PFJaYZDxBgyxkfYhH3SQw4qfE9ICCWrTmitvq14y3bs,16234
    +wheel/vendored/vendor.txt,sha256=Z2ENjB1i5prfez8CdM1Sdr3c6Zxv2rRRolMpLmBncAE,16
    +wheel/wheelfile.py,sha256=USCttNlJwafxt51YYFFKG7jnxz8dfhbyqAZL6jMTA9s,8411
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/REQUESTED b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/REQUESTED
    new file mode 100644
    index 000000000..e69de29bb
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/WHEEL
    new file mode 100644
    index 000000000..e3c6feefa
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/WHEEL
    @@ -0,0 +1,4 @@
    +Wheel-Version: 1.0
    +Generator: flit 3.10.1
    +Root-Is-Purelib: true
    +Tag: py3-none-any
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/entry_points.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/entry_points.txt
    new file mode 100644
    index 000000000..06c9f69de
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel-0.45.1.dist-info/entry_points.txt
    @@ -0,0 +1,6 @@
    +[console_scripts]
    +wheel=wheel.cli:main
    +
    +[distutils.commands]
    +bdist_wheel=wheel.bdist_wheel:bdist_wheel
    +
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__init__.py
    new file mode 100644
    index 000000000..3ab8f72d8
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__init__.py
    @@ -0,0 +1,3 @@
    +from __future__ import annotations
    +
    +__version__ = "0.45.1"
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__main__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__main__.py
    new file mode 100644
    index 000000000..0be745374
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__main__.py
    @@ -0,0 +1,23 @@
    +"""
    +Wheel command line tool (enable python -m wheel syntax)
    +"""
    +
    +from __future__ import annotations
    +
    +import sys
    +
    +
    +def main():  # needed for console script
    +    if __package__ == "":
    +        # To be able to run 'python wheel-0.9.whl/wheel':
    +        import os.path
    +
    +        path = os.path.dirname(os.path.dirname(__file__))
    +        sys.path[0:0] = [path]
    +    import wheel.cli
    +
    +    sys.exit(wheel.cli.main())
    +
    +
    +if __name__ == "__main__":
    +    sys.exit(main())
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/__init__.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..3b95982dfe21b73e962ffa0f11eae4bf3ef7d3eb
    GIT binary patch
    literal 306
    zcmX|*y-ve05XbEX@zE$uhzDTH(3tWuftUb^fvSS7%gL<`F*v@+c7Sw)m*5$A26h(S
    zAQBQ16B|;uPB^OIq`Ujw>HpW=dy;fXh__dsAB6tZ4u8>E0G(|FcqW1fs!2gdloHVy
    zb?PWx`fepDZDMW=dhQh(H(lP&_V%;>AdQ+Xz*XfdD*
    zC7;~#>)>|MSEWbPj)mJspk?>Dl$rr3qdY)X*7McF0!5|ekzETf(U2|)=6TEmsi5E`JY+34ogYWR>dvCve@0<5_zob%0Aneme
    zv-lYTurGtia0kG{rvj`23*>+WEyaPZl2f3>$U!+|;nyICNz95Zi~+#X3LvP|7ZvHA
    zB9FI@!!6NE8U%GzN16EIWOBAhh@%y#>zbaWIkrbMPN}1f5zov!L@U>Mk$T#=t5rj$
    zU-!6K%OrowIvE)Bnx03w$!+TS(*>D~EG7UFy$;i&>l)xuUfdv5JYy*qaNsgn0;S_S
    zpHKuSssBbD{Qpdzh~AFw9G%N>3C=?v&R=p)>n)Ti7eS~mzO3-xs8;Drgu3UFQaam>
    zB2+pTq3(Ig7C;6~2Y@Mplt~7?hEX;P3+6mAj6kJ+wruiZfJ3iZHuFrE1PQ}&BbjryodW%Zb^l$
    QM{l3(;-Lcs@P)AMUuwkZ;s5{u
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/_bdist_wheel.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/_bdist_wheel.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..3139275ab5d3824412df0c401c5c016c14781294
    GIT binary patch
    literal 26086
    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
    K_Gc|T-2V?g(7Zzc
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/_setuptools_logging.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/_setuptools_logging.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..b80120dd095a1d2a5c738b44099aba1d30d2682d
    GIT binary patch
    literal 1452
    zcmah}O>7%Q6rR}~|HQ5nYCuT}QU^FhtG3=kuT>~(f`teLTc
    z(?rUF3kSq8REkutRVu-q6B42aF11=I(b8Mh12?2p9CG5#+8YNhJZWdXnfKnj|NXsE
    zDIuWWe)iiH8=;rxkdZY4_~A&T%S#s*uVwQ8liy=t=@v%e;*gyk85JvXqN
    z!k;^&|lHE=Ab>OammAYdm
    zg^>4o7z+TR)e7QPQuy-Y<@&Aq5_pl9yeTA8#y&m%)@_T3yMD;Oaz7i~lcK|$TDjL(
    z?p>-2#z*MZwHw~DXbA1zC3<2&UeUj$RN%}HTg!ad9+oU`TJr}A%}IqB)_E|bLI?G|3Mwyjgqy^%>xc7~a?Wu1zl
    zI^kvLvAsWTCX5Ee$!$I2lGAZ3~eJ5aR2+kQU~k^=5Z(GM7Bsqz}!HAU2g8EFJzpa*m#&~3^B
    z1??7uss`TBMo-hoAJAsok6WAuajL4@oUZjWxLixmn^X5At`v0P_A$QikR%U}N4`#S
    zN)JMw6hWJXT&g6OPD|Y>NmJvbvZ5vTqnjgkQiMjmW5!7q4A)izmE<8_h$flx8M_gL
    z+Qe>{<%X|<<|ubb?%MTFzF2~3ECbscTT9BImmQ?3nSy3Tka0O>UYKfTiI?xd`HT@*
    zhh+!7o4KRK8`9$xs^9Bb1s*
    t13oTZjRfn3d{Mp!d^1pL4wk=cjPWb<{!29d2Pz%qF~0b^IE_cn{R8v#R`37-
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/bdist_wheel.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/bdist_wheel.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..79695211fd3ef8a9e367d0b097de318d9ead1f36
    GIT binary patch
    literal 818
    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
    JPEyMb^}kjLX7d05
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/util.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/util.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..c62fab905251f33f5a996c55b1aaf5cb3a9c7c9f
    GIT binary patch
    literal 994
    zcmZuvF>ljA6uz?^r;TZ)0#YRglv06Yq{c0+!U8N5Br2#X%9O=&a#zQ}^+k7QN}?8J
    z;0J&}YR57GVqs@zVQG}1k^!kwS-K&GsT1#>wYrN6
    z3}@6E!TszivbE+^%tPU=QMX)NpizYpn%@XymBlh&_Xr6hzpD|1BoqHo
    z5|azbgF0NrAfEJuqU4WXI90Yz9WSKMokxuo&T6zGg>!FpWo8);>Y)dV_ua>=%%me@
    z$#~#}PT>@VLD{J{pq*&GFn7Zdfuu8aukzIMfi0+v>yoihIPNnV5yqW#a!xFRuuyMs
    zrAX>V0f@`sTIiQGv2RVct?Avxj%Dv#vu$hk^Tm!;+%t+@_yY~iUCl3@dkFyS04CaC
    z_JcVSy$LsN!Y(y|v4!Qy?jTe%RLx=AM4Pw?pU&uD4Cz4V|8(FcaE?^HBUK&*(L);X
    zEZ`wYdTd+cYPAy`R1|7S@_BAS;1hi}4nP#Zwa`Is{MFQ3v9s`|u{-yAt9|}zJ9n*h
    z_s3vXALidJbu4GkaQHc(*ha5bhLD+UqeJGT(=N
    zN=AJu9|EQvZovGWOscJqC@r4$c|3A!osl@Cclaepsf7~P!Tr`T#y`=OLp1gsjUSkk
    cEq~vfY@3ri*^ZfS>0ML9H~-{xJe$_~3mj$VcmMzZ
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/wheelfile.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/__pycache__/wheelfile.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..d5092d2839f7e9f8228a1e9e204c35d9fc45a91b
    GIT binary patch
    literal 11535
    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
    t-PD>!cm3q+C)f3wT-7xT6c 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) -> 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)
    +
    +
    +setuptools_major_version = int(setuptools.__version__.split(".")[0])
    +
    +PY_LIMITED_API_PATTERN = r"cp3\d"
    +
    +
    +def _is_32bit_interpreter() -> bool:
    +    return struct.calcsize("P") == 4
    +
    +
    +def python_tag() -> str:
    +    return f"py{sys.version_info[0]}"
    +
    +
    +def get_platform(archive_root: str | None) -> str:
    +    """Return our platform name 'win32', 'linux_x86_64'"""
    +    result = sysconfig.get_platform()
    +    if result.startswith("macosx") and archive_root is not None:
    +        from .macosx_libfile import calculate_macosx_platform_tag
    +
    +        result = calculate_macosx_platform_tag(archive_root, result)
    +    elif _is_32bit_interpreter():
    +        if result == "linux-x86_64":
    +            # pip pull request #3497
    +            result = "linux-i686"
    +        elif result == "linux-aarch64":
    +            # packaging pull request #234
    +            # TODO armv8l, packaging pull request #690 => this did not land
    +            # in pip/packaging yet
    +            result = "linux-armv7l"
    +
    +    return result.replace("-", "_")
    +
    +
    +def get_flag(
    +    var: str, fallback: bool, expected: bool = True, warn: bool = True
    +) -> bool:
    +    """Use a fallback value for determining SOABI flags if the needed config
    +    var is unset or unavailable."""
    +    val = sysconfig.get_config_var(var)
    +    if val is None:
    +        if warn:
    +            warnings.warn(
    +                f"Config variable '{var}' is unset, Python ABI tag may be incorrect",
    +                RuntimeWarning,
    +                stacklevel=2,
    +            )
    +        return fallback
    +    return val == expected
    +
    +
    +def get_abi_tag() -> str | None:
    +    """Return the ABI tag based on SOABI (if available) or emulate SOABI (PyPy2)."""
    +    soabi: str = sysconfig.get_config_var("SOABI")
    +    impl = tags.interpreter_name()
    +    if not soabi and impl in ("cp", "pp") and hasattr(sys, "maxunicode"):
    +        d = ""
    +        m = ""
    +        u = ""
    +        if get_flag("Py_DEBUG", hasattr(sys, "gettotalrefcount"), warn=(impl == "cp")):
    +            d = "d"
    +
    +        if get_flag(
    +            "WITH_PYMALLOC",
    +            impl == "cp",
    +            warn=(impl == "cp" and sys.version_info < (3, 8)),
    +        ) and sys.version_info < (3, 8):
    +            m = "m"
    +
    +        abi = f"{impl}{tags.interpreter_version()}{d}{m}{u}"
    +    elif soabi and impl == "cp" and soabi.startswith("cpython"):
    +        # non-Windows
    +        abi = "cp" + soabi.split("-")[1]
    +    elif soabi and impl == "cp" and soabi.startswith("cp"):
    +        # Windows
    +        abi = soabi.split("-")[0]
    +    elif soabi and impl == "pp":
    +        # we want something like pypy36-pp73
    +        abi = "-".join(soabi.split("-")[:2])
    +        abi = abi.replace(".", "_").replace("-", "_")
    +    elif soabi and impl == "graalpy":
    +        abi = "-".join(soabi.split("-")[:3])
    +        abi = abi.replace(".", "_").replace("-", "_")
    +    elif soabi:
    +        abi = soabi.replace(".", "_").replace("-", "_")
    +    else:
    +        abi = None
    +
    +    return abi
    +
    +
    +def safer_name(name: str) -> str:
    +    return safe_name(name).replace("-", "_")
    +
    +
    +def safer_version(version: str) -> str:
    +    return safe_version(version).replace("-", "_")
    +
    +
    +def remove_readonly(
    +    func: Callable[..., object],
    +    path: str,
    +    excinfo: tuple[type[Exception], Exception, types.TracebackType],
    +) -> None:
    +    remove_readonly_exc(func, path, excinfo[1])
    +
    +
    +def remove_readonly_exc(func: Callable[..., object], path: str, exc: Exception) -> None:
    +    os.chmod(path, stat.S_IWRITE)
    +    func(path)
    +
    +
    +class bdist_wheel(Command):
    +    description = "create a wheel distribution"
    +
    +    supported_compressions = {
    +        "stored": ZIP_STORED,
    +        "deflated": ZIP_DEFLATED,
    +    }
    +
    +    user_options = [
    +        ("bdist-dir=", "b", "temporary directory for creating the distribution"),
    +        (
    +            "plat-name=",
    +            "p",
    +            "platform name to embed in generated filenames "
    +            f"(default: {get_platform(None)})",
    +        ),
    +        (
    +            "keep-temp",
    +            "k",
    +            "keep the pseudo-installation tree around after "
    +            "creating the distribution archive",
    +        ),
    +        ("dist-dir=", "d", "directory to put final built distributions in"),
    +        ("skip-build", None, "skip rebuilding everything (for testing/debugging)"),
    +        (
    +            "relative",
    +            None,
    +            "build the archive using relative paths (default: false)",
    +        ),
    +        (
    +            "owner=",
    +            "u",
    +            "Owner name used when creating a tar file [default: current user]",
    +        ),
    +        (
    +            "group=",
    +            "g",
    +            "Group name used when creating a tar file [default: current group]",
    +        ),
    +        ("universal", None, "make a universal wheel (default: false)"),
    +        (
    +            "compression=",
    +            None,
    +            "zipfile compression (one of: {}) (default: 'deflated')".format(
    +                ", ".join(supported_compressions)
    +            ),
    +        ),
    +        (
    +            "python-tag=",
    +            None,
    +            f"Python implementation compatibility tag (default: '{python_tag()}')",
    +        ),
    +        (
    +            "build-number=",
    +            None,
    +            "Build number for this particular version. "
    +            "As specified in PEP-0427, this must start with a digit. "
    +            "[default: None]",
    +        ),
    +        (
    +            "py-limited-api=",
    +            None,
    +            "Python tag (cp32|cp33|cpNN) for abi3 wheel tag (default: false)",
    +        ),
    +    ]
    +
    +    boolean_options = ["keep-temp", "skip-build", "relative", "universal"]
    +
    +    def initialize_options(self):
    +        self.bdist_dir: str = None
    +        self.data_dir = None
    +        self.plat_name: str | None = None
    +        self.plat_tag = None
    +        self.format = "zip"
    +        self.keep_temp = False
    +        self.dist_dir: str | None = None
    +        self.egginfo_dir = None
    +        self.root_is_pure: bool | None = None
    +        self.skip_build = None
    +        self.relative = False
    +        self.owner = None
    +        self.group = None
    +        self.universal: bool = False
    +        self.compression: str | int = "deflated"
    +        self.python_tag: str = python_tag()
    +        self.build_number: str | None = None
    +        self.py_limited_api: str | Literal[False] = False
    +        self.plat_name_supplied = False
    +
    +    def finalize_options(self):
    +        if self.bdist_dir is None:
    +            bdist_base = self.get_finalized_command("bdist").bdist_base
    +            self.bdist_dir = os.path.join(bdist_base, "wheel")
    +
    +        egg_info = self.distribution.get_command_obj("egg_info")
    +        egg_info.ensure_finalized()  # needed for correct `wheel_dist_name`
    +
    +        self.data_dir = self.wheel_dist_name + ".data"
    +        self.plat_name_supplied = self.plat_name is not None
    +
    +        try:
    +            self.compression = self.supported_compressions[self.compression]
    +        except KeyError:
    +            raise ValueError(f"Unsupported compression: {self.compression}") from None
    +
    +        need_options = ("dist_dir", "plat_name", "skip_build")
    +
    +        self.set_undefined_options("bdist", *zip(need_options, need_options))
    +
    +        self.root_is_pure = not (
    +            self.distribution.has_ext_modules() or self.distribution.has_c_libraries()
    +        )
    +
    +        if self.py_limited_api and not re.match(
    +            PY_LIMITED_API_PATTERN, self.py_limited_api
    +        ):
    +            raise ValueError(f"py-limited-api must match '{PY_LIMITED_API_PATTERN}'")
    +
    +        # Support legacy [wheel] section for setting universal
    +        wheel = self.distribution.get_option_dict("wheel")
    +        if "universal" in wheel:
    +            # please don't define this in your global configs
    +            log.warning(
    +                "The [wheel] section is deprecated. Use [bdist_wheel] instead.",
    +            )
    +            val = wheel["universal"][1].strip()
    +            if val.lower() in ("1", "true", "yes"):
    +                self.universal = True
    +
    +        if self.build_number is not None and not self.build_number[:1].isdigit():
    +            raise ValueError("Build tag (build-number) must start with a digit.")
    +
    +    @property
    +    def wheel_dist_name(self):
    +        """Return distribution full name with - replaced with _"""
    +        components = (
    +            safer_name(self.distribution.get_name()),
    +            safer_version(self.distribution.get_version()),
    +        )
    +        if self.build_number:
    +            components += (self.build_number,)
    +        return "-".join(components)
    +
    +    def get_tag(self) -> tuple[str, str, str]:
    +        # bdist sets self.plat_name if unset, we should only use it for purepy
    +        # wheels if the user supplied it.
    +        if self.plat_name_supplied:
    +            plat_name = cast(str, self.plat_name)
    +        elif self.root_is_pure:
    +            plat_name = "any"
    +        else:
    +            # macosx contains system version in platform name so need special handle
    +            if self.plat_name and not self.plat_name.startswith("macosx"):
    +                plat_name = self.plat_name
    +            else:
    +                # on macosx always limit the platform name to comply with any
    +                # c-extension modules in bdist_dir, since the user can specify
    +                # a higher MACOSX_DEPLOYMENT_TARGET via tools like CMake
    +
    +                # on other platforms, and on macosx if there are no c-extension
    +                # modules, use the default platform name.
    +                plat_name = get_platform(self.bdist_dir)
    +
    +            if _is_32bit_interpreter():
    +                if plat_name in ("linux-x86_64", "linux_x86_64"):
    +                    plat_name = "linux_i686"
    +                if plat_name in ("linux-aarch64", "linux_aarch64"):
    +                    # TODO armv8l, packaging pull request #690 => this did not land
    +                    # in pip/packaging yet
    +                    plat_name = "linux_armv7l"
    +
    +        plat_name = (
    +            plat_name.lower().replace("-", "_").replace(".", "_").replace(" ", "_")
    +        )
    +
    +        if self.root_is_pure:
    +            if self.universal:
    +                impl = "py2.py3"
    +            else:
    +                impl = self.python_tag
    +            tag = (impl, "none", plat_name)
    +        else:
    +            impl_name = tags.interpreter_name()
    +            impl_ver = tags.interpreter_version()
    +            impl = impl_name + impl_ver
    +            # We don't work on CPython 3.1, 3.0.
    +            if self.py_limited_api and (impl_name + impl_ver).startswith("cp3"):
    +                impl = self.py_limited_api
    +                abi_tag = "abi3"
    +            else:
    +                abi_tag = str(get_abi_tag()).lower()
    +            tag = (impl, abi_tag, plat_name)
    +            # issue gh-374: allow overriding plat_name
    +            supported_tags = [
    +                (t.interpreter, t.abi, plat_name) for t in tags.sys_tags()
    +            ]
    +            assert (
    +                tag in supported_tags
    +            ), f"would build wheel with unsupported tag {tag}"
    +        return tag
    +
    +    def run(self):
    +        build_scripts = self.reinitialize_command("build_scripts")
    +        build_scripts.executable = "python"
    +        build_scripts.force = True
    +
    +        build_ext = self.reinitialize_command("build_ext")
    +        build_ext.inplace = False
    +
    +        if not self.skip_build:
    +            self.run_command("build")
    +
    +        install = self.reinitialize_command("install", reinit_subcommands=True)
    +        install.root = self.bdist_dir
    +        install.compile = False
    +        install.skip_build = self.skip_build
    +        install.warn_dir = False
    +
    +        # A wheel without setuptools scripts is more cross-platform.
    +        # Use the (undocumented) `no_ep` option to setuptools'
    +        # install_scripts command to avoid creating entry point scripts.
    +        install_scripts = self.reinitialize_command("install_scripts")
    +        install_scripts.no_ep = True
    +
    +        # Use a custom scheme for the archive, because we have to decide
    +        # at installation time which scheme to use.
    +        for key in ("headers", "scripts", "data", "purelib", "platlib"):
    +            setattr(install, "install_" + key, os.path.join(self.data_dir, key))
    +
    +        basedir_observed = ""
    +
    +        if os.name == "nt":
    +            # win32 barfs if any of these are ''; could be '.'?
    +            # (distutils.command.install:change_roots bug)
    +            basedir_observed = os.path.normpath(os.path.join(self.data_dir, ".."))
    +            self.install_libbase = self.install_lib = basedir_observed
    +
    +        setattr(
    +            install,
    +            "install_purelib" if self.root_is_pure else "install_platlib",
    +            basedir_observed,
    +        )
    +
    +        log.info(f"installing to {self.bdist_dir}")
    +
    +        self.run_command("install")
    +
    +        impl_tag, abi_tag, plat_tag = self.get_tag()
    +        archive_basename = f"{self.wheel_dist_name}-{impl_tag}-{abi_tag}-{plat_tag}"
    +        if not self.relative:
    +            archive_root = self.bdist_dir
    +        else:
    +            archive_root = os.path.join(
    +                self.bdist_dir, self._ensure_relative(install.install_base)
    +            )
    +
    +        self.set_undefined_options("install_egg_info", ("target", "egginfo_dir"))
    +        distinfo_dirname = (
    +            f"{safer_name(self.distribution.get_name())}-"
    +            f"{safer_version(self.distribution.get_version())}.dist-info"
    +        )
    +        distinfo_dir = os.path.join(self.bdist_dir, distinfo_dirname)
    +        self.egg2dist(self.egginfo_dir, distinfo_dir)
    +
    +        self.write_wheelfile(distinfo_dir)
    +
    +        # Make the archive
    +        if not os.path.exists(self.dist_dir):
    +            os.makedirs(self.dist_dir)
    +
    +        wheel_path = os.path.join(self.dist_dir, archive_basename + ".whl")
    +        with WheelFile(wheel_path, "w", self.compression) as wf:
    +            wf.write_files(archive_root)
    +
    +        # Add to 'Distribution.dist_files' so that the "upload" command works
    +        getattr(self.distribution, "dist_files", []).append(
    +            (
    +                "bdist_wheel",
    +                "{}.{}".format(*sys.version_info[:2]),  # like 3.7
    +                wheel_path,
    +            )
    +        )
    +
    +        if not self.keep_temp:
    +            log.info(f"removing {self.bdist_dir}")
    +            if not self.dry_run:
    +                if sys.version_info < (3, 12):
    +                    rmtree(self.bdist_dir, onerror=remove_readonly)
    +                else:
    +                    rmtree(self.bdist_dir, onexc=remove_readonly_exc)
    +
    +    def write_wheelfile(
    +        self, wheelfile_base: str, generator: str = f"bdist_wheel ({wheel_version})"
    +    ):
    +        from email.message import Message
    +
    +        msg = Message()
    +        msg["Wheel-Version"] = "1.0"  # of the spec
    +        msg["Generator"] = generator
    +        msg["Root-Is-Purelib"] = str(self.root_is_pure).lower()
    +        if self.build_number is not None:
    +            msg["Build"] = self.build_number
    +
    +        # Doesn't work for bdist_wininst
    +        impl_tag, abi_tag, plat_tag = self.get_tag()
    +        for impl in impl_tag.split("."):
    +            for abi in abi_tag.split("."):
    +                for plat in plat_tag.split("."):
    +                    msg["Tag"] = "-".join((impl, abi, plat))
    +
    +        wheelfile_path = os.path.join(wheelfile_base, "WHEEL")
    +        log.info(f"creating {wheelfile_path}")
    +        with open(wheelfile_path, "wb") as f:
    +            BytesGenerator(f, maxheaderlen=0).flatten(msg)
    +
    +    def _ensure_relative(self, path: str) -> str:
    +        # copied from dir_util, deleted
    +        drive, path = os.path.splitdrive(path)
    +        if path[0:1] == os.sep:
    +            path = drive + path[1:]
    +        return path
    +
    +    @property
    +    def license_paths(self) -> Iterable[str]:
    +        if setuptools_major_version >= 57:
    +            # Setuptools has resolved any patterns to actual file names
    +            return self.distribution.metadata.license_files or ()
    +
    +        files: set[str] = set()
    +        metadata = self.distribution.get_option_dict("metadata")
    +        if setuptools_major_version >= 42:
    +            # Setuptools recognizes the license_files option but does not do globbing
    +            patterns = cast(Sequence[str], self.distribution.metadata.license_files)
    +        else:
    +            # Prior to those, wheel is entirely responsible for handling license files
    +            if "license_files" in metadata:
    +                patterns = metadata["license_files"][1].split()
    +            else:
    +                patterns = ()
    +
    +        if "license_file" in metadata:
    +            warnings.warn(
    +                'The "license_file" option is deprecated. Use "license_files" instead.',
    +                DeprecationWarning,
    +                stacklevel=2,
    +            )
    +            files.add(metadata["license_file"][1])
    +
    +        if not files and not patterns and not isinstance(patterns, list):
    +            patterns = ("LICEN[CS]E*", "COPYING*", "NOTICE*", "AUTHORS*")
    +
    +        for pattern in patterns:
    +            for path in iglob(pattern):
    +                if path.endswith("~"):
    +                    log.debug(
    +                        f'ignoring license file "{path}" as it looks like a backup'
    +                    )
    +                    continue
    +
    +                if path not in files and os.path.isfile(path):
    +                    log.info(
    +                        f'adding license file "{path}" (matched pattern "{pattern}")'
    +                    )
    +                    files.add(path)
    +
    +        return files
    +
    +    def egg2dist(self, egginfo_path: str, distinfo_path: str):
    +        """Convert an .egg-info directory into a .dist-info directory"""
    +
    +        def adios(p: str) -> None:
    +            """Appropriately delete directory, file or link."""
    +            if os.path.exists(p) and not os.path.islink(p) and os.path.isdir(p):
    +                shutil.rmtree(p)
    +            elif os.path.exists(p):
    +                os.unlink(p)
    +
    +        adios(distinfo_path)
    +
    +        if not os.path.exists(egginfo_path):
    +            # There is no egg-info. This is probably because the egg-info
    +            # file/directory is not named matching the distribution name used
    +            # to name the archive file. Check for this case and report
    +            # accordingly.
    +            import glob
    +
    +            pat = os.path.join(os.path.dirname(egginfo_path), "*.egg-info")
    +            possible = glob.glob(pat)
    +            err = f"Egg metadata expected at {egginfo_path} but not found"
    +            if possible:
    +                alt = os.path.basename(possible[0])
    +                err += f" ({alt} found - possible misnamed archive file?)"
    +
    +            raise ValueError(err)
    +
    +        if os.path.isfile(egginfo_path):
    +            # .egg-info is a single file
    +            pkg_info = pkginfo_to_metadata(egginfo_path, egginfo_path)
    +            os.mkdir(distinfo_path)
    +        else:
    +            # .egg-info is a directory
    +            pkginfo_path = os.path.join(egginfo_path, "PKG-INFO")
    +            pkg_info = pkginfo_to_metadata(egginfo_path, pkginfo_path)
    +
    +            # ignore common egg metadata that is useless to wheel
    +            shutil.copytree(
    +                egginfo_path,
    +                distinfo_path,
    +                ignore=lambda x, y: {
    +                    "PKG-INFO",
    +                    "requires.txt",
    +                    "SOURCES.txt",
    +                    "not-zip-safe",
    +                },
    +            )
    +
    +            # delete dependency_links if it is only whitespace
    +            dependency_links_path = os.path.join(distinfo_path, "dependency_links.txt")
    +            with open(dependency_links_path, encoding="utf-8") as dependency_links_file:
    +                dependency_links = dependency_links_file.read().strip()
    +            if not dependency_links:
    +                adios(dependency_links_path)
    +
    +        pkg_info_path = os.path.join(distinfo_path, "METADATA")
    +        serialization_policy = EmailPolicy(
    +            utf8=True,
    +            mangle_from_=False,
    +            max_line_length=0,
    +        )
    +        with open(pkg_info_path, "w", encoding="utf-8") as out:
    +            Generator(out, policy=serialization_policy).flatten(pkg_info)
    +
    +        for license_path in self.license_paths:
    +            filename = os.path.basename(license_path)
    +            shutil.copy(license_path, os.path.join(distinfo_path, filename))
    +
    +        adios(egginfo_path)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/_setuptools_logging.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/_setuptools_logging.py
    new file mode 100644
    index 000000000..a1a2482ba
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/_setuptools_logging.py
    @@ -0,0 +1,26 @@
    +# copied from setuptools.logging, omitting monkeypatching
    +from __future__ import annotations
    +
    +import logging
    +import sys
    +
    +
    +def _not_warning(record: logging.LogRecord) -> bool:
    +    return record.levelno < logging.WARNING
    +
    +
    +def configure() -> None:
    +    """
    +    Configure logging to emit warning and above to stderr
    +    and everything else to stdout. This behavior is provided
    +    for compatibility with distutils.log but may change in
    +    the future.
    +    """
    +    err_handler = logging.StreamHandler()
    +    err_handler.setLevel(logging.WARNING)
    +    out_handler = logging.StreamHandler(sys.stdout)
    +    out_handler.addFilter(_not_warning)
    +    handlers = err_handler, out_handler
    +    logging.basicConfig(
    +        format="{message}", style="{", handlers=handlers, level=logging.DEBUG
    +    )
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/bdist_wheel.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/bdist_wheel.py
    new file mode 100644
    index 000000000..dd7b8629e
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/bdist_wheel.py
    @@ -0,0 +1,26 @@
    +from typing import TYPE_CHECKING
    +from warnings import warn
    +
    +warn(
    +    "The 'wheel' package is no longer the canonical location of the 'bdist_wheel' "
    +    "command, and will be removed in a future release. Please update to setuptools "
    +    "v70.1 or later which contains an integrated version of this command.",
    +    DeprecationWarning,
    +    stacklevel=1,
    +)
    +
    +if TYPE_CHECKING:
    +    from ._bdist_wheel import bdist_wheel as bdist_wheel
    +else:
    +    try:
    +        # Better integration/compatibility with setuptools:
    +        # in the case new fixes or PEPs are implemented in setuptools
    +        # there is no need to backport them to the deprecated code base.
    +        # This is useful in the case of old packages in the ecosystem
    +        # that are still used but have low maintenance.
    +        from setuptools.command.bdist_wheel import bdist_wheel
    +    except ImportError:
    +        # Only used in the case of old setuptools versions.
    +        # If the user wants to get the latest fixes/PEPs,
    +        # they are encouraged to address the deprecation warning.
    +        from ._bdist_wheel import bdist_wheel as bdist_wheel
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__init__.py
    new file mode 100644
    index 000000000..6ba1217f5
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__init__.py
    @@ -0,0 +1,155 @@
    +"""
    +Wheel command-line utility.
    +"""
    +
    +from __future__ import annotations
    +
    +import argparse
    +import os
    +import sys
    +from argparse import ArgumentTypeError
    +
    +
    +class WheelError(Exception):
    +    pass
    +
    +
    +def unpack_f(args: argparse.Namespace) -> None:
    +    from .unpack import unpack
    +
    +    unpack(args.wheelfile, args.dest)
    +
    +
    +def pack_f(args: argparse.Namespace) -> None:
    +    from .pack import pack
    +
    +    pack(args.directory, args.dest_dir, args.build_number)
    +
    +
    +def convert_f(args: argparse.Namespace) -> None:
    +    from .convert import convert
    +
    +    convert(args.files, args.dest_dir, args.verbose)
    +
    +
    +def tags_f(args: argparse.Namespace) -> None:
    +    from .tags import tags
    +
    +    names = (
    +        tags(
    +            wheel,
    +            args.python_tag,
    +            args.abi_tag,
    +            args.platform_tag,
    +            args.build,
    +            args.remove,
    +        )
    +        for wheel in args.wheel
    +    )
    +
    +    for name in names:
    +        print(name)
    +
    +
    +def version_f(args: argparse.Namespace) -> None:
    +    from .. import __version__
    +
    +    print(f"wheel {__version__}")
    +
    +
    +def parse_build_tag(build_tag: str) -> str:
    +    if build_tag and not build_tag[0].isdigit():
    +        raise ArgumentTypeError("build tag must begin with a digit")
    +    elif "-" in build_tag:
    +        raise ArgumentTypeError("invalid character ('-') in build tag")
    +
    +    return build_tag
    +
    +
    +TAGS_HELP = """\
    +Make a new wheel with given tags. Any tags unspecified will remain the same.
    +Starting the tags with a "+" will append to the existing tags. Starting with a
    +"-" will remove a tag (use --option=-TAG syntax). Multiple tags can be
    +separated by ".". The original file will remain unless --remove is given.  The
    +output filename(s) will be displayed on stdout for further processing.
    +"""
    +
    +
    +def parser():
    +    p = argparse.ArgumentParser()
    +    s = p.add_subparsers(help="commands")
    +
    +    unpack_parser = s.add_parser("unpack", help="Unpack wheel")
    +    unpack_parser.add_argument(
    +        "--dest", "-d", help="Destination directory", default="."
    +    )
    +    unpack_parser.add_argument("wheelfile", help="Wheel file")
    +    unpack_parser.set_defaults(func=unpack_f)
    +
    +    repack_parser = s.add_parser("pack", help="Repack wheel")
    +    repack_parser.add_argument("directory", help="Root directory of the unpacked wheel")
    +    repack_parser.add_argument(
    +        "--dest-dir",
    +        "-d",
    +        default=os.path.curdir,
    +        help="Directory to store the wheel (default %(default)s)",
    +    )
    +    repack_parser.add_argument(
    +        "--build-number", help="Build tag to use in the wheel name"
    +    )
    +    repack_parser.set_defaults(func=pack_f)
    +
    +    convert_parser = s.add_parser("convert", help="Convert egg or wininst to wheel")
    +    convert_parser.add_argument("files", nargs="*", help="Files to convert")
    +    convert_parser.add_argument(
    +        "--dest-dir",
    +        "-d",
    +        default=os.path.curdir,
    +        help="Directory to store wheels (default %(default)s)",
    +    )
    +    convert_parser.add_argument("--verbose", "-v", action="store_true")
    +    convert_parser.set_defaults(func=convert_f)
    +
    +    tags_parser = s.add_parser(
    +        "tags", help="Add or replace the tags on a wheel", description=TAGS_HELP
    +    )
    +    tags_parser.add_argument("wheel", nargs="*", help="Existing wheel(s) to retag")
    +    tags_parser.add_argument(
    +        "--remove",
    +        action="store_true",
    +        help="Remove the original files, keeping only the renamed ones",
    +    )
    +    tags_parser.add_argument(
    +        "--python-tag", metavar="TAG", help="Specify an interpreter tag(s)"
    +    )
    +    tags_parser.add_argument("--abi-tag", metavar="TAG", help="Specify an ABI tag(s)")
    +    tags_parser.add_argument(
    +        "--platform-tag", metavar="TAG", help="Specify a platform tag(s)"
    +    )
    +    tags_parser.add_argument(
    +        "--build", type=parse_build_tag, metavar="BUILD", help="Specify a build tag"
    +    )
    +    tags_parser.set_defaults(func=tags_f)
    +
    +    version_parser = s.add_parser("version", help="Print version and exit")
    +    version_parser.set_defaults(func=version_f)
    +
    +    help_parser = s.add_parser("help", help="Show this help")
    +    help_parser.set_defaults(func=lambda args: p.print_help())
    +
    +    return p
    +
    +
    +def main():
    +    p = parser()
    +    args = p.parse_args()
    +    if not hasattr(args, "func"):
    +        p.print_help()
    +    else:
    +        try:
    +            args.func(args)
    +            return 0
    +        except WheelError as e:
    +            print(e, file=sys.stderr)
    +
    +    return 1
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__pycache__/__init__.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..fd5f392001856616127c946f8b516bb1e2ebf2dd
    GIT binary patch
    literal 6974
    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
    QwcT8Bd9NeD1=+&?0_V&o%K!iX
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__pycache__/convert.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__pycache__/convert.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..49f2f757f2bf8074525a336a9225eccffe4172f1
    GIT binary patch
    literal 16211
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__pycache__/pack.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/__pycache__/pack.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..309986b6c676932b440c3a40c8aa957da7b4c220
    GIT binary patch
    literal 4502
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/convert.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/convert.py
    new file mode 100644
    index 000000000..61d4775c5
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/convert.py
    @@ -0,0 +1,332 @@
    +from __future__ import annotations
    +
    +import os.path
    +import re
    +from abc import ABCMeta, abstractmethod
    +from collections import defaultdict
    +from collections.abc import Iterator
    +from email.message import Message
    +from email.parser import Parser
    +from email.policy import EmailPolicy
    +from glob import iglob
    +from pathlib import Path
    +from textwrap import dedent
    +from zipfile import ZipFile
    +
    +from .. import __version__
    +from ..metadata import generate_requirements
    +from ..vendored.packaging.tags import parse_tag
    +from ..wheelfile import WheelFile
    +
    +egg_filename_re = re.compile(
    +    r"""
    +    (?P.+?)-(?P.+?)
    +    (-(?Ppy\d\.\d+)
    +     (-(?P.+?))?
    +    )?.egg$""",
    +    re.VERBOSE,
    +)
    +egg_info_re = re.compile(
    +    r"""
    +    ^(?P.+?)-(?P.+?)
    +    (-(?Ppy\d\.\d+)
    +    )?.egg-info/""",
    +    re.VERBOSE,
    +)
    +wininst_re = re.compile(
    +    r"\.(?Pwin32|win-amd64)(?:-(?Ppy\d\.\d))?\.exe$"
    +)
    +pyd_re = re.compile(r"\.(?P[a-z0-9]+)-(?Pwin32|win_amd64)\.pyd$")
    +serialization_policy = EmailPolicy(
    +    utf8=True,
    +    mangle_from_=False,
    +    max_line_length=0,
    +)
    +GENERATOR = f"wheel {__version__}"
    +
    +
    +def convert_requires(requires: str, metadata: Message) -> None:
    +    extra: str | None = None
    +    requirements: dict[str | None, list[str]] = defaultdict(list)
    +    for line in requires.splitlines():
    +        line = line.strip()
    +        if not line:
    +            continue
    +
    +        if line.startswith("[") and line.endswith("]"):
    +            extra = line[1:-1]
    +            continue
    +
    +        requirements[extra].append(line)
    +
    +    for key, value in generate_requirements(requirements):
    +        metadata.add_header(key, value)
    +
    +
    +def convert_pkg_info(pkginfo: str, metadata: Message):
    +    parsed_message = Parser().parsestr(pkginfo)
    +    for key, value in parsed_message.items():
    +        key_lower = key.lower()
    +        if value == "UNKNOWN":
    +            continue
    +
    +        if key_lower == "description":
    +            description_lines = value.splitlines()
    +            value = "\n".join(
    +                (
    +                    description_lines[0].lstrip(),
    +                    dedent("\n".join(description_lines[1:])),
    +                    "\n",
    +                )
    +            )
    +            metadata.set_payload(value)
    +        elif key_lower == "home-page":
    +            metadata.add_header("Project-URL", f"Homepage, {value}")
    +        elif key_lower == "download-url":
    +            metadata.add_header("Project-URL", f"Download, {value}")
    +        else:
    +            metadata.add_header(key, value)
    +
    +    metadata.replace_header("Metadata-Version", "2.4")
    +
    +
    +def normalize(name: str) -> str:
    +    return re.sub(r"[-_.]+", "-", name).lower().replace("-", "_")
    +
    +
    +class ConvertSource(metaclass=ABCMeta):
    +    name: str
    +    version: str
    +    pyver: str = "py2.py3"
    +    abi: str = "none"
    +    platform: str = "any"
    +    metadata: Message
    +
    +    @property
    +    def dist_info_dir(self) -> str:
    +        return f"{self.name}-{self.version}.dist-info"
    +
    +    @abstractmethod
    +    def generate_contents(self) -> Iterator[tuple[str, bytes]]:
    +        pass
    +
    +
    +class EggFileSource(ConvertSource):
    +    def __init__(self, path: Path):
    +        if not (match := egg_filename_re.match(path.name)):
    +            raise ValueError(f"Invalid egg file name: {path.name}")
    +
    +        # Binary wheels are assumed to be for CPython
    +        self.path = path
    +        self.name = normalize(match.group("name"))
    +        self.version = match.group("ver")
    +        if pyver := match.group("pyver"):
    +            self.pyver = pyver.replace(".", "")
    +            if arch := match.group("arch"):
    +                self.abi = self.pyver.replace("py", "cp")
    +                self.platform = normalize(arch)
    +
    +        self.metadata = Message()
    +
    +    def generate_contents(self) -> Iterator[tuple[str, bytes]]:
    +        with ZipFile(self.path, "r") as zip_file:
    +            for filename in sorted(zip_file.namelist()):
    +                # Skip pure directory entries
    +                if filename.endswith("/"):
    +                    continue
    +
    +                # Handle files in the egg-info directory specially, selectively moving
    +                # them to the dist-info directory while converting as needed
    +                if filename.startswith("EGG-INFO/"):
    +                    if filename == "EGG-INFO/requires.txt":
    +                        requires = zip_file.read(filename).decode("utf-8")
    +                        convert_requires(requires, self.metadata)
    +                    elif filename == "EGG-INFO/PKG-INFO":
    +                        pkginfo = zip_file.read(filename).decode("utf-8")
    +                        convert_pkg_info(pkginfo, self.metadata)
    +                    elif filename == "EGG-INFO/entry_points.txt":
    +                        yield (
    +                            f"{self.dist_info_dir}/entry_points.txt",
    +                            zip_file.read(filename),
    +                        )
    +
    +                    continue
    +
    +                # For any other file, just pass it through
    +                yield filename, zip_file.read(filename)
    +
    +
    +class EggDirectorySource(EggFileSource):
    +    def generate_contents(self) -> Iterator[tuple[str, bytes]]:
    +        for dirpath, _, filenames in os.walk(self.path):
    +            for filename in sorted(filenames):
    +                path = Path(dirpath, filename)
    +                if path.parent.name == "EGG-INFO":
    +                    if path.name == "requires.txt":
    +                        requires = path.read_text("utf-8")
    +                        convert_requires(requires, self.metadata)
    +                    elif path.name == "PKG-INFO":
    +                        pkginfo = path.read_text("utf-8")
    +                        convert_pkg_info(pkginfo, self.metadata)
    +                        if name := self.metadata.get("Name"):
    +                            self.name = normalize(name)
    +
    +                        if version := self.metadata.get("Version"):
    +                            self.version = version
    +                    elif path.name == "entry_points.txt":
    +                        yield (
    +                            f"{self.dist_info_dir}/entry_points.txt",
    +                            path.read_bytes(),
    +                        )
    +
    +                    continue
    +
    +                # For any other file, just pass it through
    +                yield str(path.relative_to(self.path)), path.read_bytes()
    +
    +
    +class WininstFileSource(ConvertSource):
    +    """
    +    Handles distributions created with ``bdist_wininst``.
    +
    +    The egginfo filename has the format::
    +
    +        name-ver(-pyver)(-arch).egg-info
    +
    +    The installer filename has the format::
    +
    +        name-ver.arch(-pyver).exe
    +
    +    Some things to note:
    +
    +    1. The installer filename is not definitive. An installer can be renamed
    +       and work perfectly well as an installer. So more reliable data should
    +       be used whenever possible.
    +    2. The egg-info data should be preferred for the name and version, because
    +       these come straight from the distutils metadata, and are mandatory.
    +    3. The pyver from the egg-info data should be ignored, as it is
    +       constructed from the version of Python used to build the installer,
    +       which is irrelevant - the installer filename is correct here (even to
    +       the point that when it's not there, any version is implied).
    +    4. The architecture must be taken from the installer filename, as it is
    +       not included in the egg-info data.
    +    5. Architecture-neutral installers still have an architecture because the
    +       installer format itself (being executable) is architecture-specific. We
    +       should therefore ignore the architecture if the content is pure-python.
    +    """
    +
    +    def __init__(self, path: Path):
    +        self.path = path
    +        self.metadata = Message()
    +
    +        # Determine the initial architecture and Python version from the file name
    +        # (if possible)
    +        if match := wininst_re.search(path.name):
    +            self.platform = normalize(match.group("platform"))
    +            if pyver := match.group("pyver"):
    +                self.pyver = pyver.replace(".", "")
    +
    +        # Look for an .egg-info directory and any .pyd files for more precise info
    +        egg_info_found = pyd_found = False
    +        with ZipFile(self.path) as zip_file:
    +            for filename in zip_file.namelist():
    +                prefix, filename = filename.split("/", 1)
    +                if not egg_info_found and (match := egg_info_re.match(filename)):
    +                    egg_info_found = True
    +                    self.name = normalize(match.group("name"))
    +                    self.version = match.group("ver")
    +                    if pyver := match.group("pyver"):
    +                        self.pyver = pyver.replace(".", "")
    +                elif not pyd_found and (match := pyd_re.search(filename)):
    +                    pyd_found = True
    +                    self.abi = match.group("abi")
    +                    self.platform = match.group("platform")
    +
    +                if egg_info_found and pyd_found:
    +                    break
    +
    +    def generate_contents(self) -> Iterator[tuple[str, bytes]]:
    +        dist_info_dir = f"{self.name}-{self.version}.dist-info"
    +        data_dir = f"{self.name}-{self.version}.data"
    +        with ZipFile(self.path, "r") as zip_file:
    +            for filename in sorted(zip_file.namelist()):
    +                # Skip pure directory entries
    +                if filename.endswith("/"):
    +                    continue
    +
    +                # Handle files in the egg-info directory specially, selectively moving
    +                # them to the dist-info directory while converting as needed
    +                prefix, target_filename = filename.split("/", 1)
    +                if egg_info_re.search(target_filename):
    +                    basename = target_filename.rsplit("/", 1)[-1]
    +                    if basename == "requires.txt":
    +                        requires = zip_file.read(filename).decode("utf-8")
    +                        convert_requires(requires, self.metadata)
    +                    elif basename == "PKG-INFO":
    +                        pkginfo = zip_file.read(filename).decode("utf-8")
    +                        convert_pkg_info(pkginfo, self.metadata)
    +                    elif basename == "entry_points.txt":
    +                        yield (
    +                            f"{dist_info_dir}/entry_points.txt",
    +                            zip_file.read(filename),
    +                        )
    +
    +                    continue
    +                elif prefix == "SCRIPTS":
    +                    target_filename = f"{data_dir}/scripts/{target_filename}"
    +
    +                # For any other file, just pass it through
    +                yield target_filename, zip_file.read(filename)
    +
    +
    +def convert(files: list[str], dest_dir: str, verbose: bool) -> None:
    +    for pat in files:
    +        for archive in iglob(pat):
    +            path = Path(archive)
    +            if path.suffix == ".egg":
    +                if path.is_dir():
    +                    source: ConvertSource = EggDirectorySource(path)
    +                else:
    +                    source = EggFileSource(path)
    +            else:
    +                source = WininstFileSource(path)
    +
    +            if verbose:
    +                print(f"{archive}...", flush=True, end="")
    +
    +            dest_path = Path(dest_dir) / (
    +                f"{source.name}-{source.version}-{source.pyver}-{source.abi}"
    +                f"-{source.platform}.whl"
    +            )
    +            with WheelFile(dest_path, "w") as wheelfile:
    +                for name_or_zinfo, contents in source.generate_contents():
    +                    wheelfile.writestr(name_or_zinfo, contents)
    +
    +                # Write the METADATA file
    +                wheelfile.writestr(
    +                    f"{source.dist_info_dir}/METADATA",
    +                    source.metadata.as_string(policy=serialization_policy).encode(
    +                        "utf-8"
    +                    ),
    +                )
    +
    +                # Write the WHEEL file
    +                wheel_message = Message()
    +                wheel_message.add_header("Wheel-Version", "1.0")
    +                wheel_message.add_header("Generator", GENERATOR)
    +                wheel_message.add_header(
    +                    "Root-Is-Purelib", str(source.platform == "any").lower()
    +                )
    +                tags = parse_tag(f"{source.pyver}-{source.abi}-{source.platform}")
    +                for tag in sorted(tags, key=lambda tag: tag.interpreter):
    +                    wheel_message.add_header("Tag", str(tag))
    +
    +                wheelfile.writestr(
    +                    f"{source.dist_info_dir}/WHEEL",
    +                    wheel_message.as_string(policy=serialization_policy).encode(
    +                        "utf-8"
    +                    ),
    +                )
    +
    +            if verbose:
    +                print("OK")
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/pack.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/pack.py
    new file mode 100644
    index 000000000..64469c0c7
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/pack.py
    @@ -0,0 +1,85 @@
    +from __future__ import annotations
    +
    +import email.policy
    +import os.path
    +import re
    +from email.generator import BytesGenerator
    +from email.parser import BytesParser
    +
    +from wheel.cli import WheelError
    +from wheel.wheelfile import WheelFile
    +
    +DIST_INFO_RE = re.compile(r"^(?P(?P.+?)-(?P\d.*?))\.dist-info$")
    +
    +
    +def pack(directory: str, dest_dir: str, build_number: str | None) -> None:
    +    """Repack a previously unpacked wheel directory into a new wheel file.
    +
    +    The .dist-info/WHEEL file must contain one or more tags so that the target
    +    wheel file name can be determined.
    +
    +    :param directory: The unpacked wheel directory
    +    :param dest_dir: Destination directory (defaults to the current directory)
    +    """
    +    # Find the .dist-info directory
    +    dist_info_dirs = [
    +        fn
    +        for fn in os.listdir(directory)
    +        if os.path.isdir(os.path.join(directory, fn)) and DIST_INFO_RE.match(fn)
    +    ]
    +    if len(dist_info_dirs) > 1:
    +        raise WheelError(f"Multiple .dist-info directories found in {directory}")
    +    elif not dist_info_dirs:
    +        raise WheelError(f"No .dist-info directories found in {directory}")
    +
    +    # Determine the target wheel filename
    +    dist_info_dir = dist_info_dirs[0]
    +    name_version = DIST_INFO_RE.match(dist_info_dir).group("namever")
    +
    +    # Read the tags and the existing build number from .dist-info/WHEEL
    +    wheel_file_path = os.path.join(directory, dist_info_dir, "WHEEL")
    +    with open(wheel_file_path, "rb") as f:
    +        info = BytesParser(policy=email.policy.compat32).parse(f)
    +        tags: list[str] = info.get_all("Tag", [])
    +        existing_build_number = info.get("Build")
    +
    +        if not tags:
    +            raise WheelError(
    +                f"No tags present in {dist_info_dir}/WHEEL; cannot determine target "
    +                f"wheel filename"
    +            )
    +
    +    # Set the wheel file name and add/replace/remove the Build tag in .dist-info/WHEEL
    +    build_number = build_number if build_number is not None else existing_build_number
    +    if build_number is not None:
    +        del info["Build"]
    +        if build_number:
    +            info["Build"] = build_number
    +            name_version += "-" + build_number
    +
    +        if build_number != existing_build_number:
    +            with open(wheel_file_path, "wb") as f:
    +                BytesGenerator(f, maxheaderlen=0).flatten(info)
    +
    +    # Reassemble the tags for the wheel file
    +    tagline = compute_tagline(tags)
    +
    +    # Repack the wheel
    +    wheel_path = os.path.join(dest_dir, f"{name_version}-{tagline}.whl")
    +    with WheelFile(wheel_path, "w") as wf:
    +        print(f"Repacking wheel as {wheel_path}...", end="", flush=True)
    +        wf.write_files(directory)
    +
    +    print("OK")
    +
    +
    +def compute_tagline(tags: list[str]) -> str:
    +    """Compute a tagline from a list of tags.
    +
    +    :param tags: A list of tags
    +    :return: A tagline
    +    """
    +    impls = sorted({tag.split("-")[0] for tag in tags})
    +    abivers = sorted({tag.split("-")[1] for tag in tags})
    +    platforms = sorted({tag.split("-")[2] for tag in tags})
    +    return "-".join([".".join(impls), ".".join(abivers), ".".join(platforms)])
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/tags.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/tags.py
    new file mode 100644
    index 000000000..88da72e9e
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/tags.py
    @@ -0,0 +1,139 @@
    +from __future__ import annotations
    +
    +import email.policy
    +import itertools
    +import os
    +from collections.abc import Iterable
    +from email.parser import BytesParser
    +
    +from ..wheelfile import WheelFile
    +
    +
    +def _compute_tags(original_tags: Iterable[str], new_tags: str | None) -> set[str]:
    +    """Add or replace tags. Supports dot-separated tags"""
    +    if new_tags is None:
    +        return set(original_tags)
    +
    +    if new_tags.startswith("+"):
    +        return {*original_tags, *new_tags[1:].split(".")}
    +
    +    if new_tags.startswith("-"):
    +        return set(original_tags) - set(new_tags[1:].split("."))
    +
    +    return set(new_tags.split("."))
    +
    +
    +def tags(
    +    wheel: str,
    +    python_tags: str | None = None,
    +    abi_tags: str | None = None,
    +    platform_tags: str | None = None,
    +    build_tag: str | None = None,
    +    remove: bool = False,
    +) -> str:
    +    """Change the tags on a wheel file.
    +
    +    The tags are left unchanged if they are not specified. To specify "none",
    +    use ["none"]. To append to the previous tags, a tag should start with a
    +    "+".  If a tag starts with "-", it will be removed from existing tags.
    +    Processing is done left to right.
    +
    +    :param wheel: The paths to the wheels
    +    :param python_tags: The Python tags to set
    +    :param abi_tags: The ABI tags to set
    +    :param platform_tags: The platform tags to set
    +    :param build_tag: The build tag to set
    +    :param remove: Remove the original wheel
    +    """
    +    with WheelFile(wheel, "r") as f:
    +        assert f.filename, f"{f.filename} must be available"
    +
    +        wheel_info = f.read(f.dist_info_path + "/WHEEL")
    +        info = BytesParser(policy=email.policy.compat32).parsebytes(wheel_info)
    +
    +        original_wheel_name = os.path.basename(f.filename)
    +        namever = f.parsed_filename.group("namever")
    +        build = f.parsed_filename.group("build")
    +        original_python_tags = f.parsed_filename.group("pyver").split(".")
    +        original_abi_tags = f.parsed_filename.group("abi").split(".")
    +        original_plat_tags = f.parsed_filename.group("plat").split(".")
    +
    +    tags: list[str] = info.get_all("Tag", [])
    +    existing_build_tag = info.get("Build")
    +
    +    impls = {tag.split("-")[0] for tag in tags}
    +    abivers = {tag.split("-")[1] for tag in tags}
    +    platforms = {tag.split("-")[2] for tag in tags}
    +
    +    if impls != set(original_python_tags):
    +        msg = f"Wheel internal tags {impls!r} != filename tags {original_python_tags!r}"
    +        raise AssertionError(msg)
    +
    +    if abivers != set(original_abi_tags):
    +        msg = f"Wheel internal tags {abivers!r} != filename tags {original_abi_tags!r}"
    +        raise AssertionError(msg)
    +
    +    if platforms != set(original_plat_tags):
    +        msg = (
    +            f"Wheel internal tags {platforms!r} != filename tags {original_plat_tags!r}"
    +        )
    +        raise AssertionError(msg)
    +
    +    if existing_build_tag != build:
    +        msg = (
    +            f"Incorrect filename '{build}' "
    +            f"& *.dist-info/WHEEL '{existing_build_tag}' build numbers"
    +        )
    +        raise AssertionError(msg)
    +
    +    # Start changing as needed
    +    if build_tag is not None:
    +        build = build_tag
    +
    +    final_python_tags = sorted(_compute_tags(original_python_tags, python_tags))
    +    final_abi_tags = sorted(_compute_tags(original_abi_tags, abi_tags))
    +    final_plat_tags = sorted(_compute_tags(original_plat_tags, platform_tags))
    +
    +    final_tags = [
    +        namever,
    +        ".".join(final_python_tags),
    +        ".".join(final_abi_tags),
    +        ".".join(final_plat_tags),
    +    ]
    +    if build:
    +        final_tags.insert(1, build)
    +
    +    final_wheel_name = "-".join(final_tags) + ".whl"
    +
    +    if original_wheel_name != final_wheel_name:
    +        del info["Tag"], info["Build"]
    +        for a, b, c in itertools.product(
    +            final_python_tags, final_abi_tags, final_plat_tags
    +        ):
    +            info["Tag"] = f"{a}-{b}-{c}"
    +        if build:
    +            info["Build"] = build
    +
    +        original_wheel_path = os.path.join(
    +            os.path.dirname(f.filename), original_wheel_name
    +        )
    +        final_wheel_path = os.path.join(os.path.dirname(f.filename), final_wheel_name)
    +
    +        with WheelFile(original_wheel_path, "r") as fin, WheelFile(
    +            final_wheel_path, "w"
    +        ) as fout:
    +            fout.comment = fin.comment  # preserve the comment
    +            for item in fin.infolist():
    +                if item.is_dir():
    +                    continue
    +                if item.filename == f.dist_info_path + "/RECORD":
    +                    continue
    +                if item.filename == f.dist_info_path + "/WHEEL":
    +                    fout.writestr(item, info.as_bytes())
    +                else:
    +                    fout.writestr(item, fin.read(item))
    +
    +        if remove:
    +            os.remove(original_wheel_path)
    +
    +    return final_wheel_name
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/unpack.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/unpack.py
    new file mode 100644
    index 000000000..d48840e6e
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/cli/unpack.py
    @@ -0,0 +1,30 @@
    +from __future__ import annotations
    +
    +from pathlib import Path
    +
    +from ..wheelfile import WheelFile
    +
    +
    +def unpack(path: str, dest: str = ".") -> None:
    +    """Unpack a wheel.
    +
    +    Wheel content will be unpacked to {dest}/{name}-{ver}, where {name}
    +    is the package name and {ver} its version.
    +
    +    :param path: The path to the wheel.
    +    :param dest: Destination directory (default to current directory).
    +    """
    +    with WheelFile(path) as wf:
    +        namever = wf.parsed_filename.group("namever")
    +        destination = Path(dest) / namever
    +        print(f"Unpacking to: {destination}...", end="", flush=True)
    +        for zinfo in wf.filelist:
    +            wf.extract(zinfo, destination)
    +
    +            # Set permissions to the same values as they were set in the archive
    +            # We have to do this manually due to
    +            # https://github.com/python/cpython/issues/59999
    +            permissions = zinfo.external_attr >> 16 & 0o777
    +            destination.joinpath(zinfo.filename).chmod(permissions)
    +
    +    print("OK")
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/macosx_libfile.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/macosx_libfile.py
    new file mode 100644
    index 000000000..abdfc9eda
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/macosx_libfile.py
    @@ -0,0 +1,482 @@
    +"""
    +This module contains function to analyse dynamic library
    +headers to extract system information
    +
    +Currently only for MacOSX
    +
    +Library file on macosx system starts with Mach-O or Fat field.
    +This can be distinguish by first 32 bites and it is called magic number.
    +Proper value of magic number is with suffix _MAGIC. Suffix _CIGAM means
    +reversed bytes order.
    +Both fields can occur in two types: 32 and 64 bytes.
    +
    +FAT field inform that this library contains few version of library
    +(typically for different types version). It contains
    +information where Mach-O headers starts.
    +
    +Each section started with Mach-O header contains one library
    +(So if file starts with this field it contains only one version).
    +
    +After filed Mach-O there are section fields.
    +Each of them starts with two fields:
    +cmd - magic number for this command
    +cmdsize - total size occupied by this section information.
    +
    +In this case only sections LC_VERSION_MIN_MACOSX (for macosx 10.13 and earlier)
    +and LC_BUILD_VERSION (for macosx 10.14 and newer) are interesting,
    +because them contains information about minimal system version.
    +
    +Important remarks:
    +- For fat files this implementation looks for maximum number version.
    +  It not check if it is 32 or 64 and do not compare it with currently built package.
    +  So it is possible to false report higher version that needed.
    +- All structures signatures are taken form macosx header files.
    +- I think that binary format will be more stable than `otool` output.
    +  and if apple introduce some changes both implementation will need to be updated.
    +- The system compile will set the deployment target no lower than
    +  11.0 for arm64 builds. For "Universal 2" builds use the x86_64 deployment
    +  target when the arm64 target is 11.0.
    +"""
    +
    +from __future__ import annotations
    +
    +import ctypes
    +import os
    +import sys
    +from io import BufferedIOBase
    +from typing import TYPE_CHECKING
    +
    +if TYPE_CHECKING:
    +    from typing import Union
    +
    +    StrPath = Union[str, os.PathLike[str]]
    +
    +"""here the needed const and struct from mach-o header files"""
    +
    +FAT_MAGIC = 0xCAFEBABE
    +FAT_CIGAM = 0xBEBAFECA
    +FAT_MAGIC_64 = 0xCAFEBABF
    +FAT_CIGAM_64 = 0xBFBAFECA
    +MH_MAGIC = 0xFEEDFACE
    +MH_CIGAM = 0xCEFAEDFE
    +MH_MAGIC_64 = 0xFEEDFACF
    +MH_CIGAM_64 = 0xCFFAEDFE
    +
    +LC_VERSION_MIN_MACOSX = 0x24
    +LC_BUILD_VERSION = 0x32
    +
    +CPU_TYPE_ARM64 = 0x0100000C
    +
    +mach_header_fields = [
    +    ("magic", ctypes.c_uint32),
    +    ("cputype", ctypes.c_int),
    +    ("cpusubtype", ctypes.c_int),
    +    ("filetype", ctypes.c_uint32),
    +    ("ncmds", ctypes.c_uint32),
    +    ("sizeofcmds", ctypes.c_uint32),
    +    ("flags", ctypes.c_uint32),
    +]
    +"""
    +struct mach_header {
    +    uint32_t	magic;		/* mach magic number identifier */
    +    cpu_type_t	cputype;	/* cpu specifier */
    +    cpu_subtype_t	cpusubtype;	/* machine specifier */
    +    uint32_t	filetype;	/* type of file */
    +    uint32_t	ncmds;		/* number of load commands */
    +    uint32_t	sizeofcmds;	/* the size of all the load commands */
    +    uint32_t	flags;		/* flags */
    +};
    +typedef integer_t cpu_type_t;
    +typedef integer_t cpu_subtype_t;
    +"""
    +
    +mach_header_fields_64 = mach_header_fields + [("reserved", ctypes.c_uint32)]
    +"""
    +struct mach_header_64 {
    +    uint32_t	magic;		/* mach magic number identifier */
    +    cpu_type_t	cputype;	/* cpu specifier */
    +    cpu_subtype_t	cpusubtype;	/* machine specifier */
    +    uint32_t	filetype;	/* type of file */
    +    uint32_t	ncmds;		/* number of load commands */
    +    uint32_t	sizeofcmds;	/* the size of all the load commands */
    +    uint32_t	flags;		/* flags */
    +    uint32_t	reserved;	/* reserved */
    +};
    +"""
    +
    +fat_header_fields = [("magic", ctypes.c_uint32), ("nfat_arch", ctypes.c_uint32)]
    +"""
    +struct fat_header {
    +    uint32_t	magic;		/* FAT_MAGIC or FAT_MAGIC_64 */
    +    uint32_t	nfat_arch;	/* number of structs that follow */
    +};
    +"""
    +
    +fat_arch_fields = [
    +    ("cputype", ctypes.c_int),
    +    ("cpusubtype", ctypes.c_int),
    +    ("offset", ctypes.c_uint32),
    +    ("size", ctypes.c_uint32),
    +    ("align", ctypes.c_uint32),
    +]
    +"""
    +struct fat_arch {
    +    cpu_type_t	cputype;	/* cpu specifier (int) */
    +    cpu_subtype_t	cpusubtype;	/* machine specifier (int) */
    +    uint32_t	offset;		/* file offset to this object file */
    +    uint32_t	size;		/* size of this object file */
    +    uint32_t	align;		/* alignment as a power of 2 */
    +};
    +"""
    +
    +fat_arch_64_fields = [
    +    ("cputype", ctypes.c_int),
    +    ("cpusubtype", ctypes.c_int),
    +    ("offset", ctypes.c_uint64),
    +    ("size", ctypes.c_uint64),
    +    ("align", ctypes.c_uint32),
    +    ("reserved", ctypes.c_uint32),
    +]
    +"""
    +struct fat_arch_64 {
    +    cpu_type_t	cputype;	/* cpu specifier (int) */
    +    cpu_subtype_t	cpusubtype;	/* machine specifier (int) */
    +    uint64_t	offset;		/* file offset to this object file */
    +    uint64_t	size;		/* size of this object file */
    +    uint32_t	align;		/* alignment as a power of 2 */
    +    uint32_t	reserved;	/* reserved */
    +};
    +"""
    +
    +segment_base_fields = [("cmd", ctypes.c_uint32), ("cmdsize", ctypes.c_uint32)]
    +"""base for reading segment info"""
    +
    +segment_command_fields = [
    +    ("cmd", ctypes.c_uint32),
    +    ("cmdsize", ctypes.c_uint32),
    +    ("segname", ctypes.c_char * 16),
    +    ("vmaddr", ctypes.c_uint32),
    +    ("vmsize", ctypes.c_uint32),
    +    ("fileoff", ctypes.c_uint32),
    +    ("filesize", ctypes.c_uint32),
    +    ("maxprot", ctypes.c_int),
    +    ("initprot", ctypes.c_int),
    +    ("nsects", ctypes.c_uint32),
    +    ("flags", ctypes.c_uint32),
    +]
    +"""
    +struct segment_command { /* for 32-bit architectures */
    +    uint32_t	cmd;		/* LC_SEGMENT */
    +    uint32_t	cmdsize;	/* includes sizeof section structs */
    +    char		segname[16];	/* segment name */
    +    uint32_t	vmaddr;		/* memory address of this segment */
    +    uint32_t	vmsize;		/* memory size of this segment */
    +    uint32_t	fileoff;	/* file offset of this segment */
    +    uint32_t	filesize;	/* amount to map from the file */
    +    vm_prot_t	maxprot;	/* maximum VM protection */
    +    vm_prot_t	initprot;	/* initial VM protection */
    +    uint32_t	nsects;		/* number of sections in segment */
    +    uint32_t	flags;		/* flags */
    +};
    +typedef int vm_prot_t;
    +"""
    +
    +segment_command_fields_64 = [
    +    ("cmd", ctypes.c_uint32),
    +    ("cmdsize", ctypes.c_uint32),
    +    ("segname", ctypes.c_char * 16),
    +    ("vmaddr", ctypes.c_uint64),
    +    ("vmsize", ctypes.c_uint64),
    +    ("fileoff", ctypes.c_uint64),
    +    ("filesize", ctypes.c_uint64),
    +    ("maxprot", ctypes.c_int),
    +    ("initprot", ctypes.c_int),
    +    ("nsects", ctypes.c_uint32),
    +    ("flags", ctypes.c_uint32),
    +]
    +"""
    +struct segment_command_64 { /* for 64-bit architectures */
    +    uint32_t	cmd;		/* LC_SEGMENT_64 */
    +    uint32_t	cmdsize;	/* includes sizeof section_64 structs */
    +    char		segname[16];	/* segment name */
    +    uint64_t	vmaddr;		/* memory address of this segment */
    +    uint64_t	vmsize;		/* memory size of this segment */
    +    uint64_t	fileoff;	/* file offset of this segment */
    +    uint64_t	filesize;	/* amount to map from the file */
    +    vm_prot_t	maxprot;	/* maximum VM protection */
    +    vm_prot_t	initprot;	/* initial VM protection */
    +    uint32_t	nsects;		/* number of sections in segment */
    +    uint32_t	flags;		/* flags */
    +};
    +"""
    +
    +version_min_command_fields = segment_base_fields + [
    +    ("version", ctypes.c_uint32),
    +    ("sdk", ctypes.c_uint32),
    +]
    +"""
    +struct version_min_command {
    +    uint32_t	cmd;		/* LC_VERSION_MIN_MACOSX or
    +                               LC_VERSION_MIN_IPHONEOS or
    +                               LC_VERSION_MIN_WATCHOS or
    +                               LC_VERSION_MIN_TVOS */
    +    uint32_t	cmdsize;	/* sizeof(struct min_version_command) */
    +    uint32_t	version;	/* X.Y.Z is encoded in nibbles xxxx.yy.zz */
    +    uint32_t	sdk;		/* X.Y.Z is encoded in nibbles xxxx.yy.zz */
    +};
    +"""
    +
    +build_version_command_fields = segment_base_fields + [
    +    ("platform", ctypes.c_uint32),
    +    ("minos", ctypes.c_uint32),
    +    ("sdk", ctypes.c_uint32),
    +    ("ntools", ctypes.c_uint32),
    +]
    +"""
    +struct build_version_command {
    +    uint32_t	cmd;		/* LC_BUILD_VERSION */
    +    uint32_t	cmdsize;	/* sizeof(struct build_version_command) plus */
    +                                /* ntools * sizeof(struct build_tool_version) */
    +    uint32_t	platform;	/* platform */
    +    uint32_t	minos;		/* X.Y.Z is encoded in nibbles xxxx.yy.zz */
    +    uint32_t	sdk;		/* X.Y.Z is encoded in nibbles xxxx.yy.zz */
    +    uint32_t	ntools;		/* number of tool entries following this */
    +};
    +"""
    +
    +
    +def swap32(x: int) -> int:
    +    return (
    +        ((x << 24) & 0xFF000000)
    +        | ((x << 8) & 0x00FF0000)
    +        | ((x >> 8) & 0x0000FF00)
    +        | ((x >> 24) & 0x000000FF)
    +    )
    +
    +
    +def get_base_class_and_magic_number(
    +    lib_file: BufferedIOBase,
    +    seek: int | None = None,
    +) -> tuple[type[ctypes.Structure], int]:
    +    if seek is None:
    +        seek = lib_file.tell()
    +    else:
    +        lib_file.seek(seek)
    +    magic_number = ctypes.c_uint32.from_buffer_copy(
    +        lib_file.read(ctypes.sizeof(ctypes.c_uint32))
    +    ).value
    +
    +    # Handle wrong byte order
    +    if magic_number in [FAT_CIGAM, FAT_CIGAM_64, MH_CIGAM, MH_CIGAM_64]:
    +        if sys.byteorder == "little":
    +            BaseClass = ctypes.BigEndianStructure
    +        else:
    +            BaseClass = ctypes.LittleEndianStructure
    +
    +        magic_number = swap32(magic_number)
    +    else:
    +        BaseClass = ctypes.Structure
    +
    +    lib_file.seek(seek)
    +    return BaseClass, magic_number
    +
    +
    +def read_data(struct_class: type[ctypes.Structure], lib_file: BufferedIOBase):
    +    return struct_class.from_buffer_copy(lib_file.read(ctypes.sizeof(struct_class)))
    +
    +
    +def extract_macosx_min_system_version(path_to_lib: str):
    +    with open(path_to_lib, "rb") as lib_file:
    +        BaseClass, magic_number = get_base_class_and_magic_number(lib_file, 0)
    +        if magic_number not in [FAT_MAGIC, FAT_MAGIC_64, MH_MAGIC, MH_MAGIC_64]:
    +            return
    +
    +        if magic_number in [FAT_MAGIC, FAT_CIGAM_64]:
    +
    +            class FatHeader(BaseClass):
    +                _fields_ = fat_header_fields
    +
    +            fat_header = read_data(FatHeader, lib_file)
    +            if magic_number == FAT_MAGIC:
    +
    +                class FatArch(BaseClass):
    +                    _fields_ = fat_arch_fields
    +
    +            else:
    +
    +                class FatArch(BaseClass):
    +                    _fields_ = fat_arch_64_fields
    +
    +            fat_arch_list = [
    +                read_data(FatArch, lib_file) for _ in range(fat_header.nfat_arch)
    +            ]
    +
    +            versions_list: list[tuple[int, int, int]] = []
    +            for el in fat_arch_list:
    +                try:
    +                    version = read_mach_header(lib_file, el.offset)
    +                    if version is not None:
    +                        if el.cputype == CPU_TYPE_ARM64 and len(fat_arch_list) != 1:
    +                            # Xcode will not set the deployment target below 11.0.0
    +                            # for the arm64 architecture. Ignore the arm64 deployment
    +                            # in fat binaries when the target is 11.0.0, that way
    +                            # the other architectures can select a lower deployment
    +                            # target.
    +                            # This is safe because there is no arm64 variant for
    +                            # macOS 10.15 or earlier.
    +                            if version == (11, 0, 0):
    +                                continue
    +                        versions_list.append(version)
    +                except ValueError:
    +                    pass
    +
    +            if len(versions_list) > 0:
    +                return max(versions_list)
    +            else:
    +                return None
    +
    +        else:
    +            try:
    +                return read_mach_header(lib_file, 0)
    +            except ValueError:
    +                """when some error during read library files"""
    +                return None
    +
    +
    +def read_mach_header(
    +    lib_file: BufferedIOBase,
    +    seek: int | None = None,
    +) -> tuple[int, int, int] | None:
    +    """
    +    This function parses a Mach-O header and extracts
    +    information about the minimal macOS version.
    +
    +    :param lib_file: reference to opened library file with pointer
    +    """
    +    base_class, magic_number = get_base_class_and_magic_number(lib_file, seek)
    +    arch = "32" if magic_number == MH_MAGIC else "64"
    +
    +    class SegmentBase(base_class):
    +        _fields_ = segment_base_fields
    +
    +    if arch == "32":
    +
    +        class MachHeader(base_class):
    +            _fields_ = mach_header_fields
    +
    +    else:
    +
    +        class MachHeader(base_class):
    +            _fields_ = mach_header_fields_64
    +
    +    mach_header = read_data(MachHeader, lib_file)
    +    for _i in range(mach_header.ncmds):
    +        pos = lib_file.tell()
    +        segment_base = read_data(SegmentBase, lib_file)
    +        lib_file.seek(pos)
    +        if segment_base.cmd == LC_VERSION_MIN_MACOSX:
    +
    +            class VersionMinCommand(base_class):
    +                _fields_ = version_min_command_fields
    +
    +            version_info = read_data(VersionMinCommand, lib_file)
    +            return parse_version(version_info.version)
    +        elif segment_base.cmd == LC_BUILD_VERSION:
    +
    +            class VersionBuild(base_class):
    +                _fields_ = build_version_command_fields
    +
    +            version_info = read_data(VersionBuild, lib_file)
    +            return parse_version(version_info.minos)
    +        else:
    +            lib_file.seek(pos + segment_base.cmdsize)
    +            continue
    +
    +
    +def parse_version(version: int) -> tuple[int, int, int]:
    +    x = (version & 0xFFFF0000) >> 16
    +    y = (version & 0x0000FF00) >> 8
    +    z = version & 0x000000FF
    +    return x, y, z
    +
    +
    +def calculate_macosx_platform_tag(archive_root: StrPath, platform_tag: str) -> str:
    +    """
    +    Calculate proper macosx platform tag basing on files which are included to wheel
    +
    +    Example platform tag `macosx-10.14-x86_64`
    +    """
    +    prefix, base_version, suffix = platform_tag.split("-")
    +    base_version = tuple(int(x) for x in base_version.split("."))
    +    base_version = base_version[:2]
    +    if base_version[0] > 10:
    +        base_version = (base_version[0], 0)
    +    assert len(base_version) == 2
    +    if "MACOSX_DEPLOYMENT_TARGET" in os.environ:
    +        deploy_target = tuple(
    +            int(x) for x in os.environ["MACOSX_DEPLOYMENT_TARGET"].split(".")
    +        )
    +        deploy_target = deploy_target[:2]
    +        if deploy_target[0] > 10:
    +            deploy_target = (deploy_target[0], 0)
    +        if deploy_target < base_version:
    +            sys.stderr.write(
    +                "[WARNING] MACOSX_DEPLOYMENT_TARGET is set to a lower value ({}) than "
    +                "the version on which the Python interpreter was compiled ({}), and "
    +                "will be ignored.\n".format(
    +                    ".".join(str(x) for x in deploy_target),
    +                    ".".join(str(x) for x in base_version),
    +                )
    +            )
    +        else:
    +            base_version = deploy_target
    +
    +    assert len(base_version) == 2
    +    start_version = base_version
    +    versions_dict: dict[str, tuple[int, int]] = {}
    +    for dirpath, _dirnames, filenames in os.walk(archive_root):
    +        for filename in filenames:
    +            if filename.endswith(".dylib") or filename.endswith(".so"):
    +                lib_path = os.path.join(dirpath, filename)
    +                min_ver = extract_macosx_min_system_version(lib_path)
    +                if min_ver is not None:
    +                    min_ver = min_ver[0:2]
    +                    if min_ver[0] > 10:
    +                        min_ver = (min_ver[0], 0)
    +                    versions_dict[lib_path] = min_ver
    +
    +    if len(versions_dict) > 0:
    +        base_version = max(base_version, max(versions_dict.values()))
    +
    +    # macosx platform tag do not support minor bugfix release
    +    fin_base_version = "_".join([str(x) for x in base_version])
    +    if start_version < base_version:
    +        problematic_files = [k for k, v in versions_dict.items() if v > start_version]
    +        problematic_files = "\n".join(problematic_files)
    +        if len(problematic_files) == 1:
    +            files_form = "this file"
    +        else:
    +            files_form = "these files"
    +        error_message = (
    +            "[WARNING] This wheel needs a higher macOS version than {}  "
    +            "To silence this warning, set MACOSX_DEPLOYMENT_TARGET to at least "
    +            + fin_base_version
    +            + " or recreate "
    +            + files_form
    +            + " with lower "
    +            "MACOSX_DEPLOYMENT_TARGET:  \n" + problematic_files
    +        )
    +
    +        if "MACOSX_DEPLOYMENT_TARGET" in os.environ:
    +            error_message = error_message.format(
    +                "is set in MACOSX_DEPLOYMENT_TARGET variable."
    +            )
    +        else:
    +            error_message = error_message.format(
    +                "the version your Python interpreter is compiled against."
    +            )
    +
    +        sys.stderr.write(error_message)
    +
    +    platform_tag = prefix + "_" + fin_base_version + "_" + suffix
    +    return platform_tag
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/metadata.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/metadata.py
    new file mode 100644
    index 000000000..b8098fa85
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/metadata.py
    @@ -0,0 +1,183 @@
    +"""
    +Tools for converting old- to new-style metadata.
    +"""
    +
    +from __future__ import annotations
    +
    +import functools
    +import itertools
    +import os.path
    +import re
    +import textwrap
    +from email.message import Message
    +from email.parser import Parser
    +from typing import Generator, Iterable, Iterator, Literal
    +
    +from .vendored.packaging.requirements import Requirement
    +
    +
    +def _nonblank(str: str) -> bool | Literal[""]:
    +    return str and not str.startswith("#")
    +
    +
    +@functools.singledispatch
    +def yield_lines(iterable: Iterable[str]) -> Iterator[str]:
    +    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: str) -> Iterator[str]:
    +    return filter(_nonblank, map(str.strip, text.splitlines()))
    +
    +
    +def split_sections(
    +    s: str | Iterator[str],
    +) -> Generator[tuple[str | None, list[str]], None, None]:
    +    """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: list[str] = []
    +    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 safe_extra(extra: str) -> 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 safe_name(name: str) -> 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 requires_to_requires_dist(requirement: Requirement) -> str:
    +    """Return the version specifier for a requirement in PEP 345/566 fashion."""
    +    if requirement.url:
    +        return " @ " + requirement.url
    +
    +    requires_dist: list[str] = []
    +    for spec in requirement.specifier:
    +        requires_dist.append(spec.operator + spec.version)
    +
    +    if requires_dist:
    +        return " " + ",".join(sorted(requires_dist))
    +    else:
    +        return ""
    +
    +
    +def convert_requirements(requirements: list[str]) -> Iterator[str]:
    +    """Yield Requires-Dist: strings for parsed requirements strings."""
    +    for req in requirements:
    +        parsed_requirement = Requirement(req)
    +        spec = requires_to_requires_dist(parsed_requirement)
    +        extras = ",".join(sorted(safe_extra(e) for e in parsed_requirement.extras))
    +        if extras:
    +            extras = f"[{extras}]"
    +
    +        yield safe_name(parsed_requirement.name) + extras + spec
    +
    +
    +def generate_requirements(
    +    extras_require: dict[str | None, list[str]],
    +) -> Iterator[tuple[str, str]]:
    +    """
    +    Convert requirements from a setup()-style dictionary to
    +    ('Requires-Dist', 'requirement') and ('Provides-Extra', 'extra') tuples.
    +
    +    extras_require is a dictionary of {extra: [requirements]} as passed to setup(),
    +    using the empty extra {'': [requirements]} to hold install_requires.
    +    """
    +    for extra, depends in extras_require.items():
    +        condition = ""
    +        extra = extra or ""
    +        if ":" in extra:  # setuptools extra:condition syntax
    +            extra, condition = extra.split(":", 1)
    +
    +        extra = safe_extra(extra)
    +        if extra:
    +            yield "Provides-Extra", extra
    +            if condition:
    +                condition = "(" + condition + ") and "
    +            condition += f"extra == '{extra}'"
    +
    +        if condition:
    +            condition = " ; " + condition
    +
    +        for new_req in convert_requirements(depends):
    +            canonical_req = str(Requirement(new_req + condition))
    +            yield "Requires-Dist", canonical_req
    +
    +
    +def pkginfo_to_metadata(egg_info_path: str, pkginfo_path: str) -> Message:
    +    """
    +    Convert .egg-info directory with PKG-INFO to the Metadata 2.1 format
    +    """
    +    with open(pkginfo_path, encoding="utf-8") as headers:
    +        pkg_info = Parser().parse(headers)
    +
    +    pkg_info.replace_header("Metadata-Version", "2.1")
    +    # Those will be regenerated from `requires.txt`.
    +    del pkg_info["Provides-Extra"]
    +    del pkg_info["Requires-Dist"]
    +    requires_path = os.path.join(egg_info_path, "requires.txt")
    +    if os.path.exists(requires_path):
    +        with open(requires_path, encoding="utf-8") as requires_file:
    +            requires = requires_file.read()
    +
    +        parsed_requirements = sorted(split_sections(requires), key=lambda x: x[0] or "")
    +        for extra, reqs in parsed_requirements:
    +            for key, value in generate_requirements({extra: reqs}):
    +                if (key, value) not in pkg_info.items():
    +                    pkg_info[key] = value
    +
    +    description = pkg_info["Description"]
    +    if description:
    +        description_lines = pkg_info["Description"].splitlines()
    +        dedented_description = "\n".join(
    +            # if the first line of long_description is blank,
    +            # the first line here will be indented.
    +            (
    +                description_lines[0].lstrip(),
    +                textwrap.dedent("\n".join(description_lines[1:])),
    +                "\n",
    +            )
    +        )
    +        pkg_info.set_payload(dedented_description)
    +        del pkg_info["Description"]
    +
    +    return pkg_info
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/util.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/util.py
    new file mode 100644
    index 000000000..c928aa403
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/util.py
    @@ -0,0 +1,17 @@
    +from __future__ import annotations
    +
    +import base64
    +import logging
    +
    +log = logging.getLogger("wheel")
    +
    +
    +def urlsafe_b64encode(data: bytes) -> bytes:
    +    """urlsafe_b64encode without padding"""
    +    return base64.urlsafe_b64encode(data).rstrip(b"=")
    +
    +
    +def urlsafe_b64decode(data: bytes) -> bytes:
    +    """urlsafe_b64decode without padding"""
    +    pad = b"=" * (4 - (len(data) & 3))
    +    return base64.urlsafe_b64decode(data + pad)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/__init__.py
    new file mode 100644
    index 000000000..e69de29bb
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/__pycache__/__init__.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..dd40dc1d6a9eb04a42c56dfea1057a60397e3dea
    GIT binary patch
    literal 236
    zcmX@j%ge<81jlwKW`O9&AOanHW&w&!XQ*V*Wb|9fP{ah}eFmxd)vceApPQ8XTbOm!FafVR^c^#Rugl<(KG}l$PWdWhUn6>%mz$nMwKul_eSZ
    zdB%E%M*78>C8@dviOJcC=|J7ZsU@WaCHeU|#rpAOsd*{+Mf&9#si`^o5Kd}}etdjp
    pUS>&ryk0@&FAkgB{FKt1RJ$TppxYRMxERFv$jr#dSi}ru0RT5~L*xJe
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE
    new file mode 100644
    index 000000000..6f62d44e4
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE
    @@ -0,0 +1,3 @@
    +This software is made available under the terms of *either* of the licenses
    +found in LICENSE.APACHE or LICENSE.BSD. Contributions to this software is made
    +under the terms of *both* these licenses.
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE.APACHE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE.APACHE
    new file mode 100644
    index 000000000..f433b1a53
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE.APACHE
    @@ -0,0 +1,177 @@
    +
    +                                 Apache License
    +                           Version 2.0, January 2004
    +                        http://www.apache.org/licenses/
    +
    +   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
    +
    +   1. Definitions.
    +
    +      "License" shall mean the terms and conditions for use, reproduction,
    +      and distribution as defined by Sections 1 through 9 of this document.
    +
    +      "Licensor" shall mean the copyright owner or entity authorized by
    +      the copyright owner that is granting the License.
    +
    +      "Legal Entity" shall mean the union of the acting entity and all
    +      other entities that control, are controlled by, or are under common
    +      control with that entity. For the purposes of this definition,
    +      "control" means (i) the power, direct or indirect, to cause the
    +      direction or management of such entity, whether by contract or
    +      otherwise, or (ii) ownership of fifty percent (50%) or more of the
    +      outstanding shares, or (iii) beneficial ownership of such entity.
    +
    +      "You" (or "Your") shall mean an individual or Legal Entity
    +      exercising permissions granted by this License.
    +
    +      "Source" form shall mean the preferred form for making modifications,
    +      including but not limited to software source code, documentation
    +      source, and configuration files.
    +
    +      "Object" form shall mean any form resulting from mechanical
    +      transformation or translation of a Source form, including but
    +      not limited to compiled object code, generated documentation,
    +      and conversions to other media types.
    +
    +      "Work" shall mean the work of authorship, whether in Source or
    +      Object form, made available under the License, as indicated by a
    +      copyright notice that is included in or attached to the work
    +      (an example is provided in the Appendix below).
    +
    +      "Derivative Works" shall mean any work, whether in Source or Object
    +      form, that is based on (or derived from) the Work and for which the
    +      editorial revisions, annotations, elaborations, or other modifications
    +      represent, as a whole, an original work of authorship. For the purposes
    +      of this License, Derivative Works shall not include works that remain
    +      separable from, or merely link (or bind by name) to the interfaces of,
    +      the Work and Derivative Works thereof.
    +
    +      "Contribution" shall mean any work of authorship, including
    +      the original version of the Work and any modifications or additions
    +      to that Work or Derivative Works thereof, that is intentionally
    +      submitted to Licensor for inclusion in the Work by the copyright owner
    +      or by an individual or Legal Entity authorized to submit on behalf of
    +      the copyright owner. For the purposes of this definition, "submitted"
    +      means any form of electronic, verbal, or written communication sent
    +      to the Licensor or its representatives, including but not limited to
    +      communication on electronic mailing lists, source code control systems,
    +      and issue tracking systems that are managed by, or on behalf of, the
    +      Licensor for the purpose of discussing and improving the Work, but
    +      excluding communication that is conspicuously marked or otherwise
    +      designated in writing by the copyright owner as "Not a Contribution."
    +
    +      "Contributor" shall mean Licensor and any individual or Legal Entity
    +      on behalf of whom a Contribution has been received by Licensor and
    +      subsequently incorporated within the Work.
    +
    +   2. Grant of Copyright License. Subject to the terms and conditions of
    +      this License, each Contributor hereby grants to You a perpetual,
    +      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
    +      copyright license to reproduce, prepare Derivative Works of,
    +      publicly display, publicly perform, sublicense, and distribute the
    +      Work and such Derivative Works in Source or Object form.
    +
    +   3. Grant of Patent License. Subject to the terms and conditions of
    +      this License, each Contributor hereby grants to You a perpetual,
    +      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
    +      (except as stated in this section) patent license to make, have made,
    +      use, offer to sell, sell, import, and otherwise transfer the Work,
    +      where such license applies only to those patent claims licensable
    +      by such Contributor that are necessarily infringed by their
    +      Contribution(s) alone or by combination of their Contribution(s)
    +      with the Work to which such Contribution(s) was submitted. If You
    +      institute patent litigation against any entity (including a
    +      cross-claim or counterclaim in a lawsuit) alleging that the Work
    +      or a Contribution incorporated within the Work constitutes direct
    +      or contributory patent infringement, then any patent licenses
    +      granted to You under this License for that Work shall terminate
    +      as of the date such litigation is filed.
    +
    +   4. Redistribution. You may reproduce and distribute copies of the
    +      Work or Derivative Works thereof in any medium, with or without
    +      modifications, and in Source or Object form, provided that You
    +      meet the following conditions:
    +
    +      (a) You must give any other recipients of the Work or
    +          Derivative Works a copy of this License; and
    +
    +      (b) You must cause any modified files to carry prominent notices
    +          stating that You changed the files; and
    +
    +      (c) You must retain, in the Source form of any Derivative Works
    +          that You distribute, all copyright, patent, trademark, and
    +          attribution notices from the Source form of the Work,
    +          excluding those notices that do not pertain to any part of
    +          the Derivative Works; and
    +
    +      (d) If the Work includes a "NOTICE" text file as part of its
    +          distribution, then any Derivative Works that You distribute must
    +          include a readable copy of the attribution notices contained
    +          within such NOTICE file, excluding those notices that do not
    +          pertain to any part of the Derivative Works, in at least one
    +          of the following places: within a NOTICE text file distributed
    +          as part of the Derivative Works; within the Source form or
    +          documentation, if provided along with the Derivative Works; or,
    +          within a display generated by the Derivative Works, if and
    +          wherever such third-party notices normally appear. The contents
    +          of the NOTICE file are for informational purposes only and
    +          do not modify the License. You may add Your own attribution
    +          notices within Derivative Works that You distribute, alongside
    +          or as an addendum to the NOTICE text from the Work, provided
    +          that such additional attribution notices cannot be construed
    +          as modifying the License.
    +
    +      You may add Your own copyright statement to Your modifications and
    +      may provide additional or different license terms and conditions
    +      for use, reproduction, or distribution of Your modifications, or
    +      for any such Derivative Works as a whole, provided Your use,
    +      reproduction, and distribution of the Work otherwise complies with
    +      the conditions stated in this License.
    +
    +   5. Submission of Contributions. Unless You explicitly state otherwise,
    +      any Contribution intentionally submitted for inclusion in the Work
    +      by You to the Licensor shall be under the terms and conditions of
    +      this License, without any additional terms or conditions.
    +      Notwithstanding the above, nothing herein shall supersede or modify
    +      the terms of any separate license agreement you may have executed
    +      with Licensor regarding such Contributions.
    +
    +   6. Trademarks. This License does not grant permission to use the trade
    +      names, trademarks, service marks, or product names of the Licensor,
    +      except as required for reasonable and customary use in describing the
    +      origin of the Work and reproducing the content of the NOTICE file.
    +
    +   7. Disclaimer of Warranty. Unless required by applicable law or
    +      agreed to in writing, Licensor provides the Work (and each
    +      Contributor provides its Contributions) on an "AS IS" BASIS,
    +      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
    +      implied, including, without limitation, any warranties or conditions
    +      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
    +      PARTICULAR PURPOSE. You are solely responsible for determining the
    +      appropriateness of using or redistributing the Work and assume any
    +      risks associated with Your exercise of permissions under this License.
    +
    +   8. Limitation of Liability. In no event and under no legal theory,
    +      whether in tort (including negligence), contract, or otherwise,
    +      unless required by applicable law (such as deliberate and grossly
    +      negligent acts) or agreed to in writing, shall any Contributor be
    +      liable to You for damages, including any direct, indirect, special,
    +      incidental, or consequential damages of any character arising as a
    +      result of this License or out of the use or inability to use the
    +      Work (including but not limited to damages for loss of goodwill,
    +      work stoppage, computer failure or malfunction, or any and all
    +      other commercial damages or losses), even if such Contributor
    +      has been advised of the possibility of such damages.
    +
    +   9. Accepting Warranty or Additional Liability. While redistributing
    +      the Work or Derivative Works thereof, You may choose to offer,
    +      and charge a fee for, acceptance of support, warranty, indemnity,
    +      or other liability obligations and/or rights consistent with this
    +      License. However, in accepting such obligations, You may act only
    +      on Your own behalf and on Your sole responsibility, not on behalf
    +      of any other Contributor, and only if You agree to indemnify,
    +      defend, and hold each Contributor harmless for any liability
    +      incurred by, or claims asserted against, such Contributor by reason
    +      of your accepting any such warranty or additional liability.
    +
    +   END OF TERMS AND CONDITIONS
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE.BSD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE.BSD
    new file mode 100644
    index 000000000..42ce7b75c
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/LICENSE.BSD
    @@ -0,0 +1,23 @@
    +Copyright (c) Donald Stufft and individual contributors.
    +All rights reserved.
    +
    +Redistribution and use in source and binary forms, with or without
    +modification, are permitted provided that the following conditions are met:
    +
    +    1. Redistributions of source code must retain the above copyright notice,
    +       this list of conditions and the following disclaimer.
    +
    +    2. Redistributions in binary form must reproduce the above copyright
    +       notice, this list of conditions and the following disclaimer in the
    +       documentation and/or other materials provided with the distribution.
    +
    +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
    +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
    +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
    +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
    +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
    +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
    +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
    +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
    +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
    +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__init__.py
    new file mode 100644
    index 000000000..e69de29bb
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/__init__.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..a97dc5edb8e3a799f10528ad738127db32d08971
    GIT binary patch
    literal 246
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/_parser.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/_parser.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..20e1eb60e51b3476b083826f839e615839a8fd43
    GIT binary patch
    literal 14117
    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
    ASpWb4
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/_tokenizer.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/_tokenizer.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..6abf6ff5edbb4dab0fa474377ce8f1e59d3cea3c
    GIT binary patch
    literal 7990
    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
    K89~T6;r{?X!y?N7
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/requirements.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/requirements.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..3fca3ed6e3d746850c8a6e2e5abb60238d8f13c5
    GIT binary patch
    literal 4507
    zcmaJ_T}&I<6}~fL8~*{efv`!o$?#Wj>fr1`chgN^y9uOavtdzCBh_s+op^>|$DSc~
    z#sLGV(kQBuC{myg1+;D}3&`=bm$a&i&50cldj4t(QRg+h4@-jE|6iVZ$!YBD3`yU>1l(Bql}DOpHmh
    zF*eP`xU?hYV2H#@T*{et#cE96k#eU!F^|bRQ{J>M=1coyezWaL)u!uWbtYevs!s=E
    z0fw;TM?`X8Cz3}FKH{u7V3wz#2zQ^HyGysAg_40t~wrlQ>?
    zE|oYRoyh9rs?yW_+Urp*q05IS#P~(=0$6LZo|({9HKj#`%d#S=G&(sh%c-ckonPh@F5tj{EMz-ToI%ERpTnulcfTu8w7EBkp(r{Ds>0i0_>*LVQ3u0?n)6CdXR2Y7hUvH=+}NBhay
    z_aeNgNW2MLt(!k9CNx>&Uj`blDzKjOqLj)W9s|6~h@w)An1fjhu&`u=DtZO0$8b?N
    zN~#RUi{S}=Bg6$i4t`rXfd2yV5Zw*~GRr(F@>kedHt9z7on@8?4qE~mW@572Rz1aN
    zEF=#Cn)cxmz1G$N8$`ygV%c0E_UvGb&@qc1v^lU1*?hUKu<_VZbN15Oz^>8mDc8R~
    zsW;oL+!VHJ&jgSCX+?iA(Gmg9CIJ4uq${Whi802zbL~
    z0h0Pb&G3{^Yq-*8(xtd_0}_!UPYMEsYluMVvidYgV-8JDjZq9t!)4Ab8H}tUR4`jo
    z^d+Xcgp$w&VY;y*_PT9p3+QNn0&_?8d2ro9yH7?O)n|!*ScQ
    z-rDux(EUSCT63~5c)Pcdsa_9>m69@9msbMf~0P}
    zD}o*CzTlm{n|(Q7`vwfzz102Dp8UQeHwJE>-e`O4(>Ffv`>ZeDHgsd)&gq+{|KaBg
    zPU7$Q=0%VMS~dv-iwd=WIQlU7hjaN*WVI#d@A+SW1M#+oSi0sr$&$yc=VS->*w=KD
    z=N|J;;ORl=+Yy3zylwE?`Xz+hX~IAl&N9Da78nM?CJ7z83ynxj5`%VEDFdatoedSc
    zzQRfn*dGvyyUUg4!-TM_&}O|9OfYg44SU4WD5cOS4@Fxf2Uu6>`GDMIOO^<^U4=r<
    z|JMGHas-fROkUDJd$=GVUBhpkEdt^FcphBs9H}CO~X?uLEI<6O-eEPbZxqM2g=JGN5Ddx
    z2l5~C%~i5q7rNzr?yJ9Z?AEdMgRS?bmZm;(J=8y$S((Xq9m^j)p7X!D-q@7e^W9ui
    z=kldoDE!19M*aR<{TrdCIcY(eSMs5bC;kqU9=&yRy>ZW+zA!aEHJ6-=KJmA#*Eigm
    zxiz!CXYX%4_C%)2%>2w;Iu~ls``Zf~@i+fh!-KwdB66aeiI*+~5FuW1pIhgEz$=qU
    zR`!An3!Fz4go3nmVOV-dZS>gnC<(K}2D%!ZLwk^*zgHO3_Zm)D%p#D3Ab&v;Y1rXj
    zOLzkGG#&`}wLW-f^5*26{;aukt-14|;}g${C*S;fzP=~t?lGSuJNAfcH}{CS8TU9#
    zAWqo39ITBSo~}DyFZG}jsKr+BT!s>@pnVqBd@L1R}3a8(jSAN)(_+=*{E-L
    z9%x*so3DEo=v)hQ7C5f9?s>53S+Hd-*z&ZsXLaDuLw_8~xAy0QZ-3>4&MnRv@D_;E
    z<2Ai$I8}XIraO`^!qIf<&jD3CoXV8%Vf%wdbLpsWmQkXY90^XX@;b5|RH4Uwo8HAP
    zLZ%oB(FEgFIfPlJnzU&3zG+n@1%g!-Y0;|Jv?{$n?7czwGSyyYMXSB06&~)c0#;R|
    zXk~-MV|Wu@Fh}wv`fqal3ljb(>HUJV!`}-R$G8{wy&zD1?LWmZ-c5qk-0lAXjJ?JK
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/specifiers.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/specifiers.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..1ac7715a1aca557adfc5cd87b9b30cd733e939d7
    GIT binary patch
    literal 39602
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/tags.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/tags.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..e450d552cdba04edc4a38b3b285c9c37af42a1ce
    GIT binary patch
    literal 21814
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/version.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/__pycache__/version.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..810bbc161d213ece16487bd83a861100e594efca
    GIT binary patch
    literal 20050
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_elffile.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_elffile.py
    new file mode 100644
    index 000000000..6fb19b30b
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_elffile.py
    @@ -0,0 +1,108 @@
    +"""
    +ELF file parser.
    +
    +This provides a class ``ELFFile`` that parses an ELF executable in a similar
    +interface to ``ZipFile``. Only the read interface is implemented.
    +
    +Based on: https://gist.github.com/lyssdod/f51579ae8d93c8657a5564aefc2ffbca
    +ELF header: https://refspecs.linuxfoundation.org/elf/gabi4+/ch4.eheader.html
    +"""
    +
    +import enum
    +import os
    +import struct
    +from typing import IO, Optional, Tuple
    +
    +
    +class ELFInvalid(ValueError):
    +    pass
    +
    +
    +class EIClass(enum.IntEnum):
    +    C32 = 1
    +    C64 = 2
    +
    +
    +class EIData(enum.IntEnum):
    +    Lsb = 1
    +    Msb = 2
    +
    +
    +class EMachine(enum.IntEnum):
    +    I386 = 3
    +    S390 = 22
    +    Arm = 40
    +    X8664 = 62
    +    AArc64 = 183
    +
    +
    +class ELFFile:
    +    """
    +    Representation of an ELF executable.
    +    """
    +
    +    def __init__(self, f: IO[bytes]) -> None:
    +        self._f = f
    +
    +        try:
    +            ident = self._read("16B")
    +        except struct.error:
    +            raise ELFInvalid("unable to parse identification")
    +        magic = bytes(ident[:4])
    +        if magic != b"\x7fELF":
    +            raise ELFInvalid(f"invalid magic: {magic!r}")
    +
    +        self.capacity = ident[4]  # Format for program header (bitness).
    +        self.encoding = ident[5]  # Data structure encoding (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:
    +            raise ELFInvalid(
    +                f"unrecognized capacity ({self.capacity}) or "
    +                f"encoding ({self.encoding})"
    +            )
    +
    +        try:
    +            (
    +                _,
    +                self.machine,  # Architecture type.
    +                _,
    +                _,
    +                self._e_phoff,  # Offset of program header.
    +                _,
    +                self.flags,  # Processor-specific flags.
    +                _,
    +                self._e_phentsize,  # Size of section.
    +                self._e_phnum,  # Number of sections.
    +            ) = self._read(e_fmt)
    +        except struct.error as e:
    +            raise ELFInvalid("unable to parse machine and section information") from e
    +
    +    def _read(self, fmt: str) -> Tuple[int, ...]:
    +        return struct.unpack(fmt, self._f.read(struct.calcsize(fmt)))
    +
    +    @property
    +    def interpreter(self) -> Optional[str]:
    +        """
    +        The path recorded in the ``PT_INTERP`` section header.
    +        """
    +        for index in range(self._e_phnum):
    +            self._f.seek(self._e_phoff + self._e_phentsize * index)
    +            try:
    +                data = self._read(self._p_fmt)
    +            except struct.error:
    +                continue
    +            if data[self._p_idx[0]] != 3:  # Not PT_INTERP.
    +                continue
    +            self._f.seek(data[self._p_idx[1]])
    +            return os.fsdecode(self._f.read(data[self._p_idx[2]])).strip("\0")
    +        return None
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_manylinux.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_manylinux.py
    new file mode 100644
    index 000000000..1f5f4ab3e
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_manylinux.py
    @@ -0,0 +1,260 @@
    +import collections
    +import contextlib
    +import functools
    +import os
    +import re
    +import sys
    +import warnings
    +from typing import Dict, Generator, Iterator, NamedTuple, Optional, Sequence, Tuple
    +
    +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[Optional[ELFFile], 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() -> 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/fcf1d003bf4f0100c/Lib/platform.py#L175-L183
    +    try:
    +        # Should be a string like "glibc 2.17".
    +        version_string: Optional[str] = os.confstr("CS_GNU_LIBC_VERSION")
    +        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() -> 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 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() -> Optional[str]:
    +    """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,
    +        )
    +        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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_musllinux.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_musllinux.py
    new file mode 100644
    index 000000000..eb4251b5c
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_musllinux.py
    @@ -0,0 +1,83 @@
    +"""PEP 656 support.
    +
    +This module implements logic to detect if the currently running Python is
    +linked against musl, and what musl version is used.
    +"""
    +
    +import functools
    +import re
    +import subprocess
    +import sys
    +from typing import Iterator, NamedTuple, Optional, Sequence
    +
    +from ._elffile import ELFFile
    +
    +
    +class _MuslVersion(NamedTuple):
    +    major: int
    +    minor: int
    +
    +
    +def _parse_musl_version(output: str) -> Optional[_MuslVersion]:
    +    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) -> Optional[_MuslVersion]:
    +    """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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_parser.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_parser.py
    new file mode 100644
    index 000000000..513686a21
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_parser.py
    @@ -0,0 +1,356 @@
    +"""Handwritten parser of dependency specifiers.
    +
    +The docstring for each __parse_* function contains EBNF-inspired grammar representing
    +the implementation.
    +"""
    +
    +import ast
    +from typing import Any, List, NamedTuple, Optional, Tuple, Union
    +
    +from ._tokenizer import DEFAULT_RULES, Tokenizer
    +
    +
    +class Node:
    +    def __init__(self, value: str) -> None:
    +        self.value = value
    +
    +    def __str__(self) -> str:
    +        return self.value
    +
    +    def __repr__(self) -> str:
    +        return f"<{self.__class__.__name__}('{self}')>"
    +
    +    def serialize(self) -> str:
    +        raise NotImplementedError
    +
    +
    +class Variable(Node):
    +    def serialize(self) -> str:
    +        return str(self)
    +
    +
    +class Value(Node):
    +    def serialize(self) -> str:
    +        return f'"{self}"'
    +
    +
    +class Op(Node):
    +    def serialize(self) -> str:
    +        return str(self)
    +
    +
    +MarkerVar = Union[Variable, Value]
    +MarkerItem = Tuple[MarkerVar, Op, MarkerVar]
    +# MarkerAtom = Union[MarkerItem, List["MarkerAtom"]]
    +# MarkerList = List[Union["MarkerList", MarkerAtom, str]]
    +# mypy does not support recursive type definition
    +# https://github.com/python/mypy/issues/731
    +MarkerAtom = Any
    +MarkerList = List[Any]
    +
    +
    +class ParsedRequirement(NamedTuple):
    +    name: str
    +    url: str
    +    extras: List[str]
    +    specifier: str
    +    marker: Optional[MarkerList]
    +
    +
    +# --------------------------------------------------------------------------------------
    +# Recursive descent parser for dependency specifier
    +# --------------------------------------------------------------------------------------
    +def parse_requirement(source: str) -> ParsedRequirement:
    +    return _parse_requirement(Tokenizer(source, rules=DEFAULT_RULES))
    +
    +
    +def _parse_requirement(tokenizer: Tokenizer) -> ParsedRequirement:
    +    """
    +    requirement = WS? IDENTIFIER WS? extras WS? requirement_details
    +    """
    +    tokenizer.consume("WS")
    +
    +    name_token = tokenizer.expect(
    +        "IDENTIFIER", expected="package name at the start of dependency specifier"
    +    )
    +    name = name_token.text
    +    tokenizer.consume("WS")
    +
    +    extras = _parse_extras(tokenizer)
    +    tokenizer.consume("WS")
    +
    +    url, specifier, marker = _parse_requirement_details(tokenizer)
    +    tokenizer.expect("END", expected="end of dependency specifier")
    +
    +    return ParsedRequirement(name, url, extras, specifier, marker)
    +
    +
    +def _parse_requirement_details(
    +    tokenizer: Tokenizer,
    +) -> Tuple[str, str, Optional[MarkerList]]:
    +    """
    +    requirement_details = AT URL (WS requirement_marker?)?
    +                        | specifier WS? (requirement_marker)?
    +    """
    +
    +    specifier = ""
    +    url = ""
    +    marker = None
    +
    +    if tokenizer.check("AT"):
    +        tokenizer.read()
    +        tokenizer.consume("WS")
    +
    +        url_start = tokenizer.position
    +        url = tokenizer.expect("URL", expected="URL after @").text
    +        if tokenizer.check("END", peek=True):
    +            return (url, specifier, marker)
    +
    +        tokenizer.expect("WS", expected="whitespace after URL")
    +
    +        # 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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_structures.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_structures.py
    new file mode 100644
    index 000000000..90a6465f9
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_tokenizer.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_tokenizer.py
    new file mode 100644
    index 000000000..dd0d648d4
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/_tokenizer.py
    @@ -0,0 +1,192 @@
    +import contextlib
    +import re
    +from dataclasses import dataclass
    +from typing import Dict, Iterator, NoReturn, Optional, Tuple, Union
    +
    +from .specifiers import Specifier
    +
    +
    +@dataclass
    +class Token:
    +    name: str
    +    text: str
    +    position: int
    +
    +
    +class ParserSyntaxError(Exception):
    +    """The provided source text could not be parsed correctly."""
    +
    +    def __init__(
    +        self,
    +        message: str,
    +        *,
    +        source: str,
    +        span: Tuple[int, int],
    +    ) -> None:
    +        self.span = span
    +        self.message = message
    +        self.source = source
    +
    +        super().__init__()
    +
    +    def __str__(self) -> str:
    +        marker = " " * self.span[0] + "~" * (self.span[1] - self.span[0]) + "^"
    +        return "\n    ".join([self.message, self.source, marker])
    +
    +
    +DEFAULT_RULES: "Dict[str, Union[str, re.Pattern[str]]]" = {
    +    "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, Union[str, re.Pattern[str]]]",
    +    ) -> None:
    +        self.source = source
    +        self.rules: Dict[str, re.Pattern[str]] = {
    +            name: re.compile(pattern) for name, pattern in rules.items()
    +        }
    +        self.next_token: Optional[Token] = None
    +        self.position = 0
    +
    +    def consume(self, name: str) -> None:
    +        """Move beyond provided token name, if at current position."""
    +        if self.check(name):
    +            self.read()
    +
    +    def check(self, name: str, *, peek: bool = False) -> bool:
    +        """Check whether the next token has the provided name.
    +
    +        By default, if the check succeeds, the token *must* be read before
    +        another check. If `peek` is set to `True`, the token is not loaded and
    +        would need to be checked again.
    +        """
    +        assert (
    +            self.next_token is None
    +        ), f"Cannot check for {name!r}, already have {self.next_token!r}"
    +        assert name in self.rules, f"Unknown token name: {name!r}"
    +
    +        expression = self.rules[name]
    +
    +        match = expression.match(self.source, self.position)
    +        if match is None:
    +            return False
    +        if not peek:
    +            self.next_token = Token(name, match[0], self.position)
    +        return True
    +
    +    def expect(self, name: str, *, expected: str) -> Token:
    +        """Expect a certain token name next, failing with a syntax error otherwise.
    +
    +        The token is *not* read.
    +        """
    +        if not self.check(name):
    +            raise self.raise_syntax_error(f"Expected {expected}")
    +        return self.read()
    +
    +    def read(self) -> Token:
    +        """Consume the next token and return it."""
    +        token = self.next_token
    +        assert token is not None
    +
    +        self.position += len(token.text)
    +        self.next_token = None
    +
    +        return token
    +
    +    def raise_syntax_error(
    +        self,
    +        message: str,
    +        *,
    +        span_start: Optional[int] = None,
    +        span_end: Optional[int] = None,
    +    ) -> NoReturn:
    +        """Raise ParserSyntaxError at the given position."""
    +        span = (
    +            self.position if span_start is None else span_start,
    +            self.position if span_end is None else span_end,
    +        )
    +        raise ParserSyntaxError(
    +            message,
    +            source=self.source,
    +            span=span,
    +        )
    +
    +    @contextlib.contextmanager
    +    def enclosing_tokens(
    +        self, open_token: str, close_token: str, *, 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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/markers.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/markers.py
    new file mode 100644
    index 000000000..c96d22a5a
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/markers.py
    @@ -0,0 +1,253 @@
    +# 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.
    +
    +import operator
    +import os
    +import platform
    +import sys
    +from typing import Any, Callable, Dict, List, Optional, Tuple, Union
    +
    +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",
    +    "UndefinedComparison",
    +    "UndefinedEnvironmentName",
    +    "Marker",
    +    "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.
    +    """
    +
    +
    +def _normalize_extra_values(results: Any) -> Any:
    +    """
    +    Normalize extra values.
    +    """
    +    if isinstance(results[0], tuple):
    +        lhs, op, rhs = results[0]
    +        if isinstance(lhs, Variable) and lhs.value == "extra":
    +            normalized_extra = canonicalize_name(rhs.value)
    +            rhs = Value(normalized_extra)
    +        elif isinstance(rhs, Variable) and rhs.value == "extra":
    +            normalized_extra = canonicalize_name(lhs.value)
    +            lhs = Value(normalized_extra)
    +        results[0] = lhs, op, rhs
    +    return results
    +
    +
    +def _format_marker(
    +    marker: Union[List[str], MarkerAtom, str], first: Optional[bool] = 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: Optional[Operator] = _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 = "{0.major}.{0.minor}.{0.micro}".format(info)
    +    kind = info.releaselevel
    +    if kind != "final":
    +        version += kind[0] + str(info.serial)
    +    return version
    +
    +
    +def default_environment() -> Dict[str, str]:
    +    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: Optional[Dict[str, str]] = 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 = 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, current_environment)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/requirements.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/requirements.py
    new file mode 100644
    index 000000000..bdc43a7e9
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/requirements.py
    @@ -0,0 +1,90 @@
    +# 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 typing import Any, Iterator, Optional, Set
    +
    +from ._parser import parse_requirement as _parse_requirement
    +from ._tokenizer import ParserSyntaxError
    +from .markers import Marker, _normalize_extra_values
    +from .specifiers import SpecifierSet
    +from .utils import canonicalize_name
    +
    +
    +class InvalidRequirement(ValueError):
    +    """
    +    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: Optional[str] = parsed.url or None
    +        self.extras: Set[str] = set(parsed.extras or [])
    +        self.specifier: SpecifierSet = SpecifierSet(parsed.specifier)
    +        self.marker: Optional[Marker] = None
    +        if parsed.marker is not None:
    +            self.marker = Marker.__new__(Marker)
    +            self.marker._markers = _normalize_extra_values(parsed.marker)
    +
    +    def _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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/specifiers.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/specifiers.py
    new file mode 100644
    index 000000000..6d4066ae2
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/specifiers.py
    @@ -0,0 +1,1011 @@
    +# This file is dual licensed under the terms of the Apache License, Version
    +# 2.0, and the BSD License. See the LICENSE file in the root of this repository
    +# for complete details.
    +"""
    +.. testsetup::
    +
    +    from packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier
    +    from packaging.version import Version
    +"""
    +
    +import abc
    +import itertools
    +import re
    +from typing import Callable, Iterable, Iterator, List, Optional, Tuple, TypeVar, Union
    +
    +from .utils import canonicalize_version
    +from .version import Version
    +
    +UnparsedVersion = Union[Version, str]
    +UnparsedVersionVar = TypeVar("UnparsedVersionVar", bound=UnparsedVersion)
    +CallableOperator = Callable[[Version, str], bool]
    +
    +
    +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) -> Optional[bool]:
    +        """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: Optional[bool] = None) -> bool:
    +        """
    +        Determines if the given item is contained within this specifier.
    +        """
    +
    +    @abc.abstractmethod
    +    def filter(
    +        self, iterable: Iterable[UnparsedVersionVar], prereleases: Optional[bool] = None
    +    ) -> Iterator[UnparsedVersionVar]:
    +        """
    +        Takes an iterable of items and filters them so that only items which
    +        are contained within this specifier are allowed in it.
    +        """
    +
    +
    +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: Optional[bool] = None) -> None:
    +        """Initialize a Specifier instance.
    +
    +        :param spec:
    +            The string representation of a specifier which will be parsed and
    +            normalized before use.
    +        :param prereleases:
    +            This tells the specifier if it should accept prerelease versions if
    +            applicable or not. The default of ``None`` will autodetect it from the
    +            given specifiers.
    +        :raises InvalidSpecifier:
    +            If the given specifier is invalid (i.e. bad syntax).
    +        """
    +        match = self._regex.search(spec)
    +        if not match:
    +            raise InvalidSpecifier(f"Invalid specifier: '{spec}'")
    +
    +        self._spec: Tuple[str, str] = (
    +            match.group("operator").strip(),
    +            match.group("version").strip(),
    +        )
    +
    +        # Store whether or not this Specifier should accept prereleases
    +        self._prereleases = prereleases
    +
    +    # 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: Union[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: Optional[bool] = 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: Optional[bool] = 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 = "", prereleases: Optional[bool] = 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.
    +        :param prereleases:
    +            This tells the SpecifierSet if it should accept prerelease versions if
    +            applicable or not. The default of ``None`` will autodetect it from the
    +            given specifiers.
    +
    +        :raises InvalidSpecifier:
    +            If the given ``specifiers`` are not parseable than this exception will be
    +            raised.
    +        """
    +
    +        # Split on `,` to break each individual specifier into it's own item, and
    +        # strip each item to remove leading/trailing whitespace.
    +        split_specifiers = [s.strip() for s in specifiers.split(",") if s.strip()]
    +
    +        # Make each individual specifier a Specifier and save in a frozen set for later.
    +        self._specs = frozenset(map(Specifier, split_specifiers))
    +
    +        # Store our prereleases value so we can use it later to determine if
    +        # we accept prereleases or not.
    +        self._prereleases = prereleases
    +
    +    @property
    +    def prereleases(self) -> Optional[bool]:
    +        # If we have been given an explicit prerelease modifier, then we'll
    +        # pass that through here.
    +        if self._prereleases is not None:
    +            return self._prereleases
    +
    +        # If we don't have any specifiers, and we don't have a forced value,
    +        # then we'll just return None since we don't know if this should have
    +        # pre-releases or not.
    +        if not self._specs:
    +            return None
    +
    +        # Otherwise we'll see if any of the given specifiers accept
    +        # prereleases, if any of them do we'll return True, otherwise False.
    +        return any(s.prereleases for s in self._specs)
    +
    +    @prereleases.setter
    +    def prereleases(self, value: bool) -> None:
    +        self._prereleases = value
    +
    +    def __repr__(self) -> str:
    +        """A representation of the specifier set that shows all internal state.
    +
    +        Note that the ordering of the individual specifiers within the set may not
    +        match the input string.
    +
    +        >>> SpecifierSet('>=1.0.0,!=2.0.0')
    +        =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: Union["SpecifierSet", str]) -> "SpecifierSet":
    +        """Return a SpecifierSet which is a combination of the two sets.
    +
    +        :param other: The other object to combine with.
    +
    +        >>> SpecifierSet(">=1.0.0,!=1.0.1") & '<=2.0.0,!=2.0.1'
    +        =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: Optional[bool] = None,
    +        installed: Optional[bool] = 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: Optional[bool] = 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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/tags.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/tags.py
    new file mode 100644
    index 000000000..89f192613
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/tags.py
    @@ -0,0 +1,571 @@
    +# 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.
    +
    +import logging
    +import platform
    +import re
    +import struct
    +import subprocess
    +import sys
    +import sysconfig
    +from importlib.machinery import EXTENSION_SUFFIXES
    +from typing import (
    +    Dict,
    +    FrozenSet,
    +    Iterable,
    +    Iterator,
    +    List,
    +    Optional,
    +    Sequence,
    +    Tuple,
    +    Union,
    +    cast,
    +)
    +
    +from . import _manylinux, _musllinux
    +
    +logger = logging.getLogger(__name__)
    +
    +PythonVersion = Sequence[int]
    +MacVersion = 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__ = ["_interpreter", "_abi", "_platform", "_hash"]
    +
    +    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) -> Union[int, str, None]:
    +    value: Union[int, str, None] = sysconfig.get_config_var(name)
    +    if value is None and warn:
    +        logger.debug(
    +            "Config variable '%s' is unset, Python ABI tag may be incorrect", name
    +        )
    +    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: Optional[PythonVersion] = None,
    +    abis: Optional[Iterable[str]] = None,
    +    platforms: Optional[Iterable[str]] = 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:
    +                interpreter = "cp{version}".format(
    +                    version=_version_nodot((python_version[0], minor_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: Optional[str] = None,
    +    abis: Optional[Iterable[str]] = None,
    +    platforms: Optional[Iterable[str]] = 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: Optional[PythonVersion] = None,
    +    interpreter: Optional[str] = None,
    +    platforms: Optional[Iterable[str]] = 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: MacVersion, 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: Optional[MacVersion] = None, arch: Optional[str] = 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("MacVersion", tuple(map(int, version_str.split(".")[:2])))
    +        if version == (10, 16):
    +            # When built against an older macOS SDK, Python will report macOS 10.16
    +            # instead of the real version.
    +            version_str = subprocess.run(
    +                [
    +                    sys.executable,
    +                    "-sS",
    +                    "-c",
    +                    "import platform; print(platform.mac_ver()[0])",
    +                ],
    +                check=True,
    +                env={"SYSTEM_VERSION_COMPAT": "0"},
    +                stdout=subprocess.PIPE,
    +                text=True,
    +            ).stdout
    +            version = cast("MacVersion", 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.
    +        for minor_version in range(version[1], -1, -1):
    +            compat_version = 10, minor_version
    +            binary_formats = _mac_binary_formats(compat_version, arch)
    +            for binary_format in binary_formats:
    +                yield "macosx_{major}_{minor}_{binary_format}".format(
    +                    major=10, minor=minor_version, binary_format=binary_format
    +                )
    +
    +    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.
    +        for major_version in range(version[0], 10, -1):
    +            compat_version = major_version, 0
    +            binary_formats = _mac_binary_formats(compat_version, arch)
    +            for binary_format in binary_formats:
    +                yield "macosx_{major}_{minor}_{binary_format}".format(
    +                    major=major_version, minor=0, binary_format=binary_format
    +                )
    +
    +    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.
    +        if arch == "x86_64":
    +            for minor_version in range(16, 3, -1):
    +                compat_version = 10, minor_version
    +                binary_formats = _mac_binary_formats(compat_version, arch)
    +                for binary_format in binary_formats:
    +                    yield "macosx_{major}_{minor}_{binary_format}".format(
    +                        major=compat_version[0],
    +                        minor=compat_version[1],
    +                        binary_format=binary_format,
    +                    )
    +        else:
    +            for minor_version in range(16, 3, -1):
    +                compat_version = 10, minor_version
    +                binary_format = "universal2"
    +                yield "macosx_{major}_{minor}_{binary_format}".format(
    +                    major=compat_version[0],
    +                    minor=compat_version[1],
    +                    binary_format=binary_format,
    +                )
    +
    +
    +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() == "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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/utils.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/utils.py
    new file mode 100644
    index 000000000..c2c2f75aa
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/utils.py
    @@ -0,0 +1,172 @@
    +# 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.
    +
    +import re
    +from typing import FrozenSet, NewType, Tuple, Union, cast
    +
    +from .tags import Tag, parse_tag
    +from .version import InvalidVersion, Version
    +
    +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
    +
    +
    +def canonicalize_version(
    +    version: Union[Version, str], *, strip_trailing_zero: bool = True
    +) -> str:
    +    """
    +    This is very similar to Version.__str__, but has one subtle difference
    +    with the way it handles the release segment.
    +    """
    +    if isinstance(version, str):
    +        try:
    +            parsed = Version(version)
    +        except InvalidVersion:
    +            # Legacy versions cannot be normalized
    +            return version
    +    else:
    +        parsed = version
    +
    +    parts = []
    +
    +    # Epoch
    +    if parsed.epoch != 0:
    +        parts.append(f"{parsed.epoch}!")
    +
    +    # Release segment
    +    release_segment = ".".join(str(x) for x in parsed.release)
    +    if strip_trailing_zero:
    +        # NB: This strips trailing '.0's to normalize
    +        release_segment = re.sub(r"(\.0)+$", "", release_segment)
    +    parts.append(release_segment)
    +
    +    # Pre-release
    +    if parsed.pre is not None:
    +        parts.append("".join(str(x) for x in parsed.pre))
    +
    +    # Post-release
    +    if parsed.post is not None:
    +        parts.append(f".post{parsed.post}")
    +
    +    # Development release
    +    if parsed.dev is not None:
    +        parts.append(f".dev{parsed.dev}")
    +
    +    # Local version segment
    +    if parsed.local is not None:
    +        parts.append(f"+{parsed.local}")
    +
    +    return "".join(parts)
    +
    +
    +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}"
    +        )
    +
    +    filename = filename[:-4]
    +    dashes = filename.count("-")
    +    if dashes not in (4, 5):
    +        raise InvalidWheelFilename(
    +            f"Invalid wheel filename (wrong number of parts): {filename}"
    +        )
    +
    +    parts = filename.split("-", dashes - 2)
    +    name_part = parts[0]
    +    # See PEP 427 for the rules on escaping the project name.
    +    if "__" in name_part or re.match(r"^[\w\d._]*$", name_part, re.UNICODE) is None:
    +        raise InvalidWheelFilename(f"Invalid project name: {filename}")
    +    name = canonicalize_name(name_part)
    +
    +    try:
    +        version = Version(parts[1])
    +    except InvalidVersion as e:
    +        raise InvalidWheelFilename(
    +            f"Invalid wheel filename (invalid version): {filename}"
    +        ) from e
    +
    +    if dashes == 5:
    +        build_part = parts[2]
    +        build_match = _build_tag_regex.match(build_part)
    +        if build_match is None:
    +            raise InvalidWheelFilename(
    +                f"Invalid build number: {build_part} in '{filename}'"
    +            )
    +        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}"
    +        )
    +
    +    # 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}")
    +
    +    name = canonicalize_name(name_part)
    +
    +    try:
    +        version = Version(version_part)
    +    except InvalidVersion as e:
    +        raise InvalidSdistFilename(
    +            f"Invalid sdist filename (invalid version): {filename}"
    +        ) from e
    +
    +    return (name, version)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/version.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/version.py
    new file mode 100644
    index 000000000..cda8e9993
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/packaging/version.py
    @@ -0,0 +1,561 @@
    +# This file is dual licensed under the terms of the Apache License, Version
    +# 2.0, and the BSD License. See the LICENSE file in the root of this repository
    +# for complete details.
    +"""
    +.. testsetup::
    +
    +    from packaging.version import parse, Version
    +"""
    +
    +import itertools
    +import re
    +from typing import Any, Callable, NamedTuple, Optional, SupportsInt, Tuple, Union
    +
    +from ._structures import Infinity, InfinityType, NegativeInfinity, NegativeInfinityType
    +
    +__all__ = ["VERSION_PATTERN", "parse", "Version", "InvalidVersion"]
    +
    +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: Optional[Tuple[str, int]]
    +    pre: Optional[Tuple[str, int]]
    +    post: Optional[Tuple[str, int]]
    +    local: Optional[LocalType]
    +
    +
    +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}'")
    +
    +        # 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 rounded-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) -> Optional[Tuple[str, int]]:
    +        """The pre-release segment of the version.
    +
    +        >>> print(Version("1.2.3").pre)
    +        None
    +        >>> Version("1.2.3a1").pre
    +        ('a', 1)
    +        >>> Version("1.2.3b1").pre
    +        ('b', 1)
    +        >>> Version("1.2.3rc1").pre
    +        ('rc', 1)
    +        """
    +        return self._version.pre
    +
    +    @property
    +    def post(self) -> Optional[int]:
    +        """The post-release number of the version.
    +
    +        >>> print(Version("1.2.3").post)
    +        None
    +        >>> Version("1.2.3.post1").post
    +        1
    +        """
    +        return self._version.post[1] if self._version.post else None
    +
    +    @property
    +    def dev(self) -> Optional[int]:
    +        """The development number of the version.
    +
    +        >>> print(Version("1.2.3").dev)
    +        None
    +        >>> Version("1.2.3.dev1").dev
    +        1
    +        """
    +        return self._version.dev[1] if self._version.dev else None
    +
    +    @property
    +    def local(self) -> Optional[str]:
    +        """The local version segment of the version.
    +
    +        >>> print(Version("1.2.3").local)
    +        None
    +        >>> Version("1.2.3+abc").local
    +        'abc'
    +        """
    +        if self._version.local:
    +            return ".".join(str(x) for x in self._version.local)
    +        else:
    +            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.2.3+abc.dev1").public
    +        '1.2.3'
    +        """
    +        return str(self).split("+", 1)[0]
    +
    +    @property
    +    def base_version(self) -> str:
    +        """The "base version" of the version.
    +
    +        >>> Version("1.2.3").base_version
    +        '1.2.3'
    +        >>> Version("1.2.3+abc").base_version
    +        '1.2.3'
    +        >>> Version("1!1.2.3+abc.dev1").base_version
    +        '1!1.2.3'
    +
    +        The "base version" is the public version of the project without any pre or post
    +        release markers.
    +        """
    +        parts = []
    +
    +        # Epoch
    +        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
    +
    +
    +def _parse_letter_version(
    +    letter: Optional[str], number: Union[str, bytes, SupportsInt, None]
    +) -> Optional[Tuple[str, int]]:
    +    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)
    +    if not letter and 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: Optional[str]) -> Optional[LocalType]:
    +    """
    +    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: Optional[Tuple[str, int]],
    +    post: Optional[Tuple[str, int]],
    +    dev: Optional[Tuple[str, int]],
    +    local: Optional[LocalType],
    +) -> 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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/vendor.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/vendor.txt
    new file mode 100644
    index 000000000..14666103a
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/vendored/vendor.txt
    @@ -0,0 +1 @@
    +packaging==24.0
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/wheelfile.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/wheelfile.py
    new file mode 100644
    index 000000000..0a0f4596c
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/wheel/wheelfile.py
    @@ -0,0 +1,227 @@
    +from __future__ import annotations
    +
    +import csv
    +import hashlib
    +import os.path
    +import re
    +import stat
    +import time
    +from io import StringIO, TextIOWrapper
    +from typing import IO, TYPE_CHECKING, Literal
    +from zipfile import ZIP_DEFLATED, ZipFile, ZipInfo
    +
    +from wheel.cli import WheelError
    +from wheel.util import log, urlsafe_b64decode, urlsafe_b64encode
    +
    +if TYPE_CHECKING:
    +    from typing import Protocol, Sized, Union
    +
    +    from typing_extensions import Buffer
    +
    +    StrPath = Union[str, os.PathLike[str]]
    +
    +    class SizedBuffer(Sized, Buffer, Protocol): ...
    +
    +
    +# Non-greedy matching of an optional build number may be too clever (more
    +# invalid wheel filenames will match). Separate regex for .dist-info?
    +WHEEL_INFO_RE = re.compile(
    +    r"""^(?P(?P[^\s-]+?)-(?P[^\s-]+?))(-(?P\d[^\s-]*))?
    +     -(?P[^\s-]+?)-(?P[^\s-]+?)-(?P\S+)\.whl$""",
    +    re.VERBOSE,
    +)
    +MINIMUM_TIMESTAMP = 315532800  # 1980-01-01 00:00:00 UTC
    +
    +
    +def get_zipinfo_datetime(timestamp: float | None = None):
    +    # Some applications need reproducible .whl files, but they can't do this without
    +    # forcing the timestamp of the individual ZipInfo objects. See issue #143.
    +    timestamp = int(os.environ.get("SOURCE_DATE_EPOCH", timestamp or time.time()))
    +    timestamp = max(timestamp, MINIMUM_TIMESTAMP)
    +    return time.gmtime(timestamp)[0:6]
    +
    +
    +class WheelFile(ZipFile):
    +    """A ZipFile derivative class that also reads SHA-256 hashes from
    +    .dist-info/RECORD and checks any read files against those.
    +    """
    +
    +    _default_algorithm = hashlib.sha256
    +
    +    def __init__(
    +        self,
    +        file: StrPath,
    +        mode: Literal["r", "w", "x", "a"] = "r",
    +        compression: int = ZIP_DEFLATED,
    +    ):
    +        basename = os.path.basename(file)
    +        self.parsed_filename = WHEEL_INFO_RE.match(basename)
    +        if not basename.endswith(".whl") or self.parsed_filename is None:
    +            raise WheelError(f"Bad wheel filename {basename!r}")
    +
    +        ZipFile.__init__(self, file, mode, compression=compression, allowZip64=True)
    +
    +        self.dist_info_path = "{}.dist-info".format(
    +            self.parsed_filename.group("namever")
    +        )
    +        self.record_path = self.dist_info_path + "/RECORD"
    +        self._file_hashes: dict[str, tuple[None, None] | tuple[int, bytes]] = {}
    +        self._file_sizes = {}
    +        if mode == "r":
    +            # Ignore RECORD and any embedded wheel signatures
    +            self._file_hashes[self.record_path] = None, None
    +            self._file_hashes[self.record_path + ".jws"] = None, None
    +            self._file_hashes[self.record_path + ".p7s"] = None, None
    +
    +            # Fill in the expected hashes by reading them from RECORD
    +            try:
    +                record = self.open(self.record_path)
    +            except KeyError:
    +                raise WheelError(f"Missing {self.record_path} file") from None
    +
    +            with record:
    +                for line in csv.reader(
    +                    TextIOWrapper(record, newline="", encoding="utf-8")
    +                ):
    +                    path, hash_sum, size = line
    +                    if not hash_sum:
    +                        continue
    +
    +                    algorithm, hash_sum = hash_sum.split("=")
    +                    try:
    +                        hashlib.new(algorithm)
    +                    except ValueError:
    +                        raise WheelError(
    +                            f"Unsupported hash algorithm: {algorithm}"
    +                        ) from None
    +
    +                    if algorithm.lower() in {"md5", "sha1"}:
    +                        raise WheelError(
    +                            f"Weak hash algorithm ({algorithm}) is not permitted by "
    +                            f"PEP 427"
    +                        )
    +
    +                    self._file_hashes[path] = (
    +                        algorithm,
    +                        urlsafe_b64decode(hash_sum.encode("ascii")),
    +                    )
    +
    +    def open(
    +        self,
    +        name_or_info: str | ZipInfo,
    +        mode: Literal["r", "w"] = "r",
    +        pwd: bytes | None = None,
    +    ) -> IO[bytes]:
    +        def _update_crc(newdata: bytes) -> None:
    +            eof = ef._eof
    +            update_crc_orig(newdata)
    +            running_hash.update(newdata)
    +            if eof and running_hash.digest() != expected_hash:
    +                raise WheelError(f"Hash mismatch for file '{ef_name}'")
    +
    +        ef_name = (
    +            name_or_info.filename if isinstance(name_or_info, ZipInfo) else name_or_info
    +        )
    +        if (
    +            mode == "r"
    +            and not ef_name.endswith("/")
    +            and ef_name not in self._file_hashes
    +        ):
    +            raise WheelError(f"No hash found for file '{ef_name}'")
    +
    +        ef = ZipFile.open(self, name_or_info, mode, pwd)
    +        if mode == "r" and not ef_name.endswith("/"):
    +            algorithm, expected_hash = self._file_hashes[ef_name]
    +            if expected_hash is not None:
    +                # Monkey patch the _update_crc method to also check for the hash from
    +                # RECORD
    +                running_hash = hashlib.new(algorithm)
    +                update_crc_orig, ef._update_crc = ef._update_crc, _update_crc
    +
    +        return ef
    +
    +    def write_files(self, base_dir: str):
    +        log.info(f"creating '{self.filename}' and adding '{base_dir}' to it")
    +        deferred: list[tuple[str, str]] = []
    +        for root, dirnames, filenames in os.walk(base_dir):
    +            # Sort the directory names so that `os.walk` will walk them in a
    +            # defined order on the next iteration.
    +            dirnames.sort()
    +            for name in sorted(filenames):
    +                path = os.path.normpath(os.path.join(root, name))
    +                if os.path.isfile(path):
    +                    arcname = os.path.relpath(path, base_dir).replace(os.path.sep, "/")
    +                    if arcname == self.record_path:
    +                        pass
    +                    elif root.endswith(".dist-info"):
    +                        deferred.append((path, arcname))
    +                    else:
    +                        self.write(path, arcname)
    +
    +        deferred.sort()
    +        for path, arcname in deferred:
    +            self.write(path, arcname)
    +
    +    def write(
    +        self,
    +        filename: str,
    +        arcname: str | None = None,
    +        compress_type: int | None = None,
    +    ) -> None:
    +        with open(filename, "rb") as f:
    +            st = os.fstat(f.fileno())
    +            data = f.read()
    +
    +        zinfo = ZipInfo(
    +            arcname or filename, date_time=get_zipinfo_datetime(st.st_mtime)
    +        )
    +        zinfo.external_attr = (stat.S_IMODE(st.st_mode) | stat.S_IFMT(st.st_mode)) << 16
    +        zinfo.compress_type = compress_type or self.compression
    +        self.writestr(zinfo, data, compress_type)
    +
    +    def writestr(
    +        self,
    +        zinfo_or_arcname: str | ZipInfo,
    +        data: SizedBuffer | str,
    +        compress_type: int | None = None,
    +    ):
    +        if isinstance(zinfo_or_arcname, str):
    +            zinfo_or_arcname = ZipInfo(
    +                zinfo_or_arcname, date_time=get_zipinfo_datetime()
    +            )
    +            zinfo_or_arcname.compress_type = self.compression
    +            zinfo_or_arcname.external_attr = (0o664 | stat.S_IFREG) << 16
    +
    +        if isinstance(data, str):
    +            data = data.encode("utf-8")
    +
    +        ZipFile.writestr(self, zinfo_or_arcname, data, compress_type)
    +        fname = (
    +            zinfo_or_arcname.filename
    +            if isinstance(zinfo_or_arcname, ZipInfo)
    +            else zinfo_or_arcname
    +        )
    +        log.info(f"adding '{fname}'")
    +        if fname != self.record_path:
    +            hash_ = self._default_algorithm(data)
    +            self._file_hashes[fname] = (
    +                hash_.name,
    +                urlsafe_b64encode(hash_.digest()).decode("ascii"),
    +            )
    +            self._file_sizes[fname] = len(data)
    +
    +    def close(self):
    +        # Write RECORD
    +        if self.fp is not None and self.mode == "w" and self._file_hashes:
    +            data = StringIO()
    +            writer = csv.writer(data, delimiter=",", quotechar='"', lineterminator="\n")
    +            writer.writerows(
    +                (
    +                    (fname, algorithm + "=" + hash_, self._file_sizes[fname])
    +                    for fname, (algorithm, hash_) in self._file_hashes.items()
    +                )
    +            )
    +            writer.writerow((format(self.record_path), "", ""))
    +            self.writestr(self.record_path, data.getvalue())
    +
    +        ZipFile.close(self)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/INSTALLER
    new file mode 100644
    index 000000000..a1b589e38
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/INSTALLER
    @@ -0,0 +1 @@
    +pip
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/LICENSE
    new file mode 100644
    index 000000000..1bb5a4435
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/LICENSE
    @@ -0,0 +1,17 @@
    +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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/METADATA
    new file mode 100644
    index 000000000..139928171
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/METADATA
    @@ -0,0 +1,102 @@
    +Metadata-Version: 2.1
    +Name: zipp
    +Version: 3.19.2
    +Summary: Backport of pathlib-compatible object wrapper for zip files
    +Author-email: "Jason R. Coombs" 
    +Project-URL: Homepage, https://github.com/jaraco/zipp
    +Classifier: Development Status :: 5 - Production/Stable
    +Classifier: Intended Audience :: Developers
    +Classifier: License :: OSI Approved :: MIT License
    +Classifier: Programming Language :: Python :: 3
    +Classifier: Programming Language :: Python :: 3 :: Only
    +Requires-Python: >=3.8
    +Description-Content-Type: text/x-rst
    +License-File: LICENSE
    +Provides-Extra: doc
    +Requires-Dist: sphinx >=3.5 ; extra == 'doc'
    +Requires-Dist: jaraco.packaging >=9.3 ; extra == 'doc'
    +Requires-Dist: rst.linker >=1.9 ; extra == 'doc'
    +Requires-Dist: furo ; extra == 'doc'
    +Requires-Dist: sphinx-lint ; extra == 'doc'
    +Requires-Dist: jaraco.tidelift >=1.4 ; extra == 'doc'
    +Provides-Extra: test
    +Requires-Dist: pytest !=8.1.*,>=6 ; extra == 'test'
    +Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'test'
    +Requires-Dist: pytest-cov ; extra == 'test'
    +Requires-Dist: pytest-mypy ; extra == 'test'
    +Requires-Dist: pytest-enabler >=2.2 ; extra == 'test'
    +Requires-Dist: pytest-ruff >=0.2.1 ; extra == 'test'
    +Requires-Dist: jaraco.itertools ; extra == 'test'
    +Requires-Dist: jaraco.functools ; extra == 'test'
    +Requires-Dist: more-itertools ; extra == 'test'
    +Requires-Dist: big-O ; extra == 'test'
    +Requires-Dist: pytest-ignore-flaky ; extra == 'test'
    +Requires-Dist: jaraco.test ; extra == 'test'
    +Requires-Dist: importlib-resources ; (python_version < "3.9") and extra == 'test'
    +
    +.. image:: https://img.shields.io/pypi/v/zipp.svg
    +   :target: https://pypi.org/project/zipp
    +
    +.. image:: https://img.shields.io/pypi/pyversions/zipp.svg
    +
    +.. image:: https://github.com/jaraco/zipp/actions/workflows/main.yml/badge.svg
    +   :target: https://github.com/jaraco/zipp/actions?query=workflow%3A%22tests%22
    +   :alt: tests
    +
    +.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json
    +    :target: https://github.com/astral-sh/ruff
    +    :alt: Ruff
    +
    +.. .. image:: https://readthedocs.org/projects/PROJECT_RTD/badge/?version=latest
    +..    :target: https://PROJECT_RTD.readthedocs.io/en/latest/?badge=latest
    +
    +.. image:: https://img.shields.io/badge/skeleton-2024-informational
    +   :target: https://blog.jaraco.com/skeleton
    +
    +.. image:: https://tidelift.com/badges/package/pypi/zipp
    +   :target: https://tidelift.com/subscription/pkg/pypi-zipp?utm_source=pypi-zipp&utm_medium=readme
    +
    +
    +A pathlib-compatible Zipfile object wrapper. Official backport of the standard library
    +`Path object `_.
    +
    +
    +Compatibility
    +=============
    +
    +New features are introduced in this third-party library and later merged
    +into CPython. The following table indicates which versions of this library
    +were contributed to different versions in the standard library:
    +
    +.. list-table::
    +   :header-rows: 1
    +
    +   * - zipp
    +     - stdlib
    +   * - 3.18
    +     - 3.13
    +   * - 3.16
    +     - 3.12
    +   * - 3.5
    +     - 3.11
    +   * - 3.2
    +     - 3.10
    +   * - 3.3 ??
    +     - 3.9
    +   * - 1.0
    +     - 3.8
    +
    +
    +Usage
    +=====
    +
    +Use ``zipp.Path`` in place of ``zipfile.Path`` on any Python.
    +
    +For Enterprise
    +==============
    +
    +Available as part of the Tidelift Subscription.
    +
    +This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use.
    +
    +`Learn more `_.
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/RECORD
    new file mode 100644
    index 000000000..3419c08be
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/RECORD
    @@ -0,0 +1,15 @@
    +zipp-3.19.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4
    +zipp-3.19.2.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023
    +zipp-3.19.2.dist-info/METADATA,sha256=UIrk_kMIHGSwsKKChYizqMw0MMZpPRZ2ZiVpQAsN_bE,3575
    +zipp-3.19.2.dist-info/RECORD,,
    +zipp-3.19.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
    +zipp-3.19.2.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
    +zipp-3.19.2.dist-info/top_level.txt,sha256=iAbdoSHfaGqBfVb2XuR9JqSQHCoOsOtG6y9C_LSpqFw,5
    +zipp/__init__.py,sha256=QuI1g00G4fRAcGt-HqbV0oWIkmSgedCGGYsHHYzNa8A,13412
    +zipp/__pycache__/__init__.cpython-312.pyc,,
    +zipp/__pycache__/glob.cpython-312.pyc,,
    +zipp/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
    +zipp/compat/__pycache__/__init__.cpython-312.pyc,,
    +zipp/compat/__pycache__/py310.cpython-312.pyc,,
    +zipp/compat/py310.py,sha256=eZpkW0zRtunkhEh8jjX3gCGe22emoKCBJw72Zt4RkhA,219
    +zipp/glob.py,sha256=etWpnfEoRyfUvrUsi6sTiGmErvPwe6HzY6pT8jg_lUI,3082
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/REQUESTED b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/REQUESTED
    new file mode 100644
    index 000000000..e69de29bb
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/WHEEL
    new file mode 100644
    index 000000000..bab98d675
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/WHEEL
    @@ -0,0 +1,5 @@
    +Wheel-Version: 1.0
    +Generator: bdist_wheel (0.43.0)
    +Root-Is-Purelib: true
    +Tag: py3-none-any
    +
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/top_level.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/top_level.txt
    new file mode 100644
    index 000000000..e82f676f8
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp-3.19.2.dist-info/top_level.txt
    @@ -0,0 +1 @@
    +zipp
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/__init__.py
    new file mode 100644
    index 000000000..d65297b83
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/__init__.py
    @@ -0,0 +1,501 @@
    +import io
    +import posixpath
    +import zipfile
    +import itertools
    +import contextlib
    +import pathlib
    +import re
    +import stat
    +import sys
    +
    +from .compat.py310 import text_encoding
    +from .glob import Translator
    +
    +
    +__all__ = ['Path']
    +
    +
    +def _parents(path):
    +    """
    +    Given a path with elements separated by
    +    posixpath.sep, generate all parents of that path.
    +
    +    >>> list(_parents('b/d'))
    +    ['b']
    +    >>> list(_parents('/b/d/'))
    +    ['/b']
    +    >>> list(_parents('b/d/f/'))
    +    ['b/d', 'b']
    +    >>> list(_parents('b'))
    +    []
    +    >>> list(_parents(''))
    +    []
    +    """
    +    return itertools.islice(_ancestry(path), 1, None)
    +
    +
    +def _ancestry(path):
    +    """
    +    Given a path with elements separated by
    +    posixpath.sep, generate all elements of that path
    +
    +    >>> list(_ancestry('b/d'))
    +    ['b/d', 'b']
    +    >>> list(_ancestry('/b/d/'))
    +    ['/b/d', '/b']
    +    >>> list(_ancestry('b/d/f/'))
    +    ['b/d/f', 'b/d', 'b']
    +    >>> list(_ancestry('b'))
    +    ['b']
    +    >>> list(_ancestry(''))
    +    []
    +    """
    +    path = path.rstrip(posixpath.sep)
    +    while path and path != posixpath.sep:
    +        yield path
    +        path, tail = posixpath.split(path)
    +
    +
    +_dedupe = dict.fromkeys
    +"""Deduplicate an iterable in original order"""
    +
    +
    +def _difference(minuend, subtrahend):
    +    """
    +    Return items in minuend not in subtrahend, retaining order
    +    with O(1) lookup.
    +    """
    +    return itertools.filterfalse(set(subtrahend).__contains__, minuend)
    +
    +
    +class InitializedState:
    +    """
    +    Mix-in to save the initialization state for pickling.
    +    """
    +
    +    def __init__(self, *args, **kwargs):
    +        self.__args = args
    +        self.__kwargs = kwargs
    +        super().__init__(*args, **kwargs)
    +
    +    def __getstate__(self):
    +        return self.__args, self.__kwargs
    +
    +    def __setstate__(self, state):
    +        args, kwargs = state
    +        super().__init__(*args, **kwargs)
    +
    +
    +class SanitizedNames:
    +    """
    +    ZipFile mix-in to ensure names are sanitized.
    +    """
    +
    +    def namelist(self):
    +        return list(map(self._sanitize, super().namelist()))
    +
    +    @staticmethod
    +    def _sanitize(name):
    +        r"""
    +        Ensure a relative path with posix separators and no dot names.
    +
    +        Modeled after
    +        https://github.com/python/cpython/blob/bcc1be39cb1d04ad9fc0bd1b9193d3972835a57c/Lib/zipfile/__init__.py#L1799-L1813
    +        but provides consistent cross-platform behavior.
    +
    +        >>> san = SanitizedNames._sanitize
    +        >>> san('/foo/bar')
    +        'foo/bar'
    +        >>> san('//foo.txt')
    +        'foo.txt'
    +        >>> san('foo/.././bar.txt')
    +        'foo/bar.txt'
    +        >>> san('foo../.bar.txt')
    +        'foo../.bar.txt'
    +        >>> san('\\foo\\bar.txt')
    +        'foo/bar.txt'
    +        >>> san('D:\\foo.txt')
    +        'D/foo.txt'
    +        >>> san('\\\\server\\share\\file.txt')
    +        'server/share/file.txt'
    +        >>> san('\\\\?\\GLOBALROOT\\Volume3')
    +        '?/GLOBALROOT/Volume3'
    +        >>> san('\\\\.\\PhysicalDrive1\\root')
    +        'PhysicalDrive1/root'
    +
    +        Retain any trailing slash.
    +        >>> san('abc/')
    +        'abc/'
    +
    +        Raises a ValueError if the result is empty.
    +        >>> san('../..')
    +        Traceback (most recent call last):
    +        ...
    +        ValueError: Empty filename
    +        """
    +
    +        def allowed(part):
    +            return part and part not in {'..', '.'}
    +
    +        # Remove the drive letter.
    +        # Don't use ntpath.splitdrive, because that also strips UNC paths
    +        bare = re.sub('^([A-Z]):', r'\1', name, flags=re.IGNORECASE)
    +        clean = bare.replace('\\', '/')
    +        parts = clean.split('/')
    +        joined = '/'.join(filter(allowed, parts))
    +        if not joined:
    +            raise ValueError("Empty filename")
    +        return joined + '/' * name.endswith('/')
    +
    +
    +class CompleteDirs(InitializedState, SanitizedNames, zipfile.ZipFile):
    +    """
    +    A ZipFile subclass that ensures that implied directories
    +    are always included in the namelist.
    +
    +    >>> list(CompleteDirs._implied_dirs(['foo/bar.txt', 'foo/bar/baz.txt']))
    +    ['foo/', 'foo/bar/']
    +    >>> list(CompleteDirs._implied_dirs(['foo/bar.txt', 'foo/bar/baz.txt', 'foo/bar/']))
    +    ['foo/']
    +    """
    +
    +    @staticmethod
    +    def _implied_dirs(names):
    +        parents = itertools.chain.from_iterable(map(_parents, names))
    +        as_dirs = (p + posixpath.sep for p in parents)
    +        return _dedupe(_difference(as_dirs, names))
    +
    +    def namelist(self):
    +        names = super().namelist()
    +        return names + list(self._implied_dirs(names))
    +
    +    def _name_set(self):
    +        return set(self.namelist())
    +
    +    def resolve_dir(self, name):
    +        """
    +        If the name represents a directory, return that name
    +        as a directory (with the trailing slash).
    +        """
    +        names = self._name_set()
    +        dirname = name + '/'
    +        dir_match = name not in names and dirname in names
    +        return dirname if dir_match else name
    +
    +    def getinfo(self, name):
    +        """
    +        Supplement getinfo for implied dirs.
    +        """
    +        try:
    +            return super().getinfo(name)
    +        except KeyError:
    +            if not name.endswith('/') or name not in self._name_set():
    +                raise
    +            return zipfile.ZipInfo(filename=name)
    +
    +    @classmethod
    +    def make(cls, source):
    +        """
    +        Given a source (filename or zipfile), return an
    +        appropriate CompleteDirs subclass.
    +        """
    +        if isinstance(source, CompleteDirs):
    +            return source
    +
    +        if not isinstance(source, zipfile.ZipFile):
    +            return cls(source)
    +
    +        # Only allow for FastLookup when supplied zipfile is read-only
    +        if 'r' not in source.mode:
    +            cls = CompleteDirs
    +
    +        source.__class__ = cls
    +        return source
    +
    +    @classmethod
    +    def inject(cls, zf: zipfile.ZipFile) -> zipfile.ZipFile:
    +        """
    +        Given a writable zip file zf, inject directory entries for
    +        any directories implied by the presence of children.
    +        """
    +        for name in cls._implied_dirs(zf.namelist()):
    +            zf.writestr(name, b"")
    +        return zf
    +
    +
    +class FastLookup(CompleteDirs):
    +    """
    +    ZipFile subclass to ensure implicit
    +    dirs exist and are resolved rapidly.
    +    """
    +
    +    def namelist(self):
    +        with contextlib.suppress(AttributeError):
    +            return self.__names
    +        self.__names = super().namelist()
    +        return self.__names
    +
    +    def _name_set(self):
    +        with contextlib.suppress(AttributeError):
    +            return self.__lookup
    +        self.__lookup = super()._name_set()
    +        return self.__lookup
    +
    +
    +def _extract_text_encoding(encoding=None, *args, **kwargs):
    +    # compute stack level so that the caller of the caller sees any warning.
    +    is_pypy = sys.implementation.name == 'pypy'
    +    stack_level = 3 + is_pypy
    +    return text_encoding(encoding, stack_level), args, kwargs
    +
    +
    +class Path:
    +    """
    +    A :class:`importlib.resources.abc.Traversable` interface for zip files.
    +
    +    Implements many of the features users enjoy from
    +    :class:`pathlib.Path`.
    +
    +    Consider a zip file with this structure::
    +
    +        .
    +        ├── a.txt
    +        └── b
    +            ├── c.txt
    +            └── d
    +                └── e.txt
    +
    +    >>> data = io.BytesIO()
    +    >>> zf = zipfile.ZipFile(data, 'w')
    +    >>> zf.writestr('a.txt', 'content of a')
    +    >>> zf.writestr('b/c.txt', 'content of c')
    +    >>> zf.writestr('b/d/e.txt', 'content of e')
    +    >>> zf.filename = 'mem/abcde.zip'
    +
    +    Path accepts the zipfile object itself or a filename
    +
    +    >>> path = Path(zf)
    +
    +    From there, several path operations are available.
    +
    +    Directory iteration (including the zip file itself):
    +
    +    >>> a, b = path.iterdir()
    +    >>> a
    +    Path('mem/abcde.zip', 'a.txt')
    +    >>> b
    +    Path('mem/abcde.zip', 'b/')
    +
    +    name property:
    +
    +    >>> b.name
    +    'b'
    +
    +    join with divide operator:
    +
    +    >>> c = b / 'c.txt'
    +    >>> c
    +    Path('mem/abcde.zip', 'b/c.txt')
    +    >>> c.name
    +    'c.txt'
    +
    +    Read text:
    +
    +    >>> c.read_text(encoding='utf-8')
    +    'content of c'
    +
    +    existence:
    +
    +    >>> c.exists()
    +    True
    +    >>> (b / 'missing.txt').exists()
    +    False
    +
    +    Coercion to string:
    +
    +    >>> import os
    +    >>> str(c).replace(os.sep, posixpath.sep)
    +    'mem/abcde.zip/b/c.txt'
    +
    +    At the root, ``name``, ``filename``, and ``parent``
    +    resolve to the zipfile.
    +
    +    >>> str(path)
    +    'mem/abcde.zip/'
    +    >>> path.name
    +    'abcde.zip'
    +    >>> path.filename == pathlib.Path('mem/abcde.zip')
    +    True
    +    >>> str(path.parent)
    +    'mem'
    +
    +    If the zipfile has no filename, such attributes are not
    +    valid and accessing them will raise an Exception.
    +
    +    >>> zf.filename = None
    +    >>> path.name
    +    Traceback (most recent call last):
    +    ...
    +    TypeError: ...
    +
    +    >>> path.filename
    +    Traceback (most recent call last):
    +    ...
    +    TypeError: ...
    +
    +    >>> path.parent
    +    Traceback (most recent call last):
    +    ...
    +    TypeError: ...
    +
    +    # workaround python/cpython#106763
    +    >>> pass
    +    """
    +
    +    __repr = "{self.__class__.__name__}({self.root.filename!r}, {self.at!r})"
    +
    +    def __init__(self, root, at=""):
    +        """
    +        Construct a Path from a ZipFile or filename.
    +
    +        Note: When the source is an existing ZipFile object,
    +        its type (__class__) will be mutated to a
    +        specialized type. If the caller wishes to retain the
    +        original type, the caller should either create a
    +        separate ZipFile object or pass a filename.
    +        """
    +        self.root = FastLookup.make(root)
    +        self.at = at
    +
    +    def __eq__(self, other):
    +        """
    +        >>> Path(zipfile.ZipFile(io.BytesIO(), 'w')) == 'foo'
    +        False
    +        """
    +        if self.__class__ is not other.__class__:
    +            return NotImplemented
    +        return (self.root, self.at) == (other.root, other.at)
    +
    +    def __hash__(self):
    +        return hash((self.root, self.at))
    +
    +    def open(self, mode='r', *args, pwd=None, **kwargs):
    +        """
    +        Open this entry as text or binary following the semantics
    +        of ``pathlib.Path.open()`` by passing arguments through
    +        to io.TextIOWrapper().
    +        """
    +        if self.is_dir():
    +            raise IsADirectoryError(self)
    +        zip_mode = mode[0]
    +        if not self.exists() and zip_mode == 'r':
    +            raise FileNotFoundError(self)
    +        stream = self.root.open(self.at, zip_mode, pwd=pwd)
    +        if 'b' in mode:
    +            if args or kwargs:
    +                raise ValueError("encoding args invalid for binary operation")
    +            return stream
    +        # Text mode:
    +        encoding, args, kwargs = _extract_text_encoding(*args, **kwargs)
    +        return io.TextIOWrapper(stream, encoding, *args, **kwargs)
    +
    +    def _base(self):
    +        return pathlib.PurePosixPath(self.at or self.root.filename)
    +
    +    @property
    +    def name(self):
    +        return self._base().name
    +
    +    @property
    +    def suffix(self):
    +        return self._base().suffix
    +
    +    @property
    +    def suffixes(self):
    +        return self._base().suffixes
    +
    +    @property
    +    def stem(self):
    +        return self._base().stem
    +
    +    @property
    +    def filename(self):
    +        return pathlib.Path(self.root.filename).joinpath(self.at)
    +
    +    def read_text(self, *args, **kwargs):
    +        encoding, args, kwargs = _extract_text_encoding(*args, **kwargs)
    +        with self.open('r', encoding, *args, **kwargs) as strm:
    +            return strm.read()
    +
    +    def read_bytes(self):
    +        with self.open('rb') as strm:
    +            return strm.read()
    +
    +    def _is_child(self, path):
    +        return posixpath.dirname(path.at.rstrip("/")) == self.at.rstrip("/")
    +
    +    def _next(self, at):
    +        return self.__class__(self.root, at)
    +
    +    def is_dir(self):
    +        return not self.at or self.at.endswith("/")
    +
    +    def is_file(self):
    +        return self.exists() and not self.is_dir()
    +
    +    def exists(self):
    +        return self.at in self.root._name_set()
    +
    +    def iterdir(self):
    +        if not self.is_dir():
    +            raise ValueError("Can't listdir a file")
    +        subs = map(self._next, self.root.namelist())
    +        return filter(self._is_child, subs)
    +
    +    def match(self, path_pattern):
    +        return pathlib.PurePosixPath(self.at).match(path_pattern)
    +
    +    def is_symlink(self):
    +        """
    +        Return whether this path is a symlink.
    +        """
    +        info = self.root.getinfo(self.at)
    +        mode = info.external_attr >> 16
    +        return stat.S_ISLNK(mode)
    +
    +    def glob(self, pattern):
    +        if not pattern:
    +            raise ValueError(f"Unacceptable pattern: {pattern!r}")
    +
    +        prefix = re.escape(self.at)
    +        tr = Translator(seps='/')
    +        matches = re.compile(prefix + tr.translate(pattern)).fullmatch
    +        names = (data.filename for data in self.root.filelist)
    +        return map(self._next, filter(matches, names))
    +
    +    def rglob(self, pattern):
    +        return self.glob(f'**/{pattern}')
    +
    +    def relative_to(self, other, *extra):
    +        return posixpath.relpath(str(self), str(other.joinpath(*extra)))
    +
    +    def __str__(self):
    +        return posixpath.join(self.root.filename, self.at)
    +
    +    def __repr__(self):
    +        return self.__repr.format(self=self)
    +
    +    def joinpath(self, *other):
    +        next = posixpath.join(self.at, *other)
    +        return self._next(self.root.resolve_dir(next))
    +
    +    __truediv__ = joinpath
    +
    +    @property
    +    def parent(self):
    +        if not self.at:
    +            return self.filename.parent
    +        parent_at = posixpath.dirname(self.at.rstrip('/'))
    +        if parent_at:
    +            parent_at += '/'
    +        return self._next(parent_at)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/__pycache__/__init__.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..d7cba04782bbf6a44a4fd9a6393f4ada6c648dba
    GIT binary patch
    literal 22799
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/__pycache__/glob.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/__pycache__/glob.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..c9981ec0f2b15cce81c995b174a681c484295a2f
    GIT binary patch
    literal 5296
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/__init__.py
    new file mode 100644
    index 000000000..e69de29bb
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/__pycache__/__init__.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..d6fa4bc47efba93e8d4973ef08b89579617d0d77
    GIT binary patch
    literal 233
    zcmX@j%ge<81jlwKW`O9&AOanHW&w&!XQ*V*Wb|9fP{ah}eFmxd)uEq}pPQ8XTbOm!FafVR^c^#Rugl<(KG}l$PWdWhUn6>%mz$nMwKul_eSZ
    zdB%E%M*78>C8@dviOJcC=|J7ZsU@WaCHeU|#rpAOsd*{+Mfz2l1qJ%a`MCv&CHnF4
    qnR%Hd@$q^EmA^P_a`RJ4b5iY!Sb+{>1ma>4<0CU8BV!RWkOcr&Eke8i
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/__pycache__/py310.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/__pycache__/py310.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..76e1bf74a04f962761bba81d59b7010c7eef930b
    GIT binary patch
    literal 544
    zcmY*Wu}%U(5Z%2y6i`fz6qs00a)qoyj26biAc=)Yv@tZ7<93z9Ijis!yB5;tZW!R<|n@
    zlOJ?iDjOHHPC4RjPJP>SQ2q}&b{%;EZ&0_G-z^|!bF%G;G3Je6Gs4>*r_^D{=nxlE
    zAKlrWhb-FiOfGoE-JQG_glh&TU2a4#_2mI#!r8J2Juq6?=$%gm6#Go%niKg4I-JNY
    z^jN5}fQ5=p=e%&WLwsga*Rb7d8m9g$Yl7h?WRTLc_+g9UwnL8mby3PIvON(#RS4l2
    rB*!2zU4k(EnFO0#!%S|F$vy4AX9~UJp_U$K=`R()wb4O&p69aPHIavR
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/py310.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/py310.py
    new file mode 100644
    index 000000000..d5ca53e03
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/compat/py310.py
    @@ -0,0 +1,11 @@
    +import sys
    +import io
    +
    +
    +def _text_encoding(encoding, stacklevel=2, /):  # pragma: no cover
    +    return encoding
    +
    +
    +text_encoding = (
    +    io.text_encoding if sys.version_info > (3, 10) else _text_encoding  # type: ignore
    +)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/glob.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/glob.py
    new file mode 100644
    index 000000000..69c41d77c
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/zipp/glob.py
    @@ -0,0 +1,106 @@
    +import os
    +import re
    +
    +
    +_default_seps = os.sep + str(os.altsep) * bool(os.altsep)
    +
    +
    +class Translator:
    +    """
    +    >>> Translator('xyz')
    +    Traceback (most recent call last):
    +    ...
    +    AssertionError: Invalid separators
    +
    +    >>> Translator('')
    +    Traceback (most recent call last):
    +    ...
    +    AssertionError: Invalid separators
    +    """
    +
    +    seps: str
    +
    +    def __init__(self, seps: str = _default_seps):
    +        assert seps and set(seps) <= set(_default_seps), "Invalid separators"
    +        self.seps = seps
    +
    +    def translate(self, pattern):
    +        """
    +        Given a glob pattern, produce a regex that matches it.
    +        """
    +        return self.extend(self.translate_core(pattern))
    +
    +    def extend(self, pattern):
    +        r"""
    +        Extend regex for pattern-wide concerns.
    +
    +        Apply '(?s:)' to create a non-matching group that
    +        matches newlines (valid on Unix).
    +
    +        Append '\Z' to imply fullmatch even when match is used.
    +        """
    +        return rf'(?s:{pattern})\Z'
    +
    +    def translate_core(self, pattern):
    +        r"""
    +        Given a glob pattern, produce a regex that matches it.
    +
    +        >>> t = Translator()
    +        >>> t.translate_core('*.txt').replace('\\\\', '')
    +        '[^/]*\\.txt'
    +        >>> t.translate_core('a?txt')
    +        'a[^/]txt'
    +        >>> t.translate_core('**/*').replace('\\\\', '')
    +        '.*/[^/][^/]*'
    +        """
    +        self.restrict_rglob(pattern)
    +        return ''.join(map(self.replace, separate(self.star_not_empty(pattern))))
    +
    +    def replace(self, match):
    +        """
    +        Perform the replacements for a match from :func:`separate`.
    +        """
    +        return match.group('set') or (
    +            re.escape(match.group(0))
    +            .replace('\\*\\*', r'.*')
    +            .replace('\\*', rf'[^{re.escape(self.seps)}]*')
    +            .replace('\\?', r'[^/]')
    +        )
    +
    +    def restrict_rglob(self, pattern):
    +        """
    +        Raise ValueError if ** appears in anything but a full path segment.
    +
    +        >>> Translator().translate('**foo')
    +        Traceback (most recent call last):
    +        ...
    +        ValueError: ** must appear alone in a path segment
    +        """
    +        seps_pattern = rf'[{re.escape(self.seps)}]+'
    +        segments = re.split(seps_pattern, pattern)
    +        if any('**' in segment and segment != '**' for segment in segments):
    +            raise ValueError("** must appear alone in a path segment")
    +
    +    def star_not_empty(self, pattern):
    +        """
    +        Ensure that * will not match an empty segment.
    +        """
    +
    +        def handle_segment(match):
    +            segment = match.group(0)
    +            return '?*' if segment == '*' else segment
    +
    +        not_seps_pattern = rf'[^{re.escape(self.seps)}]+'
    +        return re.sub(not_seps_pattern, handle_segment, pattern)
    +
    +
    +def separate(pattern):
    +    """
    +    Separate out character sets to avoid translating their contents.
    +
    +    >>> [m.group(0) for m in separate('*.txt')]
    +    ['*.txt']
    +    >>> [m.group(0) for m in separate('a[?]txt')]
    +    ['a', '[?]', 'txt']
    +    """
    +    return re.finditer(r'([^\[]+)|(?P[\[].*?[\]])|([\[][^\]]*$)', pattern)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/archive_util.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/archive_util.py
    new file mode 100644
    index 000000000..1a02010bb
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/archive_util.py
    @@ -0,0 +1,219 @@
    +"""Utilities for extracting common archive formats"""
    +
    +import contextlib
    +import os
    +import posixpath
    +import shutil
    +import tarfile
    +import zipfile
    +
    +from ._path import ensure_directory
    +
    +from distutils.errors import DistutilsError
    +
    +__all__ = [
    +    "unpack_archive",
    +    "unpack_zipfile",
    +    "unpack_tarfile",
    +    "default_filter",
    +    "UnrecognizedFormat",
    +    "extraction_drivers",
    +    "unpack_directory",
    +]
    +
    +
    +class UnrecognizedFormat(DistutilsError):
    +    """Couldn't recognize the archive type"""
    +
    +
    +def default_filter(src, dst):
    +    """The default progress/filter callback; returns True for all files"""
    +    return dst
    +
    +
    +def unpack_archive(
    +    filename, extract_dir, progress_filter=default_filter, drivers=None
    +) -> None:
    +    """Unpack `filename` to `extract_dir`, or raise ``UnrecognizedFormat``
    +
    +    `progress_filter` is a function taking two arguments: a source path
    +    internal to the archive ('/'-separated), and a filesystem path where it
    +    will be extracted.  The callback must return the desired extract path
    +    (which may be the same as the one passed in), or else ``None`` to skip
    +    that file or directory.  The callback can thus be used to report on the
    +    progress of the extraction, as well as to filter the items extracted or
    +    alter their extraction paths.
    +
    +    `drivers`, if supplied, must be a non-empty sequence of functions with the
    +    same signature as this function (minus the `drivers` argument), that raise
    +    ``UnrecognizedFormat`` if they do not support extracting the designated
    +    archive type.  The `drivers` are tried in sequence until one is found that
    +    does not raise an error, or until all are exhausted (in which case
    +    ``UnrecognizedFormat`` is raised).  If you do not supply a sequence of
    +    drivers, the module's ``extraction_drivers`` constant will be used, which
    +    means that ``unpack_zipfile`` and ``unpack_tarfile`` will be tried, in that
    +    order.
    +    """
    +    for driver in drivers or extraction_drivers:
    +        try:
    +            driver(filename, extract_dir, progress_filter)
    +        except UnrecognizedFormat:
    +            continue
    +        else:
    +            return
    +    else:
    +        raise UnrecognizedFormat(f"Not a recognized archive type: {filename}")
    +
    +
    +def unpack_directory(filename, extract_dir, progress_filter=default_filter) -> None:
    +    """ "Unpack" a directory, using the same interface as for archives
    +
    +    Raises ``UnrecognizedFormat`` if `filename` is not a directory
    +    """
    +    if not os.path.isdir(filename):
    +        raise UnrecognizedFormat(f"{filename} is not a directory")
    +
    +    paths = {
    +        filename: ('', extract_dir),
    +    }
    +    for base, dirs, files in os.walk(filename):
    +        src, dst = paths[base]
    +        for d in dirs:
    +            paths[os.path.join(base, d)] = src + d + '/', os.path.join(dst, d)
    +        for f in files:
    +            target = os.path.join(dst, f)
    +            target = progress_filter(src + f, target)
    +            if not target:
    +                # skip non-files
    +                continue
    +            ensure_directory(target)
    +            f = os.path.join(base, f)
    +            shutil.copyfile(f, target)
    +            shutil.copystat(f, target)
    +
    +
    +def unpack_zipfile(filename, extract_dir, progress_filter=default_filter) -> None:
    +    """Unpack zip `filename` to `extract_dir`
    +
    +    Raises ``UnrecognizedFormat`` if `filename` is not a zipfile (as determined
    +    by ``zipfile.is_zipfile()``).  See ``unpack_archive()`` for an explanation
    +    of the `progress_filter` argument.
    +    """
    +
    +    if not zipfile.is_zipfile(filename):
    +        raise UnrecognizedFormat(f"{filename} is not a zip file")
    +
    +    with zipfile.ZipFile(filename) as z:
    +        _unpack_zipfile_obj(z, extract_dir, progress_filter)
    +
    +
    +def _unpack_zipfile_obj(zipfile_obj, extract_dir, progress_filter=default_filter):
    +    """Internal/private API used by other parts of setuptools.
    +    Similar to ``unpack_zipfile``, but receives an already opened :obj:`zipfile.ZipFile`
    +    object instead of a filename.
    +    """
    +    for info in zipfile_obj.infolist():
    +        name = info.filename
    +
    +        # don't extract absolute paths or ones with .. in them
    +        if name.startswith('/') or '..' in name.split('/'):
    +            continue
    +
    +        target = os.path.join(extract_dir, *name.split('/'))
    +        target = progress_filter(name, target)
    +        if not target:
    +            continue
    +        if name.endswith('/'):
    +            # directory
    +            ensure_directory(target)
    +        else:
    +            # file
    +            ensure_directory(target)
    +            data = zipfile_obj.read(info.filename)
    +            with open(target, 'wb') as f:
    +                f.write(data)
    +        unix_attributes = info.external_attr >> 16
    +        if unix_attributes:
    +            os.chmod(target, unix_attributes)
    +
    +
    +def _resolve_tar_file_or_dir(tar_obj, tar_member_obj):
    +    """Resolve any links and extract link targets as normal files."""
    +    while tar_member_obj is not None and (
    +        tar_member_obj.islnk() or tar_member_obj.issym()
    +    ):
    +        linkpath = tar_member_obj.linkname
    +        if tar_member_obj.issym():
    +            base = posixpath.dirname(tar_member_obj.name)
    +            linkpath = posixpath.join(base, linkpath)
    +            linkpath = posixpath.normpath(linkpath)
    +        tar_member_obj = tar_obj._getmember(linkpath)
    +
    +    is_file_or_dir = tar_member_obj is not None and (
    +        tar_member_obj.isfile() or tar_member_obj.isdir()
    +    )
    +    if is_file_or_dir:
    +        return tar_member_obj
    +
    +    raise LookupError('Got unknown file type')
    +
    +
    +def _iter_open_tar(tar_obj, extract_dir, progress_filter):
    +    """Emit member-destination pairs from a tar archive."""
    +    # don't do any chowning!
    +    tar_obj.chown = lambda *args: None
    +
    +    with contextlib.closing(tar_obj):
    +        for member in tar_obj:
    +            name = member.name
    +            # don't extract absolute paths or ones with .. in them
    +            if name.startswith('/') or '..' in name.split('/'):
    +                continue
    +
    +            prelim_dst = os.path.join(extract_dir, *name.split('/'))
    +
    +            try:
    +                member = _resolve_tar_file_or_dir(tar_obj, member)
    +            except LookupError:
    +                continue
    +
    +            final_dst = progress_filter(name, prelim_dst)
    +            if not final_dst:
    +                continue
    +
    +            if final_dst.endswith(os.sep):
    +                final_dst = final_dst[:-1]
    +
    +            yield member, final_dst
    +
    +
    +def unpack_tarfile(filename, extract_dir, progress_filter=default_filter) -> bool:
    +    """Unpack tar/tar.gz/tar.bz2 `filename` to `extract_dir`
    +
    +    Raises ``UnrecognizedFormat`` if `filename` is not a tarfile (as determined
    +    by ``tarfile.open()``).  See ``unpack_archive()`` for an explanation
    +    of the `progress_filter` argument.
    +    """
    +    try:
    +        tarobj = tarfile.open(filename)
    +    except tarfile.TarError as e:
    +        raise UnrecognizedFormat(
    +            f"{filename} is not a compressed or uncompressed tar file"
    +        ) from e
    +
    +    for member, final_dst in _iter_open_tar(
    +        tarobj,
    +        extract_dir,
    +        progress_filter,
    +    ):
    +        try:
    +            # XXX Ugh
    +            tarobj._extract_member(member, final_dst)
    +        except tarfile.ExtractError:
    +            # chown/chmod/mkfifo/mknode/makedev failed
    +            pass
    +
    +    return True
    +
    +
    +extraction_drivers = unpack_directory, unpack_zipfile, unpack_tarfile
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/build_meta.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/build_meta.py
    new file mode 100644
    index 000000000..8f2e930c7
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/build_meta.py
    @@ -0,0 +1,548 @@
    +"""A PEP 517 interface to setuptools
    +
    +Previously, when a user or a command line tool (let's call it a "frontend")
    +needed to make a request of setuptools to take a certain action, for
    +example, generating a list of installation requirements, the frontend
    +would call "setup.py egg_info" or "setup.py bdist_wheel" on the command line.
    +
    +PEP 517 defines a different method of interfacing with setuptools. Rather
    +than calling "setup.py" directly, the frontend should:
    +
    +  1. Set the current directory to the directory with a setup.py file
    +  2. Import this module into a safe python interpreter (one in which
    +     setuptools can potentially set global variables or crash hard).
    +  3. Call one of the functions defined in PEP 517.
    +
    +What each function does is defined in PEP 517. However, here is a "casual"
    +definition of the functions (this definition should not be relied on for
    +bug reports or API stability):
    +
    +  - `build_wheel`: build a wheel in the folder and return the basename
    +  - `get_requires_for_build_wheel`: get the `setup_requires` to build
    +  - `prepare_metadata_for_build_wheel`: get the `install_requires`
    +  - `build_sdist`: build an sdist in the folder and return the basename
    +  - `get_requires_for_build_sdist`: get the `setup_requires` to build
    +
    +Again, this is not a formal definition! Just a "taste" of the module.
    +"""
    +
    +from __future__ import annotations
    +
    +import contextlib
    +import io
    +import os
    +import shlex
    +import shutil
    +import sys
    +import tempfile
    +import tokenize
    +import warnings
    +from collections.abc import Iterable, Iterator, Mapping
    +from pathlib import Path
    +from typing import TYPE_CHECKING, Union
    +
    +import setuptools
    +
    +from . import errors
    +from ._path import StrPath, same_path
    +from ._reqs import parse_strings
    +from .warnings import SetuptoolsDeprecationWarning
    +
    +import distutils
    +from distutils.util import strtobool
    +
    +if TYPE_CHECKING:
    +    from typing_extensions import TypeAlias
    +
    +__all__ = [
    +    'get_requires_for_build_sdist',
    +    'get_requires_for_build_wheel',
    +    'prepare_metadata_for_build_wheel',
    +    'build_wheel',
    +    'build_sdist',
    +    'get_requires_for_build_editable',
    +    'prepare_metadata_for_build_editable',
    +    'build_editable',
    +    '__legacy__',
    +    'SetupRequirementsError',
    +]
    +
    +
    +class SetupRequirementsError(BaseException):
    +    def __init__(self, specifiers) -> None:
    +        self.specifiers = specifiers
    +
    +
    +class Distribution(setuptools.dist.Distribution):
    +    def fetch_build_eggs(self, specifiers):
    +        specifier_list = list(parse_strings(specifiers))
    +
    +        raise SetupRequirementsError(specifier_list)
    +
    +    @classmethod
    +    @contextlib.contextmanager
    +    def patch(cls):
    +        """
    +        Replace
    +        distutils.dist.Distribution with this class
    +        for the duration of this context.
    +        """
    +        orig = distutils.core.Distribution
    +        distutils.core.Distribution = cls  # type: ignore[misc] # monkeypatching
    +        try:
    +            yield
    +        finally:
    +            distutils.core.Distribution = orig  # type: ignore[misc] # monkeypatching
    +
    +
    +@contextlib.contextmanager
    +def no_install_setup_requires():
    +    """Temporarily disable installing setup_requires
    +
    +    Under PEP 517, the backend reports build dependencies to the frontend,
    +    and the frontend is responsible for ensuring they're installed.
    +    So setuptools (acting as a backend) should not try to install them.
    +    """
    +    orig = setuptools._install_setup_requires
    +    setuptools._install_setup_requires = lambda attrs: None
    +    try:
    +        yield
    +    finally:
    +        setuptools._install_setup_requires = orig
    +
    +
    +def _get_immediate_subdirectories(a_dir):
    +    return [
    +        name for name in os.listdir(a_dir) if os.path.isdir(os.path.join(a_dir, name))
    +    ]
    +
    +
    +def _file_with_extension(directory: StrPath, extension: str | tuple[str, ...]):
    +    matching = (f for f in os.listdir(directory) if f.endswith(extension))
    +    try:
    +        (file,) = matching
    +    except ValueError:
    +        raise ValueError(
    +            'No distribution was found. Ensure that `setup.py` '
    +            'is not empty and that it calls `setup()`.'
    +        ) from None
    +    return file
    +
    +
    +def _open_setup_script(setup_script):
    +    if not os.path.exists(setup_script):
    +        # Supply a default setup.py
    +        return io.StringIO("from setuptools import setup; setup()")
    +
    +    return tokenize.open(setup_script)
    +
    +
    +@contextlib.contextmanager
    +def suppress_known_deprecation():
    +    with warnings.catch_warnings():
    +        warnings.filterwarnings('ignore', 'setup.py install is deprecated')
    +        yield
    +
    +
    +_ConfigSettings: TypeAlias = Union[Mapping[str, Union[str, list[str], None]], None]
    +"""
    +Currently the user can run::
    +
    +    pip install -e . --config-settings key=value
    +    python -m build -C--key=value -C key=value
    +
    +- pip will pass both key and value as strings and overwriting repeated keys
    +  (pypa/pip#11059).
    +- build will accumulate values associated with repeated keys in a list.
    +  It will also accept keys with no associated value.
    +  This means that an option passed by build can be ``str | list[str] | None``.
    +- PEP 517 specifies that ``config_settings`` is an optional dict.
    +"""
    +
    +
    +class _ConfigSettingsTranslator:
    +    """Translate ``config_settings`` into distutils-style command arguments.
    +    Only a limited number of options is currently supported.
    +    """
    +
    +    # See pypa/setuptools#1928 pypa/setuptools#2491
    +
    +    def _get_config(self, key: str, config_settings: _ConfigSettings) -> list[str]:
    +        """
    +        Get the value of a specific key in ``config_settings`` as a list of strings.
    +
    +        >>> fn = _ConfigSettingsTranslator()._get_config
    +        >>> fn("--global-option", None)
    +        []
    +        >>> fn("--global-option", {})
    +        []
    +        >>> fn("--global-option", {'--global-option': 'foo'})
    +        ['foo']
    +        >>> fn("--global-option", {'--global-option': ['foo']})
    +        ['foo']
    +        >>> fn("--global-option", {'--global-option': 'foo'})
    +        ['foo']
    +        >>> fn("--global-option", {'--global-option': 'foo bar'})
    +        ['foo', 'bar']
    +        """
    +        cfg = config_settings or {}
    +        opts = cfg.get(key) or []
    +        return shlex.split(opts) if isinstance(opts, str) else opts
    +
    +    def _global_args(self, config_settings: _ConfigSettings) -> Iterator[str]:
    +        """
    +        Let the user specify ``verbose`` or ``quiet`` + escape hatch via
    +        ``--global-option``.
    +        Note: ``-v``, ``-vv``, ``-vvv`` have similar effects in setuptools,
    +        so we just have to cover the basic scenario ``-v``.
    +
    +        >>> fn = _ConfigSettingsTranslator()._global_args
    +        >>> list(fn(None))
    +        []
    +        >>> list(fn({"verbose": "False"}))
    +        ['-q']
    +        >>> list(fn({"verbose": "1"}))
    +        ['-v']
    +        >>> list(fn({"--verbose": None}))
    +        ['-v']
    +        >>> list(fn({"verbose": "true", "--global-option": "-q --no-user-cfg"}))
    +        ['-v', '-q', '--no-user-cfg']
    +        >>> list(fn({"--quiet": None}))
    +        ['-q']
    +        """
    +        cfg = config_settings or {}
    +        falsey = {"false", "no", "0", "off"}
    +        if "verbose" in cfg or "--verbose" in cfg:
    +            level = str(cfg.get("verbose") or cfg.get("--verbose") or "1")
    +            yield ("-q" if level.lower() in falsey else "-v")
    +        if "quiet" in cfg or "--quiet" in cfg:
    +            level = str(cfg.get("quiet") or cfg.get("--quiet") or "1")
    +            yield ("-v" if level.lower() in falsey else "-q")
    +
    +        yield from self._get_config("--global-option", config_settings)
    +
    +    def __dist_info_args(self, config_settings: _ConfigSettings) -> Iterator[str]:
    +        """
    +        The ``dist_info`` command accepts ``tag-date`` and ``tag-build``.
    +
    +        .. warning::
    +           We cannot use this yet as it requires the ``sdist`` and ``bdist_wheel``
    +           commands run in ``build_sdist`` and ``build_wheel`` to reuse the egg-info
    +           directory created in ``prepare_metadata_for_build_wheel``.
    +
    +        >>> fn = _ConfigSettingsTranslator()._ConfigSettingsTranslator__dist_info_args
    +        >>> list(fn(None))
    +        []
    +        >>> list(fn({"tag-date": "False"}))
    +        ['--no-date']
    +        >>> list(fn({"tag-date": None}))
    +        ['--no-date']
    +        >>> list(fn({"tag-date": "true", "tag-build": ".a"}))
    +        ['--tag-date', '--tag-build', '.a']
    +        """
    +        cfg = config_settings or {}
    +        if "tag-date" in cfg:
    +            val = strtobool(str(cfg["tag-date"] or "false"))
    +            yield ("--tag-date" if val else "--no-date")
    +        if "tag-build" in cfg:
    +            yield from ["--tag-build", str(cfg["tag-build"])]
    +
    +    def _editable_args(self, config_settings: _ConfigSettings) -> Iterator[str]:
    +        """
    +        The ``editable_wheel`` command accepts ``editable-mode=strict``.
    +
    +        >>> fn = _ConfigSettingsTranslator()._editable_args
    +        >>> list(fn(None))
    +        []
    +        >>> list(fn({"editable-mode": "strict"}))
    +        ['--mode', 'strict']
    +        """
    +        cfg = config_settings or {}
    +        mode = cfg.get("editable-mode") or cfg.get("editable_mode")
    +        if not mode:
    +            return
    +        yield from ["--mode", str(mode)]
    +
    +    def _arbitrary_args(self, config_settings: _ConfigSettings) -> Iterator[str]:
    +        """
    +        Users may expect to pass arbitrary lists of arguments to a command
    +        via "--global-option" (example provided in PEP 517 of a "escape hatch").
    +
    +        >>> fn = _ConfigSettingsTranslator()._arbitrary_args
    +        >>> list(fn(None))
    +        []
    +        >>> list(fn({}))
    +        []
    +        >>> list(fn({'--build-option': 'foo'}))
    +        ['foo']
    +        >>> list(fn({'--build-option': ['foo']}))
    +        ['foo']
    +        >>> list(fn({'--build-option': 'foo'}))
    +        ['foo']
    +        >>> list(fn({'--build-option': 'foo bar'}))
    +        ['foo', 'bar']
    +        >>> list(fn({'--global-option': 'foo'}))
    +        []
    +        """
    +        yield from self._get_config("--build-option", config_settings)
    +
    +
    +class _BuildMetaBackend(_ConfigSettingsTranslator):
    +    def _get_build_requires(
    +        self, config_settings: _ConfigSettings, requirements: list[str]
    +    ):
    +        sys.argv = [
    +            *sys.argv[:1],
    +            *self._global_args(config_settings),
    +            "egg_info",
    +        ]
    +        try:
    +            with Distribution.patch():
    +                self.run_setup()
    +        except SetupRequirementsError as e:
    +            requirements += e.specifiers
    +
    +        return requirements
    +
    +    def run_setup(self, setup_script: str = 'setup.py'):
    +        # Note that we can reuse our build directory between calls
    +        # Correctness comes first, then optimization later
    +        __file__ = os.path.abspath(setup_script)
    +        __name__ = '__main__'
    +
    +        with _open_setup_script(__file__) as f:
    +            code = f.read().replace(r'\r\n', r'\n')
    +
    +        try:
    +            exec(code, locals())
    +        except SystemExit as e:
    +            if e.code:
    +                raise
    +            # We ignore exit code indicating success
    +            SetuptoolsDeprecationWarning.emit(
    +                "Running `setup.py` directly as CLI tool is deprecated.",
    +                "Please avoid using `sys.exit(0)` or similar statements "
    +                "that don't fit in the paradigm of a configuration file.",
    +                see_url="https://blog.ganssle.io/articles/2021/10/"
    +                "setup-py-deprecated.html",
    +            )
    +
    +    def get_requires_for_build_wheel(self, config_settings: _ConfigSettings = None):
    +        return self._get_build_requires(config_settings, requirements=[])
    +
    +    def get_requires_for_build_sdist(self, config_settings: _ConfigSettings = None):
    +        return self._get_build_requires(config_settings, requirements=[])
    +
    +    def _bubble_up_info_directory(
    +        self, metadata_directory: StrPath, suffix: str
    +    ) -> str:
    +        """
    +        PEP 517 requires that the .dist-info directory be placed in the
    +        metadata_directory. To comply, we MUST copy the directory to the root.
    +
    +        Returns the basename of the info directory, e.g. `proj-0.0.0.dist-info`.
    +        """
    +        info_dir = self._find_info_directory(metadata_directory, suffix)
    +        if not same_path(info_dir.parent, metadata_directory):
    +            shutil.move(str(info_dir), metadata_directory)
    +            # PEP 517 allow other files and dirs to exist in metadata_directory
    +        return info_dir.name
    +
    +    def _find_info_directory(self, metadata_directory: StrPath, suffix: str) -> Path:
    +        for parent, dirs, _ in os.walk(metadata_directory):
    +            candidates = [f for f in dirs if f.endswith(suffix)]
    +
    +            if len(candidates) != 0 or len(dirs) != 1:
    +                assert len(candidates) == 1, f"Multiple {suffix} directories found"
    +                return Path(parent, candidates[0])
    +
    +        msg = f"No {suffix} directory found in {metadata_directory}"
    +        raise errors.InternalError(msg)
    +
    +    def prepare_metadata_for_build_wheel(
    +        self, metadata_directory: StrPath, config_settings: _ConfigSettings = None
    +    ):
    +        sys.argv = [
    +            *sys.argv[:1],
    +            *self._global_args(config_settings),
    +            "dist_info",
    +            "--output-dir",
    +            str(metadata_directory),
    +            "--keep-egg-info",
    +        ]
    +        with no_install_setup_requires():
    +            self.run_setup()
    +
    +        self._bubble_up_info_directory(metadata_directory, ".egg-info")
    +        return self._bubble_up_info_directory(metadata_directory, ".dist-info")
    +
    +    def _build_with_temp_dir(
    +        self,
    +        setup_command: Iterable[str],
    +        result_extension: str | tuple[str, ...],
    +        result_directory: StrPath,
    +        config_settings: _ConfigSettings,
    +        arbitrary_args: Iterable[str] = (),
    +    ):
    +        result_directory = os.path.abspath(result_directory)
    +
    +        # Build in a temporary directory, then copy to the target.
    +        os.makedirs(result_directory, exist_ok=True)
    +
    +        with tempfile.TemporaryDirectory(
    +            prefix=".tmp-", dir=result_directory
    +        ) as tmp_dist_dir:
    +            sys.argv = [
    +                *sys.argv[:1],
    +                *self._global_args(config_settings),
    +                *setup_command,
    +                "--dist-dir",
    +                tmp_dist_dir,
    +                *arbitrary_args,
    +            ]
    +            with no_install_setup_requires():
    +                self.run_setup()
    +
    +            result_basename = _file_with_extension(tmp_dist_dir, result_extension)
    +            result_path = os.path.join(result_directory, result_basename)
    +            if os.path.exists(result_path):
    +                # os.rename will fail overwriting on non-Unix.
    +                os.remove(result_path)
    +            os.rename(os.path.join(tmp_dist_dir, result_basename), result_path)
    +
    +        return result_basename
    +
    +    def build_wheel(
    +        self,
    +        wheel_directory: StrPath,
    +        config_settings: _ConfigSettings = None,
    +        metadata_directory: StrPath | None = None,
    +    ):
    +        def _build(cmd: list[str]):
    +            with suppress_known_deprecation():
    +                return self._build_with_temp_dir(
    +                    cmd,
    +                    '.whl',
    +                    wheel_directory,
    +                    config_settings,
    +                    self._arbitrary_args(config_settings),
    +                )
    +
    +        if metadata_directory is None:
    +            return _build(['bdist_wheel'])
    +
    +        try:
    +            return _build(['bdist_wheel', '--dist-info-dir', str(metadata_directory)])
    +        except SystemExit as ex:  # pragma: nocover
    +            # pypa/setuptools#4683
    +            if "--dist-info-dir not recognized" not in str(ex):
    +                raise
    +            _IncompatibleBdistWheel.emit()
    +            return _build(['bdist_wheel'])
    +
    +    def build_sdist(
    +        self, sdist_directory: StrPath, config_settings: _ConfigSettings = None
    +    ):
    +        return self._build_with_temp_dir(
    +            ['sdist', '--formats', 'gztar'], '.tar.gz', sdist_directory, config_settings
    +        )
    +
    +    def _get_dist_info_dir(self, metadata_directory: StrPath | None) -> str | None:
    +        if not metadata_directory:
    +            return None
    +        dist_info_candidates = list(Path(metadata_directory).glob("*.dist-info"))
    +        assert len(dist_info_candidates) <= 1
    +        return str(dist_info_candidates[0]) if dist_info_candidates else None
    +
    +    def build_editable(
    +        self,
    +        wheel_directory: StrPath,
    +        config_settings: _ConfigSettings = None,
    +        metadata_directory: StrPath | None = None,
    +    ):
    +        # XXX can or should we hide our editable_wheel command normally?
    +        info_dir = self._get_dist_info_dir(metadata_directory)
    +        opts = ["--dist-info-dir", info_dir] if info_dir else []
    +        cmd = ["editable_wheel", *opts, *self._editable_args(config_settings)]
    +        with suppress_known_deprecation():
    +            return self._build_with_temp_dir(
    +                cmd, ".whl", wheel_directory, config_settings
    +            )
    +
    +    def get_requires_for_build_editable(self, config_settings: _ConfigSettings = None):
    +        return self.get_requires_for_build_wheel(config_settings)
    +
    +    def prepare_metadata_for_build_editable(
    +        self, metadata_directory: StrPath, config_settings: _ConfigSettings = None
    +    ):
    +        return self.prepare_metadata_for_build_wheel(
    +            metadata_directory, config_settings
    +        )
    +
    +
    +class _BuildMetaLegacyBackend(_BuildMetaBackend):
    +    """Compatibility backend for setuptools
    +
    +    This is a version of setuptools.build_meta that endeavors
    +    to maintain backwards
    +    compatibility with pre-PEP 517 modes of invocation. It
    +    exists as a temporary
    +    bridge between the old packaging mechanism and the new
    +    packaging mechanism,
    +    and will eventually be removed.
    +    """
    +
    +    def run_setup(self, setup_script: str = 'setup.py'):
    +        # In order to maintain compatibility with scripts assuming that
    +        # the setup.py script is in a directory on the PYTHONPATH, inject
    +        # '' into sys.path. (pypa/setuptools#1642)
    +        sys_path = list(sys.path)  # Save the original path
    +
    +        script_dir = os.path.dirname(os.path.abspath(setup_script))
    +        if script_dir not in sys.path:
    +            sys.path.insert(0, script_dir)
    +
    +        # Some setup.py scripts (e.g. in pygame and numpy) use sys.argv[0] to
    +        # get the directory of the source code. They expect it to refer to the
    +        # setup.py script.
    +        sys_argv_0 = sys.argv[0]
    +        sys.argv[0] = setup_script
    +
    +        try:
    +            super().run_setup(setup_script=setup_script)
    +        finally:
    +            # While PEP 517 frontends should be calling each hook in a fresh
    +            # subprocess according to the standard (and thus it should not be
    +            # strictly necessary to restore the old sys.path), we'll restore
    +            # the original path so that the path manipulation does not persist
    +            # within the hook after run_setup is called.
    +            sys.path[:] = sys_path
    +            sys.argv[0] = sys_argv_0
    +
    +
    +class _IncompatibleBdistWheel(SetuptoolsDeprecationWarning):
    +    _SUMMARY = "wheel.bdist_wheel is deprecated, please import it from setuptools"
    +    _DETAILS = """
    +    Ensure that any custom bdist_wheel implementation is a subclass of
    +    setuptools.command.bdist_wheel.bdist_wheel.
    +    """
    +    _DUE_DATE = (2025, 10, 15)
    +    # Initially introduced in 2024/10/15, but maybe too disruptive to be enforced?
    +    _SEE_URL = "https://github.com/pypa/wheel/pull/631"
    +
    +
    +# The primary backend
    +_BACKEND = _BuildMetaBackend()
    +
    +get_requires_for_build_wheel = _BACKEND.get_requires_for_build_wheel
    +get_requires_for_build_sdist = _BACKEND.get_requires_for_build_sdist
    +prepare_metadata_for_build_wheel = _BACKEND.prepare_metadata_for_build_wheel
    +build_wheel = _BACKEND.build_wheel
    +build_sdist = _BACKEND.build_sdist
    +get_requires_for_build_editable = _BACKEND.get_requires_for_build_editable
    +prepare_metadata_for_build_editable = _BACKEND.prepare_metadata_for_build_editable
    +build_editable = _BACKEND.build_editable
    +
    +
    +# The legacy backend
    +__legacy__ = _BuildMetaLegacyBackend()
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/cli-32.exe b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/cli-32.exe
    new file mode 100644
    index 0000000000000000000000000000000000000000..65c3cd99cc7433f271a5b9387abdd1ddb949d1a6
    GIT binary patch
    literal 11776
    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
    I{a-)-138F7F#rGn
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/cli-64.exe b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/cli-64.exe
    new file mode 100644
    index 0000000000000000000000000000000000000000..3ea50eebfe3f0113b231a318cc1ad6e238afd60d
    GIT binary patch
    literal 14336
    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
    AO8@`>
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/cli-arm64.exe b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/cli-arm64.exe
    new file mode 100644
    index 0000000000000000000000000000000000000000..da96455a07a0bad4cde5dc5626544325f82c722b
    GIT binary patch
    literal 13824
    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
    I{a-)-138F7F#rGn
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__init__.py
    new file mode 100644
    index 000000000..50e6c2f54
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__init__.py
    @@ -0,0 +1,21 @@
    +# mypy: disable_error_code=call-overload
    +# pyright: reportCallIssue=false, reportArgumentType=false
    +# Can't disable on the exact line because distutils doesn't exists on Python 3.12
    +# and type-checkers aren't aware of distutils_hack,
    +# causing distutils.command.bdist.bdist.format_commands to be Any.
    +
    +import sys
    +
    +from distutils.command.bdist import bdist
    +
    +if 'egg' not in bdist.format_commands:
    +    try:
    +        # format_commands is a dict in vendored distutils
    +        # It used to be a list in older (stdlib) distutils
    +        # We support both for backwards compatibility
    +        bdist.format_commands['egg'] = ('bdist_egg', "Python .egg file")
    +    except TypeError:
    +        bdist.format_command['egg'] = ('bdist_egg', "Python .egg file")
    +        bdist.format_commands.append('egg')
    +
    +del bdist, sys
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/__init__.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..023c809ff451b4f3b82686caede2201efbd18b01
    GIT binary patch
    literal 685
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/alias.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/alias.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..bcd0a5b8459612076cbb241c8c92920645dc303f
    GIT binary patch
    literal 3579
    zcmb7HO>7&-6`t82aw$@Oq(bY*R@Rm)iLEKdm64=%?K-e*NB)tWIspvAEwSRRq?O5C
    zdUh#?GzBQFfzpoCNN51DNQ(H-gAEs`js<#YFYTchQF35*A)o^49&%GH9}1oNW|m7@
    zj(W%dd^7uI=FQCe`QGE-TU%QYw7>pInYkE1=wI~1Yhrz{eHI4GNJT2npe#<}ESKc6
    ze3HkM$7O`9m=s~m-$6+qht45YxPw$t;~(>`grr~f!JJg^$E2?*E5fJ$h#eorQ?P9E3$5}L+0-a?23_mXiHc3(v?
    zu6XRdylHE)V#o@a&Sy2lmZwZ2XB1l_a!w(ZZcNLQ1=*U(XdjMPxr}ZP$6~?`KD2{}
    zcJTEbJP_j?foM76h-?}@d64Dcw8g<)WO=8Mm@%_jLIDYhONA@MoYm5{l{jVb~g1BbJDaEpfr={N+vPV7-jUyM6O`Zn8xVH(eEcL-PYncC4EDghTWEC=X17c
    zW~@Zo%w`osg`;%E8p#zLzcq7{K9F?6RebQXP6Js$o2~M5#EA#WxE2g8^7r1}i0rHI
    zzy85mX#bW7{4F1ng1;<$RQSd1MQc%8^Y?AEM;1?iTv(O5Yr(dK^V=W>r77_meJpL;
    z29RZ>p(IvOl2dV#SGlC1@<~w@rm^OmZDZ?pks^F0{V>FEiFso{ZBeB=
    zLb3(=0Q5od&Y&Z*Cl^P@v?<*HdxF7CVyE-AY|kjRtQ&LY4b75Gm;>`>O`^$lWm&~H
    z)NgJw>s$8R@jk?Xk7!wQPIE9RcDqA)IB$S0VsIi{fLegO1`pWf^3-AJZ~HuuWz=-d
    zSxtpf&D}}QtRq23-<%HXm45gBuK)r
    zWMc2P{tBkP&08U`DKxy&$YI;>v0#Pdjhnp(5ULmWL2pjwyt$v_0s?*U6JJve6whAD
    zTefWFw6s1|khKq$w4Et1n>XNKxM5D&P_kM~zBQv6a-IQ0Jnou4=5v+b0nWEe^~?ht
    zKBF0=2hJlj1W7NDmkmI*Ta3B}cvZkby7mN+y7~`SrNa;2e`xE8k%sRV_L)FI|@ojLbWs0T1c(v_?
    zuPXLb2{^r{p{!#~Lp2qT(Mw$3lYvo*qCU9bJonPPU_(xGTZt>-$92c|dW`P(3SdUN
    zVc@-Q;+>+3H-BBiygyu&S@bea`*1
    z;f5G)zxQoaKXsIOPL*ccoA>ZWHpOw)Y#MN^{U14^ih7Z!F;5foyiGC5+ZXl5&0fXu
    zR$j+CwJwE*SDIHF&=1
    zSHlBOLWdiJS`Xx7+Pg2tz}oEUULIc>uP93w%V%oQp5>XPnJ=v0z4dVH595!hnLo0|KWP{
    zc=_BjDY7`Wd}-;@gYgw{<<@HA$EyRU{(SgvNB(l;E9o-B87P1tIof$*OvFNtluA+E
    zrczEzDwQ?We1?ugsnpH9lBv)5Qz_L<13L)SP@3qhUUYivI;Zue1*Msl@-W$Q(KeK~
    zG}1_N?UPUfX^P=7SY9I(Tgee1j}W_@oARhlnPF)Hv?hSuLH`g=Y=*}cF4PWwXI1Ej
    z0w{27i|4w0n>6dmRZ0Gj$aNiDxVR;ueTSY#k5;2cSFWv`uSQQUTz)R_V&8U)D7L+5
    z>lUwI_b7Twx{U;#DX+R*Bq6aGKQud?E3unvcYW~*G`YPAfI|tYNgSF0qyS`eW{j=khx%J54S^zi)
    zJ)VXGFlDxKiF3d4zCKs%wQ9-fYZ~g
    zrbp`jHv%lEq}V$cV$^dzg(LR=W<;ZZZ7esrQ-Ef!@sJfvCIgC{6-t~ninVK;ojq1gb`wo@Cvi4=_R#KD=;@FX<-|GJIeX47l03%~
    z{jsyZuWsLaTdlS=@s>n&Ro!}iRrS^Ps`@L3!^*+^`5y<)ZF`pE{(&NjGspq{{tcev
    z=D8O+f$QM}UML9h!v#GBJcV^3U5}3a>U;F;*U)2Nzs4RT`!)5L@T(7*hb=vpVQY_d
    z*w$lXWep+wu%pMp!p2bHu(QWG?CNo`xG7XLT-;O4!sbxPu)D{Nutl(jN{2V}Y#8?R
    zc-S{vsBE~rr<{fDp^D+kp332>o+_RTIz?*V5vm@p>8U~7B@~upKs~jBGw2muyAc+O
    z-r{=dgkt#hLJ9nhLZje*OW)H_z#ZX)(ziHaL$LS*oeYPb#^9!*6LL7)7d%5RWXI+3
    z2brV~06TI$KA{Zlma}#%(AH+568;vnScMi_gleHisC~Dfr&aJGy-lct-!5zt>hbl7
    z0Z!QXyL``+7Eb;rG$|qNS7;U*-ZJ!bjO%>9iS1G_GBz3sheJ|ZUwC*pFe0?|3WHL_
    z9~>C4TAv*o3<=&gguRp~4)%^k2E!xL�?DK5Yw(jD#Zrme%dlrOgAuh<`K?IhVGx
    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
    WP{_{NJS-O^_{PG|ok(L#{r>?!PHTw(
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/bdist_rpm.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/bdist_rpm.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..fc0dad89e7d246af5feaa4ab2c4d14ec71e0b50d
    GIT binary patch
    literal 2124
    zcma)7&5smC6tDi6p59?TcELqJg+jh;l9>*m2@+yLTtp141VS{EXs4&UcBY4#?y;(y
    zWrkhi0TVYdS-7|)UOlMmf8gDV7dETeO-D|eki89zXyoLp?wQ#YIar74SM^@~>V5oP
    z^-qOD4#D{G2fOiA2BF`?VmM%(jQ)r4Swb#yC5l>7Rg#1(Q@N#76_6EIrD`kV$P#L4
    z)vSbMbPl7uH2R3p0~!^)82{FKK-=GCIm3w&6=e1(KjI}8HK
    zr%0O-#}D6E$dK~>2`RrxBoT~&xmGOm0YG_K~Vx7Dg9
    z9IR$Lijj@SYA#%Dv3ASWB!qGp#{1U^W1dTJ*dW*?Gj>EnJhHUGQWXTT=F#OD!9A$_|=uD+$)|3O++;?GDEbAdh%H4{b`1;E2P0xLg(=O3DMQGPw~F=7UA2+_HVUPF%P>
    z0fNXNR=Y-taExQm$Coc%6nmr8^YqF%zjbrkfy9i429ij3|4W#bP&m>xMJ=BhuH?#s
    zBj0D1)l?;+In*4oYm2q3Ef0_+6pA~N(bR|1=C`?RQyxllX!CRj8QJOX_91T|ekW)_
    zD%|d!VH!k{w-nUlQ00_mU@ZzW>ro1I#*DOr>#zr@vhhq5iV6-Aon|UQg6S$J1Hjn^
    zAr!xse%iKk4NAZbK;R*<2PGYz>Q)+I*yg89v+jkBs8#__&3314n|#E7)8jlM+&uQ?
    z$&-fSJFHD9UXE`BO#AvL$5wTq0O{@=jXJ|~MJyuD}3*&9TA8U|{SPht0
    zX8?v`1@@umR8Hs&7e&BN=gmgYBBo8r4fA5>5(}Ed3AuUp%BAvj;DR?oIzRP}bvdX7
    zp&3RYz}eKSj3nySAd;{V_$MmIj+@*INqLx!tEZ5tK#tLitt`&XPy*)qc2Y=V|i^YZF
    zn!aa6-*fNvUv%6D81yevi##Nx{tg5nwJ=D=^GN+X`fd_%UYe7p(4y?fb>zq&9Ykne
    zo|Bv6hG&Loj^#nqJXa5mGt}Rezc{P{-n@JTW+{*MG88KqGCOGBld3-vpV
    z`}p0};`v8erSP8gSP@5%HkSMQF#?f`C+TbB%(x0Ir7`F}=1&`XtXr1IfMvxw%W4H~
    zM1`EUtWP4F4m4TIas$V*n20MbS(felL74opIP41MCQ*Ki*rbq?umvBI)Cqy_hUqi(
    zNY*lXZyfE|x2o>#tHsRzKGrk2^pvmzht%X{PHxg?)Bhn)oBSoAfgdR4;u#SSUS*Wk
    zI6K%%u1xE;UwANb=&61>4eu>>7!=|e;KHJ(NRspb?R$VuJVZzDqoaRl2c+B`b*Xr_
    K_ymENK>P#lZXtmH
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/bdist_wheel.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/bdist_wheel.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..a3e67a6c80e3dc7cb61c083ce0c49cc798ca5559
    GIT binary patch
    literal 26247
    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ℜ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
    hdt^rZqb3jUesly4==f`=xdX
    z_a(0!l>3!-MfX>NYJaL-D_A|ttNyOgo-SJNTHe&JEU(6Ee<+zX+f%xC8oe{TH0qrh
    z%r@$u(U3-AIO~L=h@IFMp~Anl2U5hs6~Sjk^Spk`SF!Zh6B>a5mG#6Ayz6B=9oF={
    z9Sw%l=8o^g!x?ky2LAf+n7LQ3^rKk0v}N{7O)TtRMbA@ecJkqL8~YFyyXOZr*&_DK)ui1She0+dvIx0
    zc--9GxpmuqDAq;Xij!DK-w9gH(H&yaiUx5{gjbrE-)<>C=9ePJ-E=lETk$xFVj%+6
    zN_TE)W17*x_({&z@u$wB`Ox~?{P|DH=l81Csk5J+y!h9X7k~S~$0r-VxGPWNv7T{w
    zz<+|rlL2od;O(+k;uWto-mOoMz3k?u1N8k4qK{rjjTUGG^TKV`n|!%nw!U1c3n|TU4C0
    zm54_xovT;B-f1vAnqm0qXkhkwb}(#dY3;lBAK$&Tw8Z>=6!1O|V;1*(#iA6(P4=kA
    z2UtQ0jK24H?GcR)dtCalUbHJkpLIIp;5SpVJDui?9`XGi51A`D%nLV|6Q;I}tl#c&
    z9%8Y|`67`36^pp+3fX5Oiv7N?42s6)Vb*Po;yVr@WSRM0=H!CSJi%4?
    zwU~vRd$i>S54psabkg86>9DR3jDiSqt^tzFkM&#zv|*YnBEXC(80F&FXo?@ApMqzA
    z>-iFVA>?2=x6nAQIV>vz^MEaIN8%#E3o=}o@MsO52J}?>Lwk(jW3bAVHUhTwoS1Ek
    zB=8V676lGagnSU;hVngwMHAQunwZjAeyA<)`k@oBJhd(}U@%RD?9{RZ&iO?qrH7x-
    z(ot~nT$wN_wt&sFT?=f{Z}KMFMsjM{^%2>Z76qklXrt0dkE5!s;EqR#8Yj?8v2QeU
    z>#YjC4dT=3Z1C6?NgO4y-FKo09%{6!o{pU4-2jJYf(a;KFE>a$&eE|ew<^GxcS#$d
    znB%%2Kr9;!(v!S$AnOu@#0dv%GZfna_mCXGmzd>!p@-Vgm4
    z;?CdYHWePI=iRTO;N3Kur+M)44=`}64MoUU3R1u+=eb3o46<-k!
    z1T$4}nPFBQ##A!3-NGvIoz$lTCK*GaWtx~&5=n{5P4bkI4
    z#3B(TB!yD}2-lWKOez1_YFg(qawBn-
    zMKKdkT9uB9Ge~aXr+OV5L0+^_Wjd1Yqac}3la!g6lJhb>NN~~KjbaD~s0w<5U3iMT>%q!CQvH;(%ec$*!2uXbP0QBoRk8y#iJV3YVF;XMhcQIJfwE_yz)jLxKCXosSSSP-|7^5Z+;0HTCN6SYRV
    zjhSb3U{2b;bHwm*!b_fp8W4xA8FG)v|BT(VP
    z<#B3GpczitHnga1OZs3VU!&$tYTlyeA~lQDEK##e4XF+D`G!P>Jd-siaieac`Ox~j
    z_*SL1ceh}jV^8jV^o>u-7xs!(^qjCxoc!hLUU9xs+g~hJ>ie~EGlPH6)GPHDUzx5L
    zcGXL-HfHJDSU17@CBBVG$R}%9jR*AdBg^zpSyvGKeeDgp#YezEHPfou)X+7brsiq%
    zY5V@eJMZ3Ey>ZuGd;Fc7_wU`iv3hIGcroeO7qx5Vi`;ejP0U1&S?V&Hy;7l2_`9|6
    s+&cH%y71h(^3O95KDJK3sFn*$zrOv#!sW$WTqx8(I`eOft~yx%0quHdPyhe`
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/build_clib.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/build_clib.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..eb5447c345a544bccd660043cef0f6cd09bbed79
    GIT binary patch
    literal 3866
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/build_py.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/build_py.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..d3a656e51843ef0a9d80b76fb12a346957af3d8b
    GIT binary patch
    literal 21981
    zcmcJ132+Bq-iulaxe4=ArwF4ojjgTc#9=wqrUD2%

    G!CX4ltctf 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/dist_info.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/dist_info.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ed4626b5af198311b2ee3ff3ee6f82a596f6840b GIT binary patch literal 5198 zcmb^#S!^4}b(Xs%S3E>r))i4+JHF^xq~gRyYR88xIk9VnGHeBj85e7kyCPR!a+%qs zWfBr%6b32>LGAohG7`gbQNRwIBI!o~7yW2@pa{?(F_J-HBLgn#0L`BgrAQ$3qi<%p zq^vOLPlv$Fo0&In-oAVIcfa3*p#AL+@pRFT&_Btdd%eE($wUcZQGg0J|i&+K}EI{$S zYEz~;)=Xia+LCFFwKB+oUPhAt3X&S-)_bhQPpqxr2nC8molb0n8V6N zD#)xPU|E;(MG)GUhCy(KjI(i7$m_D8jS0GJ(c!augcH%xW2d77 z!@@{(`0RcmX(>2NKA`VO{f3+&w&>OJMlNskfdUSij8;5bRX?z^nm(u^`Bo za;lP43<37Z!8nkvbAHX8)hhQ76}Jv)*_{S_Wm3(% zyGKtCM9-WUJuw18-Yrz50IJJqMCTPp8Os}aEaN6HC%lPtt;Pu8=Y1B7+IKHb&mlmwqu|I3OS-Lg_1ZRvPhNV zaIRpsC|Sh-dP-3iwH%2H)TncWT<{t3ft3@s*k)s{v#s6sT5TNftHCx@U(>L<%f_gUa3_1yVcQGb+hOlP zu;HSZ7{waXSM<~pMX1yC5zoX*B2OIELDBL=Y@mE$H`(*(@i7^TGz#)5*|4B4 zYc(N56(o;A;x@!e@-e*xsWQRDoJ=kUWsS*=Yf2V(!9vJ|gLIvIrs>UD!H@)2>t1@u zT_K?pk0&LBAmCmA@iWjByKAv)Bk#|{zTOU=4v{O+S`G-MfH2K1wRg{C-pzd0-v4WS zr*OM4?OpEfoi%Q~b>pqiHXr=>nT75{B*;B(?ReieCzW>`F6}t{iDzNQ$%WS8X@0q9 z^Bi|4a67Qj(?88G@?DR-folifKDZ=oyW_v@pFaM;7kt#St=!XB>gk&vdgm3gf9UN) zOIxAl@c_In=%x0i#FQZNGh(MNn!ncq_4w=D8cFLeTc@Aw}Fg5|)jQefBJwvU1z z1n+HL2>f`OTW%4`E&EF?`|m$rK5(*h;N-%AR~A~L)9$5?r>>994$P)z&(62)1Og4q z!Ogc`yYbqsb2rZ2-S$!BgUEg9kIL_r`)_>enLlu5Avj7SG!{TUCJ(|Esakwkelrgx ztS%-ljzZ1tS5i=?%c6|2hV_txlnhuGC)5S->S(cHAw4F@tGVci9#H84!jS9g?|K{$&)*X|LH_p;0Kl?z{4ODFC=8j z0^C*Xtog)~J5e~MYta1*eRmoC!`rdcy>+&G?uGe|J=4dReSz!zUG9OeZ`s#!ZRG06 z?D4tued*KD2fouQ4$j~IdDEuHO|93D-yM3;^z3p|`;7NpFTr`x6nX4x{_Yz$YHq8$ z`yZVIm!E}?x|rW`1HI^XA%OnWyZtE3{+VR~u3skXfaLl^Wx{yXu7Gl-!5fhIuo_|^ z1)+L2H%@}thGr*;A3RgXcBdGFx5?BiHO8yugpCE>Q7s&F_fH@p*!TX7F#Q8kcU6mz+CljGYHF*k+Q}3=*Ljn*XY{+P38{uHxonIn2hbxSdqV>cM&l%ZY-qOs z?Sp7B=@=(benX=t>v32qso*V6e>Nq{f1gDcs_5Ph|W0yMjt&ddcM zK@*e7;(QiwhcCkY(3ws}CtF?ubL6dPy5k9*L{*yR%uOT{+UZFWD`^-XAq0BJA(D&t zk}E^3l@V)MoDe<+I6AR-+vV}gFe%pFB4OZ%yyo>q=pfzkzH5Q2fifQ~@xeLiXqn~V%@KuDDQROW7}!{K8z%U85WsC`ASq{71h+Ov50v4=@{|iUt<;1` zq{9bDN9t6(lN_Lb?U2N!TZZ3A?3d2NNyvYgXpDY5ew{!9=}6tS#=mH3=ny^+Qr7|-X({}63|h&msljxSK~A=>&7g}*>u0DR**!!U!)b@#s!1t{(R E0(o7zc>n+a literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/easy_install.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/easy_install.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9e44740a557bfc9f48fe0239aea98b83cef0f16c GIT binary patch literal 1558 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 b`3MdE_a_J@Yz9C6{^jA{&5Hk!6rueeJGl18 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/install_egg_info.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/install_egg_info.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b5e19dc59c991fd500163df38866c67ac61e2b61 GIT binary patch literal 3796 zcmahMOKcm*b#}R2E~RBGSrTPMYQ73Iv)Ee1H6XVy0U_=$~}retZ?#%>uH7WF#{hiqnzRm<$_d zGoHAIp>vPMWxR1O;GFE$_>3>^v)6e|$oS*_OjEpxK`iZYuD|_Zp zoR|HwcaDquVB}#G=w;%5m({^0V(;g}&S z4mLjaL+O$+WtdSj2T!Xev}mM;Y3fuon>S|+eI)YQ@hDMEWw?4P5+#b6%bJFvk!aGf zX4KWieX2+{Zyi>3)daR`L6MBCsTw*d^c^5PNYoB@Ak>p*(N=fwJoiL6vI{d5d*O|! zd)aUFUqF`Nh0=RpkkZ2^GcvnY^$Ld4&=dPU*|SzXd5bABY45&mn66cqK7f$;kiEqM zl^afbh`~lxmq*C71Cef~#XTfdG=1pc8tB&2V6~<_aQD0WDe4b333(Lu#_HYxmJ73( zO0aEPAV2_5R1zu%o&SI8>;R|=FJ3#W0udznc194!XDgeA5v5)nUO8Qz|Jj74Lfd#`yrcw{NHm|D^nwdE6=eIw<*k@dG9 z2S@4N*3tfX?pGqFKKgLa)am9p=1 zIpQCG1IOll2VwgEIg;<00ryP$B^RrYjZZgrwAr z%~QOen%KU7)Az6v@Pjf(Ptv<)%tZ zV)>MtN-}3E7N65?dKv(hkOYY~aW|bpMR6)}y?4OW2u|5^(uaqt-R=^)$u9z{R2}kX z0M#UMq%0h{^KwP#-);^poGhJOI9ED%r~O{{-R?^Bz(-Rbr&d!R>#O?1D}R{$-DD*) zzAd(IilMR?T5f;PeZPBM{#5%!`>S|>YU%32JEeE-jNO~KJ5dP?Ziy`m7fKg? zefVD2-LB;;4<_$VF2~j<9`%1d^x07P#G4f{wsoj&q4>+kbTs3EGD_VRa zn^klf(^kRq%F0wO73M4t!AZ*_6BC-m>uT1n!i2sk)ZAGoYJ9MffvR3OcEHqb2u99o zMlzw1(MXjx3LMDW0RA(Jb_CQl_!O~$&~0w3Ex0tgIJ(?lY5VTV$a?$g>4$B989Mt# zckhlD2zGcBXr;liDfX7d-epfk?B5m-EsU4OH-dvJeJi9QjsTDOH*6<@u7TPT(*$5= z6zFbf8-dRPAk^ePbs7g80ld)lwfYZJ`fmdOb)Rv5f9JCx@^{`gm)>1`cX{l=#Qll& z&L_etM<{FY7`j}n$DmgdB#9;*NwS(GDPzbvjpCvt{VbQzsyjYOl8q!RH$#7&#H!uz zT4IhU*zIF5^+()C!K)M;r+_Mrze53SDQsh4TB&V75kjAN4t>FW{~w26pPhi$^Pk%B zu+i7$as66@d58?hZj8^4%lfKJf+sNV;Y5+n&0ZIuSTl> zyzGBg_KRCyiFS0@PQ-p0vNZkEMeIcGIGBIjNyiFyRDSUq&xNzjTaDsz5Jm%n3U+jVnbWrmo1H`D&Y_j7|3)yiFY!Mq5I`LO literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/install_lib.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/install_lib.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..fadbd6cf624f225654c2a0de7030e6e8f6e4311f GIT binary patch literal 6145 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/install_scripts.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/install_scripts.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0d65a6449808ca201610d2c3c887ae9a42bda0e5 GIT binary patch literal 3851 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 GTmJ(rSWasI literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/sdist.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/sdist.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9a2f0284f60a7cae2e2c63be3acfe34ea2d9d182 GIT binary patch literal 12111 zcmbtadvH|OdB1mGx-0E!clAIL5^#k;Xt5p!V#~(7WJ_Qi5D5a?kxiCm@0GM-Upe;* zp^a2ihbB^oR=BZ)JWd9s(`j&=OqfpF@idc}IGst8=^xcbqLOcL$8FqcGt=qFfNO{L zkN&=Mckk{>YsXCw=-(pEQojCMB$pC z2#OdJ;^LqvQrQ->4chpxebCN-9fJ=1+GEbRYtY5pIAUdSX;4Dhskmb9c==#CFPFtC z;+{bd%97%adE=FXmAt(z=8O9yHc^NN2CMj+@>q4eX0S#S)Y`!fN~Kb9Ssbjh2}cCQ zb6HTlYSrl0+;sE5Z`jT9U|_-)^!=J1f}&9oP9&0gSdS(XT0fqhk&$pTfr9izEUaly zhuN=fW=koq>R~0Uhf(S2jcPiJo*ScnzZT5~wV@Lyj~+SN-*YT9aQg8lP8>hp)89LQ z*7jI(I6{qb$$>(PAc%KgMB%f7h<((p`ceAcnxu%|v%QgR(JP#h1z}3G36tVz_B0Bc zzma{I6mmWKu>W7i>c3&TX8WqsiSJ$6>JTRE-NKc!@7u@4pd-Ega5SOF;aE%_ipEq; z9!n@HlbL!Us$qq4B$?1zGM28>RDCR^CzCO)lNyGG&`o6;7U>*j$+1*_(9X&*0mGxB z$3!TVj3#u=aKw^fC1^9slqgGt^eU2IhGt%Bf8er zH}JWR{-mOsrK7!vLno8xl6sdurYBi69P8?|O0np9&{@Wiu-<|`3Byi8ZGLw{c6y! z9$&7-mmBcA0lyoSI<#$6>XA213m3(~O#?!3qv7O7lHNZM4>Min53)WI)7N$XCs10He_jy%Kb?9n5Wr*j~hv*5@S<_o*sw#&;^u#zrI@l$`Q~(L48D^1@ z=mnMYQk%v{qz`w1`u7{6l0J+Ah&;(AWIZXT#&kY@~V~l}OsXgPvaVExa!|9$Q z#LvImaD0?AOadtxp296p*XL06IVBp=pTl9a%gD~0F+2%%7`t~t4JA{0&|wH^M<>&C z?fXbs~p3o8day*VB8v zum5!cU}Woj(6Fl)^(+vvDvWgBy>D1es25Z0K-y>Gg!SSP)N31%acuZS^`Uv~>d@T4 zT;I$6nd(Eo(TKHQ^aaGCdAjfta~1E}0C(4fNnz9idemf-BIbBkq!zTcH7Va>N(Ag@ zQKYcZq!6+M2gWGTVw8Y+P15O%cpBv*KlhY<=PiDwCw#qf{aeNMM)vDPD+#P`nZp^r zQi9txDOV3MhuSGy=^dN2#34?&)(I(8up*R%hq+`fF<(za*+AoNjc*Q$uFSWaq&irm%*#bHgg06l;Qiq2_(Zo

    MURZ$)_S0C}*ty&&nh}VH&#R$AhBeC2 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 GcmE4f7_qwm literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/setopt.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/setopt.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..787694e0b9bf5281adca4c0ee596c10f088119d0 GIT binary patch literal 7092 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/test.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/__pycache__/test.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..01c01b113e9d976abff48db82f3a9543bf385802 GIT binary patch literal 1922 zcmaJ>&2Jk;6rb^~?Tzh(kPiqcqysHYR%+Iw9I8U0s_2IhV4|iXl@Z!(JmX~B{V+4L zNo`dqs&dGG5YF7H@E>sJ!X>B&s#Pi>AtZ7OaeL{BH?xk@G!i5E=eINO&3p6S@4ep! z2TKUnufKRJSMmt`r9KW9e5-}KHvqQ~MHB}p#C437oC|WHQ8%<~1ZJ48=Rvlpxnb4| zIdl`z{05>0W^5b!8dNW~i}t{t`mk|Y_M#}3p7i5Lz-RHZI1Igrg8244lSxa)aUia- z7H18uwBYf`kCq!ayG&yN5H82vMG&^o0|@Zm3_|?0>}%c4Y0YCmbJU3q7m4QwB6`MuTPlD6);wYDk#E*y<1VkjQR?HUg}zMluJW1=U6qpiONnIHIgdG1$&9>^36&l4;(m1{4q4R;*!}8P?KvLbg#bkL z`uyB%Ev77!KEHOuy%jITvMLi9bKeW9PG1WArE04!SK{bH=YtDX;Y&8#3tv=^Qc>-t zqN;*&TJ5y#y2}h$B)RMI5eUYDpSTFHj-C|Do2w6h*tO37VcEZ1_LIuj`#C)L(VydI zp1e8nyj&P4JsU#9JbQc9oX4I4An73^&G`@gXZey zGNQ&$xSj{zqk2JczFwpSKnvJz@gXqkTqzM)^DleHBVo#0TPHk8DiBm$VC zEj#CgvTed<9MI!tGc+d9NJ`tb4cq8cRBmR&m?i=HB*kIp?5!js(`wfh2_$w}QAo5{ z!*BY)l1vi}%i2(@fSu@EQg#A*F38w^o-`C?AqcHQW|*_=km<}`le2d}#L!j9q}Vy0)6}rbK{mC zAe{+KQ|IK#Ik4y|J_8@D3LgdO|K0MpK!r~#I0f*svEQrPk9w?P$N;i3$Sls gjGv tuple[list[str], dict[str, list[str]]]: + """Given values for ``install_requires`` and ``extras_require`` + create modified versions in a way that can be written in ``requires.txt`` + """ + extras = _convert_extras_requirements(extras_require) + return _move_install_requirements_markers(install_requires, extras) + + +def _convert_extras_requirements( + extras_require: Mapping[str, _StrOrIter], +) -> defaultdict[str, _Ordered[Requirement]]: + """ + Convert requirements in `extras_require` of the form + `"extra": ["barbazquux; {marker}"]` to + `"extra:{marker}": ["barbazquux"]`. + """ + output = defaultdict[str, _Ordered[Requirement]](dict) + for section, v in extras_require.items(): + # Do not strip empty sections. + output[section] + for r in _reqs.parse(v): + output[section + _suffix_for(r)].setdefault(r) + + return output + + +def _move_install_requirements_markers( + install_requires: _StrOrIter, extras_require: Mapping[str, _Ordered[Requirement]] +) -> tuple[list[str], dict[str, list[str]]]: + """ + The ``requires.txt`` file has an specific format: + - Environment markers need to be part of the section headers and + should not be part of the requirement spec itself. + + Move requirements in ``install_requires`` that are using environment + markers ``extras_require``. + """ + + # divide the install_requires into two sets, simple ones still + # handled by install_requires and more complex ones handled by extras_require. + + inst_reqs = list(_reqs.parse(install_requires)) + simple_reqs = filter(_no_marker, inst_reqs) + complex_reqs = filterfalse(_no_marker, inst_reqs) + simple_install_requires = list(map(str, simple_reqs)) + + for r in complex_reqs: + extras_require[':' + str(r.marker)].setdefault(r) + + expanded_extras = dict( + # list(dict.fromkeys(...)) ensures a list of unique strings + (k, list(dict.fromkeys(str(r) for r in map(_clean_req, v)))) + for k, v in extras_require.items() + ) + + return simple_install_requires, expanded_extras + + +def _suffix_for(req): + """Return the 'extras_require' suffix for a given requirement.""" + return ':' + str(req.marker) if req.marker else '' + + +def _clean_req(req): + """Given a Requirement, remove environment markers and return it""" + r = Requirement(str(req)) # create a copy before modifying + r.marker = None + return r + + +def _no_marker(req): + return not req.marker + + +def _write_requirements(stream, reqs): + lines = yield_lines(reqs or ()) + + def append_cr(line): + return line + '\n' + + lines = map(append_cr, lines) + stream.writelines(lines) + + +def write_requirements(cmd, basename, filename): + dist = cmd.distribution + data = io.StringIO() + install_requires, extras_require = _prepare( + dist.install_requires or (), dist.extras_require or {} + ) + _write_requirements(data, install_requires) + for extra in sorted(extras_require): + data.write('\n[{extra}]\n'.format(**vars())) + _write_requirements(data, extras_require[extra]) + cmd.write_or_delete_file("requirements", filename, data.getvalue()) + + +def write_setup_requirements(cmd, basename, filename): + data = io.StringIO() + _write_requirements(data, cmd.distribution.setup_requires) + cmd.write_or_delete_file("setup-requirements", filename, data.getvalue()) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/alias.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/alias.py new file mode 100644 index 000000000..b8d74af71 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/alias.py @@ -0,0 +1,77 @@ +from setuptools.command.setopt import config_file, edit_config, option_base + +from distutils.errors import DistutilsOptionError + + +def shquote(arg): + """Quote an argument for later parsing by shlex.split()""" + for c in '"', "'", "\\", "#": + if c in arg: + return repr(arg) + if arg.split() != [arg]: + return repr(arg) + return arg + + +class alias(option_base): + """Define a shortcut that invokes one or more commands""" + + description = "define a shortcut to invoke one or more commands" + command_consumes_arguments = True + + user_options = [ + ('remove', 'r', 'remove (unset) the alias'), + ] + option_base.user_options + + boolean_options = option_base.boolean_options + ['remove'] + + def initialize_options(self): + option_base.initialize_options(self) + self.args = None + self.remove = None + + def finalize_options(self) -> None: + option_base.finalize_options(self) + if self.remove and len(self.args) != 1: + raise DistutilsOptionError( + "Must specify exactly one argument (the alias name) when using --remove" + ) + + def run(self) -> None: + aliases = self.distribution.get_option_dict('aliases') + + if not self.args: + print("Command Aliases") + print("---------------") + for alias in aliases: + print("setup.py alias", format_alias(alias, aliases)) + return + + elif len(self.args) == 1: + (alias,) = self.args + if self.remove: + command = None + elif alias in aliases: + print("setup.py alias", format_alias(alias, aliases)) + return + else: + print(f"No alias definition found for {alias!r}") + return + else: + alias = self.args[0] + command = ' '.join(map(shquote, self.args[1:])) + + edit_config(self.filename, {'aliases': {alias: command}}, self.dry_run) + + +def format_alias(name, aliases): + source, command = aliases[name] + if source == config_file('global'): + source = '--global-config ' + elif source == config_file('user'): + source = '--user-config ' + elif source == config_file('local'): + source = '' + else: + source = f'--filename={source!r}' + return source + name + ' ' + command diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/bdist_egg.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/bdist_egg.py new file mode 100644 index 000000000..b66020c86 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/bdist_egg.py @@ -0,0 +1,477 @@ +"""setuptools.command.bdist_egg + +Build .egg distributions""" + +from __future__ import annotations + +import marshal +import os +import re +import sys +import textwrap +from sysconfig import get_path, get_platform, get_python_version +from types import CodeType +from typing import TYPE_CHECKING, Literal + +from setuptools import Command +from setuptools.extension import Library + +from .._path import StrPathT, ensure_directory + +from distutils import log +from distutils.dir_util import mkpath, remove_tree + +if TYPE_CHECKING: + from typing_extensions import TypeAlias + +# Same as zipfile._ZipFileMode from typeshed +_ZipFileMode: TypeAlias = Literal["r", "w", "x", "a"] + + +def _get_purelib(): + return get_path("purelib") + + +def strip_module(filename): + if '.' in filename: + filename = os.path.splitext(filename)[0] + if filename.endswith('module'): + filename = filename[:-6] + return filename + + +def sorted_walk(dir): + """Do os.walk in a reproducible way, + independent of indeterministic filesystem readdir order + """ + for base, dirs, files in os.walk(dir): + dirs.sort() + files.sort() + yield base, dirs, files + + +def write_stub(resource, pyfile) -> None: + _stub_template = textwrap.dedent( + """ + def __bootstrap__(): + global __bootstrap__, __loader__, __file__ + import sys, importlib.resources as irs, importlib.util + with irs.as_file(irs.files(__name__).joinpath(%r)) as __file__: + __loader__ = None; del __bootstrap__, __loader__ + spec = importlib.util.spec_from_file_location(__name__,__file__) + mod = importlib.util.module_from_spec(spec) + spec.loader.exec_module(mod) + __bootstrap__() + """ + ).lstrip() + with open(pyfile, 'w', encoding="utf-8") as f: + f.write(_stub_template % resource) + + +class bdist_egg(Command): + description = 'create an "egg" distribution' + + user_options = [ + ('bdist-dir=', 'b', "temporary directory for creating the distribution"), + ( + 'plat-name=', + 'p', + "platform name to embed in generated filenames " + "(by default uses `sysconfig.get_platform()`)", + ), + ('exclude-source-files', None, "remove all .py files from the generated egg"), + ( + 'keep-temp', + 'k', + "keep the pseudo-installation tree around after " + "creating the distribution archive", + ), + ('dist-dir=', 'd', "directory to put final built distributions in"), + ('skip-build', None, "skip rebuilding everything (for testing/debugging)"), + ] + + boolean_options = ['keep-temp', 'skip-build', 'exclude-source-files'] + + def initialize_options(self): + self.bdist_dir = None + self.plat_name = None + self.keep_temp = False + self.dist_dir = None + self.skip_build = False + self.egg_output = None + self.exclude_source_files = None + + def finalize_options(self) -> None: + ei_cmd = self.ei_cmd = self.get_finalized_command("egg_info") + self.egg_info = ei_cmd.egg_info + + if self.bdist_dir is None: + bdist_base = self.get_finalized_command('bdist').bdist_base + self.bdist_dir = os.path.join(bdist_base, 'egg') + + if self.plat_name is None: + self.plat_name = get_platform() + + self.set_undefined_options('bdist', ('dist_dir', 'dist_dir')) + + if self.egg_output is None: + # Compute filename of the output egg + basename = ei_cmd._get_egg_basename( + py_version=get_python_version(), + platform=self.distribution.has_ext_modules() and self.plat_name, + ) + + self.egg_output = os.path.join(self.dist_dir, basename + '.egg') + + def do_install_data(self) -> None: + # Hack for packages that install data to install's --install-lib + self.get_finalized_command('install').install_lib = self.bdist_dir + + site_packages = os.path.normcase(os.path.realpath(_get_purelib())) + old, self.distribution.data_files = self.distribution.data_files, [] + + for item in old: + if isinstance(item, tuple) and len(item) == 2: + if os.path.isabs(item[0]): + realpath = os.path.realpath(item[0]) + normalized = os.path.normcase(realpath) + if normalized == site_packages or normalized.startswith( + site_packages + os.sep + ): + item = realpath[len(site_packages) + 1 :], item[1] + # XXX else: raise ??? + self.distribution.data_files.append(item) + + try: + log.info("installing package data to %s", self.bdist_dir) + self.call_command('install_data', force=False, root=None) + finally: + self.distribution.data_files = old + + def get_outputs(self): + return [self.egg_output] + + def call_command(self, cmdname, **kw): + """Invoke reinitialized command `cmdname` with keyword args""" + for dirname in INSTALL_DIRECTORY_ATTRS: + kw.setdefault(dirname, self.bdist_dir) + kw.setdefault('skip_build', self.skip_build) + kw.setdefault('dry_run', self.dry_run) + cmd = self.reinitialize_command(cmdname, **kw) + self.run_command(cmdname) + return cmd + + def run(self): # noqa: C901 # is too complex (14) # FIXME + # Generate metadata first + self.run_command("egg_info") + # We run install_lib before install_data, because some data hacks + # pull their data path from the install_lib command. + log.info("installing library code to %s", self.bdist_dir) + instcmd = self.get_finalized_command('install') + old_root = instcmd.root + instcmd.root = None + if self.distribution.has_c_libraries() and not self.skip_build: + self.run_command('build_clib') + cmd = self.call_command('install_lib', warn_dir=False) + instcmd.root = old_root + + all_outputs, ext_outputs = self.get_ext_outputs() + self.stubs = [] + to_compile = [] + for p, ext_name in enumerate(ext_outputs): + filename, _ext = os.path.splitext(ext_name) + pyfile = os.path.join(self.bdist_dir, strip_module(filename) + '.py') + self.stubs.append(pyfile) + log.info("creating stub loader for %s", ext_name) + if not self.dry_run: + write_stub(os.path.basename(ext_name), pyfile) + to_compile.append(pyfile) + ext_outputs[p] = ext_name.replace(os.sep, '/') + + if to_compile: + cmd.byte_compile(to_compile) + if self.distribution.data_files: + self.do_install_data() + + # Make the EGG-INFO directory + archive_root = self.bdist_dir + egg_info = os.path.join(archive_root, 'EGG-INFO') + self.mkpath(egg_info) + if self.distribution.scripts: + script_dir = os.path.join(egg_info, 'scripts') + log.info("installing scripts to %s", script_dir) + self.call_command('install_scripts', install_dir=script_dir, no_ep=True) + + self.copy_metadata_to(egg_info) + native_libs = os.path.join(egg_info, "native_libs.txt") + if all_outputs: + log.info("writing %s", native_libs) + if not self.dry_run: + ensure_directory(native_libs) + with open(native_libs, 'wt', encoding="utf-8") as libs_file: + libs_file.write('\n'.join(all_outputs)) + libs_file.write('\n') + elif os.path.isfile(native_libs): + log.info("removing %s", native_libs) + if not self.dry_run: + os.unlink(native_libs) + + write_safety_flag(os.path.join(archive_root, 'EGG-INFO'), self.zip_safe()) + + if os.path.exists(os.path.join(self.egg_info, 'depends.txt')): + log.warn( + "WARNING: 'depends.txt' will not be used by setuptools 0.6!\n" + "Use the install_requires/extras_require setup() args instead." + ) + + if self.exclude_source_files: + self.zap_pyfiles() + + # Make the archive + make_zipfile( + self.egg_output, + archive_root, + verbose=self.verbose, + dry_run=self.dry_run, + mode=self.gen_header(), + ) + if not self.keep_temp: + remove_tree(self.bdist_dir, dry_run=self.dry_run) + + # Add to 'Distribution.dist_files' so that the "upload" command works + getattr(self.distribution, 'dist_files', []).append(( + 'bdist_egg', + get_python_version(), + self.egg_output, + )) + + def zap_pyfiles(self): + log.info("Removing .py files from temporary directory") + for base, dirs, files in walk_egg(self.bdist_dir): + for name in files: + path = os.path.join(base, name) + + if name.endswith('.py'): + log.debug("Deleting %s", path) + os.unlink(path) + + if base.endswith('__pycache__'): + path_old = path + + pattern = r'(?P.+)\.(?P[^.]+)\.pyc' + m = re.match(pattern, name) + path_new = os.path.join(base, os.pardir, m.group('name') + '.pyc') + log.info(f"Renaming file from [{path_old}] to [{path_new}]") + try: + os.remove(path_new) + except OSError: + pass + os.rename(path_old, path_new) + + def zip_safe(self): + safe = getattr(self.distribution, 'zip_safe', None) + if safe is not None: + return safe + log.warn("zip_safe flag not set; analyzing archive contents...") + return analyze_egg(self.bdist_dir, self.stubs) + + def gen_header(self) -> Literal["w"]: + return 'w' + + def copy_metadata_to(self, target_dir) -> None: + "Copy metadata (egg info) to the target_dir" + # normalize the path (so that a forward-slash in egg_info will + # match using startswith below) + norm_egg_info = os.path.normpath(self.egg_info) + prefix = os.path.join(norm_egg_info, '') + for path in self.ei_cmd.filelist.files: + if path.startswith(prefix): + target = os.path.join(target_dir, path[len(prefix) :]) + ensure_directory(target) + self.copy_file(path, target) + + def get_ext_outputs(self): + """Get a list of relative paths to C extensions in the output distro""" + + all_outputs = [] + ext_outputs = [] + + paths = {self.bdist_dir: ''} + for base, dirs, files in sorted_walk(self.bdist_dir): + all_outputs.extend( + paths[base] + filename + for filename in files + if os.path.splitext(filename)[1].lower() in NATIVE_EXTENSIONS + ) + for filename in dirs: + paths[os.path.join(base, filename)] = paths[base] + filename + '/' + + if self.distribution.has_ext_modules(): + build_cmd = self.get_finalized_command('build_ext') + for ext in build_cmd.extensions: + if isinstance(ext, Library): + continue + fullname = build_cmd.get_ext_fullname(ext.name) + filename = build_cmd.get_ext_filename(fullname) + if not os.path.basename(filename).startswith('dl-'): + if os.path.exists(os.path.join(self.bdist_dir, filename)): + ext_outputs.append(filename) + + return all_outputs, ext_outputs + + +NATIVE_EXTENSIONS: dict[str, None] = dict.fromkeys('.dll .so .dylib .pyd'.split()) + + +def walk_egg(egg_dir): + """Walk an unpacked egg's contents, skipping the metadata directory""" + walker = sorted_walk(egg_dir) + base, dirs, files = next(walker) + if 'EGG-INFO' in dirs: + dirs.remove('EGG-INFO') + yield base, dirs, files + yield from walker + + +def analyze_egg(egg_dir, stubs): + # check for existing flag in EGG-INFO + for flag, fn in safety_flags.items(): + if os.path.exists(os.path.join(egg_dir, 'EGG-INFO', fn)): + return flag + if not can_scan(): + return False + safe = True + for base, dirs, files in walk_egg(egg_dir): + for name in files: + if name.endswith('.py') or name.endswith('.pyw'): + continue + elif name.endswith('.pyc') or name.endswith('.pyo'): + # always scan, even if we already know we're not safe + safe = scan_module(egg_dir, base, name, stubs) and safe + return safe + + +def write_safety_flag(egg_dir, safe) -> None: + # Write or remove zip safety flag file(s) + for flag, fn in safety_flags.items(): + fn = os.path.join(egg_dir, fn) + if os.path.exists(fn): + if safe is None or bool(safe) != flag: + os.unlink(fn) + elif safe is not None and bool(safe) == flag: + with open(fn, 'wt', encoding="utf-8") as f: + f.write('\n') + + +safety_flags = { + True: 'zip-safe', + False: 'not-zip-safe', +} + + +def scan_module(egg_dir, base, name, stubs): + """Check whether module possibly uses unsafe-for-zipfile stuff""" + + filename = os.path.join(base, name) + if filename[:-1] in stubs: + return True # Extension module + pkg = base[len(egg_dir) + 1 :].replace(os.sep, '.') + module = pkg + (pkg and '.' or '') + os.path.splitext(name)[0] + skip = 16 # skip magic & reserved? & date & file size + f = open(filename, 'rb') + f.read(skip) + code = marshal.load(f) + f.close() + safe = True + symbols = dict.fromkeys(iter_symbols(code)) + for bad in ['__file__', '__path__']: + if bad in symbols: + log.warn("%s: module references %s", module, bad) + safe = False + if 'inspect' in symbols: + for bad in [ + 'getsource', + 'getabsfile', + 'getfile', + 'getsourcefile', + 'getsourcelines', + 'findsource', + 'getcomments', + 'getframeinfo', + 'getinnerframes', + 'getouterframes', + 'stack', + 'trace', + ]: + if bad in symbols: + log.warn("%s: module MAY be using inspect.%s", module, bad) + safe = False + return safe + + +def iter_symbols(code): + """Yield names and strings used by `code` and its nested code objects""" + yield from code.co_names + for const in code.co_consts: + if isinstance(const, str): + yield const + elif isinstance(const, CodeType): + yield from iter_symbols(const) + + +def can_scan() -> bool: + if not sys.platform.startswith('java') and sys.platform != 'cli': + # CPython, PyPy, etc. + return True + log.warn("Unable to analyze compiled code on this platform.") + log.warn( + "Please ask the author to include a 'zip_safe'" + " setting (either True or False) in the package's setup.py" + ) + return False + + +# Attribute names of options for commands that might need to be convinced to +# install to the egg build directory + +INSTALL_DIRECTORY_ATTRS = ['install_lib', 'install_dir', 'install_data', 'install_base'] + + +def make_zipfile( + zip_filename: StrPathT, + base_dir, + verbose: bool = False, + dry_run: bool = False, + compress=True, + mode: _ZipFileMode = 'w', +) -> StrPathT: + """Create a zip file from all the files under 'base_dir'. The output + zip file will be named 'base_dir' + ".zip". Uses either the "zipfile" + Python module (if available) or the InfoZIP "zip" utility (if installed + and found on the default search path). If neither tool is available, + raises DistutilsExecError. Returns the name of the output zip file. + """ + import zipfile + + mkpath(os.path.dirname(zip_filename), dry_run=dry_run) # type: ignore[arg-type] # python/mypy#18075 + log.info("creating '%s' and adding '%s' to it", zip_filename, base_dir) + + def visit(z, dirname, names): + for name in names: + path = os.path.normpath(os.path.join(dirname, name)) + if os.path.isfile(path): + p = path[len(base_dir) + 1 :] + if not dry_run: + z.write(path, p) + log.debug("adding '%s'", p) + + compression = zipfile.ZIP_DEFLATED if compress else zipfile.ZIP_STORED + if not dry_run: + z = zipfile.ZipFile(zip_filename, mode, compression=compression) + for dirname, dirs, files in sorted_walk(base_dir): + visit(z, dirname, files) + z.close() + else: + for dirname, dirs, files in sorted_walk(base_dir): + visit(None, dirname, files) + return zip_filename diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/bdist_rpm.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/bdist_rpm.py new file mode 100644 index 000000000..6dbb27002 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/bdist_rpm.py @@ -0,0 +1,42 @@ +from ..dist import Distribution +from ..warnings import SetuptoolsDeprecationWarning + +import distutils.command.bdist_rpm as orig + + +class bdist_rpm(orig.bdist_rpm): + """ + Override the default bdist_rpm behavior to do the following: + + 1. Run egg_info to ensure the name and version are properly calculated. + 2. Always run 'install' using --single-version-externally-managed to + disable eggs in RPM distributions. + """ + + distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution + + def run(self) -> None: + SetuptoolsDeprecationWarning.emit( + "Deprecated command", + """ + bdist_rpm is deprecated and will be removed in a future version. + Use bdist_wheel (wheel packages) instead. + """, + see_url="https://github.com/pypa/setuptools/issues/1988", + due_date=(2023, 10, 30), # Deprecation introduced in 22 Oct 2021. + ) + + # ensure distro name is up-to-date + self.run_command('egg_info') + + orig.bdist_rpm.run(self) + + def _make_spec_file(self): + spec = orig.bdist_rpm._make_spec_file(self) + return [ + line.replace( + "setup.py install ", + "setup.py install --single-version-externally-managed ", + ).replace("%setup", "%setup -n %{name}-%{unmangled_version}") + for line in spec + ] diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/bdist_wheel.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/bdist_wheel.py new file mode 100644 index 000000000..91ed00170 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/bdist_wheel.py @@ -0,0 +1,604 @@ +""" +Create a wheel (.whl) distribution. + +A wheel is a built archive format. +""" + +from __future__ import annotations + +import os +import re +import shutil +import struct +import sys +import sysconfig +import warnings +from collections.abc import Iterable, Sequence +from email.generator import BytesGenerator +from glob import iglob +from typing import Literal, cast +from zipfile import ZIP_DEFLATED, ZIP_STORED + +from packaging import tags, version as _packaging_version +from wheel.wheelfile import WheelFile + +from .. import Command, __version__, _shutil +from .._core_metadata import _safe_license_file +from .._normalization import safer_name +from ..warnings import SetuptoolsDeprecationWarning +from .egg_info import egg_info as egg_info_cls + +from distutils import log + + +def safe_version(version: str) -> 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) + + +setuptools_major_version = int(__version__.split(".")[0]) + +PY_LIMITED_API_PATTERN = r"cp3\d" + + +def _is_32bit_interpreter() -> bool: + return struct.calcsize("P") == 4 + + +def python_tag() -> str: + return f"py{sys.version_info.major}" + + +def get_platform(archive_root: str | None) -> str: + """Return our platform name 'win32', 'linux_x86_64'""" + result = sysconfig.get_platform() + if result.startswith("macosx") and archive_root is not None: # pragma: no cover + from wheel.macosx_libfile import calculate_macosx_platform_tag + + result = calculate_macosx_platform_tag(archive_root, result) + elif _is_32bit_interpreter(): + if result == "linux-x86_64": + # pip pull request #3497 + result = "linux-i686" + elif result == "linux-aarch64": + # packaging pull request #234 + # TODO armv8l, packaging pull request #690 => this did not land + # in pip/packaging yet + result = "linux-armv7l" + + return result.replace("-", "_") + + +def get_flag( + var: str, fallback: bool, expected: bool = True, warn: bool = True +) -> bool: + """Use a fallback value for determining SOABI flags if the needed config + var is unset or unavailable.""" + val = sysconfig.get_config_var(var) + if val is None: + if warn: + warnings.warn( + f"Config variable '{var}' is unset, Python ABI tag may be incorrect", + RuntimeWarning, + stacklevel=2, + ) + return fallback + return val == expected + + +def get_abi_tag() -> str | None: + """Return the ABI tag based on SOABI (if available) or emulate SOABI (PyPy2).""" + soabi: str = sysconfig.get_config_var("SOABI") + impl = tags.interpreter_name() + if not soabi and impl in ("cp", "pp") and hasattr(sys, "maxunicode"): + d = "" + u = "" + if get_flag("Py_DEBUG", hasattr(sys, "gettotalrefcount"), warn=(impl == "cp")): + d = "d" + + abi = f"{impl}{tags.interpreter_version()}{d}{u}" + elif soabi and impl == "cp" and soabi.startswith("cpython"): + # non-Windows + abi = "cp" + soabi.split("-")[1] + elif soabi and impl == "cp" and soabi.startswith("cp"): + # Windows + abi = soabi.split("-")[0] + if hasattr(sys, "gettotalrefcount"): + # using debug build; append "d" flag + abi += "d" + elif soabi and impl == "pp": + # we want something like pypy36-pp73 + abi = "-".join(soabi.split("-")[:2]) + abi = abi.replace(".", "_").replace("-", "_") + elif soabi and impl == "graalpy": + abi = "-".join(soabi.split("-")[:3]) + abi = abi.replace(".", "_").replace("-", "_") + elif soabi: + abi = soabi.replace(".", "_").replace("-", "_") + else: + abi = None + + return abi + + +def safer_version(version: str) -> str: + return safe_version(version).replace("-", "_") + + +class bdist_wheel(Command): + description = "create a wheel distribution" + + supported_compressions = { + "stored": ZIP_STORED, + "deflated": ZIP_DEFLATED, + } + + user_options = [ + ("bdist-dir=", "b", "temporary directory for creating the distribution"), + ( + "plat-name=", + "p", + "platform name to embed in generated filenames " + f"[default: {get_platform(None)}]", + ), + ( + "keep-temp", + "k", + "keep the pseudo-installation tree around after " + "creating the distribution archive", + ), + ("dist-dir=", "d", "directory to put final built distributions in"), + ("skip-build", None, "skip rebuilding everything (for testing/debugging)"), + ( + "relative", + None, + "build the archive using relative paths [default: false]", + ), + ( + "owner=", + "u", + "Owner name used when creating a tar file [default: current user]", + ), + ( + "group=", + "g", + "Group name used when creating a tar file [default: current group]", + ), + ("universal", None, "*DEPRECATED* make a universal wheel [default: false]"), + ( + "compression=", + None, + f"zipfile compression (one of: {', '.join(supported_compressions)}) [default: 'deflated']", + ), + ( + "python-tag=", + None, + f"Python implementation compatibility tag [default: '{python_tag()}']", + ), + ( + "build-number=", + None, + "Build number for this particular version. " + "As specified in PEP-0427, this must start with a digit. " + "[default: None]", + ), + ( + "py-limited-api=", + None, + "Python tag (cp32|cp33|cpNN) for abi3 wheel tag [default: false]", + ), + ( + "dist-info-dir=", + None, + "directory where a pre-generated dist-info can be found (e.g. as a " + "result of calling the PEP517 'prepare_metadata_for_build_wheel' " + "method)", + ), + ] + + boolean_options = ["keep-temp", "skip-build", "relative", "universal"] + + def initialize_options(self) -> None: + self.bdist_dir: str | None = None + self.data_dir = "" + self.plat_name: str | None = None + self.plat_tag: str | None = None + self.format = "zip" + self.keep_temp = False + self.dist_dir: str | None = None + self.dist_info_dir = None + self.egginfo_dir: str | None = None + self.root_is_pure: bool | None = None + self.skip_build = False + self.relative = False + self.owner = None + self.group = None + self.universal = False + self.compression: str | int = "deflated" + self.python_tag = python_tag() + self.build_number: str | None = None + self.py_limited_api: str | Literal[False] = False + self.plat_name_supplied = False + + def finalize_options(self) -> None: + if not self.bdist_dir: + bdist_base = self.get_finalized_command("bdist").bdist_base + self.bdist_dir = os.path.join(bdist_base, "wheel") + + if self.dist_info_dir is None: + egg_info = cast(egg_info_cls, self.distribution.get_command_obj("egg_info")) + egg_info.ensure_finalized() # needed for correct `wheel_dist_name` + + self.data_dir = self.wheel_dist_name + ".data" + self.plat_name_supplied = bool(self.plat_name) + + need_options = ("dist_dir", "plat_name", "skip_build") + + self.set_undefined_options("bdist", *zip(need_options, need_options)) + + self.root_is_pure = not ( + self.distribution.has_ext_modules() or self.distribution.has_c_libraries() + ) + + self._validate_py_limited_api() + + # Support legacy [wheel] section for setting universal + wheel = self.distribution.get_option_dict("wheel") + if "universal" in wheel: # pragma: no cover + # please don't define this in your global configs + log.warn("The [wheel] section is deprecated. Use [bdist_wheel] instead.") + val = wheel["universal"][1].strip() + if val.lower() in ("1", "true", "yes"): + self.universal = True + + if self.universal: + SetuptoolsDeprecationWarning.emit( + "bdist_wheel.universal is deprecated", + """ + With Python 2.7 end-of-life, support for building universal wheels + (i.e., wheels that support both Python 2 and Python 3) + is being obviated. + Please discontinue using this option, or if you still need it, + file an issue with pypa/setuptools describing your use case. + """, + due_date=(2025, 8, 30), # Introduced in 2024-08-30 + ) + + if self.build_number is not None and not self.build_number[:1].isdigit(): + raise ValueError("Build tag (build-number) must start with a digit.") + + def _validate_py_limited_api(self) -> None: + if not self.py_limited_api: + return + + if not re.match(PY_LIMITED_API_PATTERN, self.py_limited_api): + raise ValueError(f"py-limited-api must match '{PY_LIMITED_API_PATTERN}'") + + if sysconfig.get_config_var("Py_GIL_DISABLED"): + raise ValueError( + f"`py_limited_api={self.py_limited_api!r}` not supported. " + "`Py_LIMITED_API` is currently incompatible with " + "`Py_GIL_DISABLED`. " + "See https://github.com/python/cpython/issues/111506." + ) + + @property + def wheel_dist_name(self) -> str: + """Return distribution full name with - replaced with _""" + components = [ + safer_name(self.distribution.get_name()), + safer_version(self.distribution.get_version()), + ] + if self.build_number: + components.append(self.build_number) + return "-".join(components) + + def get_tag(self) -> tuple[str, str, str]: + # bdist sets self.plat_name if unset, we should only use it for purepy + # wheels if the user supplied it. + if self.plat_name_supplied and self.plat_name: + plat_name = self.plat_name + elif self.root_is_pure: + plat_name = "any" + else: + # macosx contains system version in platform name so need special handle + if self.plat_name and not self.plat_name.startswith("macosx"): + plat_name = self.plat_name + else: + # on macosx always limit the platform name to comply with any + # c-extension modules in bdist_dir, since the user can specify + # a higher MACOSX_DEPLOYMENT_TARGET via tools like CMake + + # on other platforms, and on macosx if there are no c-extension + # modules, use the default platform name. + plat_name = get_platform(self.bdist_dir) + + if _is_32bit_interpreter(): + if plat_name in ("linux-x86_64", "linux_x86_64"): + plat_name = "linux_i686" + if plat_name in ("linux-aarch64", "linux_aarch64"): + # TODO armv8l, packaging pull request #690 => this did not land + # in pip/packaging yet + plat_name = "linux_armv7l" + + plat_name = ( + plat_name.lower().replace("-", "_").replace(".", "_").replace(" ", "_") + ) + + if self.root_is_pure: + if self.universal: + impl = "py2.py3" + else: + impl = self.python_tag + tag = (impl, "none", plat_name) + else: + impl_name = tags.interpreter_name() + impl_ver = tags.interpreter_version() + impl = impl_name + impl_ver + # We don't work on CPython 3.1, 3.0. + if self.py_limited_api and (impl_name + impl_ver).startswith("cp3"): + impl = self.py_limited_api + abi_tag = "abi3" + else: + abi_tag = str(get_abi_tag()).lower() + tag = (impl, abi_tag, plat_name) + # issue gh-374: allow overriding plat_name + supported_tags = [ + (t.interpreter, t.abi, plat_name) for t in tags.sys_tags() + ] + assert tag in supported_tags, ( + f"would build wheel with unsupported tag {tag}" + ) + return tag + + def run(self): + build_scripts = self.reinitialize_command("build_scripts") + build_scripts.executable = "python" + build_scripts.force = True + + build_ext = self.reinitialize_command("build_ext") + build_ext.inplace = False + + if not self.skip_build: + self.run_command("build") + + install = self.reinitialize_command("install", reinit_subcommands=True) + install.root = self.bdist_dir + install.compile = False + install.skip_build = self.skip_build + install.warn_dir = False + + # A wheel without setuptools scripts is more cross-platform. + # Use the (undocumented) `no_ep` option to setuptools' + # install_scripts command to avoid creating entry point scripts. + install_scripts = self.reinitialize_command("install_scripts") + install_scripts.no_ep = True + + # Use a custom scheme for the archive, because we have to decide + # at installation time which scheme to use. + for key in ("headers", "scripts", "data", "purelib", "platlib"): + setattr(install, "install_" + key, os.path.join(self.data_dir, key)) + + basedir_observed = "" + + if os.name == "nt": + # win32 barfs if any of these are ''; could be '.'? + # (distutils.command.install:change_roots bug) + basedir_observed = os.path.normpath(os.path.join(self.data_dir, "..")) + self.install_libbase = self.install_lib = basedir_observed + + setattr( + install, + "install_purelib" if self.root_is_pure else "install_platlib", + basedir_observed, + ) + + log.info(f"installing to {self.bdist_dir}") + + self.run_command("install") + + impl_tag, abi_tag, plat_tag = self.get_tag() + archive_basename = f"{self.wheel_dist_name}-{impl_tag}-{abi_tag}-{plat_tag}" + if not self.relative: + archive_root = self.bdist_dir + else: + archive_root = os.path.join( + self.bdist_dir, self._ensure_relative(install.install_base) + ) + + self.set_undefined_options("install_egg_info", ("target", "egginfo_dir")) + distinfo_dirname = ( + f"{safer_name(self.distribution.get_name())}-" + f"{safer_version(self.distribution.get_version())}.dist-info" + ) + distinfo_dir = os.path.join(self.bdist_dir, distinfo_dirname) + if self.dist_info_dir: + # Use the given dist-info directly. + log.debug(f"reusing {self.dist_info_dir}") + shutil.copytree(self.dist_info_dir, distinfo_dir) + # Egg info is still generated, so remove it now to avoid it getting + # copied into the wheel. + _shutil.rmtree(self.egginfo_dir) + else: + # Convert the generated egg-info into dist-info. + self.egg2dist(self.egginfo_dir, distinfo_dir) + + self.write_wheelfile(distinfo_dir) + + # Make the archive + if not os.path.exists(self.dist_dir): + os.makedirs(self.dist_dir) + + wheel_path = os.path.join(self.dist_dir, archive_basename + ".whl") + with WheelFile(wheel_path, "w", self._zip_compression()) as wf: + wf.write_files(archive_root) + + # Add to 'Distribution.dist_files' so that the "upload" command works + getattr(self.distribution, "dist_files", []).append(( + "bdist_wheel", + f"{sys.version_info.major}.{sys.version_info.minor}", + wheel_path, + )) + + if not self.keep_temp: + log.info(f"removing {self.bdist_dir}") + if not self.dry_run: + _shutil.rmtree(self.bdist_dir) + + def write_wheelfile( + self, wheelfile_base: str, generator: str = f"setuptools ({__version__})" + ) -> None: + from email.message import Message + + msg = Message() + msg["Wheel-Version"] = "1.0" # of the spec + msg["Generator"] = generator + msg["Root-Is-Purelib"] = str(self.root_is_pure).lower() + if self.build_number is not None: + msg["Build"] = self.build_number + + # Doesn't work for bdist_wininst + impl_tag, abi_tag, plat_tag = self.get_tag() + for impl in impl_tag.split("."): + for abi in abi_tag.split("."): + for plat in plat_tag.split("."): + msg["Tag"] = "-".join((impl, abi, plat)) + + wheelfile_path = os.path.join(wheelfile_base, "WHEEL") + log.info(f"creating {wheelfile_path}") + with open(wheelfile_path, "wb") as f: + BytesGenerator(f, maxheaderlen=0).flatten(msg) + + def _ensure_relative(self, path: str) -> str: + # copied from dir_util, deleted + drive, path = os.path.splitdrive(path) + if path[0:1] == os.sep: + path = drive + path[1:] + return path + + @property + def license_paths(self) -> Iterable[str]: + if setuptools_major_version >= 57: + # Setuptools has resolved any patterns to actual file names + return self.distribution.metadata.license_files or () + + files = set[str]() + metadata = self.distribution.get_option_dict("metadata") + if setuptools_major_version >= 42: + # Setuptools recognizes the license_files option but does not do globbing + patterns = cast(Sequence[str], self.distribution.metadata.license_files) + else: + # Prior to those, wheel is entirely responsible for handling license files + if "license_files" in metadata: + patterns = metadata["license_files"][1].split() + else: + patterns = () + + if "license_file" in metadata: + warnings.warn( + 'The "license_file" option is deprecated. Use "license_files" instead.', + DeprecationWarning, + stacklevel=2, + ) + files.add(metadata["license_file"][1]) + + if not files and not patterns and not isinstance(patterns, list): + patterns = ("LICEN[CS]E*", "COPYING*", "NOTICE*", "AUTHORS*") + + for pattern in patterns: + for path in iglob(pattern): + if path.endswith("~"): + log.debug( + f'ignoring license file "{path}" as it looks like a backup' + ) + continue + + if path not in files and os.path.isfile(path): + log.info( + f'adding license file "{path}" (matched pattern "{pattern}")' + ) + files.add(path) + + return files + + def egg2dist(self, egginfo_path: str, distinfo_path: str) -> None: + """Convert an .egg-info directory into a .dist-info directory""" + + def adios(p: str) -> None: + """Appropriately delete directory, file or link.""" + if os.path.exists(p) and not os.path.islink(p) and os.path.isdir(p): + _shutil.rmtree(p) + elif os.path.exists(p): + os.unlink(p) + + adios(distinfo_path) + + if not os.path.exists(egginfo_path): + # There is no egg-info. This is probably because the egg-info + # file/directory is not named matching the distribution name used + # to name the archive file. Check for this case and report + # accordingly. + import glob + + pat = os.path.join(os.path.dirname(egginfo_path), "*.egg-info") + possible = glob.glob(pat) + err = f"Egg metadata expected at {egginfo_path} but not found" + if possible: + alt = os.path.basename(possible[0]) + err += f" ({alt} found - possible misnamed archive file?)" + + raise ValueError(err) + + # .egg-info is a directory + pkginfo_path = os.path.join(egginfo_path, "PKG-INFO") + + # ignore common egg metadata that is useless to wheel + shutil.copytree( + egginfo_path, + distinfo_path, + ignore=lambda x, y: { + "PKG-INFO", + "requires.txt", + "SOURCES.txt", + "not-zip-safe", + }, + ) + + # delete dependency_links if it is only whitespace + dependency_links_path = os.path.join(distinfo_path, "dependency_links.txt") + with open(dependency_links_path, encoding="utf-8") as dependency_links_file: + dependency_links = dependency_links_file.read().strip() + if not dependency_links: + adios(dependency_links_path) + + metadata_path = os.path.join(distinfo_path, "METADATA") + shutil.copy(pkginfo_path, metadata_path) + + licenses_folder_path = os.path.join(distinfo_path, "licenses") + for license_path in self.license_paths: + safe_path = _safe_license_file(license_path) + dist_info_license_path = os.path.join(licenses_folder_path, safe_path) + os.makedirs(os.path.dirname(dist_info_license_path), exist_ok=True) + shutil.copy(license_path, dist_info_license_path) + + adios(egginfo_path) + + def _zip_compression(self) -> int: + if ( + isinstance(self.compression, int) + and self.compression in self.supported_compressions.values() + ): + return self.compression + + compression = self.supported_compressions.get(str(self.compression)) + if compression is not None: + return compression + + raise ValueError(f"Unsupported compression: {self.compression!r}") diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build.py new file mode 100644 index 000000000..54cbb8d2e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build.py @@ -0,0 +1,135 @@ +from __future__ import annotations + +from typing import Protocol + +from ..dist import Distribution + +from distutils.command.build import build as _build + +_ORIGINAL_SUBCOMMANDS = {"build_py", "build_clib", "build_ext", "build_scripts"} + + +class build(_build): + distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution + + # copy to avoid sharing the object with parent class + sub_commands = _build.sub_commands[:] + + +class SubCommand(Protocol): + """In order to support editable installations (see :pep:`660`) all + build subcommands **SHOULD** implement this protocol. They also **MUST** inherit + from ``setuptools.Command``. + + When creating an :pep:`editable wheel <660>`, ``setuptools`` will try to evaluate + custom ``build`` subcommands using the following procedure: + + 1. ``setuptools`` will set the ``editable_mode`` attribute to ``True`` + 2. ``setuptools`` will execute the ``run()`` command. + + .. important:: + Subcommands **SHOULD** take advantage of ``editable_mode=True`` to adequate + its behaviour or perform optimisations. + + For example, if a subcommand doesn't need to generate an extra file and + all it does is to copy a source file into the build directory, + ``run()`` **SHOULD** simply "early return". + + Similarly, if the subcommand creates files that would be placed alongside + Python files in the final distribution, during an editable install + the command **SHOULD** generate these files "in place" (i.e. write them to + the original source directory, instead of using the build directory). + Note that ``get_output_mapping()`` should reflect that and include mappings + for "in place" builds accordingly. + + 3. ``setuptools`` use any knowledge it can derive from the return values of + ``get_outputs()`` and ``get_output_mapping()`` to create an editable wheel. + When relevant ``setuptools`` **MAY** attempt to use file links based on the value + of ``get_output_mapping()``. Alternatively, ``setuptools`` **MAY** attempt to use + :doc:`import hooks ` to redirect any attempt to import + to the directory with the original source code and other files built in place. + + Please note that custom sub-commands **SHOULD NOT** rely on ``run()`` being + executed (or not) to provide correct return values for ``get_outputs()``, + ``get_output_mapping()`` or ``get_source_files()``. The ``get_*`` methods should + work independently of ``run()``. + """ + + editable_mode: bool = False + """Boolean flag that will be set to ``True`` when setuptools is used for an + editable installation (see :pep:`660`). + Implementations **SHOULD** explicitly set the default value of this attribute to + ``False``. + When subcommands run, they can use this flag to perform optimizations or change + their behaviour accordingly. + """ + + build_lib: str + """String representing the directory where the build artifacts should be stored, + e.g. ``build/lib``. + For example, if a distribution wants to provide a Python module named ``pkg.mod``, + then a corresponding file should be written to ``{build_lib}/package/module.py``. + A way of thinking about this is that the files saved under ``build_lib`` + would be eventually copied to one of the directories in :obj:`site.PREFIXES` + upon installation. + + A command that produces platform-independent files (e.g. compiling text templates + into Python functions), **CAN** initialize ``build_lib`` by copying its value from + the ``build_py`` command. On the other hand, a command that produces + platform-specific files **CAN** initialize ``build_lib`` by copying its value from + the ``build_ext`` command. In general this is done inside the ``finalize_options`` + method with the help of the ``set_undefined_options`` command:: + + def finalize_options(self): + self.set_undefined_options("build_py", ("build_lib", "build_lib")) + ... + """ + + def initialize_options(self) -> None: + """(Required by the original :class:`setuptools.Command` interface)""" + ... + + def finalize_options(self) -> None: + """(Required by the original :class:`setuptools.Command` interface)""" + ... + + def run(self) -> None: + """(Required by the original :class:`setuptools.Command` interface)""" + ... + + def get_source_files(self) -> list[str]: + """ + Return a list of all files that are used by the command to create the expected + outputs. + For example, if your build command transpiles Java files into Python, you should + list here all the Java files. + The primary purpose of this function is to help populating the ``sdist`` + with all the files necessary to build the distribution. + All files should be strings relative to the project root directory. + """ + ... + + def get_outputs(self) -> list[str]: + """ + Return a list of files intended for distribution as they would have been + produced by the build. + These files should be strings in the form of + ``"{build_lib}/destination/file/path"``. + + .. note:: + The return value of ``get_output()`` should include all files used as keys + in ``get_output_mapping()`` plus files that are generated during the build + and don't correspond to any source file already present in the project. + """ + ... + + def get_output_mapping(self) -> dict[str, str]: + """ + Return a mapping between destination files as they would be produced by the + build (dict keys) into the respective existing (source) files (dict values). + Existing (source) files should be represented as strings relative to the project + root directory. + Destination files should be strings in the form of + ``"{build_lib}/destination/file/path"``. + """ + ... diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build_clib.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build_clib.py new file mode 100644 index 000000000..f376f4ce4 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build_clib.py @@ -0,0 +1,103 @@ +from ..dist import Distribution +from ..modified import newer_pairwise_group + +import distutils.command.build_clib as orig +from distutils import log +from distutils.errors import DistutilsSetupError + + +class build_clib(orig.build_clib): + """ + Override the default build_clib behaviour to do the following: + + 1. Implement a rudimentary timestamp-based dependency system + so 'compile()' doesn't run every time. + 2. Add more keys to the 'build_info' dictionary: + * obj_deps - specify dependencies for each object compiled. + this should be a dictionary mapping a key + with the source filename to a list of + dependencies. Use an empty string for global + dependencies. + * cflags - specify a list of additional flags to pass to + the compiler. + """ + + distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution + + def build_libraries(self, libraries) -> None: + for lib_name, build_info in libraries: + sources = build_info.get('sources') + if sources is None or not isinstance(sources, (list, tuple)): + raise DistutilsSetupError( + f"in 'libraries' option (library '{lib_name}'), " + "'sources' must be present and must be " + "a list of source filenames" + ) + sources = sorted(list(sources)) + + log.info("building '%s' library", lib_name) + + # Make sure everything is the correct type. + # obj_deps should be a dictionary of keys as sources + # and a list/tuple of files that are its dependencies. + obj_deps = build_info.get('obj_deps', dict()) + if not isinstance(obj_deps, dict): + raise DistutilsSetupError( + f"in 'libraries' option (library '{lib_name}'), " + "'obj_deps' must be a dictionary of " + "type 'source: list'" + ) + dependencies = [] + + # Get the global dependencies that are specified by the '' key. + # These will go into every source's dependency list. + global_deps = obj_deps.get('', list()) + if not isinstance(global_deps, (list, tuple)): + raise DistutilsSetupError( + f"in 'libraries' option (library '{lib_name}'), " + "'obj_deps' must be a dictionary of " + "type 'source: list'" + ) + + # Build the list to be used by newer_pairwise_group + # each source will be auto-added to its dependencies. + for source in sources: + src_deps = [source] + src_deps.extend(global_deps) + extra_deps = obj_deps.get(source, list()) + if not isinstance(extra_deps, (list, tuple)): + raise DistutilsSetupError( + f"in 'libraries' option (library '{lib_name}'), " + "'obj_deps' must be a dictionary of " + "type 'source: list'" + ) + src_deps.extend(extra_deps) + dependencies.append(src_deps) + + expected_objects = self.compiler.object_filenames( + sources, + output_dir=self.build_temp, + ) + + if newer_pairwise_group(dependencies, expected_objects) != ([], []): + # First, compile the source code to object files in the library + # directory. (This should probably change to putting object + # files in a temporary build directory.) + macros = build_info.get('macros') + include_dirs = build_info.get('include_dirs') + cflags = build_info.get('cflags') + self.compiler.compile( + sources, + output_dir=self.build_temp, + macros=macros, + include_dirs=include_dirs, + extra_postargs=cflags, + debug=self.debug, + ) + + # Now "link" the object files together into a static library. + # (On Unix at least, this isn't really linking -- it just + # builds an archive. Whatever.) + self.compiler.create_static_lib( + expected_objects, lib_name, output_dir=self.build_clib, debug=self.debug + ) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build_ext.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build_ext.py new file mode 100644 index 000000000..af73fff7a --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build_ext.py @@ -0,0 +1,470 @@ +from __future__ import annotations + +import itertools +import os +import sys +import textwrap +from collections.abc import Iterator +from importlib.machinery import EXTENSION_SUFFIXES +from importlib.util import cache_from_source as _compiled_file_name +from pathlib import Path +from typing import TYPE_CHECKING + +from setuptools.dist import Distribution +from setuptools.errors import BaseError +from setuptools.extension import Extension, Library + +from distutils import log +from distutils.ccompiler import new_compiler +from distutils.sysconfig import customize_compiler, get_config_var + +if TYPE_CHECKING: + # Cython not installed on CI tests, causing _build_ext to be `Any` + from distutils.command.build_ext import build_ext as _build_ext +else: + try: + # Attempt to use Cython for building extensions, if available + from Cython.Distutils.build_ext import build_ext as _build_ext + + # Additionally, assert that the compiler module will load + # also. Ref #1229. + __import__('Cython.Compiler.Main') + except ImportError: + from distutils.command.build_ext import build_ext as _build_ext + +# make sure _config_vars is initialized +get_config_var("LDSHARED") +# Not publicly exposed in typeshed distutils stubs, but this is done on purpose +# See https://github.com/pypa/setuptools/pull/4228#issuecomment-1959856400 +from distutils.sysconfig import _config_vars as _CONFIG_VARS # noqa: E402 + + +def _customize_compiler_for_shlib(compiler): + if sys.platform == "darwin": + # building .dylib requires additional compiler flags on OSX; here we + # temporarily substitute the pyconfig.h variables so that distutils' + # 'customize_compiler' uses them before we build the shared libraries. + tmp = _CONFIG_VARS.copy() + try: + # XXX Help! I don't have any idea whether these are right... + _CONFIG_VARS['LDSHARED'] = ( + "gcc -Wl,-x -dynamiclib -undefined dynamic_lookup" + ) + _CONFIG_VARS['CCSHARED'] = " -dynamiclib" + _CONFIG_VARS['SO'] = ".dylib" + customize_compiler(compiler) + finally: + _CONFIG_VARS.clear() + _CONFIG_VARS.update(tmp) + else: + customize_compiler(compiler) + + +have_rtld = False +use_stubs = False +libtype = 'shared' + +if sys.platform == "darwin": + use_stubs = True +elif os.name != 'nt': + try: + import dl # type: ignore[import-not-found] # https://github.com/python/mypy/issues/13002 + + use_stubs = have_rtld = hasattr(dl, 'RTLD_NOW') + except ImportError: + pass + + +def get_abi3_suffix(): + """Return the file extension for an abi3-compliant Extension()""" + for suffix in EXTENSION_SUFFIXES: + if '.abi3' in suffix: # Unix + return suffix + elif suffix == '.pyd': # Windows + return suffix + return None + + +class build_ext(_build_ext): + distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution + editable_mode = False + inplace = False + + def run(self): + """Build extensions in build directory, then copy if --inplace""" + old_inplace, self.inplace = self.inplace, False + _build_ext.run(self) + self.inplace = old_inplace + if old_inplace: + self.copy_extensions_to_source() + + def _get_inplace_equivalent(self, build_py, ext: Extension) -> tuple[str, str]: + fullname = self.get_ext_fullname(ext.name) + filename = self.get_ext_filename(fullname) + modpath = fullname.split('.') + package = '.'.join(modpath[:-1]) + package_dir = build_py.get_package_dir(package) + inplace_file = os.path.join(package_dir, os.path.basename(filename)) + regular_file = os.path.join(self.build_lib, filename) + return (inplace_file, regular_file) + + def copy_extensions_to_source(self) -> None: + build_py = self.get_finalized_command('build_py') + for ext in self.extensions: + inplace_file, regular_file = self._get_inplace_equivalent(build_py, ext) + + # Always copy, even if source is older than destination, to ensure + # that the right extensions for the current Python/platform are + # used. + if os.path.exists(regular_file) or not ext.optional: + self.copy_file(regular_file, inplace_file, level=self.verbose) + + if ext._needs_stub: + inplace_stub = self._get_equivalent_stub(ext, inplace_file) + self._write_stub_file(inplace_stub, ext, compile=True) + # Always compile stub and remove the original (leave the cache behind) + # (this behaviour was observed in previous iterations of the code) + + def _get_equivalent_stub(self, ext: Extension, output_file: str) -> str: + dir_ = os.path.dirname(output_file) + _, _, name = ext.name.rpartition(".") + return f"{os.path.join(dir_, name)}.py" + + def _get_output_mapping(self) -> Iterator[tuple[str, str]]: + if not self.inplace: + return + + build_py = self.get_finalized_command('build_py') + opt = self.get_finalized_command('install_lib').optimize or "" + + for ext in self.extensions: + inplace_file, regular_file = self._get_inplace_equivalent(build_py, ext) + yield (regular_file, inplace_file) + + if ext._needs_stub: + # This version of `build_ext` always builds artifacts in another dir, + # when "inplace=True" is given it just copies them back. + # This is done in the `copy_extensions_to_source` function, which + # always compile stub files via `_compile_and_remove_stub`. + # At the end of the process, a `.pyc` stub file is created without the + # corresponding `.py`. + + inplace_stub = self._get_equivalent_stub(ext, inplace_file) + regular_stub = self._get_equivalent_stub(ext, regular_file) + inplace_cache = _compiled_file_name(inplace_stub, optimization=opt) + output_cache = _compiled_file_name(regular_stub, optimization=opt) + yield (output_cache, inplace_cache) + + def get_ext_filename(self, fullname: str) -> str: + so_ext = os.getenv('SETUPTOOLS_EXT_SUFFIX') + if so_ext: + filename = os.path.join(*fullname.split('.')) + so_ext + else: + filename = _build_ext.get_ext_filename(self, fullname) + ext_suffix = get_config_var('EXT_SUFFIX') + if not isinstance(ext_suffix, str): + raise OSError( + "Configuration variable EXT_SUFFIX not found for this platform " + "and environment variable SETUPTOOLS_EXT_SUFFIX is missing" + ) + so_ext = ext_suffix + + if fullname in self.ext_map: + ext = self.ext_map[fullname] + abi3_suffix = get_abi3_suffix() + if ext.py_limited_api and abi3_suffix: # Use abi3 + filename = filename[: -len(so_ext)] + abi3_suffix + if isinstance(ext, Library): + fn, ext = os.path.splitext(filename) + return self.shlib_compiler.library_filename(fn, libtype) + elif use_stubs and ext._links_to_dynamic: + d, fn = os.path.split(filename) + return os.path.join(d, 'dl-' + fn) + return filename + + def initialize_options(self): + _build_ext.initialize_options(self) + self.shlib_compiler = None + self.shlibs = [] + self.ext_map = {} + self.editable_mode = False + + def finalize_options(self) -> None: + _build_ext.finalize_options(self) + self.extensions = self.extensions or [] + self.check_extensions_list(self.extensions) + self.shlibs = [ext for ext in self.extensions if isinstance(ext, Library)] + if self.shlibs: + self.setup_shlib_compiler() + for ext in self.extensions: + ext._full_name = self.get_ext_fullname(ext.name) + for ext in self.extensions: + fullname = ext._full_name + self.ext_map[fullname] = ext + + # distutils 3.1 will also ask for module names + # XXX what to do with conflicts? + self.ext_map[fullname.split('.')[-1]] = ext + + ltd = self.shlibs and self.links_to_dynamic(ext) or False + ns = ltd and use_stubs and not isinstance(ext, Library) + ext._links_to_dynamic = ltd + ext._needs_stub = ns + filename = ext._file_name = self.get_ext_filename(fullname) + libdir = os.path.dirname(os.path.join(self.build_lib, filename)) + if ltd and libdir not in ext.library_dirs: + ext.library_dirs.append(libdir) + if ltd and use_stubs and os.curdir not in ext.runtime_library_dirs: + ext.runtime_library_dirs.append(os.curdir) + + if self.editable_mode: + self.inplace = True + + def setup_shlib_compiler(self): + compiler = self.shlib_compiler = new_compiler( + compiler=self.compiler, dry_run=self.dry_run, force=self.force + ) + _customize_compiler_for_shlib(compiler) + + if self.include_dirs is not None: + compiler.set_include_dirs(self.include_dirs) + if self.define is not None: + # 'define' option is a list of (name,value) tuples + for name, value in self.define: + compiler.define_macro(name, value) + if self.undef is not None: + for macro in self.undef: + compiler.undefine_macro(macro) + if self.libraries is not None: + compiler.set_libraries(self.libraries) + if self.library_dirs is not None: + compiler.set_library_dirs(self.library_dirs) + if self.rpath is not None: + compiler.set_runtime_library_dirs(self.rpath) + if self.link_objects is not None: + compiler.set_link_objects(self.link_objects) + + # hack so distutils' build_extension() builds a library instead + compiler.link_shared_object = link_shared_object.__get__(compiler) # type: ignore[method-assign] + + def get_export_symbols(self, ext): + if isinstance(ext, Library): + return ext.export_symbols + return _build_ext.get_export_symbols(self, ext) + + def build_extension(self, ext) -> None: + ext._convert_pyx_sources_to_lang() + _compiler = self.compiler + try: + if isinstance(ext, Library): + self.compiler = self.shlib_compiler + _build_ext.build_extension(self, ext) + if ext._needs_stub: + build_lib = self.get_finalized_command('build_py').build_lib + self.write_stub(build_lib, ext) + finally: + self.compiler = _compiler + + def links_to_dynamic(self, ext): + """Return true if 'ext' links to a dynamic lib in the same package""" + # XXX this should check to ensure the lib is actually being built + # XXX as dynamic, and not just using a locally-found version or a + # XXX static-compiled version + libnames = dict.fromkeys([lib._full_name for lib in self.shlibs]) + pkg = '.'.join(ext._full_name.split('.')[:-1] + ['']) + return any(pkg + libname in libnames for libname in ext.libraries) + + def get_source_files(self) -> list[str]: + return [*_build_ext.get_source_files(self), *self._get_internal_depends()] + + def _get_internal_depends(self) -> Iterator[str]: + """Yield ``ext.depends`` that are contained by the project directory""" + project_root = Path(self.distribution.src_root or os.curdir).resolve() + depends = (dep for ext in self.extensions for dep in ext.depends) + + def skip(orig_path: str, reason: str) -> None: + log.info( + "dependency %s won't be automatically " + "included in the manifest: the path %s", + orig_path, + reason, + ) + + for dep in depends: + path = Path(dep) + + if path.is_absolute(): + skip(dep, "must be relative") + continue + + if ".." in path.parts: + skip(dep, "can't have `..` segments") + continue + + try: + resolved = (project_root / path).resolve(strict=True) + except OSError: + skip(dep, "doesn't exist") + continue + + try: + resolved.relative_to(project_root) + except ValueError: + skip(dep, "must be inside the project root") + continue + + yield path.as_posix() + + def get_outputs(self) -> list[str]: + if self.inplace: + return list(self.get_output_mapping().keys()) + return sorted(_build_ext.get_outputs(self) + self.__get_stubs_outputs()) + + def get_output_mapping(self) -> dict[str, str]: + """See :class:`setuptools.commands.build.SubCommand`""" + mapping = self._get_output_mapping() + return dict(sorted(mapping, key=lambda x: x[0])) + + def __get_stubs_outputs(self): + # assemble the base name for each extension that needs a stub + ns_ext_bases = ( + os.path.join(self.build_lib, *ext._full_name.split('.')) + for ext in self.extensions + if ext._needs_stub + ) + # pair each base with the extension + pairs = itertools.product(ns_ext_bases, self.__get_output_extensions()) + return list(base + fnext for base, fnext in pairs) + + def __get_output_extensions(self): + yield '.py' + yield '.pyc' + if self.get_finalized_command('build_py').optimize: + yield '.pyo' + + def write_stub(self, output_dir, ext, compile=False) -> None: + stub_file = os.path.join(output_dir, *ext._full_name.split('.')) + '.py' + self._write_stub_file(stub_file, ext, compile) + + def _write_stub_file(self, stub_file: str, ext: Extension, compile=False): + log.info("writing stub loader for %s to %s", ext._full_name, stub_file) + if compile and os.path.exists(stub_file): + raise BaseError(stub_file + " already exists! Please delete.") + if not self.dry_run: + with open(stub_file, 'w', encoding="utf-8") as f: + content = ( + textwrap.dedent(f""" + def __bootstrap__(): + global __bootstrap__, __file__, __loader__ + import sys, os, importlib.resources as irs, importlib.util + #rtld import dl + with irs.files(__name__).joinpath( + {os.path.basename(ext._file_name)!r}) as __file__: + del __bootstrap__ + if '__loader__' in globals(): + del __loader__ + #rtld old_flags = sys.getdlopenflags() + old_dir = os.getcwd() + try: + os.chdir(os.path.dirname(__file__)) + #rtld sys.setdlopenflags(dl.RTLD_NOW) + spec = importlib.util.spec_from_file_location( + __name__, __file__) + mod = importlib.util.module_from_spec(spec) + spec.loader.exec_module(mod) + finally: + #rtld sys.setdlopenflags(old_flags) + os.chdir(old_dir) + __bootstrap__() + """) + .lstrip() + .replace('#rtld', '#rtld' * (not have_rtld)) + ) + f.write(content) + if compile: + self._compile_and_remove_stub(stub_file) + + def _compile_and_remove_stub(self, stub_file: str): + from distutils.util import byte_compile + + byte_compile([stub_file], optimize=0, force=True, dry_run=self.dry_run) + optimize = self.get_finalized_command('install_lib').optimize + if optimize > 0: + byte_compile( + [stub_file], + optimize=optimize, + force=True, + dry_run=self.dry_run, + ) + if os.path.exists(stub_file) and not self.dry_run: + os.unlink(stub_file) + + +if use_stubs or os.name == 'nt': + # Build shared libraries + # + def link_shared_object( + self, + objects, + output_libname, + output_dir=None, + libraries=None, + library_dirs=None, + runtime_library_dirs=None, + export_symbols=None, + debug: bool = False, + extra_preargs=None, + extra_postargs=None, + build_temp=None, + target_lang=None, + ) -> None: + self.link( + self.SHARED_LIBRARY, + objects, + output_libname, + output_dir, + libraries, + library_dirs, + runtime_library_dirs, + export_symbols, + debug, + extra_preargs, + extra_postargs, + build_temp, + target_lang, + ) + +else: + # Build static libraries everywhere else + libtype = 'static' + + def link_shared_object( + self, + objects, + output_libname, + output_dir=None, + libraries=None, + library_dirs=None, + runtime_library_dirs=None, + export_symbols=None, + debug: bool = False, + extra_preargs=None, + extra_postargs=None, + build_temp=None, + target_lang=None, + ) -> None: + # XXX we need to either disallow these attrs on Library instances, + # or warn/abort here if set, or something... + # libraries=None, library_dirs=None, runtime_library_dirs=None, + # export_symbols=None, extra_preargs=None, extra_postargs=None, + # build_temp=None + + assert output_dir is None # distutils build_ext doesn't pass this + output_dir, filename = os.path.split(output_libname) + basename, _ext = os.path.splitext(filename) + if self.library_filename("x").startswith('lib'): + # strip 'lib' prefix; this is kludgy if some platform uses + # a different prefix + basename = basename[3:] + + self.create_static_lib(objects, basename, output_dir, debug, target_lang) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build_py.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build_py.py new file mode 100644 index 000000000..2f6fcb7cd --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/build_py.py @@ -0,0 +1,400 @@ +from __future__ import annotations + +import fnmatch +import itertools +import os +import stat +import textwrap +from collections.abc import Iterable, Iterator +from functools import partial +from glob import glob +from pathlib import Path + +from more_itertools import unique_everseen + +from .._path import StrPath, StrPathT +from ..dist import Distribution +from ..warnings import SetuptoolsDeprecationWarning + +import distutils.command.build_py as orig +import distutils.errors +from distutils.util import convert_path + +_IMPLICIT_DATA_FILES = ('*.pyi', 'py.typed') + + +def make_writable(target) -> None: + os.chmod(target, os.stat(target).st_mode | stat.S_IWRITE) + + +class build_py(orig.build_py): + """Enhanced 'build_py' command that includes data files with packages + + The data files are specified via a 'package_data' argument to 'setup()'. + See 'setuptools.dist.Distribution' for more details. + + Also, this version of the 'build_py' command allows you to specify both + 'py_modules' and 'packages' in the same setup operation. + """ + + distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution + editable_mode: bool = False + existing_egg_info_dir: StrPath | None = None #: Private API, internal use only. + + def finalize_options(self): + orig.build_py.finalize_options(self) + self.package_data = self.distribution.package_data + self.exclude_package_data = self.distribution.exclude_package_data or {} + if 'data_files' in self.__dict__: + del self.__dict__['data_files'] + + def copy_file( # type: ignore[override] # No overload, no bytes support + self, + infile: StrPath, + outfile: StrPathT, + preserve_mode: bool = True, + preserve_times: bool = True, + link: str | None = None, + level: object = 1, + ) -> tuple[StrPathT | str, bool]: + # Overwrite base class to allow using links + if link: + infile = str(Path(infile).resolve()) + outfile = str(Path(outfile).resolve()) # type: ignore[assignment] # Re-assigning a str when outfile is StrPath is ok + return super().copy_file( # pyright: ignore[reportReturnType] # pypa/distutils#309 + infile, outfile, preserve_mode, preserve_times, link, level + ) + + def run(self) -> None: + """Build modules, packages, and copy data files to build directory""" + if not (self.py_modules or self.packages) or self.editable_mode: + return + + if self.py_modules: + self.build_modules() + + if self.packages: + self.build_packages() + self.build_package_data() + + # Only compile actual .py files, using our base class' idea of what our + # output files are. + self.byte_compile(orig.build_py.get_outputs(self, include_bytecode=False)) + + def __getattr__(self, attr: str): + "lazily compute data files" + if attr == 'data_files': + self.data_files = self._get_data_files() + return self.data_files + return orig.build_py.__getattr__(self, attr) + + def _get_data_files(self): + """Generate list of '(package,src_dir,build_dir,filenames)' tuples""" + self.analyze_manifest() + return list(map(self._get_pkg_data_files, self.packages or ())) + + def get_data_files_without_manifest(self): + """ + Generate list of ``(package,src_dir,build_dir,filenames)`` tuples, + but without triggering any attempt to analyze or build the manifest. + """ + # Prevent eventual errors from unset `manifest_files` + # (that would otherwise be set by `analyze_manifest`) + self.__dict__.setdefault('manifest_files', {}) + return list(map(self._get_pkg_data_files, self.packages or ())) + + def _get_pkg_data_files(self, package): + # Locate package source directory + src_dir = self.get_package_dir(package) + + # Compute package build directory + build_dir = os.path.join(*([self.build_lib] + package.split('.'))) + + # Strip directory from globbed filenames + filenames = [ + os.path.relpath(file, src_dir) + for file in self.find_data_files(package, src_dir) + ] + return package, src_dir, build_dir, filenames + + def find_data_files(self, package, src_dir): + """Return filenames for package's data files in 'src_dir'""" + patterns = self._get_platform_patterns( + self.package_data, + package, + src_dir, + extra_patterns=_IMPLICIT_DATA_FILES, + ) + globs_expanded = map(partial(glob, recursive=True), patterns) + # flatten the expanded globs into an iterable of matches + globs_matches = itertools.chain.from_iterable(globs_expanded) + glob_files = filter(os.path.isfile, globs_matches) + files = itertools.chain( + self.manifest_files.get(package, []), + glob_files, + ) + return self.exclude_data_files(package, src_dir, files) + + def get_outputs(self, include_bytecode: bool = True) -> list[str]: # type: ignore[override] # Using a real boolean instead of 0|1 + """See :class:`setuptools.commands.build.SubCommand`""" + if self.editable_mode: + return list(self.get_output_mapping().keys()) + return super().get_outputs(include_bytecode) + + def get_output_mapping(self) -> dict[str, str]: + """See :class:`setuptools.commands.build.SubCommand`""" + mapping = itertools.chain( + self._get_package_data_output_mapping(), + self._get_module_mapping(), + ) + return dict(sorted(mapping, key=lambda x: x[0])) + + def _get_module_mapping(self) -> Iterator[tuple[str, str]]: + """Iterate over all modules producing (dest, src) pairs.""" + for package, module, module_file in self.find_all_modules(): + package = package.split('.') + filename = self.get_module_outfile(self.build_lib, package, module) + yield (filename, module_file) + + def _get_package_data_output_mapping(self) -> Iterator[tuple[str, str]]: + """Iterate over package data producing (dest, src) pairs.""" + for package, src_dir, build_dir, filenames in self.data_files: + for filename in filenames: + target = os.path.join(build_dir, filename) + srcfile = os.path.join(src_dir, filename) + yield (target, srcfile) + + def build_package_data(self) -> None: + """Copy data files into build directory""" + for target, srcfile in self._get_package_data_output_mapping(): + self.mkpath(os.path.dirname(target)) + _outf, _copied = self.copy_file(srcfile, target) + make_writable(target) + + def analyze_manifest(self) -> None: + self.manifest_files: dict[str, list[str]] = {} + if not self.distribution.include_package_data: + return + src_dirs: dict[str, str] = {} + for package in self.packages or (): + # Locate package source directory + src_dirs[assert_relative(self.get_package_dir(package))] = package + + if ( + self.existing_egg_info_dir + and Path(self.existing_egg_info_dir, "SOURCES.txt").exists() + ): + egg_info_dir = self.existing_egg_info_dir + manifest = Path(egg_info_dir, "SOURCES.txt") + files = manifest.read_text(encoding="utf-8").splitlines() + else: + self.run_command('egg_info') + ei_cmd = self.get_finalized_command('egg_info') + egg_info_dir = ei_cmd.egg_info + files = ei_cmd.filelist.files + + check = _IncludePackageDataAbuse() + for path in self._filter_build_files(files, egg_info_dir): + d, f = os.path.split(assert_relative(path)) + prev = None + oldf = f + while d and d != prev and d not in src_dirs: + prev = d + d, df = os.path.split(d) + f = os.path.join(df, f) + if d in src_dirs: + if f == oldf: + if check.is_module(f): + continue # it's a module, not data + else: + importable = check.importable_subpackage(src_dirs[d], f) + if importable: + check.warn(importable) + self.manifest_files.setdefault(src_dirs[d], []).append(path) + + def _filter_build_files( + self, files: Iterable[str], egg_info: StrPath + ) -> Iterator[str]: + """ + ``build_meta`` may try to create egg_info outside of the project directory, + and this can be problematic for certain plugins (reported in issue #3500). + + Extensions might also include between their sources files created on the + ``build_lib`` and ``build_temp`` directories. + + This function should filter this case of invalid files out. + """ + build = self.get_finalized_command("build") + build_dirs = (egg_info, self.build_lib, build.build_temp, build.build_base) + norm_dirs = [os.path.normpath(p) for p in build_dirs if p] + + for file in files: + norm_path = os.path.normpath(file) + if not os.path.isabs(file) or all(d not in norm_path for d in norm_dirs): + yield file + + def get_data_files(self) -> None: + pass # Lazily compute data files in _get_data_files() function. + + def check_package(self, package, package_dir): + """Check namespace packages' __init__ for declare_namespace""" + try: + return self.packages_checked[package] + except KeyError: + pass + + init_py = orig.build_py.check_package(self, package, package_dir) + self.packages_checked[package] = init_py + + if not init_py or not self.distribution.namespace_packages: + return init_py + + for pkg in self.distribution.namespace_packages: + if pkg == package or pkg.startswith(package + '.'): + break + else: + return init_py + + with open(init_py, 'rb') as f: + contents = f.read() + if b'declare_namespace' not in contents: + raise distutils.errors.DistutilsError( + f"Namespace package problem: {package} is a namespace package, but " + "its\n__init__.py does not call declare_namespace()! Please " + 'fix it.\n(See the setuptools manual under ' + '"Namespace Packages" for details.)\n"' + ) + return init_py + + def initialize_options(self): + self.packages_checked = {} + orig.build_py.initialize_options(self) + self.editable_mode = False + self.existing_egg_info_dir = None + + def get_package_dir(self, package): + res = orig.build_py.get_package_dir(self, package) + if self.distribution.src_root is not None: + return os.path.join(self.distribution.src_root, res) + return res + + def exclude_data_files(self, package, src_dir, files): + """Filter filenames for package's data files in 'src_dir'""" + files = list(files) + patterns = self._get_platform_patterns( + self.exclude_package_data, + package, + src_dir, + ) + match_groups = (fnmatch.filter(files, pattern) for pattern in patterns) + # flatten the groups of matches into an iterable of matches + matches = itertools.chain.from_iterable(match_groups) + bad = set(matches) + keepers = (fn for fn in files if fn not in bad) + # ditch dupes + return list(unique_everseen(keepers)) + + @staticmethod + def _get_platform_patterns(spec, package, src_dir, extra_patterns=()): + """ + yield platform-specific path patterns (suitable for glob + or fn_match) from a glob-based spec (such as + self.package_data or self.exclude_package_data) + matching package in src_dir. + """ + raw_patterns = itertools.chain( + extra_patterns, + spec.get('', []), + spec.get(package, []), + ) + return ( + # Each pattern has to be converted to a platform-specific path + os.path.join(src_dir, convert_path(pattern)) + for pattern in raw_patterns + ) + + +def assert_relative(path): + if not os.path.isabs(path): + return path + from distutils.errors import DistutilsSetupError + + msg = ( + textwrap.dedent( + """ + Error: setup script specifies an absolute path: + + %s + + setup() arguments must *always* be /-separated paths relative to the + setup.py directory, *never* absolute paths. + """ + ).lstrip() + % path + ) + raise DistutilsSetupError(msg) + + +class _IncludePackageDataAbuse: + """Inform users that package or module is included as 'data file'""" + + class _Warning(SetuptoolsDeprecationWarning): + _SUMMARY = """ + Package {importable!r} is absent from the `packages` configuration. + """ + + _DETAILS = """ + ############################ + # Package would be ignored # + ############################ + Python recognizes {importable!r} as an importable package[^1], + but it is absent from setuptools' `packages` configuration. + + This leads to an ambiguous overall configuration. If you want to distribute this + package, please make sure that {importable!r} is explicitly added + to the `packages` configuration field. + + Alternatively, you can also rely on setuptools' discovery methods + (for example by using `find_namespace_packages(...)`/`find_namespace:` + instead of `find_packages(...)`/`find:`). + + You can read more about "package discovery" on setuptools documentation page: + + - https://setuptools.pypa.io/en/latest/userguide/package_discovery.html + + If you don't want {importable!r} to be distributed and are + already explicitly excluding {importable!r} via + `find_namespace_packages(...)/find_namespace` or `find_packages(...)/find`, + you can try to use `exclude_package_data`, or `include-package-data=False` in + combination with a more fine grained `package-data` configuration. + + You can read more about "package data files" on setuptools documentation page: + + - https://setuptools.pypa.io/en/latest/userguide/datafiles.html + + + [^1]: For Python, any directory (with suitable naming) can be imported, + even if it does not contain any `.py` files. + On the other hand, currently there is no concept of package data + directory, all directories are treated like packages. + """ + # _DUE_DATE: still not defined as this is particularly controversial. + # Warning initially introduced in May 2022. See issue #3340 for discussion. + + def __init__(self): + self._already_warned = set() + + def is_module(self, file): + return file.endswith(".py") and file[: -len(".py")].isidentifier() + + def importable_subpackage(self, parent, file): + pkg = Path(file).parent + parts = list(itertools.takewhile(str.isidentifier, pkg.parts)) + if parts: + return ".".join([parent, *parts]) + return None + + def warn(self, importable): + if importable not in self._already_warned: + self._Warning.emit(importable=importable) + self._already_warned.add(importable) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/develop.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/develop.py new file mode 100644 index 000000000..1f704fcee --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/develop.py @@ -0,0 +1,55 @@ +import site +import subprocess +import sys + +from setuptools import Command +from setuptools.warnings import SetuptoolsDeprecationWarning + + +class develop(Command): + """Set up package for development""" + + user_options = [ + ("install-dir=", "d", "install package to DIR"), + ('no-deps', 'N', "don't install dependencies"), + ('user', None, f"install in user site-package '{site.USER_SITE}'"), + ('prefix=', None, "installation prefix"), + ("index-url=", "i", "base URL of Python Package Index"), + ] + boolean_options = [ + 'no-deps', + 'user', + ] + + install_dir = None + no_deps = False + user = False + prefix = None + index_url = None + + def run(self): + cmd = ( + [sys.executable, '-m', 'pip', 'install', '-e', '.', '--use-pep517'] + + ['--target', self.install_dir] * bool(self.install_dir) + + ['--no-deps'] * self.no_deps + + ['--user'] * self.user + + ['--prefix', self.prefix] * bool(self.prefix) + + ['--index-url', self.index_url] * bool(self.index_url) + ) + subprocess.check_call(cmd) + + def initialize_options(self): + DevelopDeprecationWarning.emit() + + def finalize_options(self) -> None: + pass + + +class DevelopDeprecationWarning(SetuptoolsDeprecationWarning): + _SUMMARY = "develop command is deprecated." + _DETAILS = """ + Please avoid running ``setup.py`` and ``develop``. + Instead, use standards-based tools like pip or uv. + """ + _SEE_URL = "https://github.com/pypa/setuptools/issues/917" + _DUE_DATE = 2025, 10, 31 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/dist_info.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/dist_info.py new file mode 100644 index 000000000..dca01ff0c --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/dist_info.py @@ -0,0 +1,103 @@ +""" +Create a dist_info directory +As defined in the wheel specification +""" + +import os +import shutil +from contextlib import contextmanager +from pathlib import Path +from typing import cast + +from .. import _normalization +from .._shutil import rmdir as _rm +from .egg_info import egg_info as egg_info_cls + +from distutils import log +from distutils.core import Command + + +class dist_info(Command): + """ + This command is private and reserved for internal use of setuptools, + users should rely on ``setuptools.build_meta`` APIs. + """ + + description = "DO NOT CALL DIRECTLY, INTERNAL ONLY: create .dist-info directory" + + user_options = [ + ( + 'output-dir=', + 'o', + "directory inside of which the .dist-info will be" + "created [default: top of the source tree]", + ), + ('tag-date', 'd', "Add date stamp (e.g. 20050528) to version number"), + ('tag-build=', 'b', "Specify explicit tag to add to version number"), + ('no-date', 'D', "Don't include date stamp [default]"), + ('keep-egg-info', None, "*TRANSITIONAL* will be removed in the future"), + ] + + boolean_options = ['tag-date', 'keep-egg-info'] + negative_opt = {'no-date': 'tag-date'} + + def initialize_options(self): + self.output_dir = None + self.name = None + self.dist_info_dir = None + self.tag_date = None + self.tag_build = None + self.keep_egg_info = False + + def finalize_options(self) -> None: + dist = self.distribution + project_dir = dist.src_root or os.curdir + self.output_dir = Path(self.output_dir or project_dir) + + egg_info = cast(egg_info_cls, self.reinitialize_command("egg_info")) + egg_info.egg_base = str(self.output_dir) + + if self.tag_date: + egg_info.tag_date = self.tag_date + else: + self.tag_date = egg_info.tag_date + + if self.tag_build: + egg_info.tag_build = self.tag_build + else: + self.tag_build = egg_info.tag_build + + egg_info.finalize_options() + self.egg_info = egg_info + + name = _normalization.safer_name(dist.get_name()) + version = _normalization.safer_best_effort_version(dist.get_version()) + self.name = f"{name}-{version}" + self.dist_info_dir = os.path.join(self.output_dir, f"{self.name}.dist-info") + + @contextmanager + def _maybe_bkp_dir(self, dir_path: str, requires_bkp: bool): + if requires_bkp: + bkp_name = f"{dir_path}.__bkp__" + _rm(bkp_name, ignore_errors=True) + shutil.copytree(dir_path, bkp_name, dirs_exist_ok=True, symlinks=True) + try: + yield + finally: + _rm(dir_path, ignore_errors=True) + shutil.move(bkp_name, dir_path) + else: + yield + + def run(self) -> None: + self.output_dir.mkdir(parents=True, exist_ok=True) + self.egg_info.run() + egg_info_dir = self.egg_info.egg_info + assert os.path.isdir(egg_info_dir), ".egg-info dir should have been created" + + log.info(f"creating '{os.path.abspath(self.dist_info_dir)}'") + bdist_wheel = self.get_finalized_command('bdist_wheel') + + # TODO: if bdist_wheel if merged into setuptools, just add "keep_egg_info" there + with self._maybe_bkp_dir(egg_info_dir, self.keep_egg_info): + bdist_wheel.egg2dist(egg_info_dir, self.dist_info_dir) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/easy_install.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/easy_install.py new file mode 100644 index 000000000..8765793d4 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/easy_install.py @@ -0,0 +1,30 @@ +import os +import sys +import types + +from setuptools import Command + +from .. import _scripts, warnings + + +class easy_install(Command): + """Stubbed command for temporary pbr compatibility.""" + + +def __getattr__(name): + attr = getattr( + types.SimpleNamespace( + ScriptWriter=_scripts.ScriptWriter, + sys_executable=os.environ.get( + "__PYVENV_LAUNCHER__", os.path.normpath(sys.executable) + ), + ), + name, + ) + warnings.SetuptoolsDeprecationWarning.emit( + summary="easy_install module is deprecated", + details="Avoid accessing attributes of setuptools.command.easy_install.", + due_date=(2025, 10, 31), + see_url="https://github.com/pypa/setuptools/issues/4976", + ) + return attr diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/editable_wheel.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/editable_wheel.py new file mode 100644 index 000000000..c77257081 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/editable_wheel.py @@ -0,0 +1,908 @@ +""" +Create a wheel that, when installed, will make the source package 'editable' +(add it to the interpreter's path, including metadata) per PEP 660. Replaces +'setup.py develop'. + +.. note:: + One of the mechanisms briefly mentioned in PEP 660 to implement editable installs is + to create a separated directory inside ``build`` and use a .pth file to point to that + directory. In the context of this file such directory is referred as + *auxiliary build directory* or ``auxiliary_dir``. +""" + +from __future__ import annotations + +import io +import logging +import os +import shutil +import traceback +from collections.abc import Iterable, Iterator, Mapping +from contextlib import suppress +from enum import Enum +from inspect import cleandoc +from itertools import chain, starmap +from pathlib import Path +from tempfile import TemporaryDirectory +from types import TracebackType +from typing import TYPE_CHECKING, Protocol, TypeVar, cast + +from .. import Command, _normalization, _path, _shutil, errors, namespaces +from .._path import StrPath +from ..compat import py310, py312 +from ..discovery import find_package_path +from ..dist import Distribution +from ..warnings import InformationOnly, SetuptoolsDeprecationWarning +from .build import build as build_cls +from .build_py import build_py as build_py_cls +from .dist_info import dist_info as dist_info_cls +from .egg_info import egg_info as egg_info_cls +from .install import install as install_cls +from .install_scripts import install_scripts as install_scripts_cls + +if TYPE_CHECKING: + from typing_extensions import Self + + from .._vendor.wheel.wheelfile import WheelFile + +_P = TypeVar("_P", bound=StrPath) +_logger = logging.getLogger(__name__) + + +class _EditableMode(Enum): + """ + Possible editable installation modes: + `lenient` (new files automatically added to the package - DEFAULT); + `strict` (requires a new installation when files are added/removed); or + `compat` (attempts to emulate `python setup.py develop` - DEPRECATED). + """ + + STRICT = "strict" + LENIENT = "lenient" + COMPAT = "compat" # TODO: Remove `compat` after Dec/2022. + + @classmethod + def convert(cls, mode: str | None) -> _EditableMode: + if not mode: + return _EditableMode.LENIENT # default + + _mode = mode.upper() + if _mode not in _EditableMode.__members__: + raise errors.OptionError(f"Invalid editable mode: {mode!r}. Try: 'strict'.") + + if _mode == "COMPAT": + SetuptoolsDeprecationWarning.emit( + "Compat editable installs", + """ + The 'compat' editable mode is transitional and will be removed + in future versions of `setuptools`. + Please adapt your code accordingly to use either the 'strict' or the + 'lenient' modes. + """, + see_docs="userguide/development_mode.html", + # TODO: define due_date + # There is a series of shortcomings with the available editable install + # methods, and they are very controversial. This is something that still + # needs work. + # Moreover, `pip` is still hiding this warning, so users are not aware. + ) + + return _EditableMode[_mode] + + +_STRICT_WARNING = """ +New or renamed files may not be automatically picked up without a new installation. +""" + +_LENIENT_WARNING = """ +Options like `package-data`, `include/exclude-package-data` or +`packages.find.exclude/include` may have no effect. +""" + + +class editable_wheel(Command): + """Build 'editable' wheel for development. + This command is private and reserved for internal use of setuptools, + users should rely on ``setuptools.build_meta`` APIs. + """ + + description = "DO NOT CALL DIRECTLY, INTERNAL ONLY: create PEP 660 editable wheel" + + user_options = [ + ("dist-dir=", "d", "directory to put final built distributions in"), + ("dist-info-dir=", "I", "path to a pre-build .dist-info directory"), + ("mode=", None, cleandoc(_EditableMode.__doc__ or "")), + ] + + def initialize_options(self): + self.dist_dir = None + self.dist_info_dir = None + self.project_dir = None + self.mode = None + + def finalize_options(self) -> None: + dist = self.distribution + self.project_dir = dist.src_root or os.curdir + self.package_dir = dist.package_dir or {} + self.dist_dir = Path(self.dist_dir or os.path.join(self.project_dir, "dist")) + + def run(self) -> None: + try: + self.dist_dir.mkdir(exist_ok=True) + self._ensure_dist_info() + + # Add missing dist_info files + self.reinitialize_command("bdist_wheel") + bdist_wheel = self.get_finalized_command("bdist_wheel") + bdist_wheel.write_wheelfile(self.dist_info_dir) + + self._create_wheel_file(bdist_wheel) + except Exception as ex: + project = self.distribution.name or self.distribution.get_name() + py310.add_note( + ex, + f"An error occurred when building editable wheel for {project}.\n" + "See debugging tips in: " + "https://setuptools.pypa.io/en/latest/userguide/development_mode.html#debugging-tips", + ) + raise + + def _ensure_dist_info(self): + if self.dist_info_dir is None: + dist_info = cast(dist_info_cls, self.reinitialize_command("dist_info")) + dist_info.output_dir = self.dist_dir + dist_info.ensure_finalized() + dist_info.run() + self.dist_info_dir = dist_info.dist_info_dir + else: + assert str(self.dist_info_dir).endswith(".dist-info") + assert Path(self.dist_info_dir, "METADATA").exists() + + def _install_namespaces(self, installation_dir, pth_prefix): + # XXX: Only required to support the deprecated namespace practice + dist = self.distribution + if not dist.namespace_packages: + return + + src_root = Path(self.project_dir, self.package_dir.get("", ".")).resolve() + installer = _NamespaceInstaller(dist, installation_dir, pth_prefix, src_root) + installer.install_namespaces() + + def _find_egg_info_dir(self) -> str | None: + parent_dir = Path(self.dist_info_dir).parent if self.dist_info_dir else Path() + candidates = map(str, parent_dir.glob("*.egg-info")) + return next(candidates, None) + + def _configure_build( + self, name: str, unpacked_wheel: StrPath, build_lib: StrPath, tmp_dir: StrPath + ): + """Configure commands to behave in the following ways: + + - Build commands can write to ``build_lib`` if they really want to... + (but this folder is expected to be ignored and modules are expected to live + in the project directory...) + - Binary extensions should be built in-place (editable_mode = True) + - Data/header/script files are not part of the "editable" specification + so they are written directly to the unpacked_wheel directory. + """ + # Non-editable files (data, headers, scripts) are written directly to the + # unpacked_wheel + + dist = self.distribution + wheel = str(unpacked_wheel) + build_lib = str(build_lib) + data = str(Path(unpacked_wheel, f"{name}.data", "data")) + headers = str(Path(unpacked_wheel, f"{name}.data", "headers")) + scripts = str(Path(unpacked_wheel, f"{name}.data", "scripts")) + + # egg-info may be generated again to create a manifest (used for package data) + egg_info = cast( + egg_info_cls, dist.reinitialize_command("egg_info", reinit_subcommands=True) + ) + egg_info.egg_base = str(tmp_dir) + egg_info.ignore_egg_info_in_manifest = True + + build = cast( + build_cls, dist.reinitialize_command("build", reinit_subcommands=True) + ) + install = cast( + install_cls, dist.reinitialize_command("install", reinit_subcommands=True) + ) + + build.build_platlib = build.build_purelib = build.build_lib = build_lib + install.install_purelib = install.install_platlib = install.install_lib = wheel + install.install_scripts = build.build_scripts = scripts + install.install_headers = headers + install.install_data = data + + # For portability, ensure scripts are built with #!python shebang + # pypa/setuptools#4863 + build_scripts = dist.get_command_obj("build_scripts") + build_scripts.executable = 'python' + + install_scripts = cast( + install_scripts_cls, dist.get_command_obj("install_scripts") + ) + install_scripts.no_ep = True + + build.build_temp = str(tmp_dir) + + build_py = cast(build_py_cls, dist.get_command_obj("build_py")) + build_py.compile = False + build_py.existing_egg_info_dir = self._find_egg_info_dir() + + self._set_editable_mode() + + build.ensure_finalized() + install.ensure_finalized() + + def _set_editable_mode(self): + """Set the ``editable_mode`` flag in the build sub-commands""" + dist = self.distribution + build = dist.get_command_obj("build") + for cmd_name in build.get_sub_commands(): + cmd = dist.get_command_obj(cmd_name) + if hasattr(cmd, "editable_mode"): + cmd.editable_mode = True + elif hasattr(cmd, "inplace"): + cmd.inplace = True # backward compatibility with distutils + + def _collect_build_outputs(self) -> tuple[list[str], dict[str, str]]: + files: list[str] = [] + mapping: dict[str, str] = {} + build = self.get_finalized_command("build") + + for cmd_name in build.get_sub_commands(): + cmd = self.get_finalized_command(cmd_name) + if hasattr(cmd, "get_outputs"): + files.extend(cmd.get_outputs() or []) + if hasattr(cmd, "get_output_mapping"): + mapping.update(cmd.get_output_mapping() or {}) + + return files, mapping + + def _run_build_commands( + self, + dist_name: str, + unpacked_wheel: StrPath, + build_lib: StrPath, + tmp_dir: StrPath, + ) -> tuple[list[str], dict[str, str]]: + self._configure_build(dist_name, unpacked_wheel, build_lib, tmp_dir) + self._run_build_subcommands() + files, mapping = self._collect_build_outputs() + self._run_install("headers") + self._run_install("scripts") + self._run_install("data") + return files, mapping + + def _run_build_subcommands(self) -> None: + """ + Issue #3501 indicates that some plugins/customizations might rely on: + + 1. ``build_py`` not running + 2. ``build_py`` always copying files to ``build_lib`` + + However both these assumptions may be false in editable_wheel. + This method implements a temporary workaround to support the ecosystem + while the implementations catch up. + """ + # TODO: Once plugins/customizations had the chance to catch up, replace + # `self._run_build_subcommands()` with `self.run_command("build")`. + # Also remove _safely_run, TestCustomBuildPy. Suggested date: Aug/2023. + build = self.get_finalized_command("build") + for name in build.get_sub_commands(): + cmd = self.get_finalized_command(name) + if name == "build_py" and type(cmd) is not build_py_cls: + self._safely_run(name) + else: + self.run_command(name) + + def _safely_run(self, cmd_name: str): + try: + return self.run_command(cmd_name) + except Exception: + SetuptoolsDeprecationWarning.emit( + "Customization incompatible with editable install", + f""" + {traceback.format_exc()} + + If you are seeing this warning it is very likely that a setuptools + plugin or customization overrides the `{cmd_name}` command, without + taking into consideration how editable installs run build steps + starting from setuptools v64.0.0. + + Plugin authors and developers relying on custom build steps are + encouraged to update their `{cmd_name}` implementation considering the + information about editable installs in + https://setuptools.pypa.io/en/latest/userguide/extension.html. + + For the time being `setuptools` will silence this error and ignore + the faulty command, but this behavior will change in future versions. + """, + # TODO: define due_date + # There is a series of shortcomings with the available editable install + # methods, and they are very controversial. This is something that still + # needs work. + ) + + def _create_wheel_file(self, bdist_wheel): + from wheel.wheelfile import WheelFile + + dist_info = self.get_finalized_command("dist_info") + dist_name = dist_info.name + tag = "-".join(bdist_wheel.get_tag()) + build_tag = "0.editable" # According to PEP 427 needs to start with digit + archive_name = f"{dist_name}-{build_tag}-{tag}.whl" + wheel_path = Path(self.dist_dir, archive_name) + if wheel_path.exists(): + wheel_path.unlink() + + unpacked_wheel = TemporaryDirectory(suffix=archive_name) + build_lib = TemporaryDirectory(suffix=".build-lib") + build_tmp = TemporaryDirectory(suffix=".build-temp") + + with unpacked_wheel as unpacked, build_lib as lib, build_tmp as tmp: + unpacked_dist_info = Path(unpacked, Path(self.dist_info_dir).name) + shutil.copytree(self.dist_info_dir, unpacked_dist_info) + self._install_namespaces(unpacked, dist_name) + files, mapping = self._run_build_commands(dist_name, unpacked, lib, tmp) + strategy = self._select_strategy(dist_name, tag, lib) + with strategy, WheelFile(wheel_path, "w") as wheel_obj: + strategy(wheel_obj, files, mapping) + wheel_obj.write_files(unpacked) + + return wheel_path + + def _run_install(self, category: str): + has_category = getattr(self.distribution, f"has_{category}", None) + if has_category and has_category(): + _logger.info(f"Installing {category} as non editable") + self.run_command(f"install_{category}") + + def _select_strategy( + self, + name: str, + tag: str, + build_lib: StrPath, + ) -> EditableStrategy: + """Decides which strategy to use to implement an editable installation.""" + build_name = f"__editable__.{name}-{tag}" + project_dir = Path(self.project_dir) + mode = _EditableMode.convert(self.mode) + + if mode is _EditableMode.STRICT: + auxiliary_dir = _empty_dir(Path(self.project_dir, "build", build_name)) + return _LinkTree(self.distribution, name, auxiliary_dir, build_lib) + + packages = _find_packages(self.distribution) + has_simple_layout = _simple_layout(packages, self.package_dir, project_dir) + is_compat_mode = mode is _EditableMode.COMPAT + if set(self.package_dir) == {""} and has_simple_layout or is_compat_mode: + # src-layout(ish) is relatively safe for a simple pth file + src_dir = self.package_dir.get("", ".") + return _StaticPth(self.distribution, name, [Path(project_dir, src_dir)]) + + # Use a MetaPathFinder to avoid adding accidental top-level packages/modules + return _TopLevelFinder(self.distribution, name) + + +class EditableStrategy(Protocol): + def __call__( + self, wheel: WheelFile, files: list[str], mapping: Mapping[str, str] + ) -> object: ... + def __enter__(self) -> Self: ... + def __exit__( + self, + _exc_type: type[BaseException] | None, + _exc_value: BaseException | None, + _traceback: TracebackType | None, + ) -> object: ... + + +class _StaticPth: + def __init__(self, dist: Distribution, name: str, path_entries: list[Path]) -> None: + self.dist = dist + self.name = name + self.path_entries = path_entries + + def __call__(self, wheel: WheelFile, files: list[str], mapping: Mapping[str, str]): + entries = "\n".join(str(p.resolve()) for p in self.path_entries) + contents = _encode_pth(f"{entries}\n") + wheel.writestr(f"__editable__.{self.name}.pth", contents) + + def __enter__(self) -> Self: + msg = f""" + Editable install will be performed using .pth file to extend `sys.path` with: + {list(map(os.fspath, self.path_entries))!r} + """ + _logger.warning(msg + _LENIENT_WARNING) + return self + + def __exit__( + self, + _exc_type: object, + _exc_value: object, + _traceback: object, + ) -> None: + pass + + +class _LinkTree(_StaticPth): + """ + Creates a ``.pth`` file that points to a link tree in the ``auxiliary_dir``. + + This strategy will only link files (not dirs), so it can be implemented in + any OS, even if that means using hardlinks instead of symlinks. + + By collocating ``auxiliary_dir`` and the original source code, limitations + with hardlinks should be avoided. + """ + + def __init__( + self, + dist: Distribution, + name: str, + auxiliary_dir: StrPath, + build_lib: StrPath, + ) -> None: + self.auxiliary_dir = Path(auxiliary_dir) + self.build_lib = Path(build_lib).resolve() + self._file = dist.get_command_obj("build_py").copy_file + super().__init__(dist, name, [self.auxiliary_dir]) + + def __call__(self, wheel: WheelFile, files: list[str], mapping: Mapping[str, str]): + self._create_links(files, mapping) + super().__call__(wheel, files, mapping) + + def _normalize_output(self, file: str) -> str | None: + # Files relative to build_lib will be normalized to None + with suppress(ValueError): + path = Path(file).resolve().relative_to(self.build_lib) + return str(path).replace(os.sep, '/') + return None + + def _create_file(self, relative_output: str, src_file: str, link=None): + dest = self.auxiliary_dir / relative_output + if not dest.parent.is_dir(): + dest.parent.mkdir(parents=True) + self._file(src_file, dest, link=link) + + def _create_links(self, outputs, output_mapping: Mapping[str, str]): + self.auxiliary_dir.mkdir(parents=True, exist_ok=True) + link_type = "sym" if _can_symlink_files(self.auxiliary_dir) else "hard" + normalised = ((self._normalize_output(k), v) for k, v in output_mapping.items()) + # remove files that are not relative to build_lib + mappings = {k: v for k, v in normalised if k is not None} + + for output in outputs: + relative = self._normalize_output(output) + if relative and relative not in mappings: + self._create_file(relative, output) + + for relative, src in mappings.items(): + self._create_file(relative, src, link=link_type) + + def __enter__(self) -> Self: + msg = "Strict editable install will be performed using a link tree.\n" + _logger.warning(msg + _STRICT_WARNING) + return self + + def __exit__( + self, + _exc_type: object, + _exc_value: object, + _traceback: object, + ) -> None: + msg = f"""\n + Strict editable installation performed using the auxiliary directory: + {self.auxiliary_dir} + + Please be careful to not remove this directory, otherwise you might not be able + to import/use your package. + """ + InformationOnly.emit("Editable installation.", msg) + + +class _TopLevelFinder: + def __init__(self, dist: Distribution, name: str) -> None: + self.dist = dist + self.name = name + + def template_vars(self) -> tuple[str, str, dict[str, str], dict[str, list[str]]]: + src_root = self.dist.src_root or os.curdir + top_level = chain(_find_packages(self.dist), _find_top_level_modules(self.dist)) + package_dir = self.dist.package_dir or {} + roots = _find_package_roots(top_level, package_dir, src_root) + + namespaces_ = dict( + chain( + _find_namespaces(self.dist.packages or [], roots), + ((ns, []) for ns in _find_virtual_namespaces(roots)), + ) + ) + + legacy_namespaces = { + pkg: find_package_path(pkg, roots, self.dist.src_root or "") + for pkg in self.dist.namespace_packages or [] + } + + mapping = {**roots, **legacy_namespaces} + # ^-- We need to explicitly add the legacy_namespaces to the mapping to be + # able to import their modules even if another package sharing the same + # namespace is installed in a conventional (non-editable) way. + + name = f"__editable__.{self.name}.finder" + finder = _normalization.safe_identifier(name) + return finder, name, mapping, namespaces_ + + def get_implementation(self) -> Iterator[tuple[str, bytes]]: + finder, name, mapping, namespaces_ = self.template_vars() + + content = bytes(_finder_template(name, mapping, namespaces_), "utf-8") + yield (f"{finder}.py", content) + + content = _encode_pth(f"import {finder}; {finder}.install()") + yield (f"__editable__.{self.name}.pth", content) + + def __call__(self, wheel: WheelFile, files: list[str], mapping: Mapping[str, str]): + for file, content in self.get_implementation(): + wheel.writestr(file, content) + + def __enter__(self) -> Self: + msg = "Editable install will be performed using a meta path finder.\n" + _logger.warning(msg + _LENIENT_WARNING) + return self + + def __exit__( + self, + _exc_type: object, + _exc_value: object, + _traceback: object, + ) -> None: + msg = """\n + Please be careful with folders in your working directory with the same + name as your package as they may take precedence during imports. + """ + InformationOnly.emit("Editable installation.", msg) + + +def _encode_pth(content: str) -> bytes: + """ + Prior to Python 3.13 (see https://github.com/python/cpython/issues/77102), + .pth files are always read with 'locale' encoding, the recommendation + from the cpython core developers is to write them as ``open(path, "w")`` + and ignore warnings (see python/cpython#77102, pypa/setuptools#3937). + This function tries to simulate this behavior without having to create an + actual file, in a way that supports a range of active Python versions. + (There seems to be some variety in the way different version of Python handle + ``encoding=None``, not all of them use ``locale.getpreferredencoding(False)`` + or ``locale.getencoding()``). + """ + with io.BytesIO() as buffer: + wrapper = io.TextIOWrapper(buffer, encoding=py312.PTH_ENCODING) + # TODO: Python 3.13 replace the whole function with `bytes(content, "utf-8")` + wrapper.write(content) + wrapper.flush() + buffer.seek(0) + return buffer.read() + + +def _can_symlink_files(base_dir: Path) -> bool: + with TemporaryDirectory(dir=str(base_dir.resolve())) as tmp: + path1, path2 = Path(tmp, "file1.txt"), Path(tmp, "file2.txt") + path1.write_text("file1", encoding="utf-8") + with suppress(AttributeError, NotImplementedError, OSError): + os.symlink(path1, path2) + if path2.is_symlink() and path2.read_text(encoding="utf-8") == "file1": + return True + + try: + os.link(path1, path2) # Ensure hard links can be created + except Exception as ex: + msg = ( + "File system does not seem to support either symlinks or hard links. " + "Strict editable installs require one of them to be supported." + ) + raise LinksNotSupported(msg) from ex + return False + + +def _simple_layout( + packages: Iterable[str], package_dir: dict[str, str], project_dir: StrPath +) -> bool: + """Return ``True`` if: + - all packages are contained by the same parent directory, **and** + - all packages become importable if the parent directory is added to ``sys.path``. + + >>> _simple_layout(['a'], {"": "src"}, "/tmp/myproj") + True + >>> _simple_layout(['a', 'a.b'], {"": "src"}, "/tmp/myproj") + True + >>> _simple_layout(['a', 'a.b'], {}, "/tmp/myproj") + True + >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"": "src"}, "/tmp/myproj") + True + >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "a", "b": "b"}, ".") + True + >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "_a", "b": "_b"}, ".") + False + >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "_a"}, "/tmp/myproj") + False + >>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a.a1.a2": "_a2"}, ".") + False + >>> _simple_layout(['a', 'a.b'], {"": "src", "a.b": "_ab"}, "/tmp/myproj") + False + >>> # Special cases, no packages yet: + >>> _simple_layout([], {"": "src"}, "/tmp/myproj") + True + >>> _simple_layout([], {"a": "_a", "": "src"}, "/tmp/myproj") + False + """ + layout = {pkg: find_package_path(pkg, package_dir, project_dir) for pkg in packages} + if not layout: + return set(package_dir) in ({}, {""}) + parent = os.path.commonpath(starmap(_parent_path, layout.items())) + return all( + _path.same_path(Path(parent, *key.split('.')), value) + for key, value in layout.items() + ) + + +def _parent_path(pkg, pkg_path): + """Infer the parent path containing a package, that if added to ``sys.path`` would + allow importing that package. + When ``pkg`` is directly mapped into a directory with a different name, return its + own path. + >>> _parent_path("a", "src/a") + 'src' + >>> _parent_path("b", "src/c") + 'src/c' + """ + parent = pkg_path[: -len(pkg)] if pkg_path.endswith(pkg) else pkg_path + return parent.rstrip("/" + os.sep) + + +def _find_packages(dist: Distribution) -> Iterator[str]: + yield from iter(dist.packages or []) + + py_modules = dist.py_modules or [] + nested_modules = [mod for mod in py_modules if "." in mod] + if dist.ext_package: + yield dist.ext_package + else: + ext_modules = dist.ext_modules or [] + nested_modules += [x.name for x in ext_modules if "." in x.name] + + for module in nested_modules: + package, _, _ = module.rpartition(".") + yield package + + +def _find_top_level_modules(dist: Distribution) -> Iterator[str]: + py_modules = dist.py_modules or [] + yield from (mod for mod in py_modules if "." not in mod) + + if not dist.ext_package: + ext_modules = dist.ext_modules or [] + yield from (x.name for x in ext_modules if "." not in x.name) + + +def _find_package_roots( + packages: Iterable[str], + package_dir: Mapping[str, str], + src_root: StrPath, +) -> dict[str, str]: + pkg_roots: dict[str, str] = { + pkg: _absolute_root(find_package_path(pkg, package_dir, src_root)) + for pkg in sorted(packages) + } + + return _remove_nested(pkg_roots) + + +def _absolute_root(path: StrPath) -> str: + """Works for packages and top-level modules""" + path_ = Path(path) + parent = path_.parent + + if path_.exists(): + return str(path_.resolve()) + else: + return str(parent.resolve() / path_.name) + + +def _find_virtual_namespaces(pkg_roots: dict[str, str]) -> Iterator[str]: + """By carefully designing ``package_dir``, it is possible to implement the logical + structure of PEP 420 in a package without the corresponding directories. + + Moreover a parent package can be purposefully/accidentally skipped in the discovery + phase (e.g. ``find_packages(include=["mypkg.*"])``, when ``mypkg.foo`` is included + by ``mypkg`` itself is not). + We consider this case to also be a virtual namespace (ignoring the original + directory) to emulate a non-editable installation. + + This function will try to find these kinds of namespaces. + """ + for pkg in pkg_roots: + if "." not in pkg: + continue + parts = pkg.split(".") + for i in range(len(parts) - 1, 0, -1): + partial_name = ".".join(parts[:i]) + path = Path(find_package_path(partial_name, pkg_roots, "")) + if not path.exists() or partial_name not in pkg_roots: + # partial_name not in pkg_roots ==> purposefully/accidentally skipped + yield partial_name + + +def _find_namespaces( + packages: list[str], pkg_roots: dict[str, str] +) -> Iterator[tuple[str, list[str]]]: + for pkg in packages: + path = find_package_path(pkg, pkg_roots, "") + if Path(path).exists() and not Path(path, "__init__.py").exists(): + yield (pkg, [path]) + + +def _remove_nested(pkg_roots: dict[str, str]) -> dict[str, str]: + output = dict(pkg_roots.copy()) + + for pkg, path in reversed(list(pkg_roots.items())): + if any( + pkg != other and _is_nested(pkg, path, other, other_path) + for other, other_path in pkg_roots.items() + ): + output.pop(pkg) + + return output + + +def _is_nested(pkg: str, pkg_path: str, parent: str, parent_path: str) -> bool: + """ + Return ``True`` if ``pkg`` is nested inside ``parent`` both logically and in the + file system. + >>> _is_nested("a.b", "path/a/b", "a", "path/a") + True + >>> _is_nested("a.b", "path/a/b", "a", "otherpath/a") + False + >>> _is_nested("a.b", "path/a/b", "c", "path/c") + False + >>> _is_nested("a.a", "path/a/a", "a", "path/a") + True + >>> _is_nested("b.a", "path/b/a", "a", "path/a") + False + """ + norm_pkg_path = _path.normpath(pkg_path) + rest = pkg.replace(parent, "", 1).strip(".").split(".") + return pkg.startswith(parent) and norm_pkg_path == _path.normpath( + Path(parent_path, *rest) + ) + + +def _empty_dir(dir_: _P) -> _P: + """Create a directory ensured to be empty. Existing files may be removed.""" + _shutil.rmtree(dir_, ignore_errors=True) + os.makedirs(dir_) + return dir_ + + +class _NamespaceInstaller(namespaces.Installer): + def __init__(self, distribution, installation_dir, editable_name, src_root) -> None: + self.distribution = distribution + self.src_root = src_root + self.installation_dir = installation_dir + self.editable_name = editable_name + self.outputs: list[str] = [] + self.dry_run = False + + def _get_nspkg_file(self): + """Installation target.""" + return os.path.join(self.installation_dir, self.editable_name + self.nspkg_ext) + + def _get_root(self): + """Where the modules/packages should be loaded from.""" + return repr(str(self.src_root)) + + +_FINDER_TEMPLATE = """\ +from __future__ import annotations +import sys +from importlib.machinery import ModuleSpec, PathFinder +from importlib.machinery import all_suffixes as module_suffixes +from importlib.util import spec_from_file_location +from itertools import chain +from pathlib import Path + +MAPPING: dict[str, str] = {mapping!r} +NAMESPACES: dict[str, list[str]] = {namespaces!r} +PATH_PLACEHOLDER = {name!r} + ".__path_hook__" + + +class _EditableFinder: # MetaPathFinder + @classmethod + def find_spec(cls, fullname: str, path=None, target=None) -> ModuleSpec | None: # type: ignore + # Top-level packages and modules (we know these exist in the FS) + if fullname in MAPPING: + pkg_path = MAPPING[fullname] + return cls._find_spec(fullname, Path(pkg_path)) + + # Handle immediate children modules (required for namespaces to work) + # To avoid problems with case sensitivity in the file system we delegate + # to the importlib.machinery implementation. + parent, _, child = fullname.rpartition(".") + if parent and parent in MAPPING: + return PathFinder.find_spec(fullname, path=[MAPPING[parent]]) + + # Other levels of nesting should be handled automatically by importlib + # using the parent path. + return None + + @classmethod + def _find_spec(cls, fullname: str, candidate_path: Path) -> ModuleSpec | None: + init = candidate_path / "__init__.py" + candidates = (candidate_path.with_suffix(x) for x in module_suffixes()) + for candidate in chain([init], candidates): + if candidate.exists(): + return spec_from_file_location(fullname, candidate) + return None + + +class _EditableNamespaceFinder: # PathEntryFinder + @classmethod + def _path_hook(cls, path) -> type[_EditableNamespaceFinder]: + if path == PATH_PLACEHOLDER: + return cls + raise ImportError + + @classmethod + def _paths(cls, fullname: str) -> list[str]: + paths = NAMESPACES[fullname] + if not paths and fullname in MAPPING: + paths = [MAPPING[fullname]] + # Always add placeholder, for 2 reasons: + # 1. __path__ cannot be empty for the spec to be considered namespace. + # 2. In the case of nested namespaces, we need to force + # import machinery to query _EditableNamespaceFinder again. + return [*paths, PATH_PLACEHOLDER] + + @classmethod + def find_spec(cls, fullname: str, target=None) -> ModuleSpec | None: # type: ignore + if fullname in NAMESPACES: + spec = ModuleSpec(fullname, None, is_package=True) + spec.submodule_search_locations = cls._paths(fullname) + return spec + return None + + @classmethod + def find_module(cls, _fullname) -> None: + return None + + +def install(): + if not any(finder == _EditableFinder for finder in sys.meta_path): + sys.meta_path.append(_EditableFinder) + + if not NAMESPACES: + return + + if not any(hook == _EditableNamespaceFinder._path_hook for hook in sys.path_hooks): + # PathEntryFinder is needed to create NamespaceSpec without private APIS + sys.path_hooks.append(_EditableNamespaceFinder._path_hook) + if PATH_PLACEHOLDER not in sys.path: + sys.path.append(PATH_PLACEHOLDER) # Used just to trigger the path hook +""" + + +def _finder_template( + name: str, mapping: Mapping[str, str], namespaces: dict[str, list[str]] +) -> str: + """Create a string containing the code for the``MetaPathFinder`` and + ``PathEntryFinder``. + """ + mapping = dict(sorted(mapping.items(), key=lambda p: p[0])) + return _FINDER_TEMPLATE.format(name=name, mapping=mapping, namespaces=namespaces) + + +class LinksNotSupported(errors.FileError): + """File system does not seem to support either symlinks or hard links.""" diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/egg_info.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/egg_info.py new file mode 100644 index 000000000..7e00ae2ce --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/egg_info.py @@ -0,0 +1,718 @@ +"""setuptools.command.egg_info + +Create a distribution's .egg-info directory and contents""" + +import functools +import os +import re +import sys +import time +from collections.abc import Callable + +import packaging +import packaging.requirements +import packaging.version + +import setuptools.unicode_utils as unicode_utils +from setuptools import Command +from setuptools.command import bdist_egg +from setuptools.command.sdist import sdist, walk_revctrl +from setuptools.command.setopt import edit_config +from setuptools.glob import glob + +from .. import _entry_points, _normalization +from .._importlib import metadata +from ..warnings import SetuptoolsDeprecationWarning +from . import _requirestxt + +import distutils.errors +import distutils.filelist +from distutils import log +from distutils.errors import DistutilsInternalError +from distutils.filelist import FileList as _FileList +from distutils.util import convert_path + +PY_MAJOR = f'{sys.version_info.major}.{sys.version_info.minor}' + + +def translate_pattern(glob): # noqa: C901 # is too complex (14) # FIXME + """ + Translate a file path glob like '*.txt' in to a regular expression. + This differs from fnmatch.translate which allows wildcards to match + directory separators. It also knows about '**/' which matches any number of + directories. + """ + pat = '' + + # This will split on '/' within [character classes]. This is deliberate. + chunks = glob.split(os.path.sep) + + sep = re.escape(os.sep) + valid_char = f'[^{sep}]' + + for c, chunk in enumerate(chunks): + last_chunk = c == len(chunks) - 1 + + # Chunks that are a literal ** are globstars. They match anything. + if chunk == '**': + if last_chunk: + # Match anything if this is the last component + pat += '.*' + else: + # Match '(name/)*' + pat += f'(?:{valid_char}+{sep})*' + continue # Break here as the whole path component has been handled + + # Find any special characters in the remainder + i = 0 + chunk_len = len(chunk) + while i < chunk_len: + char = chunk[i] + if char == '*': + # Match any number of name characters + pat += valid_char + '*' + elif char == '?': + # Match a name character + pat += valid_char + elif char == '[': + # Character class + inner_i = i + 1 + # Skip initial !/] chars + if inner_i < chunk_len and chunk[inner_i] == '!': + inner_i = inner_i + 1 + if inner_i < chunk_len and chunk[inner_i] == ']': + inner_i = inner_i + 1 + + # Loop till the closing ] is found + while inner_i < chunk_len and chunk[inner_i] != ']': + inner_i = inner_i + 1 + + if inner_i >= chunk_len: + # Got to the end of the string without finding a closing ] + # Do not treat this as a matching group, but as a literal [ + pat += re.escape(char) + else: + # Grab the insides of the [brackets] + inner = chunk[i + 1 : inner_i] + char_class = '' + + # Class negation + if inner[0] == '!': + char_class = '^' + inner = inner[1:] + + char_class += re.escape(inner) + pat += f'[{char_class}]' + + # Skip to the end ] + i = inner_i + else: + pat += re.escape(char) + i += 1 + + # Join each chunk with the dir separator + if not last_chunk: + pat += sep + + pat += r'\Z' + return re.compile(pat, flags=re.MULTILINE | re.DOTALL) + + +class InfoCommon: + tag_build = None + tag_date = None + + @property + def name(self): + return _normalization.safe_name(self.distribution.get_name()) + + def tagged_version(self): + tagged = self._maybe_tag(self.distribution.get_version()) + return _normalization.safe_version(tagged) + + def _maybe_tag(self, version): + """ + egg_info may be called more than once for a distribution, + in which case the version string already contains all tags. + """ + return ( + version + if self.vtags and self._already_tagged(version) + else version + self.vtags + ) + + def _already_tagged(self, version: str) -> bool: + # Depending on their format, tags may change with version normalization. + # So in addition the regular tags, we have to search for the normalized ones. + return version.endswith(self.vtags) or version.endswith(self._safe_tags()) + + def _safe_tags(self) -> str: + # To implement this we can rely on `safe_version` pretending to be version 0 + # followed by tags. Then we simply discard the starting 0 (fake version number) + try: + return _normalization.safe_version(f"0{self.vtags}")[1:] + except packaging.version.InvalidVersion: + return _normalization.safe_name(self.vtags.replace(' ', '.')) + + def tags(self) -> str: + version = '' + if self.tag_build: + version += self.tag_build + if self.tag_date: + version += time.strftime("%Y%m%d") + return version + + vtags = property(tags) + + +class egg_info(InfoCommon, Command): + description = "create a distribution's .egg-info directory" + + user_options = [ + ( + 'egg-base=', + 'e', + "directory containing .egg-info directories" + " [default: top of the source tree]", + ), + ('tag-date', 'd', "Add date stamp (e.g. 20050528) to version number"), + ('tag-build=', 'b', "Specify explicit tag to add to version number"), + ('no-date', 'D', "Don't include date stamp [default]"), + ] + + boolean_options = ['tag-date'] + negative_opt = { + 'no-date': 'tag-date', + } + + def initialize_options(self): + self.egg_base = None + self.egg_name = None + self.egg_info = None + self.egg_version = None + self.ignore_egg_info_in_manifest = False + + #################################### + # allow the 'tag_svn_revision' to be detected and + # set, supporting sdists built on older Setuptools. + @property + def tag_svn_revision(self) -> None: + pass + + @tag_svn_revision.setter + def tag_svn_revision(self, value): + pass + + #################################### + + def save_version_info(self, filename) -> None: + """ + Materialize the value of date into the + build tag. Install build keys in a deterministic order + to avoid arbitrary reordering on subsequent builds. + """ + # follow the order these keys would have been added + # when PYTHONHASHSEED=0 + egg_info = dict(tag_build=self.tags(), tag_date=0) + edit_config(filename, dict(egg_info=egg_info)) + + def finalize_options(self) -> None: + # Note: we need to capture the current value returned + # by `self.tagged_version()`, so we can later update + # `self.distribution.metadata.version` without + # repercussions. + self.egg_name = self.name + self.egg_version = self.tagged_version() + parsed_version = packaging.version.Version(self.egg_version) + + try: + is_version = isinstance(parsed_version, packaging.version.Version) + spec = "%s==%s" if is_version else "%s===%s" + packaging.requirements.Requirement(spec % (self.egg_name, self.egg_version)) + except ValueError as e: + raise distutils.errors.DistutilsOptionError( + f"Invalid distribution name or version syntax: {self.egg_name}-{self.egg_version}" + ) from e + + if self.egg_base is None: + dirs = self.distribution.package_dir + self.egg_base = (dirs or {}).get('', os.curdir) + + self.ensure_dirname('egg_base') + self.egg_info = _normalization.filename_component(self.egg_name) + '.egg-info' + if self.egg_base != os.curdir: + self.egg_info = os.path.join(self.egg_base, self.egg_info) + + # Set package version for the benefit of dumber commands + # (e.g. sdist, bdist_wininst, etc.) + # + self.distribution.metadata.version = self.egg_version + + def _get_egg_basename(self, py_version=PY_MAJOR, platform=None): + """Compute filename of the output egg. Private API.""" + return _egg_basename(self.egg_name, self.egg_version, py_version, platform) + + def write_or_delete_file(self, what, filename, data, force: bool = False) -> None: + """Write `data` to `filename` or delete if empty + + If `data` is non-empty, this routine is the same as ``write_file()``. + If `data` is empty but not ``None``, this is the same as calling + ``delete_file(filename)`. If `data` is ``None``, then this is a no-op + unless `filename` exists, in which case a warning is issued about the + orphaned file (if `force` is false), or deleted (if `force` is true). + """ + if data: + self.write_file(what, filename, data) + elif os.path.exists(filename): + if data is None and not force: + log.warn("%s not set in setup(), but %s exists", what, filename) + return + else: + self.delete_file(filename) + + def write_file(self, what, filename, data) -> None: + """Write `data` to `filename` (if not a dry run) after announcing it + + `what` is used in a log message to identify what is being written + to the file. + """ + log.info("writing %s to %s", what, filename) + data = data.encode("utf-8") + if not self.dry_run: + f = open(filename, 'wb') + f.write(data) + f.close() + + def delete_file(self, filename) -> None: + """Delete `filename` (if not a dry run) after announcing it""" + log.info("deleting %s", filename) + if not self.dry_run: + os.unlink(filename) + + def run(self) -> None: + # Pre-load to avoid iterating over entry-points while an empty .egg-info + # exists in sys.path. See pypa/pyproject-hooks#206 + writers = list(metadata.entry_points(group='egg_info.writers')) + + self.mkpath(self.egg_info) + try: + os.utime(self.egg_info, None) + except OSError as e: + msg = f"Cannot update time stamp of directory '{self.egg_info}'" + raise distutils.errors.DistutilsFileError(msg) from e + for ep in writers: + writer = ep.load() + writer(self, ep.name, os.path.join(self.egg_info, ep.name)) + + # Get rid of native_libs.txt if it was put there by older bdist_egg + nl = os.path.join(self.egg_info, "native_libs.txt") + if os.path.exists(nl): + self.delete_file(nl) + + self.find_sources() + + def find_sources(self) -> None: + """Generate SOURCES.txt manifest file""" + manifest_filename = os.path.join(self.egg_info, "SOURCES.txt") + mm = manifest_maker(self.distribution) + mm.ignore_egg_info_dir = self.ignore_egg_info_in_manifest + mm.manifest = manifest_filename + mm.run() + self.filelist = mm.filelist + + +class FileList(_FileList): + # Implementations of the various MANIFEST.in commands + + def __init__( + self, warn=None, debug_print=None, ignore_egg_info_dir: bool = False + ) -> None: + super().__init__(warn, debug_print) + self.ignore_egg_info_dir = ignore_egg_info_dir + + def process_template_line(self, line) -> None: + # 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 (dir_pattern). + (action, patterns, dir, dir_pattern) = self._parse_template_line(line) + + action_map: dict[str, Callable] = { + 'include': self.include, + 'exclude': self.exclude, + 'global-include': self.global_include, + 'global-exclude': self.global_exclude, + 'recursive-include': functools.partial( + self.recursive_include, + dir, + ), + 'recursive-exclude': functools.partial( + self.recursive_exclude, + dir, + ), + 'graft': self.graft, + 'prune': self.prune, + } + log_map = { + 'include': "warning: no files found matching '%s'", + 'exclude': ("warning: no previously-included files found matching '%s'"), + 'global-include': ( + "warning: no files found matching '%s' anywhere in distribution" + ), + 'global-exclude': ( + "warning: no previously-included files matching " + "'%s' found anywhere in distribution" + ), + 'recursive-include': ( + "warning: no files found matching '%s' under directory '%s'" + ), + 'recursive-exclude': ( + "warning: no previously-included files matching " + "'%s' found under directory '%s'" + ), + 'graft': "warning: no directories found matching '%s'", + 'prune': "no previously-included directories found matching '%s'", + } + + try: + process_action = action_map[action] + except KeyError: + msg = f"Invalid MANIFEST.in: unknown action {action!r} in {line!r}" + raise DistutilsInternalError(msg) from None + + # 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. + + action_is_recursive = action.startswith('recursive-') + if action in {'graft', 'prune'}: + patterns = [dir_pattern] + extra_log_args = (dir,) if action_is_recursive else () + log_tmpl = log_map[action] + + self.debug_print( + ' '.join( + [action] + ([dir] if action_is_recursive else []) + patterns, + ) + ) + for pattern in patterns: + if not process_action(pattern): + log.warn(log_tmpl, pattern, *extra_log_args) + + def _remove_files(self, predicate): + """ + Remove all files from the file list that match the predicate. + Return True if any matching files were removed + """ + found = False + for i in range(len(self.files) - 1, -1, -1): + if predicate(self.files[i]): + self.debug_print(" removing " + self.files[i]) + del self.files[i] + found = True + return found + + def include(self, pattern): + """Include files that match 'pattern'.""" + found = [f for f in glob(pattern) if not os.path.isdir(f)] + self.extend(found) + return bool(found) + + def exclude(self, pattern): + """Exclude files that match 'pattern'.""" + match = translate_pattern(pattern) + return self._remove_files(match.match) + + def recursive_include(self, dir, pattern): + """ + Include all files anywhere in 'dir/' that match the pattern. + """ + full_pattern = os.path.join(dir, '**', pattern) + found = [f for f in glob(full_pattern, recursive=True) if not os.path.isdir(f)] + self.extend(found) + return bool(found) + + def recursive_exclude(self, dir, pattern): + """ + Exclude any file anywhere in 'dir/' that match the pattern. + """ + match = translate_pattern(os.path.join(dir, '**', pattern)) + return self._remove_files(match.match) + + def graft(self, dir): + """Include all files from 'dir/'.""" + found = [ + item + for match_dir in glob(dir) + for item in distutils.filelist.findall(match_dir) + ] + self.extend(found) + return bool(found) + + def prune(self, dir): + """Filter out files from 'dir/'.""" + match = translate_pattern(os.path.join(dir, '**')) + return self._remove_files(match.match) + + def global_include(self, pattern): + """ + Include all files anywhere in the current directory that match the + pattern. This is very inefficient on large file trees. + """ + if self.allfiles is None: + self.findall() + match = translate_pattern(os.path.join('**', pattern)) + found = [f for f in self.allfiles if match.match(f)] + self.extend(found) + return bool(found) + + def global_exclude(self, pattern): + """ + Exclude all files anywhere that match the pattern. + """ + match = translate_pattern(os.path.join('**', pattern)) + return self._remove_files(match.match) + + def append(self, item) -> None: + if item.endswith('\r'): # Fix older sdists built on Windows + item = item[:-1] + path = convert_path(item) + + if self._safe_path(path): + self.files.append(path) + + def extend(self, paths) -> None: + self.files.extend(filter(self._safe_path, paths)) + + def _repair(self): + """ + Replace self.files with only safe paths + + Because some owners of FileList manipulate the underlying + ``files`` attribute directly, this method must be called to + repair those paths. + """ + self.files = list(filter(self._safe_path, self.files)) + + def _safe_path(self, path): + enc_warn = "'%s' not %s encodable -- skipping" + + # To avoid accidental trans-codings errors, first to unicode + u_path = unicode_utils.filesys_decode(path) + if u_path is None: + log.warn(f"'{path}' in unexpected encoding -- skipping") + return False + + # Must ensure utf-8 encodability + utf8_path = unicode_utils.try_encode(u_path, "utf-8") + if utf8_path is None: + log.warn(enc_warn, path, 'utf-8') + return False + + try: + # ignore egg-info paths + is_egg_info = ".egg-info" in u_path or b".egg-info" in utf8_path + if self.ignore_egg_info_dir and is_egg_info: + return False + # accept is either way checks out + if os.path.exists(u_path) or os.path.exists(utf8_path): + return True + # this will catch any encode errors decoding u_path + except UnicodeEncodeError: + log.warn(enc_warn, path, sys.getfilesystemencoding()) + + +class manifest_maker(sdist): + template = "MANIFEST.in" + + def initialize_options(self) -> None: + self.use_defaults = True + self.prune = True + self.manifest_only = True + self.force_manifest = True + self.ignore_egg_info_dir = False + + def finalize_options(self) -> None: + pass + + def run(self) -> None: + self.filelist = FileList(ignore_egg_info_dir=self.ignore_egg_info_dir) + if not os.path.exists(self.manifest): + self.write_manifest() # it must exist so it'll get in the list + self.add_defaults() + if os.path.exists(self.template): + self.read_template() + self.add_license_files() + self._add_referenced_files() + self.prune_file_list() + self.filelist.sort() + self.filelist.remove_duplicates() + self.write_manifest() + + def _manifest_normalize(self, path): + path = unicode_utils.filesys_decode(path) + return path.replace(os.sep, '/') + + def write_manifest(self) -> None: + """ + Write the file list in 'self.filelist' to the manifest file + named by 'self.manifest'. + """ + self.filelist._repair() + + # Now _repairs should encodability, but not unicode + files = [self._manifest_normalize(f) for f in self.filelist.files] + msg = f"writing manifest file '{self.manifest}'" + self.execute(write_file, (self.manifest, files), msg) + + def warn(self, msg) -> None: + if not self._should_suppress_warning(msg): + sdist.warn(self, msg) + + @staticmethod + def _should_suppress_warning(msg): + """ + suppress missing-file warnings from sdist + """ + return re.match(r"standard file .*not found", msg) + + def add_defaults(self) -> None: + sdist.add_defaults(self) + self.filelist.append(self.template) + self.filelist.append(self.manifest) + rcfiles = list(walk_revctrl()) + if rcfiles: + self.filelist.extend(rcfiles) + elif os.path.exists(self.manifest): + self.read_manifest() + + if os.path.exists("setup.py"): + # setup.py should be included by default, even if it's not + # the script called to create the sdist + self.filelist.append("setup.py") + + ei_cmd = self.get_finalized_command('egg_info') + self.filelist.graft(ei_cmd.egg_info) + + def add_license_files(self) -> None: + license_files = self.distribution.metadata.license_files or [] + for lf in license_files: + log.info("adding license file '%s'", lf) + self.filelist.extend(license_files) + + def _add_referenced_files(self): + """Add files referenced by the config (e.g. `file:` directive) to filelist""" + referenced = getattr(self.distribution, '_referenced_files', []) + # ^-- fallback if dist comes from distutils or is a custom class + for rf in referenced: + log.debug("adding file referenced by config '%s'", rf) + self.filelist.extend(referenced) + + def _safe_data_files(self, build_py): + """ + The parent class implementation of this method + (``sdist``) will try to include data files, which + might cause recursion problems when + ``include_package_data=True``. + + Therefore, avoid triggering any attempt of + analyzing/building the manifest again. + """ + if hasattr(build_py, 'get_data_files_without_manifest'): + return build_py.get_data_files_without_manifest() + + SetuptoolsDeprecationWarning.emit( + "`build_py` command does not inherit from setuptools' `build_py`.", + """ + Custom 'build_py' does not implement 'get_data_files_without_manifest'. + Please extend command classes from setuptools instead of distutils. + """, + see_url="https://peps.python.org/pep-0632/", + # due_date not defined yet, old projects might still do it? + ) + return build_py.get_data_files() + + +def write_file(filename, contents) -> None: + """Create a file with the specified name and write 'contents' (a + sequence of strings without line terminators) to it. + """ + contents = "\n".join(contents) + + # assuming the contents has been vetted for utf-8 encoding + contents = contents.encode("utf-8") + + with open(filename, "wb") as f: # always write POSIX-style manifest + f.write(contents) + + +def write_pkg_info(cmd, basename, filename) -> None: + log.info("writing %s", filename) + if not cmd.dry_run: + metadata = cmd.distribution.metadata + metadata.version, oldver = cmd.egg_version, metadata.version + metadata.name, oldname = cmd.egg_name, metadata.name + + try: + metadata.write_pkg_info(cmd.egg_info) + finally: + metadata.name, metadata.version = oldname, oldver + + safe = getattr(cmd.distribution, 'zip_safe', None) + + bdist_egg.write_safety_flag(cmd.egg_info, safe) + + +def warn_depends_obsolete(cmd, basename, filename) -> None: + """ + Unused: left to avoid errors when updating (from source) from <= 67.8. + Old installations have a .dist-info directory with the entry-point + ``depends.txt = setuptools.command.egg_info:warn_depends_obsolete``. + This may trigger errors when running the first egg_info in build_meta. + TODO: Remove this function in a version sufficiently > 68. + """ + + +# Export API used in entry_points +write_requirements = _requirestxt.write_requirements +write_setup_requirements = _requirestxt.write_setup_requirements + + +def write_toplevel_names(cmd, basename, filename) -> None: + pkgs = dict.fromkeys([ + k.split('.', 1)[0] for k in cmd.distribution.iter_distribution_names() + ]) + cmd.write_file("top-level names", filename, '\n'.join(sorted(pkgs)) + '\n') + + +def overwrite_arg(cmd, basename, filename) -> None: + write_arg(cmd, basename, filename, True) + + +def write_arg(cmd, basename, filename, force: bool = False) -> None: + argname = os.path.splitext(basename)[0] + value = getattr(cmd.distribution, argname, None) + if value is not None: + value = '\n'.join(value) + '\n' + cmd.write_or_delete_file(argname, filename, value, force) + + +def write_entries(cmd, basename, filename) -> None: + eps = _entry_points.load(cmd.distribution.entry_points) + defn = _entry_points.render(eps) + cmd.write_or_delete_file('entry points', filename, defn, True) + + +def _egg_basename(egg_name, egg_version, py_version=None, platform=None): + """Compute filename of the output egg. Private API.""" + name = _normalization.filename_component(egg_name) + version = _normalization.filename_component(egg_version) + egg = f"{name}-{version}-py{py_version or PY_MAJOR}" + if platform: + egg += f"-{platform}" + return egg + + +class EggInfoDeprecationWarning(SetuptoolsDeprecationWarning): + """Deprecated behavior warning for EggInfo, bypassing suppression.""" diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install.py new file mode 100644 index 000000000..19ca60145 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install.py @@ -0,0 +1,131 @@ +from __future__ import annotations + +import inspect +import platform +from collections.abc import Callable +from typing import TYPE_CHECKING, Any, ClassVar + +from ..dist import Distribution +from ..warnings import SetuptoolsDeprecationWarning, SetuptoolsWarning + +import distutils.command.install as orig +from distutils.errors import DistutilsArgError + +if TYPE_CHECKING: + # This is only used for a type-cast, don't import at runtime or it'll cause deprecation warnings + from .easy_install import easy_install as easy_install_cls +else: + easy_install_cls = None + + +def __getattr__(name: str): # pragma: no cover + if name == "_install": + SetuptoolsDeprecationWarning.emit( + "`setuptools.command._install` was an internal implementation detail " + "that was left in for numpy<1.9 support.", + due_date=(2025, 5, 2), # Originally added on 2024-11-01 + ) + return orig.install + raise AttributeError(f"module {__name__!r} has no attribute {name!r}") + + +class install(orig.install): + """Use easy_install to install the package, w/dependencies""" + + distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution + + user_options = orig.install.user_options + [ + ('old-and-unmanageable', None, "Try not to use this!"), + ( + 'single-version-externally-managed', + None, + "used by system package builders to create 'flat' eggs", + ), + ] + boolean_options = orig.install.boolean_options + [ + 'old-and-unmanageable', + 'single-version-externally-managed', + ] + # Type the same as distutils.command.install.install.sub_commands + # Must keep the second tuple item potentially None due to invariance + new_commands: ClassVar[list[tuple[str, Callable[[Any], bool] | None]]] = [ + ('install_egg_info', lambda self: True), + ('install_scripts', lambda self: True), + ] + _nc = dict(new_commands) + + def initialize_options(self): + SetuptoolsDeprecationWarning.emit( + "setup.py install is deprecated.", + """ + Please avoid running ``setup.py`` directly. + Instead, use pypa/build, pypa/installer or other + standards-based tools. + """, + see_url="https://blog.ganssle.io/articles/2021/10/setup-py-deprecated.html", + due_date=(2025, 10, 31), + ) + + super().initialize_options() + self.old_and_unmanageable = None + self.single_version_externally_managed = None + + def finalize_options(self) -> None: + super().finalize_options() + if self.root: + self.single_version_externally_managed = True + elif self.single_version_externally_managed: + if not self.root and not self.record: + raise DistutilsArgError( + "You must specify --record or --root when building system packages" + ) + + def handle_extra_path(self): + if self.root or self.single_version_externally_managed: + # explicit backward-compatibility mode, allow extra_path to work + return orig.install.handle_extra_path(self) + + # Ignore extra_path when installing an egg (or being run by another + # command without --root or --single-version-externally-managed + self.path_file = None + self.extra_dirs = '' + return None + + @staticmethod + def _called_from_setup(run_frame): + """ + Attempt to detect whether run() was called from setup() or by another + command. If called by setup(), the parent caller will be the + 'run_command' method in 'distutils.dist', and *its* caller will be + the 'run_commands' method. If called any other way, the + immediate caller *might* be 'run_command', but it won't have been + called by 'run_commands'. Return True in that case or if a call stack + is unavailable. Return False otherwise. + """ + if run_frame is None: + msg = "Call stack not available. bdist_* commands may fail." + SetuptoolsWarning.emit(msg) + if platform.python_implementation() == 'IronPython': + msg = "For best results, pass -X:Frames to enable call stack." + SetuptoolsWarning.emit(msg) + return True + + frames = inspect.getouterframes(run_frame) + for frame in frames[2:4]: + (caller,) = frame[:1] + info = inspect.getframeinfo(caller) + caller_module = caller.f_globals.get('__name__', '') + + if caller_module == "setuptools.dist" and info.function == "run_command": + # Starting from v61.0.0 setuptools overwrites dist.run_command + continue + + return caller_module == 'distutils.dist' and info.function == 'run_commands' + + return False + + +# XXX Python 3.1 doesn't see _nc if this is inside the class +install.sub_commands = [ + cmd for cmd in orig.install.sub_commands if cmd[0] not in install._nc +] + install.new_commands diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install_egg_info.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install_egg_info.py new file mode 100644 index 000000000..44f22ccf5 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install_egg_info.py @@ -0,0 +1,58 @@ +import os + +from setuptools import Command, namespaces +from setuptools.archive_util import unpack_archive + +from .._path import ensure_directory + +from distutils import dir_util, log + + +class install_egg_info(namespaces.Installer, Command): + """Install an .egg-info directory for the package""" + + description = "Install an .egg-info directory for the package" + + user_options = [ + ('install-dir=', 'd', "directory to install to"), + ] + + def initialize_options(self): + self.install_dir = None + + def finalize_options(self) -> None: + self.set_undefined_options('install_lib', ('install_dir', 'install_dir')) + ei_cmd = self.get_finalized_command("egg_info") + basename = f"{ei_cmd._get_egg_basename()}.egg-info" + self.source = ei_cmd.egg_info + self.target = os.path.join(self.install_dir, basename) + self.outputs: list[str] = [] + + def run(self) -> None: + self.run_command('egg_info') + if os.path.isdir(self.target) and not os.path.islink(self.target): + dir_util.remove_tree(self.target, dry_run=self.dry_run) + elif os.path.exists(self.target): + self.execute(os.unlink, (self.target,), "Removing " + self.target) + if not self.dry_run: + ensure_directory(self.target) + self.execute(self.copytree, (), f"Copying {self.source} to {self.target}") + self.install_namespaces() + + def get_outputs(self): + return self.outputs + + def copytree(self) -> None: + # Copy the .egg-info tree to site-packages + def skimmer(src, dst): + # filter out source-control directories; note that 'src' is always + # a '/'-separated path, regardless of platform. 'dst' is a + # platform-specific path. + for skip in '.svn/', 'CVS/': + if src.startswith(skip) or '/' + skip in src: + return None + self.outputs.append(dst) + log.debug("Copying %s to %s", src, dst) + return dst + + unpack_archive(self.source, self.target, skimmer) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install_lib.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install_lib.py new file mode 100644 index 000000000..8e1e07271 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install_lib.py @@ -0,0 +1,137 @@ +from __future__ import annotations + +import os +import sys +from itertools import product, starmap + +from .._path import StrPath +from ..dist import Distribution + +import distutils.command.install_lib as orig + + +class install_lib(orig.install_lib): + """Don't add compiled flags to filenames of non-Python files""" + + distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution + + def run(self) -> None: + self.build() + outfiles = self.install() + if outfiles is not None: + # always compile, in case we have any extension stubs to deal with + self.byte_compile(outfiles) + + def get_exclusions(self): + """ + Return a collections.Sized collections.Container of paths to be + excluded for single_version_externally_managed installations. + """ + all_packages = ( + pkg + for ns_pkg in self._get_SVEM_NSPs() + for pkg in self._all_packages(ns_pkg) + ) + + excl_specs = product(all_packages, self._gen_exclusion_paths()) + return set(starmap(self._exclude_pkg_path, excl_specs)) + + def _exclude_pkg_path(self, pkg, exclusion_path): + """ + Given a package name and exclusion path within that package, + compute the full exclusion path. + """ + parts = pkg.split('.') + [exclusion_path] + return os.path.join(self.install_dir, *parts) + + @staticmethod + def _all_packages(pkg_name): + """ + >>> list(install_lib._all_packages('foo.bar.baz')) + ['foo.bar.baz', 'foo.bar', 'foo'] + """ + while pkg_name: + yield pkg_name + pkg_name, _sep, _child = pkg_name.rpartition('.') + + def _get_SVEM_NSPs(self): + """ + Get namespace packages (list) but only for + single_version_externally_managed installations and empty otherwise. + """ + # TODO: is it necessary to short-circuit here? i.e. what's the cost + # if get_finalized_command is called even when namespace_packages is + # False? + if not self.distribution.namespace_packages: + return [] + + install_cmd = self.get_finalized_command('install') + svem = install_cmd.single_version_externally_managed + + return self.distribution.namespace_packages if svem else [] + + @staticmethod + def _gen_exclusion_paths(): + """ + Generate file paths to be excluded for namespace packages (bytecode + cache files). + """ + # always exclude the package module itself + yield '__init__.py' + + yield '__init__.pyc' + yield '__init__.pyo' + + if not hasattr(sys, 'implementation'): + return + + base = os.path.join('__pycache__', '__init__.' + sys.implementation.cache_tag) + yield base + '.pyc' + yield base + '.pyo' + yield base + '.opt-1.pyc' + yield base + '.opt-2.pyc' + + def copy_tree( + self, + infile: StrPath, + outfile: str, + # override: Using actual booleans + preserve_mode: bool = True, # type: ignore[override] + preserve_times: bool = True, # type: ignore[override] + preserve_symlinks: bool = False, # type: ignore[override] + level: object = 1, + ) -> list[str]: + assert preserve_mode + assert preserve_times + assert not preserve_symlinks + exclude = self.get_exclusions() + + if not exclude: + return orig.install_lib.copy_tree(self, infile, outfile) + + # Exclude namespace package __init__.py* files from the output + + from setuptools.archive_util import unpack_directory + + from distutils import log + + outfiles: list[str] = [] + + def pf(src: str, dst: str): + if dst in exclude: + log.warn("Skipping installation of %s (namespace package)", dst) + return False + + log.info("copying %s -> %s", src, os.path.dirname(dst)) + outfiles.append(dst) + return dst + + unpack_directory(infile, outfile, pf) + return outfiles + + def get_outputs(self): + outputs = orig.install_lib.get_outputs(self) + exclude = self.get_exclusions() + if exclude: + return [f for f in outputs if f not in exclude] + return outputs diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install_scripts.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install_scripts.py new file mode 100644 index 000000000..537181e32 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/install_scripts.py @@ -0,0 +1,67 @@ +from __future__ import annotations + +import os +import sys + +from .._path import ensure_directory +from ..dist import Distribution + +import distutils.command.install_scripts as orig +from distutils import log + + +class install_scripts(orig.install_scripts): + """Do normal script install, plus any egg_info wrapper scripts""" + + distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution + + def initialize_options(self) -> None: + orig.install_scripts.initialize_options(self) + self.no_ep = False + + def run(self) -> None: + self.run_command("egg_info") + if self.distribution.scripts: + orig.install_scripts.run(self) # run first to set up self.outfiles + else: + self.outfiles: list[str] = [] + if self.no_ep: + # don't install entry point scripts into .egg file! + return + self._install_ep_scripts() + + def _install_ep_scripts(self): + # Delay import side-effects + from .. import _scripts + from .._importlib import metadata + + ei_cmd = self.get_finalized_command("egg_info") + dist = metadata.Distribution.at(path=ei_cmd.egg_info) + bs_cmd = self.get_finalized_command('build_scripts') + exec_param = getattr(bs_cmd, 'executable', None) + writer = _scripts.ScriptWriter + if exec_param == sys.executable: + # In case the path to the Python executable contains a space, wrap + # it so it's not split up. + exec_param = [exec_param] + # resolve the writer to the environment + writer = writer.best() + cmd = writer.command_spec_class.best().from_param(exec_param) + for args in writer.get_args(dist, cmd.as_header()): + self.write_script(*args) + + def write_script(self, script_name, contents, mode: str = "t", *ignored) -> None: + """Write an executable file to the scripts directory""" + from .._shutil import attempt_chmod_verbose as chmod, current_umask + + log.info("Installing %s script to %s", script_name, self.install_dir) + target = os.path.join(self.install_dir, script_name) + self.outfiles.append(target) + + encoding = None if "b" in mode else "utf-8" + mask = current_umask() + if not self.dry_run: + ensure_directory(target) + with open(target, "w" + mode, encoding=encoding) as f: + f.write(contents) + chmod(target, 0o777 - mask) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/launcher manifest.xml b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/launcher manifest.xml new file mode 100644 index 000000000..5972a96d8 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/launcher manifest.xml @@ -0,0 +1,15 @@ + + + + + + + + + + + + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/rotate.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/rotate.py new file mode 100644 index 000000000..acdce07ba --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/rotate.py @@ -0,0 +1,65 @@ +from __future__ import annotations + +import os +from typing import ClassVar + +from .. import Command, _shutil + +from distutils import log +from distutils.errors import DistutilsOptionError +from distutils.util import convert_path + + +class rotate(Command): + """Delete older distributions""" + + description = "delete older distributions, keeping N newest files" + user_options = [ + ('match=', 'm', "patterns to match (required)"), + ('dist-dir=', 'd', "directory where the distributions are"), + ('keep=', 'k', "number of matching distributions to keep"), + ] + + boolean_options: ClassVar[list[str]] = [] + + def initialize_options(self): + self.match = None + self.dist_dir = None + self.keep = None + + def finalize_options(self) -> None: + if self.match is None: + raise DistutilsOptionError( + "Must specify one or more (comma-separated) match patterns " + "(e.g. '.zip' or '.egg')" + ) + if self.keep is None: + raise DistutilsOptionError("Must specify number of files to keep") + try: + self.keep = int(self.keep) + except ValueError as e: + raise DistutilsOptionError("--keep must be an integer") from e + if isinstance(self.match, str): + self.match = [convert_path(p.strip()) for p in self.match.split(',')] + self.set_undefined_options('bdist', ('dist_dir', 'dist_dir')) + + def run(self) -> None: + self.run_command("egg_info") + from glob import glob + + for pattern in self.match: + pattern = self.distribution.get_name() + '*' + pattern + files = glob(os.path.join(self.dist_dir, pattern)) + files = [(os.path.getmtime(f), f) for f in files] + files.sort() + files.reverse() + + log.info("%d file(s) matching %s", len(files), pattern) + files = files[self.keep :] + for t, f in files: + log.info("Deleting %s", f) + if not self.dry_run: + if os.path.isdir(f): + _shutil.rmtree(f) + else: + os.unlink(f) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/saveopts.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/saveopts.py new file mode 100644 index 000000000..2a2cbce6e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/saveopts.py @@ -0,0 +1,21 @@ +from setuptools.command.setopt import edit_config, option_base + + +class saveopts(option_base): + """Save command-line options to a file""" + + description = "save supplied options to setup.cfg or other config file" + + def run(self) -> None: + dist = self.distribution + settings: dict[str, dict[str, str]] = {} + + for cmd in dist.command_options: + if cmd == 'saveopts': + continue # don't save our own options! + + for opt, (src, val) in dist.get_option_dict(cmd).items(): + if src == "command line": + settings.setdefault(cmd, {})[opt] = val + + edit_config(self.filename, settings, self.dry_run) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/sdist.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/sdist.py new file mode 100644 index 000000000..1aed1d5e4 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/sdist.py @@ -0,0 +1,217 @@ +from __future__ import annotations + +import contextlib +import os +import re +from itertools import chain +from typing import ClassVar + +from .._importlib import metadata +from ..dist import Distribution +from .build import _ORIGINAL_SUBCOMMANDS + +import distutils.command.sdist as orig +from distutils import log + +_default_revctrl = list + + +def walk_revctrl(dirname=''): + """Find all files under revision control""" + for ep in metadata.entry_points(group='setuptools.file_finders'): + yield from ep.load()(dirname) + + +class sdist(orig.sdist): + """Smart sdist that finds anything supported by revision control""" + + user_options = [ + ('formats=', None, "formats for source distribution (comma-separated list)"), + ( + 'keep-temp', + 'k', + "keep the distribution tree around after creating archive file(s)", + ), + ( + 'dist-dir=', + 'd', + "directory to put the source distribution archive(s) in [default: dist]", + ), + ( + 'owner=', + 'u', + "Owner name used when creating a tar file [default: current user]", + ), + ( + 'group=', + 'g', + "Group name used when creating a tar file [default: current group]", + ), + ] + + distribution: Distribution # override distutils.dist.Distribution with setuptools.dist.Distribution + negative_opt: ClassVar[dict[str, str]] = {} + + README_EXTENSIONS = ['', '.rst', '.txt', '.md'] + READMES = tuple(f'README{ext}' for ext in README_EXTENSIONS) + + def run(self) -> None: + self.run_command('egg_info') + ei_cmd = self.get_finalized_command('egg_info') + self.filelist = ei_cmd.filelist + self.filelist.append(os.path.join(ei_cmd.egg_info, 'SOURCES.txt')) + self.check_readme() + + # Run sub commands + for cmd_name in self.get_sub_commands(): + self.run_command(cmd_name) + + self.make_distribution() + + dist_files = getattr(self.distribution, 'dist_files', []) + for file in self.archive_files: + data = ('sdist', '', file) + if data not in dist_files: + dist_files.append(data) + + def initialize_options(self) -> None: + orig.sdist.initialize_options(self) + + def make_distribution(self) -> None: + """ + Workaround for #516 + """ + with self._remove_os_link(): + orig.sdist.make_distribution(self) + + @staticmethod + @contextlib.contextmanager + def _remove_os_link(): + """ + In a context, remove and restore os.link if it exists + """ + + class NoValue: + pass + + orig_val = getattr(os, 'link', NoValue) + try: + del os.link + except Exception: + pass + try: + yield + finally: + if orig_val is not NoValue: + os.link = orig_val + + def add_defaults(self) -> None: + super().add_defaults() + self._add_defaults_build_sub_commands() + + def _add_defaults_optional(self): + super()._add_defaults_optional() + if os.path.isfile('pyproject.toml'): + self.filelist.append('pyproject.toml') + + def _add_defaults_python(self): + """getting python files""" + if self.distribution.has_pure_modules(): + build_py = self.get_finalized_command('build_py') + self.filelist.extend(build_py.get_source_files()) + self._add_data_files(self._safe_data_files(build_py)) + + def _add_defaults_build_sub_commands(self): + build = self.get_finalized_command("build") + missing_cmds = set(build.get_sub_commands()) - _ORIGINAL_SUBCOMMANDS + # ^-- the original built-in sub-commands are already handled by default. + cmds = (self.get_finalized_command(c) for c in missing_cmds) + files = (c.get_source_files() for c in cmds if hasattr(c, "get_source_files")) + self.filelist.extend(chain.from_iterable(files)) + + def _safe_data_files(self, build_py): + """ + Since the ``sdist`` class is also used to compute the MANIFEST + (via :obj:`setuptools.command.egg_info.manifest_maker`), + there might be recursion problems when trying to obtain the list of + data_files and ``include_package_data=True`` (which in turn depends on + the files included in the MANIFEST). + + To avoid that, ``manifest_maker`` should be able to overwrite this + method and avoid recursive attempts to build/analyze the MANIFEST. + """ + return build_py.data_files + + def _add_data_files(self, data_files): + """ + Add data files as found in build_py.data_files. + """ + self.filelist.extend( + os.path.join(src_dir, name) + for _, src_dir, _, filenames in data_files + for name in filenames + ) + + def _add_defaults_data_files(self): + try: + super()._add_defaults_data_files() + except TypeError: + log.warn("data_files contains unexpected objects") + + def prune_file_list(self) -> None: + super().prune_file_list() + # Prevent accidental inclusion of test-related cache dirs at the project root + sep = re.escape(os.sep) + self.filelist.exclude_pattern(r"^(\.tox|\.nox|\.venv)" + sep, is_regex=True) + + def check_readme(self) -> None: + for f in self.READMES: + if os.path.exists(f): + return + else: + self.warn( + "standard file not found: should have one of " + ', '.join(self.READMES) + ) + + def make_release_tree(self, base_dir, files) -> None: + orig.sdist.make_release_tree(self, base_dir, files) + + # Save any egg_info command line options used to create this sdist + dest = os.path.join(base_dir, 'setup.cfg') + if hasattr(os, 'link') and os.path.exists(dest): + # unlink and re-copy, since it might be hard-linked, and + # we don't want to change the source version + os.unlink(dest) + self.copy_file('setup.cfg', dest) + + self.get_finalized_command('egg_info').save_version_info(dest) + + def _manifest_is_not_generated(self): + # check for special comment used in 2.7.1 and higher + if not os.path.isfile(self.manifest): + return False + + with open(self.manifest, 'rb') as fp: + first_line = fp.readline() + return first_line != b'# file GENERATED by distutils, do NOT edit\n' + + def read_manifest(self): + """Read the manifest file (named by 'self.manifest') and use it to + fill in 'self.filelist', the list of files to include in the source + distribution. + """ + log.info("reading manifest file '%s'", self.manifest) + manifest = open(self.manifest, 'rb') + for bytes_line in manifest: + # The manifest must contain UTF-8. See #303. + try: + line = bytes_line.decode('UTF-8') + except UnicodeDecodeError: + log.warn(f"{line!r} not UTF-8 decodable -- skipping") + continue + # ignore comments and blank lines + line = line.strip() + if line.startswith('#') or not line: + continue + self.filelist.append(line) + manifest.close() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/setopt.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/setopt.py new file mode 100644 index 000000000..678a0593d --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/setopt.py @@ -0,0 +1,141 @@ +import configparser +import os + +from .. import Command +from ..unicode_utils import _cfg_read_utf8_with_fallback + +import distutils +from distutils import log +from distutils.errors import DistutilsOptionError +from distutils.util import convert_path + +__all__ = ['config_file', 'edit_config', 'option_base', 'setopt'] + + +def config_file(kind="local"): + """Get the filename of the distutils, local, global, or per-user config + + `kind` must be one of "local", "global", or "user" + """ + if kind == 'local': + return 'setup.cfg' + if kind == 'global': + return os.path.join(os.path.dirname(distutils.__file__), 'distutils.cfg') + if kind == 'user': + dot = os.name == 'posix' and '.' or '' + return os.path.expanduser(convert_path(f"~/{dot}pydistutils.cfg")) + raise ValueError("config_file() type must be 'local', 'global', or 'user'", kind) + + +def edit_config(filename, settings, dry_run=False): + """Edit a configuration file to include `settings` + + `settings` is a dictionary of dictionaries or ``None`` values, keyed by + command/section name. A ``None`` value means to delete the entire section, + while a dictionary lists settings to be changed or deleted in that section. + A setting of ``None`` means to delete that setting. + """ + log.debug("Reading configuration from %s", filename) + opts = configparser.RawConfigParser() + opts.optionxform = lambda optionstr: optionstr # type: ignore[method-assign] # overriding method + _cfg_read_utf8_with_fallback(opts, filename) + + for section, options in settings.items(): + if options is None: + log.info("Deleting section [%s] from %s", section, filename) + opts.remove_section(section) + else: + if not opts.has_section(section): + log.debug("Adding new section [%s] to %s", section, filename) + opts.add_section(section) + for option, value in options.items(): + if value is None: + log.debug("Deleting %s.%s from %s", section, option, filename) + opts.remove_option(section, option) + if not opts.options(section): + log.info( + "Deleting empty [%s] section from %s", section, filename + ) + opts.remove_section(section) + else: + log.debug( + "Setting %s.%s to %r in %s", section, option, value, filename + ) + opts.set(section, option, value) + + log.info("Writing %s", filename) + if not dry_run: + with open(filename, 'w', encoding="utf-8") as f: + opts.write(f) + + +class option_base(Command): + """Abstract base class for commands that mess with config files""" + + user_options = [ + ('global-config', 'g', "save options to the site-wide distutils.cfg file"), + ('user-config', 'u', "save options to the current user's pydistutils.cfg file"), + ('filename=', 'f', "configuration file to use (default=setup.cfg)"), + ] + + boolean_options = [ + 'global-config', + 'user-config', + ] + + def initialize_options(self): + self.global_config = None + self.user_config = None + self.filename = None + + def finalize_options(self): + filenames = [] + if self.global_config: + filenames.append(config_file('global')) + if self.user_config: + filenames.append(config_file('user')) + if self.filename is not None: + filenames.append(self.filename) + if not filenames: + filenames.append(config_file('local')) + if len(filenames) > 1: + raise DistutilsOptionError( + "Must specify only one configuration file option", filenames + ) + (self.filename,) = filenames + + +class setopt(option_base): + """Save command-line options to a file""" + + description = "set an option in setup.cfg or another config file" + + user_options = [ + ('command=', 'c', 'command to set an option for'), + ('option=', 'o', 'option to set'), + ('set-value=', 's', 'value of the option'), + ('remove', 'r', 'remove (unset) the value'), + ] + option_base.user_options + + boolean_options = option_base.boolean_options + ['remove'] + + def initialize_options(self): + option_base.initialize_options(self) + self.command = None + self.option = None + self.set_value = None + self.remove = None + + def finalize_options(self) -> None: + option_base.finalize_options(self) + if self.command is None or self.option is None: + raise DistutilsOptionError("Must specify --command *and* --option") + if self.set_value is None and not self.remove: + raise DistutilsOptionError("Must specify --set-value or --remove") + + def run(self) -> None: + edit_config( + self.filename, + {self.command: {self.option.replace('-', '_'): self.set_value}}, + self.dry_run, + ) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/test.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/test.py new file mode 100644 index 000000000..341b11a20 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/command/test.py @@ -0,0 +1,45 @@ +from __future__ import annotations + +from setuptools import Command +from setuptools.warnings import SetuptoolsDeprecationWarning + + +# Would restrict to Literal["test"], but mypy doesn't support it: https://github.com/python/mypy/issues/8203 +def __getattr__(name: str) -> type[_test]: + if name == 'test': + SetuptoolsDeprecationWarning.emit( + "The test command is disabled and references to it are deprecated.", + "Please remove any references to `setuptools.command.test` in all " + "supported versions of the affected package.", + due_date=(2024, 11, 15), + stacklevel=2, + ) + return _test + raise AttributeError(name) + + +class _test(Command): + """ + Stub to warn when test command is referenced or used. + """ + + description = "stub for old test command (do not use)" + + user_options = [ + ('test-module=', 'm', "Run 'test_suite' in specified module"), + ( + 'test-suite=', + 's', + "Run single test, case or suite (e.g. 'module.test_suite')", + ), + ('test-runner=', 'r', "Test runner to use"), + ] + + def initialize_options(self): + pass + + def finalize_options(self): + pass + + def run(self): + raise RuntimeError("Support for the test command was removed in Setuptools 72") diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..69473f65678dd54ea0bcc2abb479748713f94bc5 GIT binary patch literal 220 zcmX@j%ge<81jlwKW`O9&AOanHW&w&!XQ*V*Wb|9fP{ah}eFmxdRjr?qpPQ8XTbOm!FafVR^c^#Rugl<(KG}l$PWdWhUn6>%mz$nMwKul_eSZ zdB%E%M*78>C8@dviOJcC=|J7ZsU@WaCHeU|#rnzlxdn+O`tk9Zd6^~g@p=W7zc_4i d^HWN5QtgUZfo@?0;$jfvBQql-V-Yiu1pu!eJ)r;q literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/py310.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/py310.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f3f53b744b5015b11e5e767f63d8c0c02afa837d GIT binary patch literal 820 zcmaJezw6n@U#B_>H38YBdfP+5>p&|XU>5Q3#3Aw*P_rHYVF*Vs)iy_`>Hr{tsz z85oKf=oWqgRTp-47N&qukm-QbDO;s%ov^P-D>Cq;d;a|VJ=@>s`?j!<2Nhqxc+D*Y zaH1!($V|Z`RA2xE2nwJEB-21OM4@HQh?gTVc3%U;R?0PMMrfwUtQr61o5XwzH7h~H zIv?%qSZ`XDIlvJtZutqblveYLS%WrUui=j+ehO}5R1 zBRYb`z85$v7f9XNi4xIdVP$3QzQcV%mm{yf>ort2r=k-H#scotSv&HCqE^;cSE3}& zsSBj(ssdc6KK#P@4~2JygY}>I#za;AbwEEu>cEx)0}vPbdoWYo((7|UPy>#pPPVMM zMKzuCEK`+N+|)1by0#(BJul`muapqF<8=ZdvtAU@ki=LuPkoH_b6rX*>6P0m_2C#7 z_c!0;5iSpL`QwXEi$Cza5v~kz<+D=xATBDFos|YpxXih(7X+>=i+eQYJ_}tx++nfS zBrW}a_~{XckaneKp5aGrMmhm~9A8&7Z3%y((y4(E`VIL%g=_nF`?=FBn7NTr8XBd8 aH{Xq0$L8XRS)Q*>Ok~}hW0B+OPxw literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/py311.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/py311.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..30e3439c6afb7cc85bfd79cef21964572fd515a6 GIT binary patch literal 1463 zcmah}OKcoP5bgQzXLkLI<3Ivz964ct?8xK*2iu8boM2Ek7Iq>rfQH$fws)QRta`@L zu4PL;L;|1U3)pbVF^C*;w3ItS;$lM(N%ILPC*M}Gkx))l&Biu9(JfWKuCA`GdR^T= zAT?Yjp~^{7P1Q=IHIxebJ!uK}!)Ys4k4;1OT21Oc(=iI$j*k|n_?d9trqimzI# zuUVQvsKWA~m%Wsqw$gsa$|U;~FYD`;4(l4#T$QRb;tOyB&C&dJcLhQPB<5QMQ4*TNtw84}M;e>gdAkG(rS_WnfaGM7e! zCQpqyp68T3YKUALZ&W6NnULqFVs@2XY{oR2bmA(wN>4ZIbkwUkQIVy=JI~u!12D(k zWv6nZ0%Yws1rW@Ioi71=Ca#fqe`!wKhx@=4ZhTA#I~L=&=wMtVi^7U{PyF`z zNmImCJ{M;MSGuJyN&mlhQMxA|>^0PqA#S6qZ5;$;sDuG+R1W2VQS@LQrvZE+tdSLo z-6W?3HAA}pjrp|Jd{VOB$* znvO>s=9T6o3+HGhj?D3?$+M-^V9Rb8NoT>~WWk6O58~|}r)Qq@(ld=d(*GA&F z+71&;lQ<2z?I>594MIlkommLL{&pH0Iz8u`Jp@S(Gm6<=&;nICWw|K2*Mwv|0&7+ zN-|G~xkb#sq|PVu;P3M5EtR}9aHo1Vx<7Wev32_GjZ+&-n*&$AzqvVZZR^DK<@{>; vCvv@&A;$}kPMv9Kx^O{wlsVRt5d7KG*HRFG7yV>=v6UifW;c!6B(#44b)9dc literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/py312.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/py312.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..67ead82654e5f39442bb424772e4c29ccc54c7dc GIT binary patch literal 503 zcmYjMO-ma=7@pbL?8X>TYJWhgREdxbnu`S~6pbH{uE8plMHtr1#H{Y_EHksk4L#I< z;H|&G-{9SgCrd%tLn(-d+yrl)I)kWv56?XB$Me3=Tun?=fR4+HV30rnZcXwW=!w9G zubTV>dw>E8BM?I$Lc^`d@-1c^InRREm!ji+07RMEzD-N4M4c7g%q{BDa^%FW??S*_ z-_EW2*vQE0uow@LgsVV>Jds`XU^0XM&Kz zPV?3WF{XRx;6WpJJi!AVGaN+h1b@!Ef*-M-lDPe)+weGLPi$*#o$T-fuCU4!7hw?L z<_n9$1Dxh+z>`*UaS6*%u|^v7j)Oz3mP}=-;yjYL$Ky0mdbG8;)J*fo@=DBU7O{`w zjW%L_E3t-q1R?wbW^O^{FLG|s^fj738~#G??j2B@|Is;H_-)VK+3$7wcJ{O*rnKfC DUnz*+ literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/py39.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/__pycache__/py39.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ec785d1042225d48fbe218a134fa50ab0b40d279 GIT binary patch literal 349 zcmX@j%ge<81jlwKX1rx&V0aATzyK4J@!15(n9h*GkiwY55XF$nkOh;0sRYs~OxZCE z3`NW-%u!60j46yDQj_H+NQIv!(@SO`{Ssu=Ew-HeEsIs3bK`nj)U_zW`PSGj&her~EhP+x_}%UAC#YzU!q@9T9RLsnV6%m2WRDECg~ScmSp7T8S5Du=@(~~r0NzV zCTAz619catmXsEhnG>u79^Gcl^R>>6;%G>u*uC&Da}c>E8+pV0~kUK#R@>; o12ZEd<82164+0GGO4sG|F3Ra`P`@N+IYFb5e@96pe-X&50K;xy= (3, 11): + import tomllib +else: # pragma: no cover + import tomli as tomllib + + +if sys.version_info >= (3, 11): + + def add_note(ex, note): + ex.add_note(note) + +else: # pragma: no cover + + def add_note(ex, note): + vars(ex).setdefault('__notes__', []).append(note) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/py311.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/py311.py new file mode 100644 index 000000000..52b58af32 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/py311.py @@ -0,0 +1,27 @@ +from __future__ import annotations + +import shutil +import sys +from typing import TYPE_CHECKING, Any, Callable + +if TYPE_CHECKING: + from _typeshed import ExcInfo, StrOrBytesPath + from typing_extensions import TypeAlias + +# Same as shutil._OnExcCallback from typeshed +_OnExcCallback: TypeAlias = Callable[[Callable[..., Any], str, BaseException], object] + + +def shutil_rmtree( + path: StrOrBytesPath, + ignore_errors: bool = False, + onexc: _OnExcCallback | None = None, +) -> None: + if sys.version_info >= (3, 12): + return shutil.rmtree(path, ignore_errors, onexc=onexc) + + def _handler(fn: Callable[..., Any], path: str, excinfo: ExcInfo) -> None: + if onexc: + onexc(fn, path, excinfo[1]) + + return shutil.rmtree(path, ignore_errors, onerror=_handler) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/py312.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/py312.py new file mode 100644 index 000000000..b20c5f697 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/py312.py @@ -0,0 +1,13 @@ +from __future__ import annotations + +import sys + +if sys.version_info >= (3, 12, 4): + # Python 3.13 should support `.pth` files encoded in UTF-8 + # See discussion in https://github.com/python/cpython/issues/77102 + PTH_ENCODING: str | None = "utf-8" +else: + from .py39 import LOCALE_ENCODING + + # PTH_ENCODING = "locale" + PTH_ENCODING = LOCALE_ENCODING diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/py39.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/py39.py new file mode 100644 index 000000000..04a4abe5a --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/compat/py39.py @@ -0,0 +1,9 @@ +import sys + +# Explicitly use the ``"locale"`` encoding in versions that support it, +# otherwise just rely on the implicit handling of ``encoding=None``. +# Since all platforms that support ``EncodingWarning`` also support +# ``encoding="locale"``, this can be used to suppress the warning. +# However, please try to use UTF-8 when possible +# (.pth files are the notorious exception: python/cpython#77102, pypa/setuptools#3937). +LOCALE_ENCODING = "locale" if sys.version_info >= (3, 10) else None diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/NOTICE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/NOTICE new file mode 100644 index 000000000..01864511b --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/NOTICE @@ -0,0 +1,10 @@ +The following files include code from opensource projects +(either as direct copies or modified versions): + +- `setuptools.schema.json`, `distutils.schema.json`: + - project: `validate-pyproject` - licensed under MPL-2.0 + (https://github.com/abravalheri/validate-pyproject): + + This Source Code Form is subject to the terms of the Mozilla Public + License, v. 2.0. If a copy of the MPL was not distributed with this file, + You can obtain one at https://mozilla.org/MPL/2.0/. diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__init__.py new file mode 100644 index 000000000..fcc7d008d --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__init__.py @@ -0,0 +1,43 @@ +"""For backward compatibility, expose main functions from +``setuptools.config.setupcfg`` +""" + +from functools import wraps +from typing import Callable, TypeVar, cast + +from ..warnings import SetuptoolsDeprecationWarning +from . import setupcfg + +Fn = TypeVar("Fn", bound=Callable) + +__all__ = ('parse_configuration', 'read_configuration') + + +def _deprecation_notice(fn: Fn) -> Fn: + @wraps(fn) + def _wrapper(*args, **kwargs): + SetuptoolsDeprecationWarning.emit( + "Deprecated API usage.", + f""" + As setuptools moves its configuration towards `pyproject.toml`, + `{__name__}.{fn.__name__}` became deprecated. + + For the time being, you can use the `{setupcfg.__name__}` module + to access a backward compatible API, but this module is provisional + and might be removed in the future. + + To read project metadata, consider using + ``build.util.project_wheel_metadata`` (https://pypi.org/project/build/). + For simple scenarios, you can also try parsing the file directly + with the help of ``configparser``. + """, + # due_date not defined yet, because the community still heavily relies on it + # Warning introduced in 24 Mar 2022 + ) + return fn(*args, **kwargs) + + return cast(Fn, _wrapper) + + +read_configuration = _deprecation_notice(setupcfg.read_configuration) +parse_configuration = _deprecation_notice(setupcfg.parse_configuration) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2be45fe11c6f59afd2b55c7660a9eb784dfd446f GIT binary patch literal 2045 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 N$DMu&&vu1H``@7akPQF; literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__pycache__/expand.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__pycache__/expand.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..88edae72d82219e52fa94de32f4ca40b8ad269aa GIT binary patch literal 24599 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 Gxc(0_S4Q#x literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__pycache__/pyprojecttoml.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/__pycache__/pyprojecttoml.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2b28481d481ad2fd11b12b545a7dacedaae969c3 GIT binary patch literal 23396 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 PHzsN~{!+l5P3!*w56jPB literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_apply_pyprojecttoml.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_apply_pyprojecttoml.py new file mode 100644 index 000000000..9088bc138 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_apply_pyprojecttoml.py @@ -0,0 +1,526 @@ +"""Translation layer between pyproject config and setuptools distribution and +metadata objects. + +The distribution and metadata objects are modeled after (an old version of) +core metadata, therefore configs in the format specified for ``pyproject.toml`` +need to be processed before being applied. + +**PRIVATE MODULE**: API reserved for setuptools internal usage only. +""" + +from __future__ import annotations + +import logging +import os +from collections.abc import Mapping +from email.headerregistry import Address +from functools import partial, reduce +from inspect import cleandoc +from itertools import chain +from types import MappingProxyType +from typing import TYPE_CHECKING, Any, Callable, TypeVar, Union + +from .. import _static +from .._path import StrPath +from ..errors import InvalidConfigError, RemovedConfigError +from ..extension import Extension +from ..warnings import SetuptoolsDeprecationWarning, SetuptoolsWarning + +if TYPE_CHECKING: + from typing_extensions import TypeAlias + + from setuptools._importlib import metadata + from setuptools.dist import Distribution + + from distutils.dist import _OptionsList # Comes from typeshed + + +EMPTY: Mapping = MappingProxyType({}) # Immutable dict-like +_ProjectReadmeValue: TypeAlias = Union[str, dict[str, str]] +_Correspondence: TypeAlias = Callable[["Distribution", Any, Union[StrPath, None]], None] +_T = TypeVar("_T") + +_logger = logging.getLogger(__name__) + + +def apply(dist: Distribution, config: dict, filename: StrPath) -> Distribution: + """Apply configuration dict read with :func:`read_configuration`""" + + if not config: + return dist # short-circuit unrelated pyproject.toml file + + root_dir = os.path.dirname(filename) or "." + + _apply_project_table(dist, config, root_dir) + _apply_tool_table(dist, config, filename) + + current_directory = os.getcwd() + os.chdir(root_dir) + try: + dist._finalize_requires() + dist._finalize_license_expression() + dist._finalize_license_files() + finally: + os.chdir(current_directory) + + return dist + + +def _apply_project_table(dist: Distribution, config: dict, root_dir: StrPath): + orig_config = config.get("project", {}) + if not orig_config: + return # short-circuit + + project_table = {k: _static.attempt_conversion(v) for k, v in orig_config.items()} + _handle_missing_dynamic(dist, project_table) + _unify_entry_points(project_table) + + for field, value in project_table.items(): + norm_key = json_compatible_key(field) + corresp = PYPROJECT_CORRESPONDENCE.get(norm_key, norm_key) + if callable(corresp): + corresp(dist, value, root_dir) + else: + _set_config(dist, corresp, value) + + +def _apply_tool_table(dist: Distribution, config: dict, filename: StrPath): + tool_table = config.get("tool", {}).get("setuptools", {}) + if not tool_table: + return # short-circuit + + if "license-files" in tool_table: + if "license-files" in config.get("project", {}): + # https://github.com/pypa/setuptools/pull/4837#discussion_r2004983349 + raise InvalidConfigError( + "'project.license-files' is defined already. " + "Remove 'tool.setuptools.license-files'." + ) + + pypa_guides = "guides/writing-pyproject-toml/#license-files" + SetuptoolsDeprecationWarning.emit( + "'tool.setuptools.license-files' is deprecated in favor of " + "'project.license-files' (available on setuptools>=77.0.0).", + see_url=f"https://packaging.python.org/en/latest/{pypa_guides}", + due_date=(2026, 2, 18), # Warning introduced on 2025-02-18 + ) + + for field, value in tool_table.items(): + norm_key = json_compatible_key(field) + + if norm_key in TOOL_TABLE_REMOVALS: + suggestion = cleandoc(TOOL_TABLE_REMOVALS[norm_key]) + msg = f""" + The parameter `tool.setuptools.{field}` was long deprecated + and has been removed from `pyproject.toml`. + """ + raise RemovedConfigError("\n".join([cleandoc(msg), suggestion])) + + norm_key = TOOL_TABLE_RENAMES.get(norm_key, norm_key) + corresp = TOOL_TABLE_CORRESPONDENCE.get(norm_key, norm_key) + if callable(corresp): + corresp(dist, value) + else: + _set_config(dist, corresp, value) + + _copy_command_options(config, dist, filename) + + +def _handle_missing_dynamic(dist: Distribution, project_table: dict): + """Be temporarily forgiving with ``dynamic`` fields not listed in ``dynamic``""" + dynamic = set(project_table.get("dynamic", [])) + for field, getter in _PREVIOUSLY_DEFINED.items(): + if not (field in project_table or field in dynamic): + value = getter(dist) + if value: + _MissingDynamic.emit(field=field, value=value) + project_table[field] = _RESET_PREVIOUSLY_DEFINED.get(field) + + +def json_compatible_key(key: str) -> str: + """As defined in :pep:`566#json-compatible-metadata`""" + return key.lower().replace("-", "_") + + +def _set_config(dist: Distribution, field: str, value: Any): + val = _PREPROCESS.get(field, _noop)(dist, value) + setter = getattr(dist.metadata, f"set_{field}", None) + if setter: + setter(val) + elif hasattr(dist.metadata, field) or field in SETUPTOOLS_PATCHES: + setattr(dist.metadata, field, val) + else: + setattr(dist, field, val) + + +_CONTENT_TYPES = { + ".md": "text/markdown", + ".rst": "text/x-rst", + ".txt": "text/plain", +} + + +def _guess_content_type(file: str) -> str | None: + _, ext = os.path.splitext(file.lower()) + if not ext: + return None + + if ext in _CONTENT_TYPES: + return _static.Str(_CONTENT_TYPES[ext]) + + valid = ", ".join(f"{k} ({v})" for k, v in _CONTENT_TYPES.items()) + msg = f"only the following file extensions are recognized: {valid}." + raise ValueError(f"Undefined content type for {file}, {msg}") + + +def _long_description( + dist: Distribution, val: _ProjectReadmeValue, root_dir: StrPath | None +): + from setuptools.config import expand + + file: str | tuple[()] + if isinstance(val, str): + file = val + text = expand.read_files(file, root_dir) + ctype = _guess_content_type(file) + else: + file = val.get("file") or () + text = val.get("text") or expand.read_files(file, root_dir) + ctype = val["content-type"] + + # XXX: Is it completely safe to assume static? + _set_config(dist, "long_description", _static.Str(text)) + + if ctype: + _set_config(dist, "long_description_content_type", _static.Str(ctype)) + + if file: + dist._referenced_files.add(file) + + +def _license(dist: Distribution, val: str | dict, root_dir: StrPath | None): + from setuptools.config import expand + + if isinstance(val, str): + if getattr(dist.metadata, "license", None): + SetuptoolsWarning.emit("`license` overwritten by `pyproject.toml`") + dist.metadata.license = None + _set_config(dist, "license_expression", _static.Str(val)) + else: + pypa_guides = "guides/writing-pyproject-toml/#license" + SetuptoolsDeprecationWarning.emit( + "`project.license` as a TOML table is deprecated", + "Please use a simple string containing a SPDX expression for " + "`project.license`. You can also use `project.license-files`. " + "(Both options available on setuptools>=77.0.0).", + see_url=f"https://packaging.python.org/en/latest/{pypa_guides}", + due_date=(2026, 2, 18), # Introduced on 2025-02-18 + ) + if "file" in val: + # XXX: Is it completely safe to assume static? + value = expand.read_files([val["file"]], root_dir) + _set_config(dist, "license", _static.Str(value)) + dist._referenced_files.add(val["file"]) + else: + _set_config(dist, "license", _static.Str(val["text"])) + + +def _people(dist: Distribution, val: list[dict], _root_dir: StrPath | None, kind: str): + field = [] + email_field = [] + for person in val: + if "name" not in person: + email_field.append(person["email"]) + elif "email" not in person: + field.append(person["name"]) + else: + addr = Address(display_name=person["name"], addr_spec=person["email"]) + email_field.append(str(addr)) + + if field: + _set_config(dist, kind, _static.Str(", ".join(field))) + if email_field: + _set_config(dist, f"{kind}_email", _static.Str(", ".join(email_field))) + + +def _project_urls(dist: Distribution, val: dict, _root_dir: StrPath | None): + _set_config(dist, "project_urls", val) + + +def _python_requires(dist: Distribution, val: str, _root_dir: StrPath | None): + _set_config(dist, "python_requires", _static.SpecifierSet(val)) + + +def _dependencies(dist: Distribution, val: list, _root_dir: StrPath | None): + if getattr(dist, "install_requires", []): + msg = "`install_requires` overwritten in `pyproject.toml` (dependencies)" + SetuptoolsWarning.emit(msg) + dist.install_requires = val + + +def _optional_dependencies(dist: Distribution, val: dict, _root_dir: StrPath | None): + if getattr(dist, "extras_require", None): + msg = "`extras_require` overwritten in `pyproject.toml` (optional-dependencies)" + SetuptoolsWarning.emit(msg) + dist.extras_require = val + + +def _ext_modules(dist: Distribution, val: list[dict]) -> list[Extension]: + existing = dist.ext_modules or [] + args = ({k.replace("-", "_"): v for k, v in x.items()} for x in val) + new = [Extension(**kw) for kw in args] + return [*existing, *new] + + +def _noop(_dist: Distribution, val: _T) -> _T: + return val + + +def _identity(val: _T) -> _T: + return val + + +def _unify_entry_points(project_table: dict): + project = project_table + given = project.pop("entry-points", project.pop("entry_points", {})) + entry_points = dict(given) # Avoid problems with static + renaming = {"scripts": "console_scripts", "gui_scripts": "gui_scripts"} + for key, value in list(project.items()): # eager to allow modifications + norm_key = json_compatible_key(key) + if norm_key in renaming: + # Don't skip even if value is empty (reason: reset missing `dynamic`) + entry_points[renaming[norm_key]] = project.pop(key) + + if entry_points: + project["entry-points"] = { + name: [f"{k} = {v}" for k, v in group.items()] + for name, group in entry_points.items() + if group # now we can skip empty groups + } + # Sometimes this will set `project["entry-points"] = {}`, and that is + # intentional (for resetting configurations that are missing `dynamic`). + + +def _copy_command_options(pyproject: dict, dist: Distribution, filename: StrPath): + tool_table = pyproject.get("tool", {}) + cmdclass = tool_table.get("setuptools", {}).get("cmdclass", {}) + valid_options = _valid_command_options(cmdclass) + + cmd_opts = dist.command_options + for cmd, config in pyproject.get("tool", {}).get("distutils", {}).items(): + cmd = json_compatible_key(cmd) + valid = valid_options.get(cmd, set()) + cmd_opts.setdefault(cmd, {}) + for key, value in config.items(): + key = json_compatible_key(key) + cmd_opts[cmd][key] = (str(filename), value) + if key not in valid: + # To avoid removing options that are specified dynamically we + # just log a warn... + _logger.warning(f"Command option {cmd}.{key} is not defined") + + +def _valid_command_options(cmdclass: Mapping = EMPTY) -> dict[str, set[str]]: + from setuptools.dist import Distribution + + from .._importlib import metadata + + valid_options = {"global": _normalise_cmd_options(Distribution.global_options)} + + unloaded_entry_points = metadata.entry_points(group='distutils.commands') + loaded_entry_points = (_load_ep(ep) for ep in unloaded_entry_points) + entry_points = (ep for ep in loaded_entry_points if ep) + for cmd, cmd_class in chain(entry_points, cmdclass.items()): + opts = valid_options.get(cmd, set()) + opts = opts | _normalise_cmd_options(getattr(cmd_class, "user_options", [])) + valid_options[cmd] = opts + + return valid_options + + +def _load_ep(ep: metadata.EntryPoint) -> tuple[str, type] | None: + if ep.value.startswith("wheel.bdist_wheel"): + # Ignore deprecated entrypoint from wheel and avoid warning pypa/wheel#631 + # TODO: remove check when `bdist_wheel` has been fully removed from pypa/wheel + return None + + # Ignore all the errors + try: + return (ep.name, ep.load()) + except Exception as ex: + msg = f"{ex.__class__.__name__} while trying to load entry-point {ep.name}" + _logger.warning(f"{msg}: {ex}") + return None + + +def _normalise_cmd_option_key(name: str) -> str: + return json_compatible_key(name).strip("_=") + + +def _normalise_cmd_options(desc: _OptionsList) -> set[str]: + return {_normalise_cmd_option_key(fancy_option[0]) for fancy_option in desc} + + +def _get_previous_entrypoints(dist: Distribution) -> dict[str, list]: + ignore = ("console_scripts", "gui_scripts") + value = getattr(dist, "entry_points", None) or {} + return {k: v for k, v in value.items() if k not in ignore} + + +def _get_previous_scripts(dist: Distribution) -> list | None: + value = getattr(dist, "entry_points", None) or {} + return value.get("console_scripts") + + +def _get_previous_gui_scripts(dist: Distribution) -> list | None: + value = getattr(dist, "entry_points", None) or {} + return value.get("gui_scripts") + + +def _set_static_list_metadata(attr: str, dist: Distribution, val: list) -> None: + """Apply distutils metadata validation but preserve "static" behaviour""" + meta = dist.metadata + setter, getter = getattr(meta, f"set_{attr}"), getattr(meta, f"get_{attr}") + setter(val) + setattr(meta, attr, _static.List(getter())) + + +def _attrgetter(attr): + """ + Similar to ``operator.attrgetter`` but returns None if ``attr`` is not found + >>> from types import SimpleNamespace + >>> obj = SimpleNamespace(a=42, b=SimpleNamespace(c=13)) + >>> _attrgetter("a")(obj) + 42 + >>> _attrgetter("b.c")(obj) + 13 + >>> _attrgetter("d")(obj) is None + True + """ + return partial(reduce, lambda acc, x: getattr(acc, x, None), attr.split(".")) + + +def _some_attrgetter(*items): + """ + Return the first "truth-y" attribute or None + >>> from types import SimpleNamespace + >>> obj = SimpleNamespace(a=42, b=SimpleNamespace(c=13)) + >>> _some_attrgetter("d", "a", "b.c")(obj) + 42 + >>> _some_attrgetter("d", "e", "b.c", "a")(obj) + 13 + >>> _some_attrgetter("d", "e", "f")(obj) is None + True + """ + + def _acessor(obj): + values = (_attrgetter(i)(obj) for i in items) + return next((i for i in values if i is not None), None) + + return _acessor + + +PYPROJECT_CORRESPONDENCE: dict[str, _Correspondence] = { + "readme": _long_description, + "license": _license, + "authors": partial(_people, kind="author"), + "maintainers": partial(_people, kind="maintainer"), + "urls": _project_urls, + "dependencies": _dependencies, + "optional_dependencies": _optional_dependencies, + "requires_python": _python_requires, +} + +TOOL_TABLE_RENAMES = {"script_files": "scripts"} +TOOL_TABLE_REMOVALS = { + "namespace_packages": """ + Please migrate to implicit native namespaces instead. + See https://packaging.python.org/en/latest/guides/packaging-namespace-packages/. + """, +} +TOOL_TABLE_CORRESPONDENCE = { + # Fields with corresponding core metadata need to be marked as static: + "obsoletes": partial(_set_static_list_metadata, "obsoletes"), + "provides": partial(_set_static_list_metadata, "provides"), + "platforms": partial(_set_static_list_metadata, "platforms"), +} + +SETUPTOOLS_PATCHES = { + "long_description_content_type", + "project_urls", + "provides_extras", + "license_file", + "license_files", + "license_expression", +} + +_PREPROCESS = { + "ext_modules": _ext_modules, +} + +_PREVIOUSLY_DEFINED = { + "name": _attrgetter("metadata.name"), + "version": _attrgetter("metadata.version"), + "description": _attrgetter("metadata.description"), + "readme": _attrgetter("metadata.long_description"), + "requires-python": _some_attrgetter("python_requires", "metadata.python_requires"), + "license": _some_attrgetter("metadata.license_expression", "metadata.license"), + # XXX: `license-file` is currently not considered in the context of `dynamic`. + # See TestPresetField.test_license_files_exempt_from_dynamic + "authors": _some_attrgetter("metadata.author", "metadata.author_email"), + "maintainers": _some_attrgetter("metadata.maintainer", "metadata.maintainer_email"), + "keywords": _attrgetter("metadata.keywords"), + "classifiers": _attrgetter("metadata.classifiers"), + "urls": _attrgetter("metadata.project_urls"), + "entry-points": _get_previous_entrypoints, + "scripts": _get_previous_scripts, + "gui-scripts": _get_previous_gui_scripts, + "dependencies": _attrgetter("install_requires"), + "optional-dependencies": _attrgetter("extras_require"), +} + + +_RESET_PREVIOUSLY_DEFINED: dict = { + # Fix improper setting: given in `setup.py`, but not listed in `dynamic` + # Use "immutable" data structures to avoid in-place modification. + # dict: pyproject name => value to which reset + "license": "", + # XXX: `license-file` is currently not considered in the context of `dynamic`. + # See TestPresetField.test_license_files_exempt_from_dynamic + "authors": _static.EMPTY_LIST, + "maintainers": _static.EMPTY_LIST, + "keywords": _static.EMPTY_LIST, + "classifiers": _static.EMPTY_LIST, + "urls": _static.EMPTY_DICT, + "entry-points": _static.EMPTY_DICT, + "scripts": _static.EMPTY_DICT, + "gui-scripts": _static.EMPTY_DICT, + "dependencies": _static.EMPTY_LIST, + "optional-dependencies": _static.EMPTY_DICT, +} + + +class _MissingDynamic(SetuptoolsWarning): + _SUMMARY = "`{field}` defined outside of `pyproject.toml` is ignored." + + _DETAILS = """ + The following seems to be defined outside of `pyproject.toml`: + + `{field} = {value!r}` + + According to the spec (see the link below), however, setuptools CANNOT + consider this value unless `{field}` is listed as `dynamic`. + + https://packaging.python.org/en/latest/specifications/pyproject-toml/#declaring-project-metadata-the-project-table + + To prevent this problem, you can list `{field}` under `dynamic` or alternatively + remove the `[project]` table from your file and rely entirely on other means of + configuration. + """ + # TODO: Consider removing this check in the future? + # There is a trade-off here between improving "debug-ability" and the cost + # of running/testing/maintaining these unnecessary checks... + + @classmethod + def details(cls, field: str, value: Any) -> str: + return cls._DETAILS.format(field=field, value=value) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/NOTICE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/NOTICE new file mode 100644 index 000000000..ac5464d88 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/NOTICE @@ -0,0 +1,438 @@ +The code contained in this directory was automatically generated using the +following command: + + python -m validate_pyproject.pre_compile --output-dir=setuptools/config/_validate_pyproject --enable-plugins setuptools distutils --very-verbose -t setuptools=setuptools/config/setuptools.schema.json -t distutils=setuptools/config/distutils.schema.json + +Please avoid changing it manually. + + +You can report issues or suggest changes directly to `validate-pyproject` +(or to the relevant plugin repository) + +- https://github.com/abravalheri/validate-pyproject/issues + + +*** + +The following files include code from opensource projects +(either as direct copies or modified versions): + +- `fastjsonschema_exceptions.py`: + - project: `fastjsonschema` - licensed under BSD-3-Clause + (https://github.com/horejsek/python-fastjsonschema) +- `extra_validations.py` and `format.py`, `error_reporting.py`: + - project: `validate-pyproject` - licensed under MPL-2.0 + (https://github.com/abravalheri/validate-pyproject) + + +Additionally the following files are automatically generated by tools provided +by the same projects: + +- `__init__.py` +- `fastjsonschema_validations.py` + +The relevant copyright notes and licenses are included below. + + +*** + +`fastjsonschema` +================ + +Copyright (c) 2018, Michal Horejsek +All rights reserved. + +Redistribution and use in source and binary forms, with or without modification, +are permitted provided that the following conditions are met: + + Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + + Redistributions in binary form must reproduce the above copyright notice, this + list of conditions and the following disclaimer in the documentation and/or + other materials provided with the distribution. + + Neither the name of the {organization} nor the names of its + contributors may be used to endorse or promote products derived from + this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR +ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES +(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; +LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON +ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS +SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + + +*** + +`validate-pyproject` +==================== + +Mozilla Public License, version 2.0 + +1. Definitions + +1.1. "Contributor" + + means each individual or legal entity that creates, contributes to the + creation of, or owns Covered Software. + +1.2. "Contributor Version" + + means the combination of the Contributions of others (if any) used by a + Contributor and that particular Contributor's Contribution. + +1.3. "Contribution" + + means Covered Software of a particular Contributor. + +1.4. "Covered Software" + + means Source Code Form to which the initial Contributor has attached the + notice in Exhibit A, the Executable Form of such Source Code Form, and + Modifications of such Source Code Form, in each case including portions + thereof. + +1.5. "Incompatible With Secondary Licenses" + means + + a. that the initial Contributor has attached the notice described in + Exhibit B to the Covered Software; or + + b. that the Covered Software was made available under the terms of + version 1.1 or earlier of the License, but not also under the terms of + a Secondary License. + +1.6. "Executable Form" + + means any form of the work other than Source Code Form. + +1.7. "Larger Work" + + means a work that combines Covered Software with other material, in a + separate file or files, that is not Covered Software. + +1.8. "License" + + means this document. + +1.9. "Licensable" + + means having the right to grant, to the maximum extent possible, whether + at the time of the initial grant or subsequently, any and all of the + rights conveyed by this License. + +1.10. "Modifications" + + means any of the following: + + a. any file in Source Code Form that results from an addition to, + deletion from, or modification of the contents of Covered Software; or + + b. any new file in Source Code Form that contains any Covered Software. + +1.11. "Patent Claims" of a Contributor + + means any patent claim(s), including without limitation, method, + process, and apparatus claims, in any patent Licensable by such + Contributor that would be infringed, but for the grant of the License, + by the making, using, selling, offering for sale, having made, import, + or transfer of either its Contributions or its Contributor Version. + +1.12. "Secondary License" + + means either the GNU General Public License, Version 2.0, the GNU Lesser + General Public License, Version 2.1, the GNU Affero General Public + License, Version 3.0, or any later versions of those licenses. + +1.13. "Source Code Form" + + means the form of the work preferred for making modifications. + +1.14. "You" (or "Your") + + means an individual or a legal entity exercising rights under this + License. For legal entities, "You" includes any entity that controls, is + controlled by, or is under common control with You. For purposes of this + definition, "control" means (a) the power, direct or indirect, to cause + the direction or management of such entity, whether by contract or + otherwise, or (b) ownership of more than fifty percent (50%) of the + outstanding shares or beneficial ownership of such entity. + + +2. License Grants and Conditions + +2.1. Grants + + Each Contributor hereby grants You a world-wide, royalty-free, + non-exclusive license: + + a. under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, or + as part of a Larger Work; and + + b. under Patent Claims of such Contributor to make, use, sell, offer for + sale, have made, import, and otherwise transfer either its + Contributions or its Contributor Version. + +2.2. Effective Date + + The licenses granted in Section 2.1 with respect to any Contribution + become effective for each Contribution on the date the Contributor first + distributes such Contribution. + +2.3. Limitations on Grant Scope + + The licenses granted in this Section 2 are the only rights granted under + this License. No additional rights or licenses will be implied from the + distribution or licensing of Covered Software under this License. + Notwithstanding Section 2.1(b) above, no patent license is granted by a + Contributor: + + a. for any code that a Contributor has removed from Covered Software; or + + b. for infringements caused by: (i) Your and any other third party's + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its Contributor + Version); or + + c. under Patent Claims infringed by Covered Software in the absence of + its Contributions. + + This License does not grant any rights in the trademarks, service marks, + or logos of any Contributor (except as may be necessary to comply with + the notice requirements in Section 3.4). + +2.4. Subsequent Licenses + + No Contributor makes additional grants as a result of Your choice to + distribute the Covered Software under a subsequent version of this + License (see Section 10.2) or under the terms of a Secondary License (if + permitted under the terms of Section 3.3). + +2.5. Representation + + Each Contributor represents that the Contributor believes its + Contributions are its original creation(s) or it has sufficient rights to + grant the rights to its Contributions conveyed by this License. + +2.6. Fair Use + + This License is not intended to limit any rights You have under + applicable copyright doctrines of fair use, fair dealing, or other + equivalents. + +2.7. Conditions + + Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted in + Section 2.1. + + +3. Responsibilities + +3.1. Distribution of Source Form + + All distribution of Covered Software in Source Code Form, including any + Modifications that You create or to which You contribute, must be under + the terms of this License. You must inform recipients that the Source + Code Form of the Covered Software is governed by the terms of this + License, and how they can obtain a copy of this License. You may not + attempt to alter or restrict the recipients' rights in the Source Code + Form. + +3.2. Distribution of Executable Form + + If You distribute Covered Software in Executable Form then: + + a. such Covered Software must also be made available in Source Code Form, + as described in Section 3.1, and You must inform recipients of the + Executable Form how they can obtain a copy of such Source Code Form by + reasonable means in a timely manner, at a charge no more than the cost + of distribution to the recipient; and + + b. You may distribute such Executable Form under the terms of this + License, or sublicense it under different terms, provided that the + license for the Executable Form does not attempt to limit or alter the + recipients' rights in the Source Code Form under this License. + +3.3. Distribution of a Larger Work + + You may create and distribute a Larger Work under terms of Your choice, + provided that You also comply with the requirements of this License for + the Covered Software. If the Larger Work is a combination of Covered + Software with a work governed by one or more Secondary Licenses, and the + Covered Software is not Incompatible With Secondary Licenses, this + License permits You to additionally distribute such Covered Software + under the terms of such Secondary License(s), so that the recipient of + the Larger Work may, at their option, further distribute the Covered + Software under the terms of either this License or such Secondary + License(s). + +3.4. Notices + + You may not remove or alter the substance of any license notices + (including copyright notices, patent notices, disclaimers of warranty, or + limitations of liability) contained within the Source Code Form of the + Covered Software, except that You may alter any license notices to the + extent required to remedy known factual inaccuracies. + +3.5. Application of Additional Terms + + You may choose to offer, and to charge a fee for, warranty, support, + indemnity or liability obligations to one or more recipients of Covered + Software. However, You may do so only on Your own behalf, and not on + behalf of any Contributor. You must make it absolutely clear that any + such warranty, support, indemnity, or liability obligation is offered by + You alone, and You hereby agree to indemnify every Contributor for any + liability incurred by such Contributor as a result of warranty, support, + indemnity or liability terms You offer. You may include additional + disclaimers of warranty and limitations of liability specific to any + jurisdiction. + +4. Inability to Comply Due to Statute or Regulation + + If it is impossible for You to comply with any of the terms of this License + with respect to some or all of the Covered Software due to statute, + judicial order, or regulation then You must: (a) comply with the terms of + this License to the maximum extent possible; and (b) describe the + limitations and the code they affect. Such description must be placed in a + text file included with all distributions of the Covered Software under + this License. Except to the extent prohibited by statute or regulation, + such description must be sufficiently detailed for a recipient of ordinary + skill to be able to understand it. + +5. Termination + +5.1. The rights granted under this License will terminate automatically if You + fail to comply with any of its terms. However, if You become compliant, + then the rights granted under this License from a particular Contributor + are reinstated (a) provisionally, unless and until such Contributor + explicitly and finally terminates Your grants, and (b) on an ongoing + basis, if such Contributor fails to notify You of the non-compliance by + some reasonable means prior to 60 days after You have come back into + compliance. Moreover, Your grants from a particular Contributor are + reinstated on an ongoing basis if such Contributor notifies You of the + non-compliance by some reasonable means, this is the first time You have + received notice of non-compliance with this License from such + Contributor, and You become compliant prior to 30 days after Your receipt + of the notice. + +5.2. If You initiate litigation against any entity by asserting a patent + infringement claim (excluding declaratory judgment actions, + counter-claims, and cross-claims) alleging that a Contributor Version + directly or indirectly infringes any patent, then the rights granted to + You by any and all Contributors for the Covered Software under Section + 2.1 of this License shall terminate. + +5.3. In the event of termination under Sections 5.1 or 5.2 above, all end user + license agreements (excluding distributors and resellers) which have been + validly granted by You or Your distributors under this License prior to + termination shall survive termination. + +6. Disclaimer of Warranty + + Covered Software is provided under this License on an "as is" basis, + without warranty of any kind, either expressed, implied, or statutory, + including, without limitation, warranties that the Covered Software is free + of defects, merchantable, fit for a particular purpose or non-infringing. + The entire risk as to the quality and performance of the Covered Software + is with You. Should any Covered Software prove defective in any respect, + You (not any Contributor) assume the cost of any necessary servicing, + repair, or correction. This disclaimer of warranty constitutes an essential + part of this License. No use of any Covered Software is authorized under + this License except under this disclaimer. + +7. Limitation of Liability + + Under no circumstances and under no legal theory, whether tort (including + negligence), contract, or otherwise, shall any Contributor, or anyone who + distributes Covered Software as permitted above, be liable to You for any + direct, indirect, special, incidental, or consequential damages of any + character including, without limitation, damages for lost profits, loss of + goodwill, work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses, even if such party shall have been + informed of the possibility of such damages. This limitation of liability + shall not apply to liability for death or personal injury resulting from + such party's negligence to the extent applicable law prohibits such + limitation. Some jurisdictions do not allow the exclusion or limitation of + incidental or consequential damages, so this exclusion and limitation may + not apply to You. + +8. Litigation + + Any litigation relating to this License may be brought only in the courts + of a jurisdiction where the defendant maintains its principal place of + business and such litigation shall be governed by laws of that + jurisdiction, without reference to its conflict-of-law provisions. Nothing + in this Section shall prevent a party's ability to bring cross-claims or + counter-claims. + +9. Miscellaneous + + This License represents the complete agreement concerning the subject + matter hereof. If any provision of this License is held to be + unenforceable, such provision shall be reformed only to the extent + necessary to make it enforceable. Any law or regulation which provides that + the language of a contract shall be construed against the drafter shall not + be used to construe this License against a Contributor. + + +10. Versions of the License + +10.1. New Versions + + Mozilla Foundation is the license steward. Except as provided in Section + 10.3, no one other than the license steward has the right to modify or + publish new versions of this License. Each version will be given a + distinguishing version number. + +10.2. Effect of New Versions + + You may distribute the Covered Software under the terms of the version + of the License under which You originally received the Covered Software, + or under the terms of any subsequent version published by the license + steward. + +10.3. Modified Versions + + If you create software not governed by this License, and you want to + create a new license for such software, you may create and use a + modified version of this License if you rename the license and remove + any references to the name of the license steward (except to note that + such modified license differs from this License). + +10.4. Distributing Source Code Form that is Incompatible With Secondary + Licenses If You choose to distribute Source Code Form that is + Incompatible With Secondary Licenses under the terms of this version of + the License, the notice described in Exhibit B of this License must be + attached. + +Exhibit A - Source Code Form License Notice + + This Source Code Form is subject to the + terms of the Mozilla Public License, v. + 2.0. If a copy of the MPL was not + distributed with this file, You can + obtain one at + https://mozilla.org/MPL/2.0/. + +If it is not possible or desirable to put the notice in a particular file, +then You may include the notice in a location (such as a LICENSE file in a +relevant directory) where a recipient would be likely to look for such a +notice. + +You may add additional accurate notices of copyright ownership. + +Exhibit B - "Incompatible With Secondary Licenses" Notice + + This Source Code Form is "Incompatible + With Secondary Licenses", as defined by + the Mozilla Public License, v. 2.0. diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__init__.py new file mode 100644 index 000000000..4f612bd51 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__init__.py @@ -0,0 +1,34 @@ +from functools import reduce +from typing import Any, Callable, Dict + +from . import formats +from .error_reporting import detailed_errors, ValidationError +from .extra_validations import EXTRA_VALIDATIONS +from .fastjsonschema_exceptions import JsonSchemaException, JsonSchemaValueException +from .fastjsonschema_validations import validate as _validate + +__all__ = [ + "validate", + "FORMAT_FUNCTIONS", + "EXTRA_VALIDATIONS", + "ValidationError", + "JsonSchemaException", + "JsonSchemaValueException", +] + + +FORMAT_FUNCTIONS: Dict[str, Callable[[str], bool]] = { + fn.__name__.replace("_", "-"): fn + for fn in formats.__dict__.values() + if callable(fn) and not fn.__name__.startswith("_") +} + + +def validate(data: Any) -> bool: + """Validate the given ``data`` object using JSON Schema + This function raises ``ValidationError`` if ``data`` is invalid. + """ + with detailed_errors(): + _validate(data, custom_formats=FORMAT_FUNCTIONS) + reduce(lambda acc, fn: fn(acc), EXTRA_VALIDATIONS, data) + return True diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d8424c18b8c8b851b1938809116aa0e8e4060c17 GIT binary patch literal 1902 zcmZ`(O>7fK6n^_-@7hW1B((g5fQL5>!Yrhy+wzRh!N3INo%BteG*1 zQK(W0sg+uZNIekL15r<{=z$|rPrdZg3l^!OuAo$^df=84RMedMW^E@3wIj{jH}ih> z{d{kJ?&wGYuAhD|%iSu#AL7tjT9a9wkpOPPWw61PT=1l#Bne)2Wlt$8o?2ABSTTlo zimkeFPb+E>A9HmtQA~KrVlq0%-8Qei*dFnk+u@~(DKA}2M`zvb^ty`O5=?@f_(m#j zBHGk}Rv;VSskb)x7I&}748bk1WC!<0rvPq%3}o{x+{4(#qDN<8s;|MnN~ii?JvDec z*|K6g{>N(YzpU)GdvfD`7QT|d98xis8&K>aF|wVgWc#E+LSoMq)OZ4+)fF0lZJ+Ac_k(2|Tb=^#xDR>iPPks_~B-)i;@1psl}3hvd0BdzW_(qRGgapJlbLg)7Ydn1Ig=S&V`YbBN>$$ybS6hy(lx0(wCJpZF&>7=WFcI(^ zukwI8rkm?q=UitZSE=!G;1Blo59FA`$-#F`7UoOsxMWf*Td(i6EJksHhMVsLIeDaV-EGk?lfo63HCA&>^|)QKIKBkYjo2 zvEDVmXKDYDU-YAo^;A8*Z|T6h4-PNsCtt>dcqI<)oiDX@c8!S`zSwhAd4N)_klh(3 zqV|hIM4^OnUaKHfsDLhw2_j%00u?w7)6x7IlvD!Bg_`ge4O7@fW;iul*&&`-lvcQ{ zWHLU5W6Yv4Hb`rZ*(>wc^O{n#!jYG#3OmH#HN(J{#xO$NFl>Bjkc*>cm9S99J~ZAS zl=-GdP?lueq?}DVyc}v6vTItTG2;s3G*l-r>oAQzeLvvQTf__l+aR9Bs11jrHelzy zz^=OF1kIsD^oQL?vZ6?m^c(a(g?)9{_b0sh6plZELr-Ds2^@c}YHjkIwz3t{o0n5N z>#3c~slD~o-bbnZf5+5!h8#$k>%cjdhfvf!KL0KD=~;^pN)Jv zvaD{Yt6LV7h0#aquEl}6y7#$)rVpWWe$PBxcyG~Ky!`FZ;)nI#{)b!o>)ivZpi1&e gN|QS02Uh?;3x{8b&p*%8Xvf66^Wz(N?bH$VU$5le?EnA( literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__pycache__/error_reporting.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__pycache__/error_reporting.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5080f0cf3bc22c8e9bf23f74bf0393ae0d9acdb7 GIT binary patch literal 18406 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__pycache__/fastjsonschema_validations.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__pycache__/fastjsonschema_validations.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..00a737712976be4ebcceb6c9fc61d1a97644558b GIT binary patch literal 233706 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 F{a*l7{p0`u literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__pycache__/formats.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/__pycache__/formats.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e414aee3813fad8a87d9847f8968576a4c6f1a1c GIT binary patch literal 18502 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/error_reporting.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/error_reporting.py new file mode 100644 index 000000000..3591231c0 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/error_reporting.py @@ -0,0 +1,336 @@ +import io +import json +import logging +import os +import re +import typing +from contextlib import contextmanager +from textwrap import indent, wrap +from typing import Any, Dict, Generator, Iterator, List, Optional, Sequence, Union + +from .fastjsonschema_exceptions import JsonSchemaValueException + +if typing.TYPE_CHECKING: + import sys + + if sys.version_info < (3, 11): + from typing_extensions import Self + else: + from typing import Self + +_logger = logging.getLogger(__name__) + +_MESSAGE_REPLACEMENTS = { + "must be named by propertyName definition": "keys must be named by", + "one of contains definition": "at least one item that matches", + " same as const definition:": "", + "only specified items": "only items matching the definition", +} + +_SKIP_DETAILS = ( + "must not be empty", + "is always invalid", + "must not be there", +) + +_NEED_DETAILS = {"anyOf", "oneOf", "allOf", "contains", "propertyNames", "not", "items"} + +_CAMEL_CASE_SPLITTER = re.compile(r"\W+|([A-Z][^A-Z\W]*)") +_IDENTIFIER = re.compile(r"^[\w_]+$", re.I) + +_TOML_JARGON = { + "object": "table", + "property": "key", + "properties": "keys", + "property names": "keys", +} + +_FORMATS_HELP = """ +For more details about `format` see +https://validate-pyproject.readthedocs.io/en/latest/api/validate_pyproject.formats.html +""" + + +class ValidationError(JsonSchemaValueException): + """Report violations of a given JSON schema. + + This class extends :exc:`~fastjsonschema.JsonSchemaValueException` + by adding the following properties: + + - ``summary``: an improved version of the ``JsonSchemaValueException`` error message + with only the necessary information) + + - ``details``: more contextual information about the error like the failing schema + itself and the value that violates the schema. + + Depending on the level of the verbosity of the ``logging`` configuration + the exception message will be only ``summary`` (default) or a combination of + ``summary`` and ``details`` (when the logging level is set to :obj:`logging.DEBUG`). + """ + + summary = "" + details = "" + _original_message = "" + + @classmethod + def _from_jsonschema(cls, ex: JsonSchemaValueException) -> "Self": + formatter = _ErrorFormatting(ex) + obj = cls(str(formatter), ex.value, formatter.name, ex.definition, ex.rule) + debug_code = os.getenv("JSONSCHEMA_DEBUG_CODE_GENERATION", "false").lower() + if debug_code != "false": # pragma: no cover + obj.__cause__, obj.__traceback__ = ex.__cause__, ex.__traceback__ + obj._original_message = ex.message + obj.summary = formatter.summary + obj.details = formatter.details + return obj + + +@contextmanager +def detailed_errors() -> Generator[None, None, None]: + try: + yield + except JsonSchemaValueException as ex: + raise ValidationError._from_jsonschema(ex) from None + + +class _ErrorFormatting: + def __init__(self, ex: JsonSchemaValueException): + self.ex = ex + self.name = f"`{self._simplify_name(ex.name)}`" + self._original_message: str = self.ex.message.replace(ex.name, self.name) + self._summary = "" + self._details = "" + + def __str__(self) -> str: + if _logger.getEffectiveLevel() <= logging.DEBUG and self.details: + return f"{self.summary}\n\n{self.details}" + + return self.summary + + @property + def summary(self) -> str: + if not self._summary: + self._summary = self._expand_summary() + + return self._summary + + @property + def details(self) -> str: + if not self._details: + self._details = self._expand_details() + + return self._details + + @staticmethod + def _simplify_name(name: str) -> str: + x = len("data.") + return name[x:] if name.startswith("data.") else name + + def _expand_summary(self) -> str: + msg = self._original_message + + for bad, repl in _MESSAGE_REPLACEMENTS.items(): + msg = msg.replace(bad, repl) + + if any(substring in msg for substring in _SKIP_DETAILS): + return msg + + schema = self.ex.rule_definition + if self.ex.rule in _NEED_DETAILS and schema: + summary = _SummaryWriter(_TOML_JARGON) + return f"{msg}:\n\n{indent(summary(schema), ' ')}" + + return msg + + def _expand_details(self) -> str: + optional = [] + definition = self.ex.definition or {} + desc_lines = definition.pop("$$description", []) + desc = definition.pop("description", None) or " ".join(desc_lines) + if desc: + description = "\n".join( + wrap( + desc, + width=80, + initial_indent=" ", + subsequent_indent=" ", + break_long_words=False, + ) + ) + optional.append(f"DESCRIPTION:\n{description}") + schema = json.dumps(definition, indent=4) + value = json.dumps(self.ex.value, indent=4) + defaults = [ + f"GIVEN VALUE:\n{indent(value, ' ')}", + f"OFFENDING RULE: {self.ex.rule!r}", + f"DEFINITION:\n{indent(schema, ' ')}", + ] + msg = "\n\n".join(optional + defaults) + epilog = f"\n{_FORMATS_HELP}" if "format" in msg.lower() else "" + return msg + epilog + + +class _SummaryWriter: + _IGNORE = frozenset(("description", "default", "title", "examples")) + + def __init__(self, jargon: Optional[Dict[str, str]] = None): + self.jargon: Dict[str, str] = jargon or {} + # Clarify confusing terms + self._terms = { + "anyOf": "at least one of the following", + "oneOf": "exactly one of the following", + "allOf": "all of the following", + "not": "(*NOT* the following)", + "prefixItems": f"{self._jargon('items')} (in order)", + "items": "items", + "contains": "contains at least one of", + "propertyNames": ( + f"non-predefined acceptable {self._jargon('property names')}" + ), + "patternProperties": f"{self._jargon('properties')} named via pattern", + "const": "predefined value", + "enum": "one of", + } + # Attributes that indicate that the definition is easy and can be done + # inline (e.g. string and number) + self._guess_inline_defs = [ + "enum", + "const", + "maxLength", + "minLength", + "pattern", + "format", + "minimum", + "maximum", + "exclusiveMinimum", + "exclusiveMaximum", + "multipleOf", + ] + + def _jargon(self, term: Union[str, List[str]]) -> Union[str, List[str]]: + if isinstance(term, list): + return [self.jargon.get(t, t) for t in term] + return self.jargon.get(term, term) + + def __call__( + self, + schema: Union[dict, List[dict]], + prefix: str = "", + *, + _path: Sequence[str] = (), + ) -> str: + if isinstance(schema, list): + return self._handle_list(schema, prefix, _path) + + filtered = self._filter_unecessary(schema, _path) + simple = self._handle_simple_dict(filtered, _path) + if simple: + return f"{prefix}{simple}" + + child_prefix = self._child_prefix(prefix, " ") + item_prefix = self._child_prefix(prefix, "- ") + indent = len(prefix) * " " + with io.StringIO() as buffer: + for i, (key, value) in enumerate(filtered.items()): + child_path = [*_path, key] + line_prefix = prefix if i == 0 else indent + buffer.write(f"{line_prefix}{self._label(child_path)}:") + # ^ just the first item should receive the complete prefix + if isinstance(value, dict): + filtered = self._filter_unecessary(value, child_path) + simple = self._handle_simple_dict(filtered, child_path) + buffer.write( + f" {simple}" + if simple + else f"\n{self(value, child_prefix, _path=child_path)}" + ) + elif isinstance(value, list) and ( + key != "type" or self._is_property(child_path) + ): + children = self._handle_list(value, item_prefix, child_path) + sep = " " if children.startswith("[") else "\n" + buffer.write(f"{sep}{children}") + else: + buffer.write(f" {self._value(value, child_path)}\n") + return buffer.getvalue() + + def _is_unecessary(self, path: Sequence[str]) -> bool: + if self._is_property(path) or not path: # empty path => instruction @ root + return False + key = path[-1] + return any(key.startswith(k) for k in "$_") or key in self._IGNORE + + def _filter_unecessary( + self, schema: Dict[str, Any], path: Sequence[str] + ) -> Dict[str, Any]: + return { + key: value + for key, value in schema.items() + if not self._is_unecessary([*path, key]) + } + + def _handle_simple_dict(self, value: dict, path: Sequence[str]) -> Optional[str]: + inline = any(p in value for p in self._guess_inline_defs) + simple = not any(isinstance(v, (list, dict)) for v in value.values()) + if inline or simple: + return f"{{{', '.join(self._inline_attrs(value, path))}}}\n" + return None + + def _handle_list( + self, schemas: list, prefix: str = "", path: Sequence[str] = () + ) -> str: + if self._is_unecessary(path): + return "" + + repr_ = repr(schemas) + if all(not isinstance(e, (dict, list)) for e in schemas) and len(repr_) < 60: + return f"{repr_}\n" + + item_prefix = self._child_prefix(prefix, "- ") + return "".join( + self(v, item_prefix, _path=[*path, f"[{i}]"]) for i, v in enumerate(schemas) + ) + + def _is_property(self, path: Sequence[str]) -> bool: + """Check if the given path can correspond to an arbitrarily named property""" + counter = 0 + for key in path[-2::-1]: + if key not in {"properties", "patternProperties"}: + break + counter += 1 + + # If the counter if even, the path correspond to a JSON Schema keyword + # otherwise it can be any arbitrary string naming a property + return counter % 2 == 1 + + def _label(self, path: Sequence[str]) -> str: + *parents, key = path + if not self._is_property(path): + norm_key = _separate_terms(key) + return self._terms.get(key) or " ".join(self._jargon(norm_key)) + + if parents[-1] == "patternProperties": + return f"(regex {key!r})" + return repr(key) # property name + + def _value(self, value: Any, path: Sequence[str]) -> str: + if path[-1] == "type" and not self._is_property(path): + type_ = self._jargon(value) + return f"[{', '.join(type_)}]" if isinstance(type_, list) else type_ + return repr(value) + + def _inline_attrs(self, schema: dict, path: Sequence[str]) -> Iterator[str]: + for key, value in schema.items(): + child_path = [*path, key] + yield f"{self._label(child_path)}: {self._value(value, child_path)}" + + def _child_prefix(self, parent_prefix: str, child_prefix: str) -> str: + return len(parent_prefix) * " " + child_prefix + + +def _separate_terms(word: str) -> List[str]: + """ + >>> _separate_terms("FooBar-foo") + ['foo', 'bar', 'foo'] + """ + return [w.lower() for w in _CAMEL_CASE_SPLITTER.split(word) if w] diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/extra_validations.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/extra_validations.py new file mode 100644 index 000000000..789411d0f --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/extra_validations.py @@ -0,0 +1,82 @@ +"""The purpose of this module is implement PEP 621 validations that are +difficult to express as a JSON Schema (or that are not supported by the current +JSON Schema library). +""" + +from inspect import cleandoc +from typing import Mapping, TypeVar + +from .error_reporting import ValidationError + +T = TypeVar("T", bound=Mapping) + + +class RedefiningStaticFieldAsDynamic(ValidationError): + _DESC = """According to PEP 621: + + Build back-ends MUST raise an error if the metadata specifies a field + statically as well as being listed in dynamic. + """ + __doc__ = _DESC + _URL = ( + "https://packaging.python.org/en/latest/specifications/" + "pyproject-toml/#dynamic" + ) + + +class IncludedDependencyGroupMustExist(ValidationError): + _DESC = """An included dependency group must exist and must not be cyclic. + """ + __doc__ = _DESC + _URL = "https://peps.python.org/pep-0735/" + + +def validate_project_dynamic(pyproject: T) -> T: + project_table = pyproject.get("project", {}) + dynamic = project_table.get("dynamic", []) + + for field in dynamic: + if field in project_table: + raise RedefiningStaticFieldAsDynamic( + message=f"You cannot provide a value for `project.{field}` and " + "list it under `project.dynamic` at the same time", + value={ + field: project_table[field], + "...": " # ...", + "dynamic": dynamic, + }, + name=f"data.project.{field}", + definition={ + "description": cleandoc(RedefiningStaticFieldAsDynamic._DESC), + "see": RedefiningStaticFieldAsDynamic._URL, + }, + rule="PEP 621", + ) + + return pyproject + + +def validate_include_depenency(pyproject: T) -> T: + dependency_groups = pyproject.get("dependency-groups", {}) + for key, value in dependency_groups.items(): + for each in value: + if ( + isinstance(each, dict) + and (include_group := each.get("include-group")) + and include_group not in dependency_groups + ): + raise IncludedDependencyGroupMustExist( + message=f"The included dependency group {include_group} doesn't exist", + value=each, + name=f"data.dependency_groups.{key}", + definition={ + "description": cleandoc(IncludedDependencyGroupMustExist._DESC), + "see": IncludedDependencyGroupMustExist._URL, + }, + rule="PEP 735", + ) + # TODO: check for `include-group` cycles (can be conditional to graphlib) + return pyproject + + +EXTRA_VALIDATIONS = (validate_project_dynamic, validate_include_depenency) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_exceptions.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_exceptions.py new file mode 100644 index 000000000..d2dddd6a1 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_exceptions.py @@ -0,0 +1,51 @@ +import re + + +SPLIT_RE = re.compile(r'[\.\[\]]+') + + +class JsonSchemaException(ValueError): + """ + Base exception of ``fastjsonschema`` library. + """ + + +class JsonSchemaValueException(JsonSchemaException): + """ + Exception raised by validation function. Available properties: + + * ``message`` containing human-readable information what is wrong (e.g. ``data.property[index] must be smaller than or equal to 42``), + * invalid ``value`` (e.g. ``60``), + * ``name`` of a path in the data structure (e.g. ``data.property[index]``), + * ``path`` as an array in the data structure (e.g. ``['data', 'property', 'index']``), + * the whole ``definition`` which the ``value`` has to fulfil (e.g. ``{'type': 'number', 'maximum': 42}``), + * ``rule`` which the ``value`` is breaking (e.g. ``maximum``) + * and ``rule_definition`` (e.g. ``42``). + + .. versionchanged:: 2.14.0 + Added all extra properties. + """ + + def __init__(self, message, value=None, name=None, definition=None, rule=None): + super().__init__(message) + self.message = message + self.value = value + self.name = name + self.definition = definition + self.rule = rule + + @property + def path(self): + return [item for item in SPLIT_RE.split(self.name) if item != ''] + + @property + def rule_definition(self): + if not self.rule or not self.definition: + return None + return self.definition.get(self.rule) + + +class JsonSchemaDefinitionException(JsonSchemaException): + """ + Exception raised by generator of validation function. + """ diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_validations.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_validations.py new file mode 100644 index 000000000..c69368a83 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/fastjsonschema_validations.py @@ -0,0 +1,1412 @@ +# noqa +# ruff: noqa +# flake8: noqa +# pylint: skip-file +# mypy: ignore-errors +# yapf: disable +# pylama:skip=1 + + +# *** PLEASE DO NOT MODIFY DIRECTLY: Automatically generated code *** + + +VERSION = "2.20.0" +from decimal import Decimal +import re +from .fastjsonschema_exceptions import JsonSchemaValueException + + +REGEX_PATTERNS = { + '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$': re.compile('^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])\\Z'), + '^.*$': re.compile('^.*$'), + '.+': re.compile('.+'), + '^.+$': re.compile('^.+$'), + 'idn-email_re_pattern': re.compile('^[^@]+@[^@]+\\.[^@]+\\Z') +} + +NoneType = type(None) + +def validate(data, custom_formats={}, name_prefix=None): + validate_https___packaging_python_org_en_latest_specifications_declaring_build_dependencies(data, custom_formats, (name_prefix or "data") + "") + return data + +def validate_https___packaging_python_org_en_latest_specifications_declaring_build_dependencies(data, custom_formats={}, name_prefix=None): + if not isinstance(data, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/declaring-build-dependencies/', 'title': 'Data structure for ``pyproject.toml`` files', '$$description': ['File format containing build-time configurations for the Python ecosystem. ', ':pep:`517` initially defined a build-system independent format for source trees', 'which was complemented by :pep:`518` to provide a way of specifying dependencies ', 'for building Python projects.', 'Please notice the ``project`` table (as initially defined in :pep:`621`) is not included', 'in this schema and should be considered separately.'], 'type': 'object', 'additionalProperties': False, 'properties': {'build-system': {'type': 'object', 'description': 'Table used to store build-related data', 'additionalProperties': False, 'properties': {'requires': {'type': 'array', '$$description': ['List of dependencies in the :pep:`508` format required to execute the build', 'system. Please notice that the resulting dependency graph', '**MUST NOT contain cycles**'], 'items': {'type': 'string'}}, 'build-backend': {'type': 'string', 'description': 'Python object that will be used to perform the build according to :pep:`517`', 'format': 'pep517-backend-reference'}, 'backend-path': {'type': 'array', '$$description': ['List of directories to be prepended to ``sys.path`` when loading the', 'back-end, and running its hooks'], 'items': {'type': 'string', '$comment': 'Should be a path (TODO: enforce it with format?)'}}}, 'required': ['requires']}, 'project': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/pyproject-toml/', 'title': 'Package metadata stored in the ``project`` table', '$$description': ['Data structure for the **project** table inside ``pyproject.toml``', '(as initially defined in :pep:`621`)'], 'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, 'version': {'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, 'description': {'type': 'string', '$$description': ['The `summary description of the project', '`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's Description", '`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, 'requires-python': {'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '`_.']}, 'license': {'description': '`Project license `_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '`_.']}}, 'required': ['text']}]}, 'license-files': {'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, 'authors': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, 'maintainers': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, 'classifiers': {'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier `_.'}, '$$description': ['`Trove classifiers `_', 'which apply to the project.']}, 'urls': {'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, 'scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create command-line wrappers for the given', '`entry points `_.']}, 'gui-scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create GUI wrappers for the given', '`entry points `_.', 'The difference between ``scripts`` and ``gui-scripts`` is only relevant in', 'Windows.']}, 'entry-points': {'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$ref': '#/definitions/entry-point-group'}}}, 'dependencies': {'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$ref': '#/definitions/dependency'}}, 'optional-dependencies': {'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$ref': '#/definitions/dependency'}}}}, 'dynamic': {'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}}, 'required': ['name'], 'additionalProperties': False, 'allOf': [{'if': {'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, 'then': {'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}}, {'if': {'required': ['license-files']}, 'then': {'properties': {'license': {'type': 'string'}}}}], 'definitions': {'author': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, 'entry-point-group': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'dependency': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}, 'tool': {'type': 'object', 'properties': {'distutils': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html', 'title': '``tool.distutils`` table', '$$description': ['**EXPERIMENTAL** (NOT OFFICIALLY SUPPORTED): Use ``tool.distutils``', 'subtables to configure arguments for ``distutils`` commands.', 'Originally, ``distutils`` allowed developers to configure arguments for', '``setup.py`` commands via `distutils configuration files', '`_.', 'See also `the old Python docs _`.'], 'type': 'object', 'properties': {'global': {'type': 'object', 'description': 'Global options applied to all ``distutils`` commands'}}, 'patternProperties': {'.+': {'type': 'object'}}, '$comment': 'TODO: Is there a practical way of making this schema more specific?'}, 'setuptools': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html', 'title': '``tool.setuptools`` table', '$$description': ['``setuptools``-specific configurations that can be set by users that require', 'customization.', 'These configurations are completely optional and probably can be skipped when', 'creating simple packages. They are equivalent to some of the `Keywords', '`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '`_', 'that are not covered by :pep:`621`; and intentionally excludes ``dependency_links``', 'and ``setup_requires`` (incompatible with modern workflows/standards).'], 'type': 'object', 'additionalProperties': False, 'properties': {'platforms': {'type': 'array', 'items': {'type': 'string'}}, 'provides': {'$$description': ['Package and virtual package names contained within this package', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'obsoletes': {'$$description': ['Packages which this package renders obsolete', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'zip-safe': {'$$description': ['Whether the project can be safely installed and run from a zip file.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'boolean'}, 'script-files': {'$$description': ['Legacy way of defining scripts (entry-points are preferred).', 'Equivalent to the ``script`` keyword in ``setup.py``', '(it was renamed to avoid confusion with entry-point based ``project.scripts``', 'defined in :pep:`621`).', '**DISCOURAGED**: generic script wrappers are tricky and may not work properly.', 'Whenever possible, please use ``project.scripts`` instead.'], 'type': 'array', 'items': {'type': 'string'}, '$comment': 'TODO: is this field deprecated/should be removed?'}, 'eager-resources': {'$$description': ['Resources that should be extracted together, if any of them is needed,', 'or if any C extensions included in the project are imported.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'array', 'items': {'type': 'string'}}, 'packages': {'$$description': ['Packages that should be included in the distribution.', 'It can be given either as a list of package identifiers', 'or as a ``dict``-like structure with a single key ``find``', 'which corresponds to a dynamic call to', '``setuptools.config.expand.find_packages`` function.', 'The ``find`` key is associated with a nested ``dict``-like structure that can', 'contain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,', 'mimicking the keyword arguments of the associated function.'], 'oneOf': [{'title': 'Array of Python package identifiers', 'type': 'array', 'items': {'$ref': '#/definitions/package-name'}}, {'$ref': '#/definitions/find-directive'}]}, 'package-dir': {'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$ref': '#/definitions/package-name'}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, 'package-data': {'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'include-package-data': {'$$description': ['Automatically include any data files inside the package directories', 'that are specified by ``MANIFEST.in``', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'boolean'}, 'exclude-package-data': {'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'namespace-packages': {'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'https://setuptools.pypa.io/en/latest/userguide/package_discovery.html', 'description': '**DEPRECATED**: use implicit namespaces instead (:pep:`420`).'}, 'py-modules': {'description': 'Modules that setuptools will manipulate', 'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'TODO: clarify the relationship with ``packages``'}, 'ext-modules': {'description': 'Extension modules to be compiled by setuptools', 'type': 'array', 'items': {'$ref': '#/definitions/ext-module'}}, 'data-files': {'$$description': ['``dict``-like structure where each key represents a directory and', 'the value is a list of glob patterns that should be installed in them.', '**DISCOURAGED**: please notice this might not work as expected with wheels.', 'Whenever possible, consider using data files inside the package directories', '(or create a new namespace package that only contains data files).', 'See `data files support', '`_.'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'cmdclass': {'$$description': ['Mapping of distutils-style command names to ``setuptools.Command`` subclasses', 'which in turn should be represented by strings with a qualified class name', '(i.e., "dotted" form with module), e.g.::\n\n', ' cmdclass = {mycmd = "pkg.subpkg.module.CommandClass"}\n\n', 'The command class should be a directly defined at the top-level of the', 'containing module (no class nesting).'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'string', 'format': 'python-qualified-identifier'}}}, 'license-files': {'type': 'array', 'items': {'type': 'string'}, '$$description': ['**PROVISIONAL**: list of glob patterns for all license files being distributed.', '(likely to become standard with :pep:`639`).', "By default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``"], '$comment': 'TODO: revise if PEP 639 is accepted. Probably ``project.license-files``?'}, 'dynamic': {'type': 'object', 'description': 'Instructions for loading :pep:`621`-related metadata dynamically', 'additionalProperties': False, 'properties': {'version': {'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'$ref': '#/definitions/attr-directive'}, {'$ref': '#/definitions/file-directive'}]}, 'classifiers': {'$ref': '#/definitions/file-directive'}, 'description': {'$ref': '#/definitions/file-directive'}, 'entry-points': {'$ref': '#/definitions/file-directive'}, 'dependencies': {'$ref': '#/definitions/file-directive-for-dependencies'}, 'optional-dependencies': {'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'$ref': '#/definitions/file-directive-for-dependencies'}}}, 'readme': {'type': 'object', 'anyOf': [{'$ref': '#/definitions/file-directive'}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'$ref': '#/definitions/file-directive/properties/file'}}, 'additionalProperties': False}], 'required': ['file']}}}}, 'definitions': {'package-name': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}, 'ext-module': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, 'file-directive': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'file-directive-for-dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$ref': '#/definitions/file-directive'}]}, 'attr-directive': {'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, 'find-directive': {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}}}}}, 'dependency-groups': {'type': 'object', 'description': 'Dependency groups following PEP 735', 'additionalProperties': False, 'patternProperties': {'^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$': {'type': 'array', 'items': {'oneOf': [{'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, {'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}]}}}}}, 'project': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/pyproject-toml/', 'title': 'Package metadata stored in the ``project`` table', '$$description': ['Data structure for the **project** table inside ``pyproject.toml``', '(as initially defined in :pep:`621`)'], 'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, 'version': {'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, 'description': {'type': 'string', '$$description': ['The `summary description of the project', '`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's Description", '`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, 'requires-python': {'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '`_.']}, 'license': {'description': '`Project license `_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '`_.']}}, 'required': ['text']}]}, 'license-files': {'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, 'authors': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, 'maintainers': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, 'classifiers': {'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier `_.'}, '$$description': ['`Trove classifiers `_', 'which apply to the project.']}, 'urls': {'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, 'scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create command-line wrappers for the given', '`entry points `_.']}, 'gui-scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create GUI wrappers for the given', '`entry points `_.', 'The difference between ``scripts`` and ``gui-scripts`` is only relevant in', 'Windows.']}, 'entry-points': {'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$ref': '#/definitions/entry-point-group'}}}, 'dependencies': {'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$ref': '#/definitions/dependency'}}, 'optional-dependencies': {'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$ref': '#/definitions/dependency'}}}}, 'dynamic': {'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}}, 'required': ['name'], 'additionalProperties': False, 'allOf': [{'if': {'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, 'then': {'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}}, {'if': {'required': ['license-files']}, 'then': {'properties': {'license': {'type': 'string'}}}}], 'definitions': {'author': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, 'entry-point-group': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'dependency': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, rule='type') + data_is_dict = isinstance(data, dict) + if data_is_dict: + data_keys = set(data.keys()) + if "build-system" in data_keys: + data_keys.remove("build-system") + data__buildsystem = data["build-system"] + if not isinstance(data__buildsystem, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system must be object", value=data__buildsystem, name="" + (name_prefix or "data") + ".build-system", definition={'type': 'object', 'description': 'Table used to store build-related data', 'additionalProperties': False, 'properties': {'requires': {'type': 'array', '$$description': ['List of dependencies in the :pep:`508` format required to execute the build', 'system. Please notice that the resulting dependency graph', '**MUST NOT contain cycles**'], 'items': {'type': 'string'}}, 'build-backend': {'type': 'string', 'description': 'Python object that will be used to perform the build according to :pep:`517`', 'format': 'pep517-backend-reference'}, 'backend-path': {'type': 'array', '$$description': ['List of directories to be prepended to ``sys.path`` when loading the', 'back-end, and running its hooks'], 'items': {'type': 'string', '$comment': 'Should be a path (TODO: enforce it with format?)'}}}, 'required': ['requires']}, rule='type') + data__buildsystem_is_dict = isinstance(data__buildsystem, dict) + if data__buildsystem_is_dict: + data__buildsystem__missing_keys = set(['requires']) - data__buildsystem.keys() + if data__buildsystem__missing_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system must contain " + (str(sorted(data__buildsystem__missing_keys)) + " properties"), value=data__buildsystem, name="" + (name_prefix or "data") + ".build-system", definition={'type': 'object', 'description': 'Table used to store build-related data', 'additionalProperties': False, 'properties': {'requires': {'type': 'array', '$$description': ['List of dependencies in the :pep:`508` format required to execute the build', 'system. Please notice that the resulting dependency graph', '**MUST NOT contain cycles**'], 'items': {'type': 'string'}}, 'build-backend': {'type': 'string', 'description': 'Python object that will be used to perform the build according to :pep:`517`', 'format': 'pep517-backend-reference'}, 'backend-path': {'type': 'array', '$$description': ['List of directories to be prepended to ``sys.path`` when loading the', 'back-end, and running its hooks'], 'items': {'type': 'string', '$comment': 'Should be a path (TODO: enforce it with format?)'}}}, 'required': ['requires']}, rule='required') + data__buildsystem_keys = set(data__buildsystem.keys()) + if "requires" in data__buildsystem_keys: + data__buildsystem_keys.remove("requires") + data__buildsystem__requires = data__buildsystem["requires"] + if not isinstance(data__buildsystem__requires, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system.requires must be array", value=data__buildsystem__requires, name="" + (name_prefix or "data") + ".build-system.requires", definition={'type': 'array', '$$description': ['List of dependencies in the :pep:`508` format required to execute the build', 'system. Please notice that the resulting dependency graph', '**MUST NOT contain cycles**'], 'items': {'type': 'string'}}, rule='type') + data__buildsystem__requires_is_list = isinstance(data__buildsystem__requires, (list, tuple)) + if data__buildsystem__requires_is_list: + data__buildsystem__requires_len = len(data__buildsystem__requires) + for data__buildsystem__requires_x, data__buildsystem__requires_item in enumerate(data__buildsystem__requires): + if not isinstance(data__buildsystem__requires_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system.requires[{data__buildsystem__requires_x}]".format(**locals()) + " must be string", value=data__buildsystem__requires_item, name="" + (name_prefix or "data") + ".build-system.requires[{data__buildsystem__requires_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "build-backend" in data__buildsystem_keys: + data__buildsystem_keys.remove("build-backend") + data__buildsystem__buildbackend = data__buildsystem["build-backend"] + if not isinstance(data__buildsystem__buildbackend, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system.build-backend must be string", value=data__buildsystem__buildbackend, name="" + (name_prefix or "data") + ".build-system.build-backend", definition={'type': 'string', 'description': 'Python object that will be used to perform the build according to :pep:`517`', 'format': 'pep517-backend-reference'}, rule='type') + if isinstance(data__buildsystem__buildbackend, str): + if not custom_formats["pep517-backend-reference"](data__buildsystem__buildbackend): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system.build-backend must be pep517-backend-reference", value=data__buildsystem__buildbackend, name="" + (name_prefix or "data") + ".build-system.build-backend", definition={'type': 'string', 'description': 'Python object that will be used to perform the build according to :pep:`517`', 'format': 'pep517-backend-reference'}, rule='format') + if "backend-path" in data__buildsystem_keys: + data__buildsystem_keys.remove("backend-path") + data__buildsystem__backendpath = data__buildsystem["backend-path"] + if not isinstance(data__buildsystem__backendpath, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system.backend-path must be array", value=data__buildsystem__backendpath, name="" + (name_prefix or "data") + ".build-system.backend-path", definition={'type': 'array', '$$description': ['List of directories to be prepended to ``sys.path`` when loading the', 'back-end, and running its hooks'], 'items': {'type': 'string', '$comment': 'Should be a path (TODO: enforce it with format?)'}}, rule='type') + data__buildsystem__backendpath_is_list = isinstance(data__buildsystem__backendpath, (list, tuple)) + if data__buildsystem__backendpath_is_list: + data__buildsystem__backendpath_len = len(data__buildsystem__backendpath) + for data__buildsystem__backendpath_x, data__buildsystem__backendpath_item in enumerate(data__buildsystem__backendpath): + if not isinstance(data__buildsystem__backendpath_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system.backend-path[{data__buildsystem__backendpath_x}]".format(**locals()) + " must be string", value=data__buildsystem__backendpath_item, name="" + (name_prefix or "data") + ".build-system.backend-path[{data__buildsystem__backendpath_x}]".format(**locals()) + "", definition={'type': 'string', '$comment': 'Should be a path (TODO: enforce it with format?)'}, rule='type') + if data__buildsystem_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".build-system must not contain "+str(data__buildsystem_keys)+" properties", value=data__buildsystem, name="" + (name_prefix or "data") + ".build-system", definition={'type': 'object', 'description': 'Table used to store build-related data', 'additionalProperties': False, 'properties': {'requires': {'type': 'array', '$$description': ['List of dependencies in the :pep:`508` format required to execute the build', 'system. Please notice that the resulting dependency graph', '**MUST NOT contain cycles**'], 'items': {'type': 'string'}}, 'build-backend': {'type': 'string', 'description': 'Python object that will be used to perform the build according to :pep:`517`', 'format': 'pep517-backend-reference'}, 'backend-path': {'type': 'array', '$$description': ['List of directories to be prepended to ``sys.path`` when loading the', 'back-end, and running its hooks'], 'items': {'type': 'string', '$comment': 'Should be a path (TODO: enforce it with format?)'}}}, 'required': ['requires']}, rule='additionalProperties') + if "project" in data_keys: + data_keys.remove("project") + data__project = data["project"] + validate_https___packaging_python_org_en_latest_specifications_pyproject_toml(data__project, custom_formats, (name_prefix or "data") + ".project") + if "tool" in data_keys: + data_keys.remove("tool") + data__tool = data["tool"] + if not isinstance(data__tool, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".tool must be object", value=data__tool, name="" + (name_prefix or "data") + ".tool", definition={'type': 'object', 'properties': {'distutils': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html', 'title': '``tool.distutils`` table', '$$description': ['**EXPERIMENTAL** (NOT OFFICIALLY SUPPORTED): Use ``tool.distutils``', 'subtables to configure arguments for ``distutils`` commands.', 'Originally, ``distutils`` allowed developers to configure arguments for', '``setup.py`` commands via `distutils configuration files', '`_.', 'See also `the old Python docs _`.'], 'type': 'object', 'properties': {'global': {'type': 'object', 'description': 'Global options applied to all ``distutils`` commands'}}, 'patternProperties': {'.+': {'type': 'object'}}, '$comment': 'TODO: Is there a practical way of making this schema more specific?'}, 'setuptools': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html', 'title': '``tool.setuptools`` table', '$$description': ['``setuptools``-specific configurations that can be set by users that require', 'customization.', 'These configurations are completely optional and probably can be skipped when', 'creating simple packages. They are equivalent to some of the `Keywords', '`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '`_', 'that are not covered by :pep:`621`; and intentionally excludes ``dependency_links``', 'and ``setup_requires`` (incompatible with modern workflows/standards).'], 'type': 'object', 'additionalProperties': False, 'properties': {'platforms': {'type': 'array', 'items': {'type': 'string'}}, 'provides': {'$$description': ['Package and virtual package names contained within this package', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'obsoletes': {'$$description': ['Packages which this package renders obsolete', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'zip-safe': {'$$description': ['Whether the project can be safely installed and run from a zip file.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'boolean'}, 'script-files': {'$$description': ['Legacy way of defining scripts (entry-points are preferred).', 'Equivalent to the ``script`` keyword in ``setup.py``', '(it was renamed to avoid confusion with entry-point based ``project.scripts``', 'defined in :pep:`621`).', '**DISCOURAGED**: generic script wrappers are tricky and may not work properly.', 'Whenever possible, please use ``project.scripts`` instead.'], 'type': 'array', 'items': {'type': 'string'}, '$comment': 'TODO: is this field deprecated/should be removed?'}, 'eager-resources': {'$$description': ['Resources that should be extracted together, if any of them is needed,', 'or if any C extensions included in the project are imported.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'array', 'items': {'type': 'string'}}, 'packages': {'$$description': ['Packages that should be included in the distribution.', 'It can be given either as a list of package identifiers', 'or as a ``dict``-like structure with a single key ``find``', 'which corresponds to a dynamic call to', '``setuptools.config.expand.find_packages`` function.', 'The ``find`` key is associated with a nested ``dict``-like structure that can', 'contain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,', 'mimicking the keyword arguments of the associated function.'], 'oneOf': [{'title': 'Array of Python package identifiers', 'type': 'array', 'items': {'$ref': '#/definitions/package-name'}}, {'$ref': '#/definitions/find-directive'}]}, 'package-dir': {'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$ref': '#/definitions/package-name'}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, 'package-data': {'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'include-package-data': {'$$description': ['Automatically include any data files inside the package directories', 'that are specified by ``MANIFEST.in``', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'boolean'}, 'exclude-package-data': {'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'namespace-packages': {'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'https://setuptools.pypa.io/en/latest/userguide/package_discovery.html', 'description': '**DEPRECATED**: use implicit namespaces instead (:pep:`420`).'}, 'py-modules': {'description': 'Modules that setuptools will manipulate', 'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'TODO: clarify the relationship with ``packages``'}, 'ext-modules': {'description': 'Extension modules to be compiled by setuptools', 'type': 'array', 'items': {'$ref': '#/definitions/ext-module'}}, 'data-files': {'$$description': ['``dict``-like structure where each key represents a directory and', 'the value is a list of glob patterns that should be installed in them.', '**DISCOURAGED**: please notice this might not work as expected with wheels.', 'Whenever possible, consider using data files inside the package directories', '(or create a new namespace package that only contains data files).', 'See `data files support', '`_.'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'cmdclass': {'$$description': ['Mapping of distutils-style command names to ``setuptools.Command`` subclasses', 'which in turn should be represented by strings with a qualified class name', '(i.e., "dotted" form with module), e.g.::\n\n', ' cmdclass = {mycmd = "pkg.subpkg.module.CommandClass"}\n\n', 'The command class should be a directly defined at the top-level of the', 'containing module (no class nesting).'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'string', 'format': 'python-qualified-identifier'}}}, 'license-files': {'type': 'array', 'items': {'type': 'string'}, '$$description': ['**PROVISIONAL**: list of glob patterns for all license files being distributed.', '(likely to become standard with :pep:`639`).', "By default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``"], '$comment': 'TODO: revise if PEP 639 is accepted. Probably ``project.license-files``?'}, 'dynamic': {'type': 'object', 'description': 'Instructions for loading :pep:`621`-related metadata dynamically', 'additionalProperties': False, 'properties': {'version': {'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'$ref': '#/definitions/attr-directive'}, {'$ref': '#/definitions/file-directive'}]}, 'classifiers': {'$ref': '#/definitions/file-directive'}, 'description': {'$ref': '#/definitions/file-directive'}, 'entry-points': {'$ref': '#/definitions/file-directive'}, 'dependencies': {'$ref': '#/definitions/file-directive-for-dependencies'}, 'optional-dependencies': {'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'$ref': '#/definitions/file-directive-for-dependencies'}}}, 'readme': {'type': 'object', 'anyOf': [{'$ref': '#/definitions/file-directive'}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'$ref': '#/definitions/file-directive/properties/file'}}, 'additionalProperties': False}], 'required': ['file']}}}}, 'definitions': {'package-name': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}, 'ext-module': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, 'file-directive': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'file-directive-for-dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$ref': '#/definitions/file-directive'}]}, 'attr-directive': {'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, 'find-directive': {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}}}}}, rule='type') + data__tool_is_dict = isinstance(data__tool, dict) + if data__tool_is_dict: + data__tool_keys = set(data__tool.keys()) + if "distutils" in data__tool_keys: + data__tool_keys.remove("distutils") + data__tool__distutils = data__tool["distutils"] + validate_https___setuptools_pypa_io_en_latest_deprecated_distutils_configfile_html(data__tool__distutils, custom_formats, (name_prefix or "data") + ".tool.distutils") + if "setuptools" in data__tool_keys: + data__tool_keys.remove("setuptools") + data__tool__setuptools = data__tool["setuptools"] + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html(data__tool__setuptools, custom_formats, (name_prefix or "data") + ".tool.setuptools") + if "dependency-groups" in data_keys: + data_keys.remove("dependency-groups") + data__dependencygroups = data["dependency-groups"] + if not isinstance(data__dependencygroups, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups must be object", value=data__dependencygroups, name="" + (name_prefix or "data") + ".dependency-groups", definition={'type': 'object', 'description': 'Dependency groups following PEP 735', 'additionalProperties': False, 'patternProperties': {'^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$': {'type': 'array', 'items': {'oneOf': [{'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, {'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}]}}}}, rule='type') + data__dependencygroups_is_dict = isinstance(data__dependencygroups, dict) + if data__dependencygroups_is_dict: + data__dependencygroups_keys = set(data__dependencygroups.keys()) + for data__dependencygroups_key, data__dependencygroups_val in data__dependencygroups.items(): + if REGEX_PATTERNS['^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'].search(data__dependencygroups_key): + if data__dependencygroups_key in data__dependencygroups_keys: + data__dependencygroups_keys.remove(data__dependencygroups_key) + if not isinstance(data__dependencygroups_val, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}".format(**locals()) + " must be array", value=data__dependencygroups_val, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}".format(**locals()) + "", definition={'type': 'array', 'items': {'oneOf': [{'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, {'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}]}}, rule='type') + data__dependencygroups_val_is_list = isinstance(data__dependencygroups_val, (list, tuple)) + if data__dependencygroups_val_is_list: + data__dependencygroups_val_len = len(data__dependencygroups_val) + for data__dependencygroups_val_x, data__dependencygroups_val_item in enumerate(data__dependencygroups_val): + data__dependencygroups_val_item_one_of_count1 = 0 + if data__dependencygroups_val_item_one_of_count1 < 2: + try: + if not isinstance(data__dependencygroups_val_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + " must be string", value=data__dependencygroups_val_item, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + "", definition={'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, rule='type') + if isinstance(data__dependencygroups_val_item, str): + if not custom_formats["pep508"](data__dependencygroups_val_item): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + " must be pep508", value=data__dependencygroups_val_item, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + "", definition={'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, rule='format') + data__dependencygroups_val_item_one_of_count1 += 1 + except JsonSchemaValueException: pass + if data__dependencygroups_val_item_one_of_count1 < 2: + try: + if not isinstance(data__dependencygroups_val_item, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + " must be object", value=data__dependencygroups_val_item, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + "", definition={'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}, rule='type') + data__dependencygroups_val_item_is_dict = isinstance(data__dependencygroups_val_item, dict) + if data__dependencygroups_val_item_is_dict: + data__dependencygroups_val_item_keys = set(data__dependencygroups_val_item.keys()) + if "include-group" in data__dependencygroups_val_item_keys: + data__dependencygroups_val_item_keys.remove("include-group") + data__dependencygroups_val_item__includegroup = data__dependencygroups_val_item["include-group"] + if not isinstance(data__dependencygroups_val_item__includegroup, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}].include-group".format(**locals()) + " must be string", value=data__dependencygroups_val_item__includegroup, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}].include-group".format(**locals()) + "", definition={'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}, rule='type') + if isinstance(data__dependencygroups_val_item__includegroup, str): + if not REGEX_PATTERNS['^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'].search(data__dependencygroups_val_item__includegroup): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}].include-group".format(**locals()) + " must match pattern ^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$", value=data__dependencygroups_val_item__includegroup, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}].include-group".format(**locals()) + "", definition={'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}, rule='pattern') + if data__dependencygroups_val_item_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + " must not contain "+str(data__dependencygroups_val_item_keys)+" properties", value=data__dependencygroups_val_item, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + "", definition={'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}, rule='additionalProperties') + data__dependencygroups_val_item_one_of_count1 += 1 + except JsonSchemaValueException: pass + if data__dependencygroups_val_item_one_of_count1 != 1: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + " must be valid exactly by one definition" + (" (" + str(data__dependencygroups_val_item_one_of_count1) + " matches found)"), value=data__dependencygroups_val_item, name="" + (name_prefix or "data") + ".dependency-groups.{data__dependencygroups_key}[{data__dependencygroups_val_x}]".format(**locals()) + "", definition={'oneOf': [{'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, {'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}]}, rule='oneOf') + if data__dependencygroups_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependency-groups must not contain "+str(data__dependencygroups_keys)+" properties", value=data__dependencygroups, name="" + (name_prefix or "data") + ".dependency-groups", definition={'type': 'object', 'description': 'Dependency groups following PEP 735', 'additionalProperties': False, 'patternProperties': {'^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$': {'type': 'array', 'items': {'oneOf': [{'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, {'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}]}}}}, rule='additionalProperties') + if data_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/declaring-build-dependencies/', 'title': 'Data structure for ``pyproject.toml`` files', '$$description': ['File format containing build-time configurations for the Python ecosystem. ', ':pep:`517` initially defined a build-system independent format for source trees', 'which was complemented by :pep:`518` to provide a way of specifying dependencies ', 'for building Python projects.', 'Please notice the ``project`` table (as initially defined in :pep:`621`) is not included', 'in this schema and should be considered separately.'], 'type': 'object', 'additionalProperties': False, 'properties': {'build-system': {'type': 'object', 'description': 'Table used to store build-related data', 'additionalProperties': False, 'properties': {'requires': {'type': 'array', '$$description': ['List of dependencies in the :pep:`508` format required to execute the build', 'system. Please notice that the resulting dependency graph', '**MUST NOT contain cycles**'], 'items': {'type': 'string'}}, 'build-backend': {'type': 'string', 'description': 'Python object that will be used to perform the build according to :pep:`517`', 'format': 'pep517-backend-reference'}, 'backend-path': {'type': 'array', '$$description': ['List of directories to be prepended to ``sys.path`` when loading the', 'back-end, and running its hooks'], 'items': {'type': 'string', '$comment': 'Should be a path (TODO: enforce it with format?)'}}}, 'required': ['requires']}, 'project': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/pyproject-toml/', 'title': 'Package metadata stored in the ``project`` table', '$$description': ['Data structure for the **project** table inside ``pyproject.toml``', '(as initially defined in :pep:`621`)'], 'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, 'version': {'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, 'description': {'type': 'string', '$$description': ['The `summary description of the project', '`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's Description", '`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, 'requires-python': {'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '`_.']}, 'license': {'description': '`Project license `_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '`_.']}}, 'required': ['text']}]}, 'license-files': {'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, 'authors': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, 'maintainers': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, 'classifiers': {'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier `_.'}, '$$description': ['`Trove classifiers `_', 'which apply to the project.']}, 'urls': {'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, 'scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create command-line wrappers for the given', '`entry points `_.']}, 'gui-scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create GUI wrappers for the given', '`entry points `_.', 'The difference between ``scripts`` and ``gui-scripts`` is only relevant in', 'Windows.']}, 'entry-points': {'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$ref': '#/definitions/entry-point-group'}}}, 'dependencies': {'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$ref': '#/definitions/dependency'}}, 'optional-dependencies': {'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$ref': '#/definitions/dependency'}}}}, 'dynamic': {'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}}, 'required': ['name'], 'additionalProperties': False, 'allOf': [{'if': {'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, 'then': {'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}}, {'if': {'required': ['license-files']}, 'then': {'properties': {'license': {'type': 'string'}}}}], 'definitions': {'author': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, 'entry-point-group': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'dependency': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}, 'tool': {'type': 'object', 'properties': {'distutils': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html', 'title': '``tool.distutils`` table', '$$description': ['**EXPERIMENTAL** (NOT OFFICIALLY SUPPORTED): Use ``tool.distutils``', 'subtables to configure arguments for ``distutils`` commands.', 'Originally, ``distutils`` allowed developers to configure arguments for', '``setup.py`` commands via `distutils configuration files', '`_.', 'See also `the old Python docs _`.'], 'type': 'object', 'properties': {'global': {'type': 'object', 'description': 'Global options applied to all ``distutils`` commands'}}, 'patternProperties': {'.+': {'type': 'object'}}, '$comment': 'TODO: Is there a practical way of making this schema more specific?'}, 'setuptools': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html', 'title': '``tool.setuptools`` table', '$$description': ['``setuptools``-specific configurations that can be set by users that require', 'customization.', 'These configurations are completely optional and probably can be skipped when', 'creating simple packages. They are equivalent to some of the `Keywords', '`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '`_', 'that are not covered by :pep:`621`; and intentionally excludes ``dependency_links``', 'and ``setup_requires`` (incompatible with modern workflows/standards).'], 'type': 'object', 'additionalProperties': False, 'properties': {'platforms': {'type': 'array', 'items': {'type': 'string'}}, 'provides': {'$$description': ['Package and virtual package names contained within this package', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'obsoletes': {'$$description': ['Packages which this package renders obsolete', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'zip-safe': {'$$description': ['Whether the project can be safely installed and run from a zip file.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'boolean'}, 'script-files': {'$$description': ['Legacy way of defining scripts (entry-points are preferred).', 'Equivalent to the ``script`` keyword in ``setup.py``', '(it was renamed to avoid confusion with entry-point based ``project.scripts``', 'defined in :pep:`621`).', '**DISCOURAGED**: generic script wrappers are tricky and may not work properly.', 'Whenever possible, please use ``project.scripts`` instead.'], 'type': 'array', 'items': {'type': 'string'}, '$comment': 'TODO: is this field deprecated/should be removed?'}, 'eager-resources': {'$$description': ['Resources that should be extracted together, if any of them is needed,', 'or if any C extensions included in the project are imported.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'array', 'items': {'type': 'string'}}, 'packages': {'$$description': ['Packages that should be included in the distribution.', 'It can be given either as a list of package identifiers', 'or as a ``dict``-like structure with a single key ``find``', 'which corresponds to a dynamic call to', '``setuptools.config.expand.find_packages`` function.', 'The ``find`` key is associated with a nested ``dict``-like structure that can', 'contain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,', 'mimicking the keyword arguments of the associated function.'], 'oneOf': [{'title': 'Array of Python package identifiers', 'type': 'array', 'items': {'$ref': '#/definitions/package-name'}}, {'$ref': '#/definitions/find-directive'}]}, 'package-dir': {'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$ref': '#/definitions/package-name'}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, 'package-data': {'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'include-package-data': {'$$description': ['Automatically include any data files inside the package directories', 'that are specified by ``MANIFEST.in``', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'boolean'}, 'exclude-package-data': {'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'namespace-packages': {'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'https://setuptools.pypa.io/en/latest/userguide/package_discovery.html', 'description': '**DEPRECATED**: use implicit namespaces instead (:pep:`420`).'}, 'py-modules': {'description': 'Modules that setuptools will manipulate', 'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'TODO: clarify the relationship with ``packages``'}, 'ext-modules': {'description': 'Extension modules to be compiled by setuptools', 'type': 'array', 'items': {'$ref': '#/definitions/ext-module'}}, 'data-files': {'$$description': ['``dict``-like structure where each key represents a directory and', 'the value is a list of glob patterns that should be installed in them.', '**DISCOURAGED**: please notice this might not work as expected with wheels.', 'Whenever possible, consider using data files inside the package directories', '(or create a new namespace package that only contains data files).', 'See `data files support', '`_.'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'cmdclass': {'$$description': ['Mapping of distutils-style command names to ``setuptools.Command`` subclasses', 'which in turn should be represented by strings with a qualified class name', '(i.e., "dotted" form with module), e.g.::\n\n', ' cmdclass = {mycmd = "pkg.subpkg.module.CommandClass"}\n\n', 'The command class should be a directly defined at the top-level of the', 'containing module (no class nesting).'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'string', 'format': 'python-qualified-identifier'}}}, 'license-files': {'type': 'array', 'items': {'type': 'string'}, '$$description': ['**PROVISIONAL**: list of glob patterns for all license files being distributed.', '(likely to become standard with :pep:`639`).', "By default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``"], '$comment': 'TODO: revise if PEP 639 is accepted. Probably ``project.license-files``?'}, 'dynamic': {'type': 'object', 'description': 'Instructions for loading :pep:`621`-related metadata dynamically', 'additionalProperties': False, 'properties': {'version': {'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'$ref': '#/definitions/attr-directive'}, {'$ref': '#/definitions/file-directive'}]}, 'classifiers': {'$ref': '#/definitions/file-directive'}, 'description': {'$ref': '#/definitions/file-directive'}, 'entry-points': {'$ref': '#/definitions/file-directive'}, 'dependencies': {'$ref': '#/definitions/file-directive-for-dependencies'}, 'optional-dependencies': {'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'$ref': '#/definitions/file-directive-for-dependencies'}}}, 'readme': {'type': 'object', 'anyOf': [{'$ref': '#/definitions/file-directive'}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'$ref': '#/definitions/file-directive/properties/file'}}, 'additionalProperties': False}], 'required': ['file']}}}}, 'definitions': {'package-name': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}, 'ext-module': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, 'file-directive': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'file-directive-for-dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$ref': '#/definitions/file-directive'}]}, 'attr-directive': {'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, 'find-directive': {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}}}}}, 'dependency-groups': {'type': 'object', 'description': 'Dependency groups following PEP 735', 'additionalProperties': False, 'patternProperties': {'^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$': {'type': 'array', 'items': {'oneOf': [{'type': 'string', 'description': 'Python package specifiers following PEP 508', 'format': 'pep508'}, {'type': 'object', 'additionalProperties': False, 'properties': {'include-group': {'description': 'Another dependency group to include in this one', 'type': 'string', 'pattern': '^([a-zA-Z0-9]|[a-zA-Z0-9][a-zA-Z0-9._-]*[a-zA-Z0-9])$'}}}]}}}}}, 'project': {'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/pyproject-toml/', 'title': 'Package metadata stored in the ``project`` table', '$$description': ['Data structure for the **project** table inside ``pyproject.toml``', '(as initially defined in :pep:`621`)'], 'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, 'version': {'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, 'description': {'type': 'string', '$$description': ['The `summary description of the project', '`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's Description", '`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, 'requires-python': {'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '`_.']}, 'license': {'description': '`Project license `_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '`_.']}}, 'required': ['text']}]}, 'license-files': {'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, 'authors': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, 'maintainers': {'type': 'array', 'items': {'$ref': '#/definitions/author'}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, 'classifiers': {'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier `_.'}, '$$description': ['`Trove classifiers `_', 'which apply to the project.']}, 'urls': {'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, 'scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create command-line wrappers for the given', '`entry points `_.']}, 'gui-scripts': {'$ref': '#/definitions/entry-point-group', '$$description': ['Instruct the installer to create GUI wrappers for the given', '`entry points `_.', 'The difference between ``scripts`` and ``gui-scripts`` is only relevant in', 'Windows.']}, 'entry-points': {'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$ref': '#/definitions/entry-point-group'}}}, 'dependencies': {'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$ref': '#/definitions/dependency'}}, 'optional-dependencies': {'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$ref': '#/definitions/dependency'}}}}, 'dynamic': {'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}}, 'required': ['name'], 'additionalProperties': False, 'allOf': [{'if': {'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, 'then': {'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}}, {'if': {'required': ['license-files']}, 'then': {'properties': {'license': {'type': 'string'}}}}], 'definitions': {'author': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, 'entry-point-group': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'dependency': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, rule='additionalProperties') + return data + +def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html(data, custom_formats={}, name_prefix=None): + if not isinstance(data, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html', 'title': '``tool.setuptools`` table', '$$description': ['``setuptools``-specific configurations that can be set by users that require', 'customization.', 'These configurations are completely optional and probably can be skipped when', 'creating simple packages. They are equivalent to some of the `Keywords', '`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '`_', 'that are not covered by :pep:`621`; and intentionally excludes ``dependency_links``', 'and ``setup_requires`` (incompatible with modern workflows/standards).'], 'type': 'object', 'additionalProperties': False, 'properties': {'platforms': {'type': 'array', 'items': {'type': 'string'}}, 'provides': {'$$description': ['Package and virtual package names contained within this package', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'obsoletes': {'$$description': ['Packages which this package renders obsolete', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'zip-safe': {'$$description': ['Whether the project can be safely installed and run from a zip file.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'boolean'}, 'script-files': {'$$description': ['Legacy way of defining scripts (entry-points are preferred).', 'Equivalent to the ``script`` keyword in ``setup.py``', '(it was renamed to avoid confusion with entry-point based ``project.scripts``', 'defined in :pep:`621`).', '**DISCOURAGED**: generic script wrappers are tricky and may not work properly.', 'Whenever possible, please use ``project.scripts`` instead.'], 'type': 'array', 'items': {'type': 'string'}, '$comment': 'TODO: is this field deprecated/should be removed?'}, 'eager-resources': {'$$description': ['Resources that should be extracted together, if any of them is needed,', 'or if any C extensions included in the project are imported.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'array', 'items': {'type': 'string'}}, 'packages': {'$$description': ['Packages that should be included in the distribution.', 'It can be given either as a list of package identifiers', 'or as a ``dict``-like structure with a single key ``find``', 'which corresponds to a dynamic call to', '``setuptools.config.expand.find_packages`` function.', 'The ``find`` key is associated with a nested ``dict``-like structure that can', 'contain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,', 'mimicking the keyword arguments of the associated function.'], 'oneOf': [{'title': 'Array of Python package identifiers', 'type': 'array', 'items': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}}, {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}]}, 'package-dir': {'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, 'package-data': {'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'include-package-data': {'$$description': ['Automatically include any data files inside the package directories', 'that are specified by ``MANIFEST.in``', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'boolean'}, 'exclude-package-data': {'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'namespace-packages': {'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'https://setuptools.pypa.io/en/latest/userguide/package_discovery.html', 'description': '**DEPRECATED**: use implicit namespaces instead (:pep:`420`).'}, 'py-modules': {'description': 'Modules that setuptools will manipulate', 'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'TODO: clarify the relationship with ``packages``'}, 'ext-modules': {'description': 'Extension modules to be compiled by setuptools', 'type': 'array', 'items': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}}, 'data-files': {'$$description': ['``dict``-like structure where each key represents a directory and', 'the value is a list of glob patterns that should be installed in them.', '**DISCOURAGED**: please notice this might not work as expected with wheels.', 'Whenever possible, consider using data files inside the package directories', '(or create a new namespace package that only contains data files).', 'See `data files support', '`_.'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'cmdclass': {'$$description': ['Mapping of distutils-style command names to ``setuptools.Command`` subclasses', 'which in turn should be represented by strings with a qualified class name', '(i.e., "dotted" form with module), e.g.::\n\n', ' cmdclass = {mycmd = "pkg.subpkg.module.CommandClass"}\n\n', 'The command class should be a directly defined at the top-level of the', 'containing module (no class nesting).'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'string', 'format': 'python-qualified-identifier'}}}, 'license-files': {'type': 'array', 'items': {'type': 'string'}, '$$description': ['**PROVISIONAL**: list of glob patterns for all license files being distributed.', '(likely to become standard with :pep:`639`).', "By default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``"], '$comment': 'TODO: revise if PEP 639 is accepted. Probably ``project.license-files``?'}, 'dynamic': {'type': 'object', 'description': 'Instructions for loading :pep:`621`-related metadata dynamically', 'additionalProperties': False, 'properties': {'version': {'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}]}, 'classifiers': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'description': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'entry-points': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$ref': '#/definitions/file-directive'}]}, 'optional-dependencies': {'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$ref': '#/definitions/file-directive'}]}}}, 'readme': {'type': 'object', 'anyOf': [{'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}], 'required': ['file']}}}}, 'definitions': {'package-name': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}, 'ext-module': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, 'file-directive': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'file-directive-for-dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}]}, 'attr-directive': {'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, 'find-directive': {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}}}, rule='type') + data_is_dict = isinstance(data, dict) + if data_is_dict: + data_keys = set(data.keys()) + if "platforms" in data_keys: + data_keys.remove("platforms") + data__platforms = data["platforms"] + if not isinstance(data__platforms, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".platforms must be array", value=data__platforms, name="" + (name_prefix or "data") + ".platforms", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__platforms_is_list = isinstance(data__platforms, (list, tuple)) + if data__platforms_is_list: + data__platforms_len = len(data__platforms) + for data__platforms_x, data__platforms_item in enumerate(data__platforms): + if not isinstance(data__platforms_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".platforms[{data__platforms_x}]".format(**locals()) + " must be string", value=data__platforms_item, name="" + (name_prefix or "data") + ".platforms[{data__platforms_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "provides" in data_keys: + data_keys.remove("provides") + data__provides = data["provides"] + if not isinstance(data__provides, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".provides must be array", value=data__provides, name="" + (name_prefix or "data") + ".provides", definition={'$$description': ['Package and virtual package names contained within this package', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, rule='type') + data__provides_is_list = isinstance(data__provides, (list, tuple)) + if data__provides_is_list: + data__provides_len = len(data__provides) + for data__provides_x, data__provides_item in enumerate(data__provides): + if not isinstance(data__provides_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".provides[{data__provides_x}]".format(**locals()) + " must be string", value=data__provides_item, name="" + (name_prefix or "data") + ".provides[{data__provides_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'pep508-identifier'}, rule='type') + if isinstance(data__provides_item, str): + if not custom_formats["pep508-identifier"](data__provides_item): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".provides[{data__provides_x}]".format(**locals()) + " must be pep508-identifier", value=data__provides_item, name="" + (name_prefix or "data") + ".provides[{data__provides_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'pep508-identifier'}, rule='format') + if "obsoletes" in data_keys: + data_keys.remove("obsoletes") + data__obsoletes = data["obsoletes"] + if not isinstance(data__obsoletes, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".obsoletes must be array", value=data__obsoletes, name="" + (name_prefix or "data") + ".obsoletes", definition={'$$description': ['Packages which this package renders obsolete', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, rule='type') + data__obsoletes_is_list = isinstance(data__obsoletes, (list, tuple)) + if data__obsoletes_is_list: + data__obsoletes_len = len(data__obsoletes) + for data__obsoletes_x, data__obsoletes_item in enumerate(data__obsoletes): + if not isinstance(data__obsoletes_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".obsoletes[{data__obsoletes_x}]".format(**locals()) + " must be string", value=data__obsoletes_item, name="" + (name_prefix or "data") + ".obsoletes[{data__obsoletes_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'pep508-identifier'}, rule='type') + if isinstance(data__obsoletes_item, str): + if not custom_formats["pep508-identifier"](data__obsoletes_item): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".obsoletes[{data__obsoletes_x}]".format(**locals()) + " must be pep508-identifier", value=data__obsoletes_item, name="" + (name_prefix or "data") + ".obsoletes[{data__obsoletes_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'pep508-identifier'}, rule='format') + if "zip-safe" in data_keys: + data_keys.remove("zip-safe") + data__zipsafe = data["zip-safe"] + if not isinstance(data__zipsafe, (bool)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".zip-safe must be boolean", value=data__zipsafe, name="" + (name_prefix or "data") + ".zip-safe", definition={'$$description': ['Whether the project can be safely installed and run from a zip file.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'boolean'}, rule='type') + if "script-files" in data_keys: + data_keys.remove("script-files") + data__scriptfiles = data["script-files"] + if not isinstance(data__scriptfiles, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".script-files must be array", value=data__scriptfiles, name="" + (name_prefix or "data") + ".script-files", definition={'$$description': ['Legacy way of defining scripts (entry-points are preferred).', 'Equivalent to the ``script`` keyword in ``setup.py``', '(it was renamed to avoid confusion with entry-point based ``project.scripts``', 'defined in :pep:`621`).', '**DISCOURAGED**: generic script wrappers are tricky and may not work properly.', 'Whenever possible, please use ``project.scripts`` instead.'], 'type': 'array', 'items': {'type': 'string'}, '$comment': 'TODO: is this field deprecated/should be removed?'}, rule='type') + data__scriptfiles_is_list = isinstance(data__scriptfiles, (list, tuple)) + if data__scriptfiles_is_list: + data__scriptfiles_len = len(data__scriptfiles) + for data__scriptfiles_x, data__scriptfiles_item in enumerate(data__scriptfiles): + if not isinstance(data__scriptfiles_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".script-files[{data__scriptfiles_x}]".format(**locals()) + " must be string", value=data__scriptfiles_item, name="" + (name_prefix or "data") + ".script-files[{data__scriptfiles_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "eager-resources" in data_keys: + data_keys.remove("eager-resources") + data__eagerresources = data["eager-resources"] + if not isinstance(data__eagerresources, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".eager-resources must be array", value=data__eagerresources, name="" + (name_prefix or "data") + ".eager-resources", definition={'$$description': ['Resources that should be extracted together, if any of them is needed,', 'or if any C extensions included in the project are imported.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__eagerresources_is_list = isinstance(data__eagerresources, (list, tuple)) + if data__eagerresources_is_list: + data__eagerresources_len = len(data__eagerresources) + for data__eagerresources_x, data__eagerresources_item in enumerate(data__eagerresources): + if not isinstance(data__eagerresources_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".eager-resources[{data__eagerresources_x}]".format(**locals()) + " must be string", value=data__eagerresources_item, name="" + (name_prefix or "data") + ".eager-resources[{data__eagerresources_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "packages" in data_keys: + data_keys.remove("packages") + data__packages = data["packages"] + data__packages_one_of_count2 = 0 + if data__packages_one_of_count2 < 2: + try: + if not isinstance(data__packages, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".packages must be array", value=data__packages, name="" + (name_prefix or "data") + ".packages", definition={'title': 'Array of Python package identifiers', 'type': 'array', 'items': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}}, rule='type') + data__packages_is_list = isinstance(data__packages, (list, tuple)) + if data__packages_is_list: + data__packages_len = len(data__packages) + for data__packages_x, data__packages_item in enumerate(data__packages): + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_package_name(data__packages_item, custom_formats, (name_prefix or "data") + ".packages[{data__packages_x}]".format(**locals())) + data__packages_one_of_count2 += 1 + except JsonSchemaValueException: pass + if data__packages_one_of_count2 < 2: + try: + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_find_directive(data__packages, custom_formats, (name_prefix or "data") + ".packages") + data__packages_one_of_count2 += 1 + except JsonSchemaValueException: pass + if data__packages_one_of_count2 != 1: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".packages must be valid exactly by one definition" + (" (" + str(data__packages_one_of_count2) + " matches found)"), value=data__packages, name="" + (name_prefix or "data") + ".packages", definition={'$$description': ['Packages that should be included in the distribution.', 'It can be given either as a list of package identifiers', 'or as a ``dict``-like structure with a single key ``find``', 'which corresponds to a dynamic call to', '``setuptools.config.expand.find_packages`` function.', 'The ``find`` key is associated with a nested ``dict``-like structure that can', 'contain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,', 'mimicking the keyword arguments of the associated function.'], 'oneOf': [{'title': 'Array of Python package identifiers', 'type': 'array', 'items': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}}, {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}]}, rule='oneOf') + if "package-dir" in data_keys: + data_keys.remove("package-dir") + data__packagedir = data["package-dir"] + if not isinstance(data__packagedir, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-dir must be object", value=data__packagedir, name="" + (name_prefix or "data") + ".package-dir", definition={'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, rule='type') + data__packagedir_is_dict = isinstance(data__packagedir, dict) + if data__packagedir_is_dict: + data__packagedir_keys = set(data__packagedir.keys()) + for data__packagedir_key, data__packagedir_val in data__packagedir.items(): + if REGEX_PATTERNS['^.*$'].search(data__packagedir_key): + if data__packagedir_key in data__packagedir_keys: + data__packagedir_keys.remove(data__packagedir_key) + if not isinstance(data__packagedir_val, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-dir.{data__packagedir_key}".format(**locals()) + " must be string", value=data__packagedir_val, name="" + (name_prefix or "data") + ".package-dir.{data__packagedir_key}".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if data__packagedir_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-dir must not contain "+str(data__packagedir_keys)+" properties", value=data__packagedir, name="" + (name_prefix or "data") + ".package-dir", definition={'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, rule='additionalProperties') + data__packagedir_len = len(data__packagedir) + if data__packagedir_len != 0: + data__packagedir_property_names = True + for data__packagedir_key in data__packagedir: + try: + data__packagedir_key_any_of_count3 = 0 + if not data__packagedir_key_any_of_count3: + try: + if data__packagedir_key != "": + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-dir must be same as const definition: ", value=data__packagedir_key, name="" + (name_prefix or "data") + ".package-dir", definition={'const': ''}, rule='const') + data__packagedir_key_any_of_count3 += 1 + except JsonSchemaValueException: pass + if not data__packagedir_key_any_of_count3: + try: + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_package_name(data__packagedir_key, custom_formats, (name_prefix or "data") + ".package-dir") + data__packagedir_key_any_of_count3 += 1 + except JsonSchemaValueException: pass + if not data__packagedir_key_any_of_count3: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-dir cannot be validated by any definition", value=data__packagedir_key, name="" + (name_prefix or "data") + ".package-dir", definition={'anyOf': [{'const': ''}, {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}]}, rule='anyOf') + except JsonSchemaValueException: + data__packagedir_property_names = False + if not data__packagedir_property_names: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-dir must be named by propertyName definition", value=data__packagedir, name="" + (name_prefix or "data") + ".package-dir", definition={'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, rule='propertyNames') + if "package-data" in data_keys: + data_keys.remove("package-data") + data__packagedata = data["package-data"] + if not isinstance(data__packagedata, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data must be object", value=data__packagedata, name="" + (name_prefix or "data") + ".package-data", definition={'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, rule='type') + data__packagedata_is_dict = isinstance(data__packagedata, dict) + if data__packagedata_is_dict: + data__packagedata_keys = set(data__packagedata.keys()) + for data__packagedata_key, data__packagedata_val in data__packagedata.items(): + if REGEX_PATTERNS['^.*$'].search(data__packagedata_key): + if data__packagedata_key in data__packagedata_keys: + data__packagedata_keys.remove(data__packagedata_key) + if not isinstance(data__packagedata_val, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data.{data__packagedata_key}".format(**locals()) + " must be array", value=data__packagedata_val, name="" + (name_prefix or "data") + ".package-data.{data__packagedata_key}".format(**locals()) + "", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__packagedata_val_is_list = isinstance(data__packagedata_val, (list, tuple)) + if data__packagedata_val_is_list: + data__packagedata_val_len = len(data__packagedata_val) + for data__packagedata_val_x, data__packagedata_val_item in enumerate(data__packagedata_val): + if not isinstance(data__packagedata_val_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data.{data__packagedata_key}[{data__packagedata_val_x}]".format(**locals()) + " must be string", value=data__packagedata_val_item, name="" + (name_prefix or "data") + ".package-data.{data__packagedata_key}[{data__packagedata_val_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if data__packagedata_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data must not contain "+str(data__packagedata_keys)+" properties", value=data__packagedata, name="" + (name_prefix or "data") + ".package-data", definition={'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, rule='additionalProperties') + data__packagedata_len = len(data__packagedata) + if data__packagedata_len != 0: + data__packagedata_property_names = True + for data__packagedata_key in data__packagedata: + try: + data__packagedata_key_any_of_count4 = 0 + if not data__packagedata_key_any_of_count4: + try: + if not isinstance(data__packagedata_key, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data must be string", value=data__packagedata_key, name="" + (name_prefix or "data") + ".package-data", definition={'type': 'string', 'format': 'python-module-name'}, rule='type') + if isinstance(data__packagedata_key, str): + if not custom_formats["python-module-name"](data__packagedata_key): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data must be python-module-name", value=data__packagedata_key, name="" + (name_prefix or "data") + ".package-data", definition={'type': 'string', 'format': 'python-module-name'}, rule='format') + data__packagedata_key_any_of_count4 += 1 + except JsonSchemaValueException: pass + if not data__packagedata_key_any_of_count4: + try: + if data__packagedata_key != "*": + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data must be same as const definition: *", value=data__packagedata_key, name="" + (name_prefix or "data") + ".package-data", definition={'const': '*'}, rule='const') + data__packagedata_key_any_of_count4 += 1 + except JsonSchemaValueException: pass + if not data__packagedata_key_any_of_count4: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data cannot be validated by any definition", value=data__packagedata_key, name="" + (name_prefix or "data") + ".package-data", definition={'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, rule='anyOf') + except JsonSchemaValueException: + data__packagedata_property_names = False + if not data__packagedata_property_names: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".package-data must be named by propertyName definition", value=data__packagedata, name="" + (name_prefix or "data") + ".package-data", definition={'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, rule='propertyNames') + if "include-package-data" in data_keys: + data_keys.remove("include-package-data") + data__includepackagedata = data["include-package-data"] + if not isinstance(data__includepackagedata, (bool)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".include-package-data must be boolean", value=data__includepackagedata, name="" + (name_prefix or "data") + ".include-package-data", definition={'$$description': ['Automatically include any data files inside the package directories', 'that are specified by ``MANIFEST.in``', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'boolean'}, rule='type') + if "exclude-package-data" in data_keys: + data_keys.remove("exclude-package-data") + data__excludepackagedata = data["exclude-package-data"] + if not isinstance(data__excludepackagedata, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data must be object", value=data__excludepackagedata, name="" + (name_prefix or "data") + ".exclude-package-data", definition={'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, rule='type') + data__excludepackagedata_is_dict = isinstance(data__excludepackagedata, dict) + if data__excludepackagedata_is_dict: + data__excludepackagedata_keys = set(data__excludepackagedata.keys()) + for data__excludepackagedata_key, data__excludepackagedata_val in data__excludepackagedata.items(): + if REGEX_PATTERNS['^.*$'].search(data__excludepackagedata_key): + if data__excludepackagedata_key in data__excludepackagedata_keys: + data__excludepackagedata_keys.remove(data__excludepackagedata_key) + if not isinstance(data__excludepackagedata_val, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data.{data__excludepackagedata_key}".format(**locals()) + " must be array", value=data__excludepackagedata_val, name="" + (name_prefix or "data") + ".exclude-package-data.{data__excludepackagedata_key}".format(**locals()) + "", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__excludepackagedata_val_is_list = isinstance(data__excludepackagedata_val, (list, tuple)) + if data__excludepackagedata_val_is_list: + data__excludepackagedata_val_len = len(data__excludepackagedata_val) + for data__excludepackagedata_val_x, data__excludepackagedata_val_item in enumerate(data__excludepackagedata_val): + if not isinstance(data__excludepackagedata_val_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data.{data__excludepackagedata_key}[{data__excludepackagedata_val_x}]".format(**locals()) + " must be string", value=data__excludepackagedata_val_item, name="" + (name_prefix or "data") + ".exclude-package-data.{data__excludepackagedata_key}[{data__excludepackagedata_val_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if data__excludepackagedata_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data must not contain "+str(data__excludepackagedata_keys)+" properties", value=data__excludepackagedata, name="" + (name_prefix or "data") + ".exclude-package-data", definition={'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, rule='additionalProperties') + data__excludepackagedata_len = len(data__excludepackagedata) + if data__excludepackagedata_len != 0: + data__excludepackagedata_property_names = True + for data__excludepackagedata_key in data__excludepackagedata: + try: + data__excludepackagedata_key_any_of_count5 = 0 + if not data__excludepackagedata_key_any_of_count5: + try: + if not isinstance(data__excludepackagedata_key, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data must be string", value=data__excludepackagedata_key, name="" + (name_prefix or "data") + ".exclude-package-data", definition={'type': 'string', 'format': 'python-module-name'}, rule='type') + if isinstance(data__excludepackagedata_key, str): + if not custom_formats["python-module-name"](data__excludepackagedata_key): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data must be python-module-name", value=data__excludepackagedata_key, name="" + (name_prefix or "data") + ".exclude-package-data", definition={'type': 'string', 'format': 'python-module-name'}, rule='format') + data__excludepackagedata_key_any_of_count5 += 1 + except JsonSchemaValueException: pass + if not data__excludepackagedata_key_any_of_count5: + try: + if data__excludepackagedata_key != "*": + raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data must be same as const definition: *", value=data__excludepackagedata_key, name="" + (name_prefix or "data") + ".exclude-package-data", definition={'const': '*'}, rule='const') + data__excludepackagedata_key_any_of_count5 += 1 + except JsonSchemaValueException: pass + if not data__excludepackagedata_key_any_of_count5: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data cannot be validated by any definition", value=data__excludepackagedata_key, name="" + (name_prefix or "data") + ".exclude-package-data", definition={'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, rule='anyOf') + except JsonSchemaValueException: + data__excludepackagedata_property_names = False + if not data__excludepackagedata_property_names: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".exclude-package-data must be named by propertyName definition", value=data__excludepackagedata, name="" + (name_prefix or "data") + ".exclude-package-data", definition={'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, rule='propertyNames') + if "namespace-packages" in data_keys: + data_keys.remove("namespace-packages") + data__namespacepackages = data["namespace-packages"] + if not isinstance(data__namespacepackages, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".namespace-packages must be array", value=data__namespacepackages, name="" + (name_prefix or "data") + ".namespace-packages", definition={'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'https://setuptools.pypa.io/en/latest/userguide/package_discovery.html', 'description': '**DEPRECATED**: use implicit namespaces instead (:pep:`420`).'}, rule='type') + data__namespacepackages_is_list = isinstance(data__namespacepackages, (list, tuple)) + if data__namespacepackages_is_list: + data__namespacepackages_len = len(data__namespacepackages) + for data__namespacepackages_x, data__namespacepackages_item in enumerate(data__namespacepackages): + if not isinstance(data__namespacepackages_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".namespace-packages[{data__namespacepackages_x}]".format(**locals()) + " must be string", value=data__namespacepackages_item, name="" + (name_prefix or "data") + ".namespace-packages[{data__namespacepackages_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='type') + if isinstance(data__namespacepackages_item, str): + if not custom_formats["python-module-name-relaxed"](data__namespacepackages_item): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".namespace-packages[{data__namespacepackages_x}]".format(**locals()) + " must be python-module-name-relaxed", value=data__namespacepackages_item, name="" + (name_prefix or "data") + ".namespace-packages[{data__namespacepackages_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='format') + if "py-modules" in data_keys: + data_keys.remove("py-modules") + data__pymodules = data["py-modules"] + if not isinstance(data__pymodules, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".py-modules must be array", value=data__pymodules, name="" + (name_prefix or "data") + ".py-modules", definition={'description': 'Modules that setuptools will manipulate', 'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'TODO: clarify the relationship with ``packages``'}, rule='type') + data__pymodules_is_list = isinstance(data__pymodules, (list, tuple)) + if data__pymodules_is_list: + data__pymodules_len = len(data__pymodules) + for data__pymodules_x, data__pymodules_item in enumerate(data__pymodules): + if not isinstance(data__pymodules_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".py-modules[{data__pymodules_x}]".format(**locals()) + " must be string", value=data__pymodules_item, name="" + (name_prefix or "data") + ".py-modules[{data__pymodules_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='type') + if isinstance(data__pymodules_item, str): + if not custom_formats["python-module-name-relaxed"](data__pymodules_item): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".py-modules[{data__pymodules_x}]".format(**locals()) + " must be python-module-name-relaxed", value=data__pymodules_item, name="" + (name_prefix or "data") + ".py-modules[{data__pymodules_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='format') + if "ext-modules" in data_keys: + data_keys.remove("ext-modules") + data__extmodules = data["ext-modules"] + if not isinstance(data__extmodules, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".ext-modules must be array", value=data__extmodules, name="" + (name_prefix or "data") + ".ext-modules", definition={'description': 'Extension modules to be compiled by setuptools', 'type': 'array', 'items': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}}, rule='type') + data__extmodules_is_list = isinstance(data__extmodules, (list, tuple)) + if data__extmodules_is_list: + data__extmodules_len = len(data__extmodules) + for data__extmodules_x, data__extmodules_item in enumerate(data__extmodules): + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_ext_module(data__extmodules_item, custom_formats, (name_prefix or "data") + ".ext-modules[{data__extmodules_x}]".format(**locals())) + if "data-files" in data_keys: + data_keys.remove("data-files") + data__datafiles = data["data-files"] + if not isinstance(data__datafiles, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".data-files must be object", value=data__datafiles, name="" + (name_prefix or "data") + ".data-files", definition={'$$description': ['``dict``-like structure where each key represents a directory and', 'the value is a list of glob patterns that should be installed in them.', '**DISCOURAGED**: please notice this might not work as expected with wheels.', 'Whenever possible, consider using data files inside the package directories', '(or create a new namespace package that only contains data files).', 'See `data files support', '`_.'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, rule='type') + data__datafiles_is_dict = isinstance(data__datafiles, dict) + if data__datafiles_is_dict: + data__datafiles_keys = set(data__datafiles.keys()) + for data__datafiles_key, data__datafiles_val in data__datafiles.items(): + if REGEX_PATTERNS['^.*$'].search(data__datafiles_key): + if data__datafiles_key in data__datafiles_keys: + data__datafiles_keys.remove(data__datafiles_key) + if not isinstance(data__datafiles_val, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".data-files.{data__datafiles_key}".format(**locals()) + " must be array", value=data__datafiles_val, name="" + (name_prefix or "data") + ".data-files.{data__datafiles_key}".format(**locals()) + "", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__datafiles_val_is_list = isinstance(data__datafiles_val, (list, tuple)) + if data__datafiles_val_is_list: + data__datafiles_val_len = len(data__datafiles_val) + for data__datafiles_val_x, data__datafiles_val_item in enumerate(data__datafiles_val): + if not isinstance(data__datafiles_val_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".data-files.{data__datafiles_key}[{data__datafiles_val_x}]".format(**locals()) + " must be string", value=data__datafiles_val_item, name="" + (name_prefix or "data") + ".data-files.{data__datafiles_key}[{data__datafiles_val_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "cmdclass" in data_keys: + data_keys.remove("cmdclass") + data__cmdclass = data["cmdclass"] + if not isinstance(data__cmdclass, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".cmdclass must be object", value=data__cmdclass, name="" + (name_prefix or "data") + ".cmdclass", definition={'$$description': ['Mapping of distutils-style command names to ``setuptools.Command`` subclasses', 'which in turn should be represented by strings with a qualified class name', '(i.e., "dotted" form with module), e.g.::\n\n', ' cmdclass = {mycmd = "pkg.subpkg.module.CommandClass"}\n\n', 'The command class should be a directly defined at the top-level of the', 'containing module (no class nesting).'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'string', 'format': 'python-qualified-identifier'}}}, rule='type') + data__cmdclass_is_dict = isinstance(data__cmdclass, dict) + if data__cmdclass_is_dict: + data__cmdclass_keys = set(data__cmdclass.keys()) + for data__cmdclass_key, data__cmdclass_val in data__cmdclass.items(): + if REGEX_PATTERNS['^.*$'].search(data__cmdclass_key): + if data__cmdclass_key in data__cmdclass_keys: + data__cmdclass_keys.remove(data__cmdclass_key) + if not isinstance(data__cmdclass_val, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".cmdclass.{data__cmdclass_key}".format(**locals()) + " must be string", value=data__cmdclass_val, name="" + (name_prefix or "data") + ".cmdclass.{data__cmdclass_key}".format(**locals()) + "", definition={'type': 'string', 'format': 'python-qualified-identifier'}, rule='type') + if isinstance(data__cmdclass_val, str): + if not custom_formats["python-qualified-identifier"](data__cmdclass_val): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".cmdclass.{data__cmdclass_key}".format(**locals()) + " must be python-qualified-identifier", value=data__cmdclass_val, name="" + (name_prefix or "data") + ".cmdclass.{data__cmdclass_key}".format(**locals()) + "", definition={'type': 'string', 'format': 'python-qualified-identifier'}, rule='format') + if "license-files" in data_keys: + data_keys.remove("license-files") + data__licensefiles = data["license-files"] + if not isinstance(data__licensefiles, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".license-files must be array", value=data__licensefiles, name="" + (name_prefix or "data") + ".license-files", definition={'type': 'array', 'items': {'type': 'string'}, '$$description': ['**PROVISIONAL**: list of glob patterns for all license files being distributed.', '(likely to become standard with :pep:`639`).', "By default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``"], '$comment': 'TODO: revise if PEP 639 is accepted. Probably ``project.license-files``?'}, rule='type') + data__licensefiles_is_list = isinstance(data__licensefiles, (list, tuple)) + if data__licensefiles_is_list: + data__licensefiles_len = len(data__licensefiles) + for data__licensefiles_x, data__licensefiles_item in enumerate(data__licensefiles): + if not isinstance(data__licensefiles_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".license-files[{data__licensefiles_x}]".format(**locals()) + " must be string", value=data__licensefiles_item, name="" + (name_prefix or "data") + ".license-files[{data__licensefiles_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "dynamic" in data_keys: + data_keys.remove("dynamic") + data__dynamic = data["dynamic"] + if not isinstance(data__dynamic, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic must be object", value=data__dynamic, name="" + (name_prefix or "data") + ".dynamic", definition={'type': 'object', 'description': 'Instructions for loading :pep:`621`-related metadata dynamically', 'additionalProperties': False, 'properties': {'version': {'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}]}, 'classifiers': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'description': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'entry-points': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$ref': '#/definitions/file-directive'}]}, 'optional-dependencies': {'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$ref': '#/definitions/file-directive'}]}}}, 'readme': {'type': 'object', 'anyOf': [{'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}], 'required': ['file']}}}, rule='type') + data__dynamic_is_dict = isinstance(data__dynamic, dict) + if data__dynamic_is_dict: + data__dynamic_keys = set(data__dynamic.keys()) + if "version" in data__dynamic_keys: + data__dynamic_keys.remove("version") + data__dynamic__version = data__dynamic["version"] + data__dynamic__version_one_of_count6 = 0 + if data__dynamic__version_one_of_count6 < 2: + try: + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_attr_directive(data__dynamic__version, custom_formats, (name_prefix or "data") + ".dynamic.version") + data__dynamic__version_one_of_count6 += 1 + except JsonSchemaValueException: pass + if data__dynamic__version_one_of_count6 < 2: + try: + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive(data__dynamic__version, custom_formats, (name_prefix or "data") + ".dynamic.version") + data__dynamic__version_one_of_count6 += 1 + except JsonSchemaValueException: pass + if data__dynamic__version_one_of_count6 != 1: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.version must be valid exactly by one definition" + (" (" + str(data__dynamic__version_one_of_count6) + " matches found)"), value=data__dynamic__version, name="" + (name_prefix or "data") + ".dynamic.version", definition={'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}]}, rule='oneOf') + if "classifiers" in data__dynamic_keys: + data__dynamic_keys.remove("classifiers") + data__dynamic__classifiers = data__dynamic["classifiers"] + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive(data__dynamic__classifiers, custom_formats, (name_prefix or "data") + ".dynamic.classifiers") + if "description" in data__dynamic_keys: + data__dynamic_keys.remove("description") + data__dynamic__description = data__dynamic["description"] + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive(data__dynamic__description, custom_formats, (name_prefix or "data") + ".dynamic.description") + if "entry-points" in data__dynamic_keys: + data__dynamic_keys.remove("entry-points") + data__dynamic__entrypoints = data__dynamic["entry-points"] + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive(data__dynamic__entrypoints, custom_formats, (name_prefix or "data") + ".dynamic.entry-points") + if "dependencies" in data__dynamic_keys: + data__dynamic_keys.remove("dependencies") + data__dynamic__dependencies = data__dynamic["dependencies"] + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive_for_dependencies(data__dynamic__dependencies, custom_formats, (name_prefix or "data") + ".dynamic.dependencies") + if "optional-dependencies" in data__dynamic_keys: + data__dynamic_keys.remove("optional-dependencies") + data__dynamic__optionaldependencies = data__dynamic["optional-dependencies"] + if not isinstance(data__dynamic__optionaldependencies, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.optional-dependencies must be object", value=data__dynamic__optionaldependencies, name="" + (name_prefix or "data") + ".dynamic.optional-dependencies", definition={'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$ref': '#/definitions/file-directive'}]}}}, rule='type') + data__dynamic__optionaldependencies_is_dict = isinstance(data__dynamic__optionaldependencies, dict) + if data__dynamic__optionaldependencies_is_dict: + data__dynamic__optionaldependencies_keys = set(data__dynamic__optionaldependencies.keys()) + for data__dynamic__optionaldependencies_key, data__dynamic__optionaldependencies_val in data__dynamic__optionaldependencies.items(): + if REGEX_PATTERNS['.+'].search(data__dynamic__optionaldependencies_key): + if data__dynamic__optionaldependencies_key in data__dynamic__optionaldependencies_keys: + data__dynamic__optionaldependencies_keys.remove(data__dynamic__optionaldependencies_key) + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive_for_dependencies(data__dynamic__optionaldependencies_val, custom_formats, (name_prefix or "data") + ".dynamic.optional-dependencies.{data__dynamic__optionaldependencies_key}".format(**locals())) + if data__dynamic__optionaldependencies_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.optional-dependencies must not contain "+str(data__dynamic__optionaldependencies_keys)+" properties", value=data__dynamic__optionaldependencies, name="" + (name_prefix or "data") + ".dynamic.optional-dependencies", definition={'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$ref': '#/definitions/file-directive'}]}}}, rule='additionalProperties') + data__dynamic__optionaldependencies_len = len(data__dynamic__optionaldependencies) + if data__dynamic__optionaldependencies_len != 0: + data__dynamic__optionaldependencies_property_names = True + for data__dynamic__optionaldependencies_key in data__dynamic__optionaldependencies: + try: + if not isinstance(data__dynamic__optionaldependencies_key, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.optional-dependencies must be string", value=data__dynamic__optionaldependencies_key, name="" + (name_prefix or "data") + ".dynamic.optional-dependencies", definition={'type': 'string', 'format': 'pep508-identifier'}, rule='type') + if isinstance(data__dynamic__optionaldependencies_key, str): + if not custom_formats["pep508-identifier"](data__dynamic__optionaldependencies_key): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.optional-dependencies must be pep508-identifier", value=data__dynamic__optionaldependencies_key, name="" + (name_prefix or "data") + ".dynamic.optional-dependencies", definition={'type': 'string', 'format': 'pep508-identifier'}, rule='format') + except JsonSchemaValueException: + data__dynamic__optionaldependencies_property_names = False + if not data__dynamic__optionaldependencies_property_names: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.optional-dependencies must be named by propertyName definition", value=data__dynamic__optionaldependencies, name="" + (name_prefix or "data") + ".dynamic.optional-dependencies", definition={'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$ref': '#/definitions/file-directive'}]}}}, rule='propertyNames') + if "readme" in data__dynamic_keys: + data__dynamic_keys.remove("readme") + data__dynamic__readme = data__dynamic["readme"] + if not isinstance(data__dynamic__readme, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.readme must be object", value=data__dynamic__readme, name="" + (name_prefix or "data") + ".dynamic.readme", definition={'type': 'object', 'anyOf': [{'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}], 'required': ['file']}, rule='type') + data__dynamic__readme_any_of_count7 = 0 + if not data__dynamic__readme_any_of_count7: + try: + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive(data__dynamic__readme, custom_formats, (name_prefix or "data") + ".dynamic.readme") + data__dynamic__readme_any_of_count7 += 1 + except JsonSchemaValueException: pass + if not data__dynamic__readme_any_of_count7: + try: + if not isinstance(data__dynamic__readme, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.readme must be object", value=data__dynamic__readme, name="" + (name_prefix or "data") + ".dynamic.readme", definition={'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}, rule='type') + data__dynamic__readme_is_dict = isinstance(data__dynamic__readme, dict) + if data__dynamic__readme_is_dict: + data__dynamic__readme_keys = set(data__dynamic__readme.keys()) + if "content-type" in data__dynamic__readme_keys: + data__dynamic__readme_keys.remove("content-type") + data__dynamic__readme__contenttype = data__dynamic__readme["content-type"] + if not isinstance(data__dynamic__readme__contenttype, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.readme.content-type must be string", value=data__dynamic__readme__contenttype, name="" + (name_prefix or "data") + ".dynamic.readme.content-type", definition={'type': 'string'}, rule='type') + if "file" in data__dynamic__readme_keys: + data__dynamic__readme_keys.remove("file") + data__dynamic__readme__file = data__dynamic__readme["file"] + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive_properties_file(data__dynamic__readme__file, custom_formats, (name_prefix or "data") + ".dynamic.readme.file") + if data__dynamic__readme_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.readme must not contain "+str(data__dynamic__readme_keys)+" properties", value=data__dynamic__readme, name="" + (name_prefix or "data") + ".dynamic.readme", definition={'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}, rule='additionalProperties') + data__dynamic__readme_any_of_count7 += 1 + except JsonSchemaValueException: pass + if not data__dynamic__readme_any_of_count7: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.readme cannot be validated by any definition", value=data__dynamic__readme, name="" + (name_prefix or "data") + ".dynamic.readme", definition={'type': 'object', 'anyOf': [{'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}], 'required': ['file']}, rule='anyOf') + data__dynamic__readme_is_dict = isinstance(data__dynamic__readme, dict) + if data__dynamic__readme_is_dict: + data__dynamic__readme__missing_keys = set(['file']) - data__dynamic__readme.keys() + if data__dynamic__readme__missing_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic.readme must contain " + (str(sorted(data__dynamic__readme__missing_keys)) + " properties"), value=data__dynamic__readme, name="" + (name_prefix or "data") + ".dynamic.readme", definition={'type': 'object', 'anyOf': [{'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}], 'required': ['file']}, rule='required') + if data__dynamic_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic must not contain "+str(data__dynamic_keys)+" properties", value=data__dynamic, name="" + (name_prefix or "data") + ".dynamic", definition={'type': 'object', 'description': 'Instructions for loading :pep:`621`-related metadata dynamically', 'additionalProperties': False, 'properties': {'version': {'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}]}, 'classifiers': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'description': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'entry-points': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$ref': '#/definitions/file-directive'}]}, 'optional-dependencies': {'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$ref': '#/definitions/file-directive'}]}}}, 'readme': {'type': 'object', 'anyOf': [{'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}], 'required': ['file']}}}, rule='additionalProperties') + if data_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html', 'title': '``tool.setuptools`` table', '$$description': ['``setuptools``-specific configurations that can be set by users that require', 'customization.', 'These configurations are completely optional and probably can be skipped when', 'creating simple packages. They are equivalent to some of the `Keywords', '`_', 'used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.', 'It considers only ``setuptools`` `parameters', '`_', 'that are not covered by :pep:`621`; and intentionally excludes ``dependency_links``', 'and ``setup_requires`` (incompatible with modern workflows/standards).'], 'type': 'object', 'additionalProperties': False, 'properties': {'platforms': {'type': 'array', 'items': {'type': 'string'}}, 'provides': {'$$description': ['Package and virtual package names contained within this package', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'obsoletes': {'$$description': ['Packages which this package renders obsolete', '**(not supported by pip)**'], 'type': 'array', 'items': {'type': 'string', 'format': 'pep508-identifier'}}, 'zip-safe': {'$$description': ['Whether the project can be safely installed and run from a zip file.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'boolean'}, 'script-files': {'$$description': ['Legacy way of defining scripts (entry-points are preferred).', 'Equivalent to the ``script`` keyword in ``setup.py``', '(it was renamed to avoid confusion with entry-point based ``project.scripts``', 'defined in :pep:`621`).', '**DISCOURAGED**: generic script wrappers are tricky and may not work properly.', 'Whenever possible, please use ``project.scripts`` instead.'], 'type': 'array', 'items': {'type': 'string'}, '$comment': 'TODO: is this field deprecated/should be removed?'}, 'eager-resources': {'$$description': ['Resources that should be extracted together, if any of them is needed,', 'or if any C extensions included in the project are imported.', '**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and', '``setup.py install`` in the context of ``eggs`` (**DEPRECATED**).'], 'type': 'array', 'items': {'type': 'string'}}, 'packages': {'$$description': ['Packages that should be included in the distribution.', 'It can be given either as a list of package identifiers', 'or as a ``dict``-like structure with a single key ``find``', 'which corresponds to a dynamic call to', '``setuptools.config.expand.find_packages`` function.', 'The ``find`` key is associated with a nested ``dict``-like structure that can', 'contain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,', 'mimicking the keyword arguments of the associated function.'], 'oneOf': [{'title': 'Array of Python package identifiers', 'type': 'array', 'items': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}}, {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}]}, 'package-dir': {'$$description': [':class:`dict`-like structure mapping from package names to directories where their', 'code can be found.', 'The empty string (as key) means that all packages are contained inside', 'the given directory will be included in the distribution.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'const': ''}, {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}]}, 'patternProperties': {'^.*$': {'type': 'string'}}}, 'package-data': {'$$description': ['Mapping from package names to lists of glob patterns.', 'Usually this option is not needed when using ``include-package-data = true``', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'include-package-data': {'$$description': ['Automatically include any data files inside the package directories', 'that are specified by ``MANIFEST.in``', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'boolean'}, 'exclude-package-data': {'$$description': ['Mapping from package names to lists of glob patterns that should be excluded', 'For more information on how to include data files, check ``setuptools`` `docs', '`_.'], 'type': 'object', 'additionalProperties': False, 'propertyNames': {'anyOf': [{'type': 'string', 'format': 'python-module-name'}, {'const': '*'}]}, 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'namespace-packages': {'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'https://setuptools.pypa.io/en/latest/userguide/package_discovery.html', 'description': '**DEPRECATED**: use implicit namespaces instead (:pep:`420`).'}, 'py-modules': {'description': 'Modules that setuptools will manipulate', 'type': 'array', 'items': {'type': 'string', 'format': 'python-module-name-relaxed'}, '$comment': 'TODO: clarify the relationship with ``packages``'}, 'ext-modules': {'description': 'Extension modules to be compiled by setuptools', 'type': 'array', 'items': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}}, 'data-files': {'$$description': ['``dict``-like structure where each key represents a directory and', 'the value is a list of glob patterns that should be installed in them.', '**DISCOURAGED**: please notice this might not work as expected with wheels.', 'Whenever possible, consider using data files inside the package directories', '(or create a new namespace package that only contains data files).', 'See `data files support', '`_.'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'array', 'items': {'type': 'string'}}}}, 'cmdclass': {'$$description': ['Mapping of distutils-style command names to ``setuptools.Command`` subclasses', 'which in turn should be represented by strings with a qualified class name', '(i.e., "dotted" form with module), e.g.::\n\n', ' cmdclass = {mycmd = "pkg.subpkg.module.CommandClass"}\n\n', 'The command class should be a directly defined at the top-level of the', 'containing module (no class nesting).'], 'type': 'object', 'patternProperties': {'^.*$': {'type': 'string', 'format': 'python-qualified-identifier'}}}, 'license-files': {'type': 'array', 'items': {'type': 'string'}, '$$description': ['**PROVISIONAL**: list of glob patterns for all license files being distributed.', '(likely to become standard with :pep:`639`).', "By default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``"], '$comment': 'TODO: revise if PEP 639 is accepted. Probably ``project.license-files``?'}, 'dynamic': {'type': 'object', 'description': 'Instructions for loading :pep:`621`-related metadata dynamically', 'additionalProperties': False, 'properties': {'version': {'$$description': ['A version dynamically loaded via either the ``attr:`` or ``file:``', 'directives. Please make sure the given file or attribute respects :pep:`440`.', 'Also ensure to set ``project.dynamic`` accordingly.'], 'oneOf': [{'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}]}, 'classifiers': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'description': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'entry-points': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$ref': '#/definitions/file-directive'}]}, 'optional-dependencies': {'type': 'object', 'propertyNames': {'type': 'string', 'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'.+': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$ref': '#/definitions/file-directive'}]}}}, 'readme': {'type': 'object', 'anyOf': [{'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, {'type': 'object', 'properties': {'content-type': {'type': 'string'}, 'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'additionalProperties': False}], 'required': ['file']}}}}, 'definitions': {'package-name': {'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}, 'ext-module': {'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, 'file-directive': {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, 'file-directive-for-dependencies': {'title': "'file:' directive for dependencies", 'allOf': [{'$$description': ['**BETA**: subset of the ``requirements.txt`` format', 'without ``pip`` flags and options', '(one :pep:`508`-compliant string per line,', 'lines that are blank or start with ``#`` are excluded).', 'See `dynamic metadata', '`_.']}, {'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}]}, 'attr-directive': {'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, 'find-directive': {'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}}}, rule='additionalProperties') + return data + +def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive_properties_file(data, custom_formats={}, name_prefix=None): + data_one_of_count8 = 0 + if data_one_of_count8 < 2: + try: + if not isinstance(data, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be string", value=data, name="" + (name_prefix or "data") + "", definition={'type': 'string'}, rule='type') + data_one_of_count8 += 1 + except JsonSchemaValueException: pass + if data_one_of_count8 < 2: + try: + if not isinstance(data, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be array", value=data, name="" + (name_prefix or "data") + "", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data_is_list = isinstance(data, (list, tuple)) + if data_is_list: + data_len = len(data) + for data_x, data_item in enumerate(data): + if not isinstance(data_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + "[{data_x}]".format(**locals()) + " must be string", value=data_item, name="" + (name_prefix or "data") + "[{data_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + data_one_of_count8 += 1 + except JsonSchemaValueException: pass + if data_one_of_count8 != 1: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be valid exactly by one definition" + (" (" + str(data_one_of_count8) + " matches found)"), value=data, name="" + (name_prefix or "data") + "", definition={'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}, rule='oneOf') + return data + +def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive_for_dependencies(data, custom_formats={}, name_prefix=None): + validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive(data, custom_formats, (name_prefix or "data") + "") + return data + +def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_file_directive(data, custom_formats={}, name_prefix=None): + if not isinstance(data, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, rule='type') + data_is_dict = isinstance(data, dict) + if data_is_dict: + data__missing_keys = set(['file']) - data.keys() + if data__missing_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must contain " + (str(sorted(data__missing_keys)) + " properties"), value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, rule='required') + data_keys = set(data.keys()) + if "file" in data_keys: + data_keys.remove("file") + data__file = data["file"] + data__file_one_of_count9 = 0 + if data__file_one_of_count9 < 2: + try: + if not isinstance(data__file, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".file must be string", value=data__file, name="" + (name_prefix or "data") + ".file", definition={'type': 'string'}, rule='type') + data__file_one_of_count9 += 1 + except JsonSchemaValueException: pass + if data__file_one_of_count9 < 2: + try: + if not isinstance(data__file, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".file must be array", value=data__file, name="" + (name_prefix or "data") + ".file", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__file_is_list = isinstance(data__file, (list, tuple)) + if data__file_is_list: + data__file_len = len(data__file) + for data__file_x, data__file_item in enumerate(data__file): + if not isinstance(data__file_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".file[{data__file_x}]".format(**locals()) + " must be string", value=data__file_item, name="" + (name_prefix or "data") + ".file[{data__file_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + data__file_one_of_count9 += 1 + except JsonSchemaValueException: pass + if data__file_one_of_count9 != 1: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".file must be valid exactly by one definition" + (" (" + str(data__file_one_of_count9) + " matches found)"), value=data__file, name="" + (name_prefix or "data") + ".file", definition={'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}, rule='oneOf') + if data_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/file-directive', 'title': "'file:' directive", 'description': 'Value is read from a file (or list of files and then concatenated)', 'type': 'object', 'additionalProperties': False, 'properties': {'file': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}}, 'required': ['file']}, rule='additionalProperties') + return data + +def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_attr_directive(data, custom_formats={}, name_prefix=None): + if not isinstance(data, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, rule='type') + data_is_dict = isinstance(data, dict) + if data_is_dict: + data__missing_keys = set(['attr']) - data.keys() + if data__missing_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must contain " + (str(sorted(data__missing_keys)) + " properties"), value=data, name="" + (name_prefix or "data") + "", definition={'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, rule='required') + data_keys = set(data.keys()) + if "attr" in data_keys: + data_keys.remove("attr") + data__attr = data["attr"] + if not isinstance(data__attr, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".attr must be string", value=data__attr, name="" + (name_prefix or "data") + ".attr", definition={'type': 'string', 'format': 'python-qualified-identifier'}, rule='type') + if isinstance(data__attr, str): + if not custom_formats["python-qualified-identifier"](data__attr): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".attr must be python-qualified-identifier", value=data__attr, name="" + (name_prefix or "data") + ".attr", definition={'type': 'string', 'format': 'python-qualified-identifier'}, rule='format') + if data_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'title': "'attr:' directive", '$id': '#/definitions/attr-directive', '$$description': ['Value is read from a module attribute. Supports callables and iterables;', 'unsupported types are cast via ``str()``'], 'type': 'object', 'additionalProperties': False, 'properties': {'attr': {'type': 'string', 'format': 'python-qualified-identifier'}}, 'required': ['attr']}, rule='additionalProperties') + return data + +def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_ext_module(data, custom_formats={}, name_prefix=None): + if not isinstance(data, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, rule='type') + data_is_dict = isinstance(data, dict) + if data_is_dict: + data__missing_keys = set(['name', 'sources']) - data.keys() + if data__missing_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must contain " + (str(sorted(data__missing_keys)) + " properties"), value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, rule='required') + data_keys = set(data.keys()) + if "name" in data_keys: + data_keys.remove("name") + data__name = data["name"] + if not isinstance(data__name, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".name must be string", value=data__name, name="" + (name_prefix or "data") + ".name", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='type') + if isinstance(data__name, str): + if not custom_formats["python-module-name-relaxed"](data__name): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".name must be python-module-name-relaxed", value=data__name, name="" + (name_prefix or "data") + ".name", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='format') + if "sources" in data_keys: + data_keys.remove("sources") + data__sources = data["sources"] + if not isinstance(data__sources, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".sources must be array", value=data__sources, name="" + (name_prefix or "data") + ".sources", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__sources_is_list = isinstance(data__sources, (list, tuple)) + if data__sources_is_list: + data__sources_len = len(data__sources) + for data__sources_x, data__sources_item in enumerate(data__sources): + if not isinstance(data__sources_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".sources[{data__sources_x}]".format(**locals()) + " must be string", value=data__sources_item, name="" + (name_prefix or "data") + ".sources[{data__sources_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "include-dirs" in data_keys: + data_keys.remove("include-dirs") + data__includedirs = data["include-dirs"] + if not isinstance(data__includedirs, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".include-dirs must be array", value=data__includedirs, name="" + (name_prefix or "data") + ".include-dirs", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__includedirs_is_list = isinstance(data__includedirs, (list, tuple)) + if data__includedirs_is_list: + data__includedirs_len = len(data__includedirs) + for data__includedirs_x, data__includedirs_item in enumerate(data__includedirs): + if not isinstance(data__includedirs_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".include-dirs[{data__includedirs_x}]".format(**locals()) + " must be string", value=data__includedirs_item, name="" + (name_prefix or "data") + ".include-dirs[{data__includedirs_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "define-macros" in data_keys: + data_keys.remove("define-macros") + data__definemacros = data["define-macros"] + if not isinstance(data__definemacros, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".define-macros must be array", value=data__definemacros, name="" + (name_prefix or "data") + ".define-macros", definition={'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, rule='type') + data__definemacros_is_list = isinstance(data__definemacros, (list, tuple)) + if data__definemacros_is_list: + data__definemacros_len = len(data__definemacros) + for data__definemacros_x, data__definemacros_item in enumerate(data__definemacros): + if not isinstance(data__definemacros_item, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}]".format(**locals()) + " must be array", value=data__definemacros_item, name="" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}]".format(**locals()) + "", definition={'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}, rule='type') + data__definemacros_item_is_list = isinstance(data__definemacros_item, (list, tuple)) + if data__definemacros_item_is_list: + data__definemacros_item_len = len(data__definemacros_item) + if data__definemacros_item_len > 0: + data__definemacros_item__0 = data__definemacros_item[0] + if not isinstance(data__definemacros_item__0, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][0]".format(**locals()) + " must be string", value=data__definemacros_item__0, name="" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][0]".format(**locals()) + "", definition={'description': 'macro name', 'type': 'string'}, rule='type') + if data__definemacros_item_len > 1: + data__definemacros_item__1 = data__definemacros_item[1] + data__definemacros_item__1_one_of_count10 = 0 + if data__definemacros_item__1_one_of_count10 < 2: + try: + if not isinstance(data__definemacros_item__1, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][1]".format(**locals()) + " must be string", value=data__definemacros_item__1, name="" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][1]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + data__definemacros_item__1_one_of_count10 += 1 + except JsonSchemaValueException: pass + if data__definemacros_item__1_one_of_count10 < 2: + try: + if not isinstance(data__definemacros_item__1, (NoneType)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][1]".format(**locals()) + " must be null", value=data__definemacros_item__1, name="" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][1]".format(**locals()) + "", definition={'type': 'null'}, rule='type') + data__definemacros_item__1_one_of_count10 += 1 + except JsonSchemaValueException: pass + if data__definemacros_item__1_one_of_count10 != 1: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][1]".format(**locals()) + " must be valid exactly by one definition" + (" (" + str(data__definemacros_item__1_one_of_count10) + " matches found)"), value=data__definemacros_item__1, name="" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}][1]".format(**locals()) + "", definition={'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}, rule='oneOf') + if data__definemacros_item_len > 2: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}]".format(**locals()) + " must contain only specified items", value=data__definemacros_item, name="" + (name_prefix or "data") + ".define-macros[{data__definemacros_x}]".format(**locals()) + "", definition={'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}, rule='items') + if "undef-macros" in data_keys: + data_keys.remove("undef-macros") + data__undefmacros = data["undef-macros"] + if not isinstance(data__undefmacros, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".undef-macros must be array", value=data__undefmacros, name="" + (name_prefix or "data") + ".undef-macros", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__undefmacros_is_list = isinstance(data__undefmacros, (list, tuple)) + if data__undefmacros_is_list: + data__undefmacros_len = len(data__undefmacros) + for data__undefmacros_x, data__undefmacros_item in enumerate(data__undefmacros): + if not isinstance(data__undefmacros_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".undef-macros[{data__undefmacros_x}]".format(**locals()) + " must be string", value=data__undefmacros_item, name="" + (name_prefix or "data") + ".undef-macros[{data__undefmacros_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "library-dirs" in data_keys: + data_keys.remove("library-dirs") + data__librarydirs = data["library-dirs"] + if not isinstance(data__librarydirs, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".library-dirs must be array", value=data__librarydirs, name="" + (name_prefix or "data") + ".library-dirs", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__librarydirs_is_list = isinstance(data__librarydirs, (list, tuple)) + if data__librarydirs_is_list: + data__librarydirs_len = len(data__librarydirs) + for data__librarydirs_x, data__librarydirs_item in enumerate(data__librarydirs): + if not isinstance(data__librarydirs_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".library-dirs[{data__librarydirs_x}]".format(**locals()) + " must be string", value=data__librarydirs_item, name="" + (name_prefix or "data") + ".library-dirs[{data__librarydirs_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "libraries" in data_keys: + data_keys.remove("libraries") + data__libraries = data["libraries"] + if not isinstance(data__libraries, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".libraries must be array", value=data__libraries, name="" + (name_prefix or "data") + ".libraries", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__libraries_is_list = isinstance(data__libraries, (list, tuple)) + if data__libraries_is_list: + data__libraries_len = len(data__libraries) + for data__libraries_x, data__libraries_item in enumerate(data__libraries): + if not isinstance(data__libraries_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".libraries[{data__libraries_x}]".format(**locals()) + " must be string", value=data__libraries_item, name="" + (name_prefix or "data") + ".libraries[{data__libraries_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "runtime-library-dirs" in data_keys: + data_keys.remove("runtime-library-dirs") + data__runtimelibrarydirs = data["runtime-library-dirs"] + if not isinstance(data__runtimelibrarydirs, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".runtime-library-dirs must be array", value=data__runtimelibrarydirs, name="" + (name_prefix or "data") + ".runtime-library-dirs", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__runtimelibrarydirs_is_list = isinstance(data__runtimelibrarydirs, (list, tuple)) + if data__runtimelibrarydirs_is_list: + data__runtimelibrarydirs_len = len(data__runtimelibrarydirs) + for data__runtimelibrarydirs_x, data__runtimelibrarydirs_item in enumerate(data__runtimelibrarydirs): + if not isinstance(data__runtimelibrarydirs_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".runtime-library-dirs[{data__runtimelibrarydirs_x}]".format(**locals()) + " must be string", value=data__runtimelibrarydirs_item, name="" + (name_prefix or "data") + ".runtime-library-dirs[{data__runtimelibrarydirs_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "extra-objects" in data_keys: + data_keys.remove("extra-objects") + data__extraobjects = data["extra-objects"] + if not isinstance(data__extraobjects, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".extra-objects must be array", value=data__extraobjects, name="" + (name_prefix or "data") + ".extra-objects", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__extraobjects_is_list = isinstance(data__extraobjects, (list, tuple)) + if data__extraobjects_is_list: + data__extraobjects_len = len(data__extraobjects) + for data__extraobjects_x, data__extraobjects_item in enumerate(data__extraobjects): + if not isinstance(data__extraobjects_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".extra-objects[{data__extraobjects_x}]".format(**locals()) + " must be string", value=data__extraobjects_item, name="" + (name_prefix or "data") + ".extra-objects[{data__extraobjects_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "extra-compile-args" in data_keys: + data_keys.remove("extra-compile-args") + data__extracompileargs = data["extra-compile-args"] + if not isinstance(data__extracompileargs, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".extra-compile-args must be array", value=data__extracompileargs, name="" + (name_prefix or "data") + ".extra-compile-args", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__extracompileargs_is_list = isinstance(data__extracompileargs, (list, tuple)) + if data__extracompileargs_is_list: + data__extracompileargs_len = len(data__extracompileargs) + for data__extracompileargs_x, data__extracompileargs_item in enumerate(data__extracompileargs): + if not isinstance(data__extracompileargs_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".extra-compile-args[{data__extracompileargs_x}]".format(**locals()) + " must be string", value=data__extracompileargs_item, name="" + (name_prefix or "data") + ".extra-compile-args[{data__extracompileargs_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "extra-link-args" in data_keys: + data_keys.remove("extra-link-args") + data__extralinkargs = data["extra-link-args"] + if not isinstance(data__extralinkargs, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".extra-link-args must be array", value=data__extralinkargs, name="" + (name_prefix or "data") + ".extra-link-args", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__extralinkargs_is_list = isinstance(data__extralinkargs, (list, tuple)) + if data__extralinkargs_is_list: + data__extralinkargs_len = len(data__extralinkargs) + for data__extralinkargs_x, data__extralinkargs_item in enumerate(data__extralinkargs): + if not isinstance(data__extralinkargs_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".extra-link-args[{data__extralinkargs_x}]".format(**locals()) + " must be string", value=data__extralinkargs_item, name="" + (name_prefix or "data") + ".extra-link-args[{data__extralinkargs_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "export-symbols" in data_keys: + data_keys.remove("export-symbols") + data__exportsymbols = data["export-symbols"] + if not isinstance(data__exportsymbols, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".export-symbols must be array", value=data__exportsymbols, name="" + (name_prefix or "data") + ".export-symbols", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__exportsymbols_is_list = isinstance(data__exportsymbols, (list, tuple)) + if data__exportsymbols_is_list: + data__exportsymbols_len = len(data__exportsymbols) + for data__exportsymbols_x, data__exportsymbols_item in enumerate(data__exportsymbols): + if not isinstance(data__exportsymbols_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".export-symbols[{data__exportsymbols_x}]".format(**locals()) + " must be string", value=data__exportsymbols_item, name="" + (name_prefix or "data") + ".export-symbols[{data__exportsymbols_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "swig-opts" in data_keys: + data_keys.remove("swig-opts") + data__swigopts = data["swig-opts"] + if not isinstance(data__swigopts, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".swig-opts must be array", value=data__swigopts, name="" + (name_prefix or "data") + ".swig-opts", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__swigopts_is_list = isinstance(data__swigopts, (list, tuple)) + if data__swigopts_is_list: + data__swigopts_len = len(data__swigopts) + for data__swigopts_x, data__swigopts_item in enumerate(data__swigopts): + if not isinstance(data__swigopts_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".swig-opts[{data__swigopts_x}]".format(**locals()) + " must be string", value=data__swigopts_item, name="" + (name_prefix or "data") + ".swig-opts[{data__swigopts_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "depends" in data_keys: + data_keys.remove("depends") + data__depends = data["depends"] + if not isinstance(data__depends, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".depends must be array", value=data__depends, name="" + (name_prefix or "data") + ".depends", definition={'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__depends_is_list = isinstance(data__depends, (list, tuple)) + if data__depends_is_list: + data__depends_len = len(data__depends) + for data__depends_x, data__depends_item in enumerate(data__depends): + if not isinstance(data__depends_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".depends[{data__depends_x}]".format(**locals()) + " must be string", value=data__depends_item, name="" + (name_prefix or "data") + ".depends[{data__depends_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "language" in data_keys: + data_keys.remove("language") + data__language = data["language"] + if not isinstance(data__language, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".language must be string", value=data__language, name="" + (name_prefix or "data") + ".language", definition={'type': 'string'}, rule='type') + if "optional" in data_keys: + data_keys.remove("optional") + data__optional = data["optional"] + if not isinstance(data__optional, (bool)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".optional must be boolean", value=data__optional, name="" + (name_prefix or "data") + ".optional", definition={'type': 'boolean'}, rule='type') + if "py-limited-api" in data_keys: + data_keys.remove("py-limited-api") + data__pylimitedapi = data["py-limited-api"] + if not isinstance(data__pylimitedapi, (bool)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".py-limited-api must be boolean", value=data__pylimitedapi, name="" + (name_prefix or "data") + ".py-limited-api", definition={'type': 'boolean'}, rule='type') + if data_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/ext-module', 'title': 'Extension module', 'description': 'Parameters to construct a :class:`setuptools.Extension` object', 'type': 'object', 'required': ['name', 'sources'], 'additionalProperties': False, 'properties': {'name': {'type': 'string', 'format': 'python-module-name-relaxed'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'include-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'define-macros': {'type': 'array', 'items': {'type': 'array', 'items': [{'description': 'macro name', 'type': 'string'}, {'description': 'macro value', 'oneOf': [{'type': 'string'}, {'type': 'null'}]}], 'additionalItems': False}}, 'undef-macros': {'type': 'array', 'items': {'type': 'string'}}, 'library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'libraries': {'type': 'array', 'items': {'type': 'string'}}, 'runtime-library-dirs': {'type': 'array', 'items': {'type': 'string'}}, 'extra-objects': {'type': 'array', 'items': {'type': 'string'}}, 'extra-compile-args': {'type': 'array', 'items': {'type': 'string'}}, 'extra-link-args': {'type': 'array', 'items': {'type': 'string'}}, 'export-symbols': {'type': 'array', 'items': {'type': 'string'}}, 'swig-opts': {'type': 'array', 'items': {'type': 'string'}}, 'depends': {'type': 'array', 'items': {'type': 'string'}}, 'language': {'type': 'string'}, 'optional': {'type': 'boolean'}, 'py-limited-api': {'type': 'boolean'}}}, rule='additionalProperties') + return data + +def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_find_directive(data, custom_formats={}, name_prefix=None): + if not isinstance(data, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}, rule='type') + data_is_dict = isinstance(data, dict) + if data_is_dict: + data_keys = set(data.keys()) + if "find" in data_keys: + data_keys.remove("find") + data__find = data["find"] + if not isinstance(data__find, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".find must be object", value=data__find, name="" + (name_prefix or "data") + ".find", definition={'type': 'object', '$$description': ['Dynamic `package discovery', '`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}, rule='type') + data__find_is_dict = isinstance(data__find, dict) + if data__find_is_dict: + data__find_keys = set(data__find.keys()) + if "where" in data__find_keys: + data__find_keys.remove("where") + data__find__where = data__find["where"] + if not isinstance(data__find__where, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".find.where must be array", value=data__find__where, name="" + (name_prefix or "data") + ".find.where", definition={'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__find__where_is_list = isinstance(data__find__where, (list, tuple)) + if data__find__where_is_list: + data__find__where_len = len(data__find__where) + for data__find__where_x, data__find__where_item in enumerate(data__find__where): + if not isinstance(data__find__where_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".find.where[{data__find__where_x}]".format(**locals()) + " must be string", value=data__find__where_item, name="" + (name_prefix or "data") + ".find.where[{data__find__where_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "exclude" in data__find_keys: + data__find_keys.remove("exclude") + data__find__exclude = data__find["exclude"] + if not isinstance(data__find__exclude, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".find.exclude must be array", value=data__find__exclude, name="" + (name_prefix or "data") + ".find.exclude", definition={'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, rule='type') + data__find__exclude_is_list = isinstance(data__find__exclude, (list, tuple)) + if data__find__exclude_is_list: + data__find__exclude_len = len(data__find__exclude) + for data__find__exclude_x, data__find__exclude_item in enumerate(data__find__exclude): + if not isinstance(data__find__exclude_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".find.exclude[{data__find__exclude_x}]".format(**locals()) + " must be string", value=data__find__exclude_item, name="" + (name_prefix or "data") + ".find.exclude[{data__find__exclude_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "include" in data__find_keys: + data__find_keys.remove("include") + data__find__include = data__find["include"] + if not isinstance(data__find__include, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".find.include must be array", value=data__find__include, name="" + (name_prefix or "data") + ".find.include", definition={'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, rule='type') + data__find__include_is_list = isinstance(data__find__include, (list, tuple)) + if data__find__include_is_list: + data__find__include_len = len(data__find__include) + for data__find__include_x, data__find__include_item in enumerate(data__find__include): + if not isinstance(data__find__include_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".find.include[{data__find__include_x}]".format(**locals()) + " must be string", value=data__find__include_item, name="" + (name_prefix or "data") + ".find.include[{data__find__include_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "namespaces" in data__find_keys: + data__find_keys.remove("namespaces") + data__find__namespaces = data__find["namespaces"] + if not isinstance(data__find__namespaces, (bool)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".find.namespaces must be boolean", value=data__find__namespaces, name="" + (name_prefix or "data") + ".find.namespaces", definition={'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}, rule='type') + if data__find_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".find must not contain "+str(data__find_keys)+" properties", value=data__find, name="" + (name_prefix or "data") + ".find", definition={'type': 'object', '$$description': ['Dynamic `package discovery', '`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}, rule='additionalProperties') + if data_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/find-directive', 'title': "'find:' directive", 'type': 'object', 'additionalProperties': False, 'properties': {'find': {'type': 'object', '$$description': ['Dynamic `package discovery', '`_.'], 'additionalProperties': False, 'properties': {'where': {'description': 'Directories to be searched for packages (Unix-style relative path)', 'type': 'array', 'items': {'type': 'string'}}, 'exclude': {'type': 'array', '$$description': ['Exclude packages that match the values listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'include': {'type': 'array', '$$description': ['Restrict the found packages to just the ones listed in this field.', "Can container shell-style wildcards (e.g. ``'pkg.*'``)"], 'items': {'type': 'string'}}, 'namespaces': {'type': 'boolean', '$$description': ['When ``True``, directories without a ``__init__.py`` file will also', 'be scanned for :pep:`420`-style implicit namespaces']}}}}}, rule='additionalProperties') + return data + +def validate_https___setuptools_pypa_io_en_latest_userguide_pyproject_config_html__definitions_package_name(data, custom_formats={}, name_prefix=None): + if not isinstance(data, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be string", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}, rule='type') + data_any_of_count11 = 0 + if not data_any_of_count11: + try: + if not isinstance(data, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be string", value=data, name="" + (name_prefix or "data") + "", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='type') + if isinstance(data, str): + if not custom_formats["python-module-name-relaxed"](data): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be python-module-name-relaxed", value=data, name="" + (name_prefix or "data") + "", definition={'type': 'string', 'format': 'python-module-name-relaxed'}, rule='format') + data_any_of_count11 += 1 + except JsonSchemaValueException: pass + if not data_any_of_count11: + try: + if not isinstance(data, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be string", value=data, name="" + (name_prefix or "data") + "", definition={'type': 'string', 'format': 'pep561-stub-name'}, rule='type') + if isinstance(data, str): + if not custom_formats["pep561-stub-name"](data): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be pep561-stub-name", value=data, name="" + (name_prefix or "data") + "", definition={'type': 'string', 'format': 'pep561-stub-name'}, rule='format') + data_any_of_count11 += 1 + except JsonSchemaValueException: pass + if not data_any_of_count11: + raise JsonSchemaValueException("" + (name_prefix or "data") + " cannot be validated by any definition", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/package-name', 'title': 'Valid package name', 'description': 'Valid package name (importable or :pep:`561`).', 'type': 'string', 'anyOf': [{'type': 'string', 'format': 'python-module-name-relaxed'}, {'type': 'string', 'format': 'pep561-stub-name'}]}, rule='anyOf') + return data + +def validate_https___setuptools_pypa_io_en_latest_deprecated_distutils_configfile_html(data, custom_formats={}, name_prefix=None): + if not isinstance(data, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html', 'title': '``tool.distutils`` table', '$$description': ['**EXPERIMENTAL** (NOT OFFICIALLY SUPPORTED): Use ``tool.distutils``', 'subtables to configure arguments for ``distutils`` commands.', 'Originally, ``distutils`` allowed developers to configure arguments for', '``setup.py`` commands via `distutils configuration files', '`_.', 'See also `the old Python docs _`.'], 'type': 'object', 'properties': {'global': {'type': 'object', 'description': 'Global options applied to all ``distutils`` commands'}}, 'patternProperties': {'.+': {'type': 'object'}}, '$comment': 'TODO: Is there a practical way of making this schema more specific?'}, rule='type') + data_is_dict = isinstance(data, dict) + if data_is_dict: + data_keys = set(data.keys()) + if "global" in data_keys: + data_keys.remove("global") + data__global = data["global"] + if not isinstance(data__global, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".global must be object", value=data__global, name="" + (name_prefix or "data") + ".global", definition={'type': 'object', 'description': 'Global options applied to all ``distutils`` commands'}, rule='type') + for data_key, data_val in data.items(): + if REGEX_PATTERNS['.+'].search(data_key): + if data_key in data_keys: + data_keys.remove(data_key) + if not isinstance(data_val, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".{data_key}".format(**locals()) + " must be object", value=data_val, name="" + (name_prefix or "data") + ".{data_key}".format(**locals()) + "", definition={'type': 'object'}, rule='type') + return data + +def validate_https___packaging_python_org_en_latest_specifications_pyproject_toml(data, custom_formats={}, name_prefix=None): + if not isinstance(data, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/pyproject-toml/', 'title': 'Package metadata stored in the ``project`` table', '$$description': ['Data structure for the **project** table inside ``pyproject.toml``', '(as initially defined in :pep:`621`)'], 'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, 'version': {'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, 'description': {'type': 'string', '$$description': ['The `summary description of the project', '`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's Description", '`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, 'requires-python': {'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '`_.']}, 'license': {'description': '`Project license `_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '`_.']}}, 'required': ['text']}]}, 'license-files': {'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, 'authors': {'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, 'maintainers': {'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, 'classifiers': {'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier `_.'}, '$$description': ['`Trove classifiers `_', 'which apply to the project.']}, 'urls': {'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, 'scripts': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'gui-scripts': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'entry-points': {'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}}}, 'dependencies': {'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}, 'optional-dependencies': {'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, 'dynamic': {'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}}, 'required': ['name'], 'additionalProperties': False, 'allOf': [{'if': {'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, 'then': {'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}}, {'if': {'required': ['license-files']}, 'then': {'properties': {'license': {'type': 'string'}}}}], 'definitions': {'author': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, 'entry-point-group': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'dependency': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}, rule='type') + try: + try: + data_is_dict = isinstance(data, dict) + if data_is_dict: + data__missing_keys = set(['dynamic']) - data.keys() + if data__missing_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must contain " + (str(sorted(data__missing_keys)) + " properties"), value=data, name="" + (name_prefix or "data") + "", definition={'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, rule='required') + data_keys = set(data.keys()) + if "dynamic" in data_keys: + data_keys.remove("dynamic") + data__dynamic = data["dynamic"] + data__dynamic_is_list = isinstance(data__dynamic, (list, tuple)) + if data__dynamic_is_list: + data__dynamic_contains = False + for data__dynamic_key in data__dynamic: + try: + if data__dynamic_key != "version": + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic must be same as const definition: version", value=data__dynamic_key, name="" + (name_prefix or "data") + ".dynamic", definition={'const': 'version'}, rule='const') + data__dynamic_contains = True + break + except JsonSchemaValueException: pass + if not data__dynamic_contains: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic must contain one of contains definition", value=data__dynamic, name="" + (name_prefix or "data") + ".dynamic", definition={'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}, rule='contains') + except JsonSchemaValueException: pass + else: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must NOT match a disallowed definition", value=data, name="" + (name_prefix or "data") + "", definition={'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, rule='not') + except JsonSchemaValueException: + pass + else: + data_is_dict = isinstance(data, dict) + if data_is_dict: + data__missing_keys = set(['version']) - data.keys() + if data__missing_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must contain " + (str(sorted(data__missing_keys)) + " properties"), value=data, name="" + (name_prefix or "data") + "", definition={'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}, rule='required') + try: + data_is_dict = isinstance(data, dict) + if data_is_dict: + data__missing_keys = set(['license-files']) - data.keys() + if data__missing_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must contain " + (str(sorted(data__missing_keys)) + " properties"), value=data, name="" + (name_prefix or "data") + "", definition={'required': ['license-files']}, rule='required') + except JsonSchemaValueException: + pass + else: + data_is_dict = isinstance(data, dict) + if data_is_dict: + data_keys = set(data.keys()) + if "license" in data_keys: + data_keys.remove("license") + data__license = data["license"] + if not isinstance(data__license, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must be string", value=data__license, name="" + (name_prefix or "data") + ".license", definition={'type': 'string'}, rule='type') + data_is_dict = isinstance(data, dict) + if data_is_dict: + data__missing_keys = set(['name']) - data.keys() + if data__missing_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must contain " + (str(sorted(data__missing_keys)) + " properties"), value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/pyproject-toml/', 'title': 'Package metadata stored in the ``project`` table', '$$description': ['Data structure for the **project** table inside ``pyproject.toml``', '(as initially defined in :pep:`621`)'], 'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, 'version': {'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, 'description': {'type': 'string', '$$description': ['The `summary description of the project', '`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's Description", '`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, 'requires-python': {'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '`_.']}, 'license': {'description': '`Project license `_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '`_.']}}, 'required': ['text']}]}, 'license-files': {'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, 'authors': {'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, 'maintainers': {'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, 'classifiers': {'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier `_.'}, '$$description': ['`Trove classifiers `_', 'which apply to the project.']}, 'urls': {'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, 'scripts': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'gui-scripts': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'entry-points': {'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}}}, 'dependencies': {'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}, 'optional-dependencies': {'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, 'dynamic': {'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}}, 'required': ['name'], 'additionalProperties': False, 'allOf': [{'if': {'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, 'then': {'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}}, {'if': {'required': ['license-files']}, 'then': {'properties': {'license': {'type': 'string'}}}}], 'definitions': {'author': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, 'entry-point-group': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'dependency': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}, rule='required') + data_keys = set(data.keys()) + if "name" in data_keys: + data_keys.remove("name") + data__name = data["name"] + if not isinstance(data__name, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".name must be string", value=data__name, name="" + (name_prefix or "data") + ".name", definition={'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, rule='type') + if isinstance(data__name, str): + if not custom_formats["pep508-identifier"](data__name): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".name must be pep508-identifier", value=data__name, name="" + (name_prefix or "data") + ".name", definition={'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, rule='format') + if "version" in data_keys: + data_keys.remove("version") + data__version = data["version"] + if not isinstance(data__version, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".version must be string", value=data__version, name="" + (name_prefix or "data") + ".version", definition={'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, rule='type') + if isinstance(data__version, str): + if not custom_formats["pep440"](data__version): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".version must be pep440", value=data__version, name="" + (name_prefix or "data") + ".version", definition={'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, rule='format') + if "description" in data_keys: + data_keys.remove("description") + data__description = data["description"] + if not isinstance(data__description, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".description must be string", value=data__description, name="" + (name_prefix or "data") + ".description", definition={'type': 'string', '$$description': ['The `summary description of the project', '`_']}, rule='type') + if "readme" in data_keys: + data_keys.remove("readme") + data__readme = data["readme"] + data__readme_one_of_count12 = 0 + if data__readme_one_of_count12 < 2: + try: + if not isinstance(data__readme, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme must be string", value=data__readme, name="" + (name_prefix or "data") + ".readme", definition={'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, rule='type') + data__readme_one_of_count12 += 1 + except JsonSchemaValueException: pass + if data__readme_one_of_count12 < 2: + try: + if not isinstance(data__readme, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme must be object", value=data__readme, name="" + (name_prefix or "data") + ".readme", definition={'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}, rule='type') + data__readme_any_of_count13 = 0 + if not data__readme_any_of_count13: + try: + data__readme_is_dict = isinstance(data__readme, dict) + if data__readme_is_dict: + data__readme__missing_keys = set(['file']) - data__readme.keys() + if data__readme__missing_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme must contain " + (str(sorted(data__readme__missing_keys)) + " properties"), value=data__readme, name="" + (name_prefix or "data") + ".readme", definition={'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, rule='required') + data__readme_keys = set(data__readme.keys()) + if "file" in data__readme_keys: + data__readme_keys.remove("file") + data__readme__file = data__readme["file"] + if not isinstance(data__readme__file, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme.file must be string", value=data__readme__file, name="" + (name_prefix or "data") + ".readme.file", definition={'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}, rule='type') + data__readme_any_of_count13 += 1 + except JsonSchemaValueException: pass + if not data__readme_any_of_count13: + try: + data__readme_is_dict = isinstance(data__readme, dict) + if data__readme_is_dict: + data__readme__missing_keys = set(['text']) - data__readme.keys() + if data__readme__missing_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme must contain " + (str(sorted(data__readme__missing_keys)) + " properties"), value=data__readme, name="" + (name_prefix or "data") + ".readme", definition={'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}, rule='required') + data__readme_keys = set(data__readme.keys()) + if "text" in data__readme_keys: + data__readme_keys.remove("text") + data__readme__text = data__readme["text"] + if not isinstance(data__readme__text, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme.text must be string", value=data__readme__text, name="" + (name_prefix or "data") + ".readme.text", definition={'type': 'string', 'description': 'Full text describing the project.'}, rule='type') + data__readme_any_of_count13 += 1 + except JsonSchemaValueException: pass + if not data__readme_any_of_count13: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme cannot be validated by any definition", value=data__readme, name="" + (name_prefix or "data") + ".readme", definition={'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, rule='anyOf') + data__readme_is_dict = isinstance(data__readme, dict) + if data__readme_is_dict: + data__readme__missing_keys = set(['content-type']) - data__readme.keys() + if data__readme__missing_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme must contain " + (str(sorted(data__readme__missing_keys)) + " properties"), value=data__readme, name="" + (name_prefix or "data") + ".readme", definition={'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}, rule='required') + data__readme_keys = set(data__readme.keys()) + if "content-type" in data__readme_keys: + data__readme_keys.remove("content-type") + data__readme__contenttype = data__readme["content-type"] + if not isinstance(data__readme__contenttype, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme.content-type must be string", value=data__readme__contenttype, name="" + (name_prefix or "data") + ".readme.content-type", definition={'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}, rule='type') + data__readme_one_of_count12 += 1 + except JsonSchemaValueException: pass + if data__readme_one_of_count12 != 1: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".readme must be valid exactly by one definition" + (" (" + str(data__readme_one_of_count12) + " matches found)"), value=data__readme, name="" + (name_prefix or "data") + ".readme", definition={'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's Description", '`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, rule='oneOf') + if "requires-python" in data_keys: + data_keys.remove("requires-python") + data__requirespython = data["requires-python"] + if not isinstance(data__requirespython, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".requires-python must be string", value=data__requirespython, name="" + (name_prefix or "data") + ".requires-python", definition={'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '`_.']}, rule='type') + if isinstance(data__requirespython, str): + if not custom_formats["pep508-versionspec"](data__requirespython): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".requires-python must be pep508-versionspec", value=data__requirespython, name="" + (name_prefix or "data") + ".requires-python", definition={'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '`_.']}, rule='format') + if "license" in data_keys: + data_keys.remove("license") + data__license = data["license"] + data__license_one_of_count14 = 0 + if data__license_one_of_count14 < 2: + try: + if not isinstance(data__license, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must be string", value=data__license, name="" + (name_prefix or "data") + ".license", definition={'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, rule='type') + if isinstance(data__license, str): + if not custom_formats["SPDX"](data__license): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must be SPDX", value=data__license, name="" + (name_prefix or "data") + ".license", definition={'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, rule='format') + data__license_one_of_count14 += 1 + except JsonSchemaValueException: pass + if data__license_one_of_count14 < 2: + try: + if not isinstance(data__license, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must be object", value=data__license, name="" + (name_prefix or "data") + ".license", definition={'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, rule='type') + data__license_is_dict = isinstance(data__license, dict) + if data__license_is_dict: + data__license__missing_keys = set(['file']) - data__license.keys() + if data__license__missing_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must contain " + (str(sorted(data__license__missing_keys)) + " properties"), value=data__license, name="" + (name_prefix or "data") + ".license", definition={'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, rule='required') + data__license_keys = set(data__license.keys()) + if "file" in data__license_keys: + data__license_keys.remove("file") + data__license__file = data__license["file"] + if not isinstance(data__license__file, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".license.file must be string", value=data__license__file, name="" + (name_prefix or "data") + ".license.file", definition={'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}, rule='type') + data__license_one_of_count14 += 1 + except JsonSchemaValueException: pass + if data__license_one_of_count14 < 2: + try: + if not isinstance(data__license, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must be object", value=data__license, name="" + (name_prefix or "data") + ".license", definition={'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '`_.']}}, 'required': ['text']}, rule='type') + data__license_is_dict = isinstance(data__license, dict) + if data__license_is_dict: + data__license__missing_keys = set(['text']) - data__license.keys() + if data__license__missing_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must contain " + (str(sorted(data__license__missing_keys)) + " properties"), value=data__license, name="" + (name_prefix or "data") + ".license", definition={'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '`_.']}}, 'required': ['text']}, rule='required') + data__license_keys = set(data__license.keys()) + if "text" in data__license_keys: + data__license_keys.remove("text") + data__license__text = data__license["text"] + if not isinstance(data__license__text, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".license.text must be string", value=data__license__text, name="" + (name_prefix or "data") + ".license.text", definition={'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '`_.']}, rule='type') + data__license_one_of_count14 += 1 + except JsonSchemaValueException: pass + if data__license_one_of_count14 != 1: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".license must be valid exactly by one definition" + (" (" + str(data__license_one_of_count14) + " matches found)"), value=data__license, name="" + (name_prefix or "data") + ".license", definition={'description': '`Project license `_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '`_.']}}, 'required': ['text']}]}, rule='oneOf') + if "license-files" in data_keys: + data_keys.remove("license-files") + data__licensefiles = data["license-files"] + if not isinstance(data__licensefiles, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".license-files must be array", value=data__licensefiles, name="" + (name_prefix or "data") + ".license-files", definition={'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, rule='type') + data__licensefiles_is_list = isinstance(data__licensefiles, (list, tuple)) + if data__licensefiles_is_list: + data__licensefiles_len = len(data__licensefiles) + for data__licensefiles_x, data__licensefiles_item in enumerate(data__licensefiles): + if not isinstance(data__licensefiles_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".license-files[{data__licensefiles_x}]".format(**locals()) + " must be string", value=data__licensefiles_item, name="" + (name_prefix or "data") + ".license-files[{data__licensefiles_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "authors" in data_keys: + data_keys.remove("authors") + data__authors = data["authors"] + if not isinstance(data__authors, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".authors must be array", value=data__authors, name="" + (name_prefix or "data") + ".authors", definition={'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, rule='type') + data__authors_is_list = isinstance(data__authors, (list, tuple)) + if data__authors_is_list: + data__authors_len = len(data__authors) + for data__authors_x, data__authors_item in enumerate(data__authors): + validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_author(data__authors_item, custom_formats, (name_prefix or "data") + ".authors[{data__authors_x}]".format(**locals())) + if "maintainers" in data_keys: + data_keys.remove("maintainers") + data__maintainers = data["maintainers"] + if not isinstance(data__maintainers, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".maintainers must be array", value=data__maintainers, name="" + (name_prefix or "data") + ".maintainers", definition={'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, rule='type') + data__maintainers_is_list = isinstance(data__maintainers, (list, tuple)) + if data__maintainers_is_list: + data__maintainers_len = len(data__maintainers) + for data__maintainers_x, data__maintainers_item in enumerate(data__maintainers): + validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_author(data__maintainers_item, custom_formats, (name_prefix or "data") + ".maintainers[{data__maintainers_x}]".format(**locals())) + if "keywords" in data_keys: + data_keys.remove("keywords") + data__keywords = data["keywords"] + if not isinstance(data__keywords, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".keywords must be array", value=data__keywords, name="" + (name_prefix or "data") + ".keywords", definition={'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, rule='type') + data__keywords_is_list = isinstance(data__keywords, (list, tuple)) + if data__keywords_is_list: + data__keywords_len = len(data__keywords) + for data__keywords_x, data__keywords_item in enumerate(data__keywords): + if not isinstance(data__keywords_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".keywords[{data__keywords_x}]".format(**locals()) + " must be string", value=data__keywords_item, name="" + (name_prefix or "data") + ".keywords[{data__keywords_x}]".format(**locals()) + "", definition={'type': 'string'}, rule='type') + if "classifiers" in data_keys: + data_keys.remove("classifiers") + data__classifiers = data["classifiers"] + if not isinstance(data__classifiers, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".classifiers must be array", value=data__classifiers, name="" + (name_prefix or "data") + ".classifiers", definition={'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier `_.'}, '$$description': ['`Trove classifiers `_', 'which apply to the project.']}, rule='type') + data__classifiers_is_list = isinstance(data__classifiers, (list, tuple)) + if data__classifiers_is_list: + data__classifiers_len = len(data__classifiers) + for data__classifiers_x, data__classifiers_item in enumerate(data__classifiers): + if not isinstance(data__classifiers_item, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".classifiers[{data__classifiers_x}]".format(**locals()) + " must be string", value=data__classifiers_item, name="" + (name_prefix or "data") + ".classifiers[{data__classifiers_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier `_.'}, rule='type') + if isinstance(data__classifiers_item, str): + if not custom_formats["trove-classifier"](data__classifiers_item): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".classifiers[{data__classifiers_x}]".format(**locals()) + " must be trove-classifier", value=data__classifiers_item, name="" + (name_prefix or "data") + ".classifiers[{data__classifiers_x}]".format(**locals()) + "", definition={'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier `_.'}, rule='format') + if "urls" in data_keys: + data_keys.remove("urls") + data__urls = data["urls"] + if not isinstance(data__urls, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".urls must be object", value=data__urls, name="" + (name_prefix or "data") + ".urls", definition={'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, rule='type') + data__urls_is_dict = isinstance(data__urls, dict) + if data__urls_is_dict: + data__urls_keys = set(data__urls.keys()) + for data__urls_key, data__urls_val in data__urls.items(): + if REGEX_PATTERNS['^.+$'].search(data__urls_key): + if data__urls_key in data__urls_keys: + data__urls_keys.remove(data__urls_key) + if not isinstance(data__urls_val, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".urls.{data__urls_key}".format(**locals()) + " must be string", value=data__urls_val, name="" + (name_prefix or "data") + ".urls.{data__urls_key}".format(**locals()) + "", definition={'type': 'string', 'format': 'url'}, rule='type') + if isinstance(data__urls_val, str): + if not custom_formats["url"](data__urls_val): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".urls.{data__urls_key}".format(**locals()) + " must be url", value=data__urls_val, name="" + (name_prefix or "data") + ".urls.{data__urls_key}".format(**locals()) + "", definition={'type': 'string', 'format': 'url'}, rule='format') + if data__urls_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".urls must not contain "+str(data__urls_keys)+" properties", value=data__urls, name="" + (name_prefix or "data") + ".urls", definition={'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, rule='additionalProperties') + if "scripts" in data_keys: + data_keys.remove("scripts") + data__scripts = data["scripts"] + validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_entry_point_group(data__scripts, custom_formats, (name_prefix or "data") + ".scripts") + if "gui-scripts" in data_keys: + data_keys.remove("gui-scripts") + data__guiscripts = data["gui-scripts"] + validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_entry_point_group(data__guiscripts, custom_formats, (name_prefix or "data") + ".gui-scripts") + if "entry-points" in data_keys: + data_keys.remove("entry-points") + data__entrypoints = data["entry-points"] + data__entrypoints_is_dict = isinstance(data__entrypoints, dict) + if data__entrypoints_is_dict: + data__entrypoints_keys = set(data__entrypoints.keys()) + for data__entrypoints_key, data__entrypoints_val in data__entrypoints.items(): + if REGEX_PATTERNS['^.+$'].search(data__entrypoints_key): + if data__entrypoints_key in data__entrypoints_keys: + data__entrypoints_keys.remove(data__entrypoints_key) + validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_entry_point_group(data__entrypoints_val, custom_formats, (name_prefix or "data") + ".entry-points.{data__entrypoints_key}".format(**locals())) + if data__entrypoints_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".entry-points must not contain "+str(data__entrypoints_keys)+" properties", value=data__entrypoints, name="" + (name_prefix or "data") + ".entry-points", definition={'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}}}, rule='additionalProperties') + data__entrypoints_len = len(data__entrypoints) + if data__entrypoints_len != 0: + data__entrypoints_property_names = True + for data__entrypoints_key in data__entrypoints: + try: + if isinstance(data__entrypoints_key, str): + if not custom_formats["python-entrypoint-group"](data__entrypoints_key): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".entry-points must be python-entrypoint-group", value=data__entrypoints_key, name="" + (name_prefix or "data") + ".entry-points", definition={'format': 'python-entrypoint-group'}, rule='format') + except JsonSchemaValueException: + data__entrypoints_property_names = False + if not data__entrypoints_property_names: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".entry-points must be named by propertyName definition", value=data__entrypoints, name="" + (name_prefix or "data") + ".entry-points", definition={'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}}}, rule='propertyNames') + if "dependencies" in data_keys: + data_keys.remove("dependencies") + data__dependencies = data["dependencies"] + if not isinstance(data__dependencies, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dependencies must be array", value=data__dependencies, name="" + (name_prefix or "data") + ".dependencies", definition={'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}, rule='type') + data__dependencies_is_list = isinstance(data__dependencies, (list, tuple)) + if data__dependencies_is_list: + data__dependencies_len = len(data__dependencies) + for data__dependencies_x, data__dependencies_item in enumerate(data__dependencies): + validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_dependency(data__dependencies_item, custom_formats, (name_prefix or "data") + ".dependencies[{data__dependencies_x}]".format(**locals())) + if "optional-dependencies" in data_keys: + data_keys.remove("optional-dependencies") + data__optionaldependencies = data["optional-dependencies"] + if not isinstance(data__optionaldependencies, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".optional-dependencies must be object", value=data__optionaldependencies, name="" + (name_prefix or "data") + ".optional-dependencies", definition={'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, rule='type') + data__optionaldependencies_is_dict = isinstance(data__optionaldependencies, dict) + if data__optionaldependencies_is_dict: + data__optionaldependencies_keys = set(data__optionaldependencies.keys()) + for data__optionaldependencies_key, data__optionaldependencies_val in data__optionaldependencies.items(): + if REGEX_PATTERNS['^.+$'].search(data__optionaldependencies_key): + if data__optionaldependencies_key in data__optionaldependencies_keys: + data__optionaldependencies_keys.remove(data__optionaldependencies_key) + if not isinstance(data__optionaldependencies_val, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".optional-dependencies.{data__optionaldependencies_key}".format(**locals()) + " must be array", value=data__optionaldependencies_val, name="" + (name_prefix or "data") + ".optional-dependencies.{data__optionaldependencies_key}".format(**locals()) + "", definition={'type': 'array', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}, rule='type') + data__optionaldependencies_val_is_list = isinstance(data__optionaldependencies_val, (list, tuple)) + if data__optionaldependencies_val_is_list: + data__optionaldependencies_val_len = len(data__optionaldependencies_val) + for data__optionaldependencies_val_x, data__optionaldependencies_val_item in enumerate(data__optionaldependencies_val): + validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_dependency(data__optionaldependencies_val_item, custom_formats, (name_prefix or "data") + ".optional-dependencies.{data__optionaldependencies_key}[{data__optionaldependencies_val_x}]".format(**locals())) + if data__optionaldependencies_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".optional-dependencies must not contain "+str(data__optionaldependencies_keys)+" properties", value=data__optionaldependencies, name="" + (name_prefix or "data") + ".optional-dependencies", definition={'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, rule='additionalProperties') + data__optionaldependencies_len = len(data__optionaldependencies) + if data__optionaldependencies_len != 0: + data__optionaldependencies_property_names = True + for data__optionaldependencies_key in data__optionaldependencies: + try: + if isinstance(data__optionaldependencies_key, str): + if not custom_formats["pep508-identifier"](data__optionaldependencies_key): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".optional-dependencies must be pep508-identifier", value=data__optionaldependencies_key, name="" + (name_prefix or "data") + ".optional-dependencies", definition={'format': 'pep508-identifier'}, rule='format') + except JsonSchemaValueException: + data__optionaldependencies_property_names = False + if not data__optionaldependencies_property_names: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".optional-dependencies must be named by propertyName definition", value=data__optionaldependencies, name="" + (name_prefix or "data") + ".optional-dependencies", definition={'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, rule='propertyNames') + if "dynamic" in data_keys: + data_keys.remove("dynamic") + data__dynamic = data["dynamic"] + if not isinstance(data__dynamic, (list, tuple)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic must be array", value=data__dynamic, name="" + (name_prefix or "data") + ".dynamic", definition={'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}, rule='type') + data__dynamic_is_list = isinstance(data__dynamic, (list, tuple)) + if data__dynamic_is_list: + data__dynamic_len = len(data__dynamic) + for data__dynamic_x, data__dynamic_item in enumerate(data__dynamic): + if data__dynamic_item not in ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']: + raise JsonSchemaValueException("" + (name_prefix or "data") + ".dynamic[{data__dynamic_x}]".format(**locals()) + " must be one of ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']", value=data__dynamic_item, name="" + (name_prefix or "data") + ".dynamic[{data__dynamic_x}]".format(**locals()) + "", definition={'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}, rule='enum') + if data_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$schema': 'http://json-schema.org/draft-07/schema#', '$id': 'https://packaging.python.org/en/latest/specifications/pyproject-toml/', 'title': 'Package metadata stored in the ``project`` table', '$$description': ['Data structure for the **project** table inside ``pyproject.toml``', '(as initially defined in :pep:`621`)'], 'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'The name (primary identifier) of the project. MUST be statically defined.', 'format': 'pep508-identifier'}, 'version': {'type': 'string', 'description': 'The version of the project as supported by :pep:`440`.', 'format': 'pep440'}, 'description': {'type': 'string', '$$description': ['The `summary description of the project', '`_']}, 'readme': {'$$description': ['`Full/detailed description of the project in the form of a README', '`_', "with meaning similar to the one defined in `core metadata's Description", '`_'], 'oneOf': [{'type': 'string', '$$description': ['Relative path to a text file (UTF-8) containing the full description', 'of the project. If the file path ends in case-insensitive ``.md`` or', '``.rst`` suffixes, then the content-type is respectively', '``text/markdown`` or ``text/x-rst``']}, {'type': 'object', 'allOf': [{'anyOf': [{'properties': {'file': {'type': 'string', '$$description': ['Relative path to a text file containing the full description', 'of the project.']}}, 'required': ['file']}, {'properties': {'text': {'type': 'string', 'description': 'Full text describing the project.'}}, 'required': ['text']}]}, {'properties': {'content-type': {'type': 'string', '$$description': ['Content-type (:rfc:`1341`) of the full description', '(e.g. ``text/markdown``). The ``charset`` parameter is assumed', 'UTF-8 when not present.'], '$comment': 'TODO: add regex pattern or format?'}}, 'required': ['content-type']}]}]}, 'requires-python': {'type': 'string', 'format': 'pep508-versionspec', '$$description': ['`The Python version requirements of the project', '`_.']}, 'license': {'description': '`Project license `_.', 'oneOf': [{'type': 'string', 'description': 'An SPDX license identifier', 'format': 'SPDX'}, {'type': 'object', 'properties': {'file': {'type': 'string', '$$description': ['Relative path to the file (UTF-8) which contains the license for the', 'project.']}}, 'required': ['file']}, {'type': 'object', 'properties': {'text': {'type': 'string', '$$description': ['The license of the project whose meaning is that of the', '`License field from the core metadata', '`_.']}}, 'required': ['text']}]}, 'license-files': {'description': 'Paths or globs to paths of license files', 'type': 'array', 'items': {'type': 'string'}}, 'authors': {'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'authors' of the project.", 'The exact meaning is open to interpretation (e.g. original or primary authors,', 'current maintainers, or owners of the package).']}, 'maintainers': {'type': 'array', 'items': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, '$$description': ["The people or organizations considered to be the 'maintainers' of the project.", 'Similarly to ``authors``, the exact meaning is open to interpretation.']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of keywords to assist searching for the distribution in a larger catalog.'}, 'classifiers': {'type': 'array', 'items': {'type': 'string', 'format': 'trove-classifier', 'description': '`PyPI classifier `_.'}, '$$description': ['`Trove classifiers `_', 'which apply to the project.']}, 'urls': {'type': 'object', 'description': 'URLs associated with the project in the form ``label => value``.', 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', 'format': 'url'}}}, 'scripts': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'gui-scripts': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'entry-points': {'$$description': ['Instruct the installer to expose the given modules/functions via', '``entry-point`` discovery mechanism (useful for plugins).', 'More information available in the `Python packaging guide', '`_.'], 'propertyNames': {'format': 'python-entrypoint-group'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}}}, 'dependencies': {'type': 'array', 'description': 'Project (mandatory) dependencies.', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}, 'optional-dependencies': {'type': 'object', 'description': 'Optional dependency for the project', 'propertyNames': {'format': 'pep508-identifier'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'array', 'items': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}}, 'dynamic': {'type': 'array', '$$description': ['Specifies which fields are intentionally unspecified and expected to be', 'dynamically provided by build tools'], 'items': {'enum': ['version', 'description', 'readme', 'requires-python', 'license', 'license-files', 'authors', 'maintainers', 'keywords', 'classifiers', 'urls', 'scripts', 'gui-scripts', 'entry-points', 'dependencies', 'optional-dependencies']}}}, 'required': ['name'], 'additionalProperties': False, 'allOf': [{'if': {'not': {'required': ['dynamic'], 'properties': {'dynamic': {'contains': {'const': 'version'}, '$$description': ['version is listed in ``dynamic``']}}}, '$$comment': ['According to :pep:`621`:', ' If the core metadata specification lists a field as "Required", then', ' the metadata MUST specify the field statically or list it in dynamic', 'In turn, `core metadata`_ defines:', ' The required fields are: Metadata-Version, Name, Version.', ' All the other fields are optional.', 'Since ``Metadata-Version`` is defined by the build back-end, ``name`` and', '``version`` are the only mandatory information in ``pyproject.toml``.', '.. _core metadata: https://packaging.python.org/specifications/core-metadata/']}, 'then': {'required': ['version'], '$$description': ['version should be statically defined in the ``version`` field']}}, {'if': {'required': ['license-files']}, 'then': {'properties': {'license': {'type': 'string'}}}}], 'definitions': {'author': {'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, 'entry-point-group': {'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, 'dependency': {'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}}}, rule='additionalProperties') + return data + +def validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_dependency(data, custom_formats={}, name_prefix=None): + if not isinstance(data, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be string", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}, rule='type') + if isinstance(data, str): + if not custom_formats["pep508"](data): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be pep508", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/dependency', 'title': 'Dependency', 'type': 'string', 'description': 'Project dependency specification according to PEP 508', 'format': 'pep508'}, rule='format') + return data + +def validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_entry_point_group(data, custom_formats={}, name_prefix=None): + if not isinstance(data, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, rule='type') + data_is_dict = isinstance(data, dict) + if data_is_dict: + data_keys = set(data.keys()) + for data_key, data_val in data.items(): + if REGEX_PATTERNS['^.+$'].search(data_key): + if data_key in data_keys: + data_keys.remove(data_key) + if not isinstance(data_val, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".{data_key}".format(**locals()) + " must be string", value=data_val, name="" + (name_prefix or "data") + ".{data_key}".format(**locals()) + "", definition={'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}, rule='type') + if isinstance(data_val, str): + if not custom_formats["python-entrypoint-reference"](data_val): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".{data_key}".format(**locals()) + " must be python-entrypoint-reference", value=data_val, name="" + (name_prefix or "data") + ".{data_key}".format(**locals()) + "", definition={'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}, rule='format') + if data_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, rule='additionalProperties') + data_len = len(data) + if data_len != 0: + data_property_names = True + for data_key in data: + try: + if isinstance(data_key, str): + if not custom_formats["python-entrypoint-name"](data_key): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be python-entrypoint-name", value=data_key, name="" + (name_prefix or "data") + "", definition={'format': 'python-entrypoint-name'}, rule='format') + except JsonSchemaValueException: + data_property_names = False + if not data_property_names: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be named by propertyName definition", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/entry-point-group', 'title': 'Entry-points', 'type': 'object', '$$description': ['Entry-points are grouped together to indicate what sort of capabilities they', 'provide.', 'See the `packaging guides', '`_', 'and `setuptools docs', '`_', 'for more information.'], 'propertyNames': {'format': 'python-entrypoint-name'}, 'additionalProperties': False, 'patternProperties': {'^.+$': {'type': 'string', '$$description': ['Reference to a Python object. It is either in the form', '``importable.module``, or ``importable.module:object.attr``.'], 'format': 'python-entrypoint-reference', '$comment': 'https://packaging.python.org/specifications/entry-points/'}}}, rule='propertyNames') + return data + +def validate_https___packaging_python_org_en_latest_specifications_pyproject_toml___definitions_author(data, custom_formats={}, name_prefix=None): + if not isinstance(data, (dict)): + raise JsonSchemaValueException("" + (name_prefix or "data") + " must be object", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, rule='type') + data_is_dict = isinstance(data, dict) + if data_is_dict: + data_keys = set(data.keys()) + if "name" in data_keys: + data_keys.remove("name") + data__name = data["name"] + if not isinstance(data__name, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".name must be string", value=data__name, name="" + (name_prefix or "data") + ".name", definition={'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, rule='type') + if "email" in data_keys: + data_keys.remove("email") + data__email = data["email"] + if not isinstance(data__email, (str)): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".email must be string", value=data__email, name="" + (name_prefix or "data") + ".email", definition={'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}, rule='type') + if isinstance(data__email, str): + if not REGEX_PATTERNS["idn-email_re_pattern"].match(data__email): + raise JsonSchemaValueException("" + (name_prefix or "data") + ".email must be idn-email", value=data__email, name="" + (name_prefix or "data") + ".email", definition={'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}, rule='format') + if data_keys: + raise JsonSchemaValueException("" + (name_prefix or "data") + " must not contain "+str(data_keys)+" properties", value=data, name="" + (name_prefix or "data") + "", definition={'$id': '#/definitions/author', 'title': 'Author or Maintainer', '$comment': 'https://peps.python.org/pep-0621/#authors-maintainers', 'type': 'object', 'additionalProperties': False, 'properties': {'name': {'type': 'string', '$$description': ['MUST be a valid email name, i.e. whatever can be put as a name, before an', 'email, in :rfc:`822`.']}, 'email': {'type': 'string', 'format': 'idn-email', 'description': 'MUST be a valid email address'}}}, rule='additionalProperties') + return data diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/formats.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/formats.py new file mode 100644 index 000000000..1cf4a465e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/_validate_pyproject/formats.py @@ -0,0 +1,402 @@ +""" +The functions in this module are used to validate schemas with the +`format JSON Schema keyword +`_. + +The correspondence is given by replacing the ``_`` character in the name of the +function with a ``-`` to obtain the format name and vice versa. +""" + +import builtins +import logging +import os +import re +import string +import typing +from itertools import chain as _chain + +if typing.TYPE_CHECKING: + from typing_extensions import Literal + +_logger = logging.getLogger(__name__) + +# ------------------------------------------------------------------------------------- +# PEP 440 + +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_REGEX = re.compile(r"^\s*" + VERSION_PATTERN + r"\s*$", re.X | re.I)
    +
    +
    +def pep440(version: str) -> bool:
    +    """See :ref:`PyPA's version specification `
    +    (initially introduced in :pep:`440`).
    +    """
    +    return VERSION_REGEX.match(version) is not None
    +
    +
    +# -------------------------------------------------------------------------------------
    +# PEP 508
    +
    +PEP508_IDENTIFIER_PATTERN = r"([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])"
    +PEP508_IDENTIFIER_REGEX = re.compile(f"^{PEP508_IDENTIFIER_PATTERN}$", re.I)
    +
    +
    +def pep508_identifier(name: str) -> bool:
    +    """See :ref:`PyPA's name specification `
    +    (initially introduced in :pep:`508#names`).
    +    """
    +    return PEP508_IDENTIFIER_REGEX.match(name) is not None
    +
    +
    +try:
    +    try:
    +        from packaging import requirements as _req
    +    except ImportError:  # pragma: no cover
    +        # let's try setuptools vendored version
    +        from setuptools._vendor.packaging import (  # type: ignore[no-redef]
    +            requirements as _req,
    +        )
    +
    +    def pep508(value: str) -> bool:
    +        """See :ref:`PyPA's dependency specifiers `
    +        (initially introduced in :pep:`508`).
    +        """
    +        try:
    +            _req.Requirement(value)
    +            return True
    +        except _req.InvalidRequirement:
    +            return False
    +
    +except ImportError:  # pragma: no cover
    +    _logger.warning(
    +        "Could not find an installation of `packaging`. Requirements, dependencies and "
    +        "versions might not be validated. "
    +        "To enforce validation, please install `packaging`."
    +    )
    +
    +    def pep508(value: str) -> bool:
    +        return True
    +
    +
    +def pep508_versionspec(value: str) -> bool:
    +    """Expression that can be used to specify/lock versions (including ranges)
    +    See ``versionspec`` in :ref:`PyPA's dependency specifiers
    +    ` (initially introduced in :pep:`508`).
    +    """
    +    if any(c in value for c in (";", "]", "@")):
    +        # In PEP 508:
    +        # conditional markers, extras and URL specs are not included in the
    +        # versionspec
    +        return False
    +    # Let's pretend we have a dependency called `requirement` with the given
    +    # version spec, then we can reuse the pep508 function for validation:
    +    return pep508(f"requirement{value}")
    +
    +
    +# -------------------------------------------------------------------------------------
    +# PEP 517
    +
    +
    +def pep517_backend_reference(value: str) -> bool:
    +    """See PyPA's specification for defining build-backend references
    +    introduced in :pep:`517#source-trees`.
    +
    +    This is similar to an entry-point reference (e.g., ``package.module:object``).
    +    """
    +    module, _, obj = value.partition(":")
    +    identifiers = (i.strip() for i in _chain(module.split("."), obj.split(".")))
    +    return all(python_identifier(i) for i in identifiers if i)
    +
    +
    +# -------------------------------------------------------------------------------------
    +# Classifiers - PEP 301
    +
    +
    +def _download_classifiers() -> str:
    +    import ssl
    +    from email.message import Message
    +    from urllib.request import urlopen
    +
    +    url = "https://pypi.org/pypi?:action=list_classifiers"
    +    context = ssl.create_default_context()
    +    with urlopen(url, context=context) as response:  # noqa: S310 (audit URLs)
    +        headers = Message()
    +        headers["content_type"] = response.getheader("content-type", "text/plain")
    +        return response.read().decode(headers.get_param("charset", "utf-8"))  # type: ignore[no-any-return]
    +
    +
    +class _TroveClassifier:
    +    """The ``trove_classifiers`` package is the official way of validating classifiers,
    +    however this package might not be always available.
    +    As a workaround we can still download a list from PyPI.
    +    We also don't want to be over strict about it, so simply skipping silently is an
    +    option (classifiers will be validated anyway during the upload to PyPI).
    +    """
    +
    +    downloaded: typing.Union[None, "Literal[False]", typing.Set[str]]
    +    """
    +    None => not cached yet
    +    False => unavailable
    +    set => cached values
    +    """
    +
    +    def __init__(self) -> None:
    +        self.downloaded = None
    +        self._skip_download = False
    +        self.__name__ = "trove_classifier"  # Emulate a public function
    +
    +    def _disable_download(self) -> None:
    +        # This is a private API. Only setuptools has the consent of using it.
    +        self._skip_download = True
    +
    +    def __call__(self, value: str) -> bool:
    +        if self.downloaded is False or self._skip_download is True:
    +            return True
    +
    +        if os.getenv("NO_NETWORK") or os.getenv("VALIDATE_PYPROJECT_NO_NETWORK"):
    +            self.downloaded = False
    +            msg = (
    +                "Install ``trove-classifiers`` to ensure proper validation. "
    +                "Skipping download of classifiers list from PyPI (NO_NETWORK)."
    +            )
    +            _logger.debug(msg)
    +            return True
    +
    +        if self.downloaded is None:
    +            msg = (
    +                "Install ``trove-classifiers`` to ensure proper validation. "
    +                "Meanwhile a list of classifiers will be downloaded from PyPI."
    +            )
    +            _logger.debug(msg)
    +            try:
    +                self.downloaded = set(_download_classifiers().splitlines())
    +            except Exception:
    +                self.downloaded = False
    +                _logger.debug("Problem with download, skipping validation")
    +                return True
    +
    +        return value in self.downloaded or value.lower().startswith("private ::")
    +
    +
    +try:
    +    from trove_classifiers import classifiers as _trove_classifiers
    +
    +    def trove_classifier(value: str) -> bool:
    +        """See https://pypi.org/classifiers/"""
    +        return value in _trove_classifiers or value.lower().startswith("private ::")
    +
    +except ImportError:  # pragma: no cover
    +    trove_classifier = _TroveClassifier()
    +
    +
    +# -------------------------------------------------------------------------------------
    +# Stub packages - PEP 561
    +
    +
    +def pep561_stub_name(value: str) -> bool:
    +    """Name of a directory containing type stubs.
    +    It must follow the name scheme ``-stubs`` as defined in
    +    :pep:`561#stub-only-packages`.
    +    """
    +    top, *children = value.split(".")
    +    if not top.endswith("-stubs"):
    +        return False
    +    return python_module_name(".".join([top[: -len("-stubs")], *children]))
    +
    +
    +# -------------------------------------------------------------------------------------
    +# Non-PEP related
    +
    +
    +def url(value: str) -> bool:
    +    """Valid URL (validation uses :obj:`urllib.parse`).
    +    For maximum compatibility please make sure to include a ``scheme`` prefix
    +    in your URL (e.g. ``http://``).
    +    """
    +    from urllib.parse import urlparse
    +
    +    try:
    +        parts = urlparse(value)
    +        if not parts.scheme:
    +            _logger.warning(
    +                "For maximum compatibility please make sure to include a "
    +                "`scheme` prefix in your URL (e.g. 'http://'). "
    +                f"Given value: {value}"
    +            )
    +            if not (value.startswith("/") or value.startswith("\\") or "@" in value):
    +                parts = urlparse(f"http://{value}")
    +
    +        return bool(parts.scheme and parts.netloc)
    +    except Exception:
    +        return False
    +
    +
    +# https://packaging.python.org/specifications/entry-points/
    +ENTRYPOINT_PATTERN = r"[^\[\s=]([^=]*[^\s=])?"
    +ENTRYPOINT_REGEX = re.compile(f"^{ENTRYPOINT_PATTERN}$", re.I)
    +RECOMMEDED_ENTRYPOINT_PATTERN = r"[\w.-]+"
    +RECOMMEDED_ENTRYPOINT_REGEX = re.compile(f"^{RECOMMEDED_ENTRYPOINT_PATTERN}$", re.I)
    +ENTRYPOINT_GROUP_PATTERN = r"\w+(\.\w+)*"
    +ENTRYPOINT_GROUP_REGEX = re.compile(f"^{ENTRYPOINT_GROUP_PATTERN}$", re.I)
    +
    +
    +def python_identifier(value: str) -> bool:
    +    """Can be used as identifier in Python.
    +    (Validation uses :obj:`str.isidentifier`).
    +    """
    +    return value.isidentifier()
    +
    +
    +def python_qualified_identifier(value: str) -> bool:
    +    """
    +    Python "dotted identifier", i.e. a sequence of :obj:`python_identifier`
    +    concatenated with ``"."`` (e.g.: ``package.module.submodule``).
    +    """
    +    if value.startswith(".") or value.endswith("."):
    +        return False
    +    return all(python_identifier(m) for m in value.split("."))
    +
    +
    +def python_module_name(value: str) -> bool:
    +    """Module name that can be used in an ``import``-statement in Python.
    +    See :obj:`python_qualified_identifier`.
    +    """
    +    return python_qualified_identifier(value)
    +
    +
    +def python_module_name_relaxed(value: str) -> bool:
    +    """Similar to :obj:`python_module_name`, but relaxed to also accept
    +    dash characters (``-``) and cover special cases like ``pip-run``.
    +
    +    It is recommended, however, that beginners avoid dash characters,
    +    as they require advanced knowledge about Python internals.
    +
    +    The following are disallowed:
    +
    +    * names starting/ending in dashes,
    +    * names ending in ``-stubs`` (potentially collide with :obj:`pep561_stub_name`).
    +    """
    +    if value.startswith("-") or value.endswith("-"):
    +        return False
    +    if value.endswith("-stubs"):
    +        return False  # Avoid collision with PEP 561
    +    return python_module_name(value.replace("-", "_"))
    +
    +
    +def python_entrypoint_group(value: str) -> bool:
    +    """See ``Data model > group`` in the :ref:`PyPA's entry-points specification
    +    `.
    +    """
    +    return ENTRYPOINT_GROUP_REGEX.match(value) is not None
    +
    +
    +def python_entrypoint_name(value: str) -> bool:
    +    """See ``Data model > name`` in the :ref:`PyPA's entry-points specification
    +    `.
    +    """
    +    if not ENTRYPOINT_REGEX.match(value):
    +        return False
    +    if not RECOMMEDED_ENTRYPOINT_REGEX.match(value):
    +        msg = f"Entry point `{value}` does not follow recommended pattern: "
    +        msg += RECOMMEDED_ENTRYPOINT_PATTERN
    +        _logger.warning(msg)
    +    return True
    +
    +
    +def python_entrypoint_reference(value: str) -> bool:
    +    """Reference to a Python object using in the format::
    +
    +        importable.module:object.attr
    +
    +    See ``Data model >object reference`` in the :ref:`PyPA's entry-points specification
    +    `.
    +    """
    +    module, _, rest = value.partition(":")
    +    if "[" in rest:
    +        obj, _, extras_ = rest.partition("[")
    +        if extras_.strip()[-1] != "]":
    +            return False
    +        extras = (x.strip() for x in extras_.strip(string.whitespace + "[]").split(","))
    +        if not all(pep508_identifier(e) for e in extras):
    +            return False
    +        _logger.warning(f"`{value}` - using extras for entry points is not recommended")
    +    else:
    +        obj = rest
    +
    +    module_parts = module.split(".")
    +    identifiers = _chain(module_parts, obj.split(".")) if rest else iter(module_parts)
    +    return all(python_identifier(i.strip()) for i in identifiers)
    +
    +
    +def uint8(value: builtins.int) -> bool:
    +    r"""Unsigned 8-bit integer (:math:`0 \leq x < 2^8`)"""
    +    return 0 <= value < 2**8
    +
    +
    +def uint16(value: builtins.int) -> bool:
    +    r"""Unsigned 16-bit integer (:math:`0 \leq x < 2^{16}`)"""
    +    return 0 <= value < 2**16
    +
    +
    +def uint(value: builtins.int) -> bool:
    +    r"""Unsigned 64-bit integer (:math:`0 \leq x < 2^{64}`)"""
    +    return 0 <= value < 2**64
    +
    +
    +def int(value: builtins.int) -> bool:
    +    r"""Signed 64-bit integer (:math:`-2^{63} \leq x < 2^{63}`)"""
    +    return -(2**63) <= value < 2**63
    +
    +
    +try:
    +    from packaging import licenses as _licenses
    +
    +    def SPDX(value: str) -> bool:
    +        """See :ref:`PyPA's License-Expression specification
    +        ` (added in :pep:`639`).
    +        """
    +        try:
    +            _licenses.canonicalize_license_expression(value)
    +            return True
    +        except _licenses.InvalidLicenseExpression:
    +            return False
    +
    +except ImportError:  # pragma: no cover
    +    _logger.warning(
    +        "Could not find an up-to-date installation of `packaging`. "
    +        "License expressions might not be validated. "
    +        "To enforce validation, please install `packaging>=24.2`."
    +    )
    +
    +    def SPDX(value: str) -> bool:
    +        return True
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/distutils.schema.json b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/distutils.schema.json
    new file mode 100644
    index 000000000..93cd2e868
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/distutils.schema.json
    @@ -0,0 +1,26 @@
    +{
    +  "$schema": "http://json-schema.org/draft-07/schema#",
    +
    +  "$id": "https://setuptools.pypa.io/en/latest/deprecated/distutils/configfile.html",
    +  "title": "``tool.distutils`` table",
    +  "$$description": [
    +    "**EXPERIMENTAL** (NOT OFFICIALLY SUPPORTED): Use ``tool.distutils``",
    +    "subtables to configure arguments for ``distutils`` commands.",
    +    "Originally, ``distutils`` allowed developers to configure arguments for",
    +    "``setup.py`` commands via `distutils configuration files",
    +    "`_.",
    +    "See also `the old Python docs _`."
    +  ],
    +
    +  "type": "object",
    +  "properties": {
    +    "global": {
    +      "type": "object",
    +      "description": "Global options applied to all ``distutils`` commands"
    +    }
    +  },
    +  "patternProperties": {
    +    ".+": {"type": "object"}
    +  },
    +  "$comment": "TODO: Is there a practical way of making this schema more specific?"
    +}
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/expand.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/expand.py
    new file mode 100644
    index 000000000..531f96501
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/expand.py
    @@ -0,0 +1,452 @@
    +"""Utility functions to expand configuration directives or special values
    +(such glob patterns).
    +
    +We can split the process of interpreting configuration files into 2 steps:
    +
    +1. The parsing the file contents from strings to value objects
    +   that can be understand by Python (for example a string with a comma
    +   separated list of keywords into an actual Python list of strings).
    +
    +2. The expansion (or post-processing) of these values according to the
    +   semantics ``setuptools`` assign to them (for example a configuration field
    +   with the ``file:`` directive should be expanded from a list of file paths to
    +   a single string with the contents of those files concatenated)
    +
    +This module focus on the second step, and therefore allow sharing the expansion
    +functions among several configuration file formats.
    +
    +**PRIVATE MODULE**: API reserved for setuptools internal usage only.
    +"""
    +
    +from __future__ import annotations
    +
    +import ast
    +import importlib
    +import os
    +import pathlib
    +import sys
    +from collections.abc import Iterable, Iterator, Mapping
    +from configparser import ConfigParser
    +from glob import iglob
    +from importlib.machinery import ModuleSpec, all_suffixes
    +from itertools import chain
    +from pathlib import Path
    +from types import ModuleType, TracebackType
    +from typing import TYPE_CHECKING, Any, Callable, TypeVar
    +
    +from .. import _static
    +from .._path import StrPath, same_path as _same_path
    +from ..discovery import find_package_path
    +from ..warnings import SetuptoolsWarning
    +
    +from distutils.errors import DistutilsOptionError
    +
    +if TYPE_CHECKING:
    +    from typing_extensions import Self
    +
    +    from setuptools.dist import Distribution
    +
    +_K = TypeVar("_K")
    +_V_co = TypeVar("_V_co", covariant=True)
    +
    +
    +class StaticModule:
    +    """Proxy to a module object that avoids executing arbitrary code."""
    +
    +    def __init__(self, name: str, spec: ModuleSpec) -> None:
    +        module = ast.parse(pathlib.Path(spec.origin).read_bytes())  # type: ignore[arg-type] # Let it raise an error on None
    +        vars(self).update(locals())
    +        del self.self
    +
    +    def _find_assignments(self) -> Iterator[tuple[ast.AST, ast.AST]]:
    +        for statement in self.module.body:
    +            if isinstance(statement, ast.Assign):
    +                yield from ((target, statement.value) for target in statement.targets)
    +            elif isinstance(statement, ast.AnnAssign) and statement.value:
    +                yield (statement.target, statement.value)
    +
    +    def __getattr__(self, attr: str):
    +        """Attempt to load an attribute "statically", via :func:`ast.literal_eval`."""
    +        try:
    +            return next(
    +                ast.literal_eval(value)
    +                for target, value in self._find_assignments()
    +                if isinstance(target, ast.Name) and target.id == attr
    +            )
    +        except Exception as e:
    +            raise AttributeError(f"{self.name} has no attribute {attr}") from e
    +
    +
    +def glob_relative(
    +    patterns: Iterable[str], root_dir: StrPath | None = None
    +) -> list[str]:
    +    """Expand the list of glob patterns, but preserving relative paths.
    +
    +    :param list[str] patterns: List of glob patterns
    +    :param str root_dir: Path to which globs should be relative
    +                         (current directory by default)
    +    :rtype: list
    +    """
    +    glob_characters = {'*', '?', '[', ']', '{', '}'}
    +    expanded_values = []
    +    root_dir = root_dir or os.getcwd()
    +    for value in patterns:
    +        # Has globby characters?
    +        if any(char in value for char in glob_characters):
    +            # then expand the glob pattern while keeping paths *relative*:
    +            glob_path = os.path.abspath(os.path.join(root_dir, value))
    +            expanded_values.extend(
    +                sorted(
    +                    os.path.relpath(path, root_dir).replace(os.sep, "/")
    +                    for path in iglob(glob_path, recursive=True)
    +                )
    +            )
    +
    +        else:
    +            # take the value as-is
    +            path = os.path.relpath(value, root_dir).replace(os.sep, "/")
    +            expanded_values.append(path)
    +
    +    return expanded_values
    +
    +
    +def read_files(
    +    filepaths: StrPath | Iterable[StrPath], root_dir: StrPath | None = None
    +) -> str:
    +    """Return the content of the files concatenated using ``\n`` as str
    +
    +    This function is sandboxed and won't reach anything outside ``root_dir``
    +
    +    (By default ``root_dir`` is the current directory).
    +    """
    +    from more_itertools import always_iterable
    +
    +    root_dir = os.path.abspath(root_dir or os.getcwd())
    +    _filepaths = (os.path.join(root_dir, path) for path in always_iterable(filepaths))
    +    return '\n'.join(
    +        _read_file(path)
    +        for path in _filter_existing_files(_filepaths)
    +        if _assert_local(path, root_dir)
    +    )
    +
    +
    +def _filter_existing_files(filepaths: Iterable[StrPath]) -> Iterator[StrPath]:
    +    for path in filepaths:
    +        if os.path.isfile(path):
    +            yield path
    +        else:
    +            SetuptoolsWarning.emit(f"File {path!r} cannot be found")
    +
    +
    +def _read_file(filepath: bytes | StrPath) -> str:
    +    with open(filepath, encoding='utf-8') as f:
    +        return f.read()
    +
    +
    +def _assert_local(filepath: StrPath, root_dir: str):
    +    if Path(os.path.abspath(root_dir)) not in Path(os.path.abspath(filepath)).parents:
    +        msg = f"Cannot access {filepath!r} (or anything outside {root_dir!r})"
    +        raise DistutilsOptionError(msg)
    +
    +    return True
    +
    +
    +def read_attr(
    +    attr_desc: str,
    +    package_dir: Mapping[str, str] | None = None,
    +    root_dir: StrPath | None = None,
    +) -> Any:
    +    """Reads the value of an attribute from a module.
    +
    +    This function will try to read the attributed statically first
    +    (via :func:`ast.literal_eval`), and only evaluate the module if it fails.
    +
    +    Examples:
    +        read_attr("package.attr")
    +        read_attr("package.module.attr")
    +
    +    :param str attr_desc: Dot-separated string describing how to reach the
    +        attribute (see examples above)
    +    :param dict[str, str] package_dir: Mapping of package names to their
    +        location in disk (represented by paths relative to ``root_dir``).
    +    :param str root_dir: Path to directory containing all the packages in
    +        ``package_dir`` (current directory by default).
    +    :rtype: str
    +    """
    +    root_dir = root_dir or os.getcwd()
    +    attrs_path = attr_desc.strip().split('.')
    +    attr_name = attrs_path.pop()
    +    module_name = '.'.join(attrs_path)
    +    module_name = module_name or '__init__'
    +    path = _find_module(module_name, package_dir, root_dir)
    +    spec = _find_spec(module_name, path)
    +
    +    try:
    +        value = getattr(StaticModule(module_name, spec), attr_name)
    +        # XXX: Is marking as static contents coming from modules too optimistic?
    +        return _static.attempt_conversion(value)
    +    except Exception:
    +        # fallback to evaluate module
    +        module = _load_spec(spec, module_name)
    +        return getattr(module, attr_name)
    +
    +
    +def _find_spec(module_name: str, module_path: StrPath | None) -> ModuleSpec:
    +    spec = importlib.util.spec_from_file_location(module_name, module_path)
    +    spec = spec or importlib.util.find_spec(module_name)
    +
    +    if spec is None:
    +        raise ModuleNotFoundError(module_name)
    +
    +    return spec
    +
    +
    +def _load_spec(spec: ModuleSpec, module_name: str) -> ModuleType:
    +    name = getattr(spec, "__name__", module_name)
    +    if name in sys.modules:
    +        return sys.modules[name]
    +    module = importlib.util.module_from_spec(spec)
    +    sys.modules[name] = module  # cache (it also ensures `==` works on loaded items)
    +    assert spec.loader is not None
    +    spec.loader.exec_module(module)
    +    return module
    +
    +
    +def _find_module(
    +    module_name: str, package_dir: Mapping[str, str] | None, root_dir: StrPath
    +) -> str | None:
    +    """Find the path to the module named ``module_name``,
    +    considering the ``package_dir`` in the build configuration and ``root_dir``.
    +
    +    >>> tmp = getfixture('tmpdir')
    +    >>> _ = tmp.ensure("a/b/c.py")
    +    >>> _ = tmp.ensure("a/b/d/__init__.py")
    +    >>> r = lambda x: x.replace(str(tmp), "tmp").replace(os.sep, "/")
    +    >>> r(_find_module("a.b.c", None, tmp))
    +    'tmp/a/b/c.py'
    +    >>> r(_find_module("f.g.h", {"": "1", "f": "2", "f.g": "3", "f.g.h": "a/b/d"}, tmp))
    +    'tmp/a/b/d/__init__.py'
    +    """
    +    path_start = find_package_path(module_name, package_dir or {}, root_dir)
    +    candidates = chain.from_iterable(
    +        (f"{path_start}{ext}", os.path.join(path_start, f"__init__{ext}"))
    +        for ext in all_suffixes()
    +    )
    +    return next((x for x in candidates if os.path.isfile(x)), None)
    +
    +
    +def resolve_class(
    +    qualified_class_name: str,
    +    package_dir: Mapping[str, str] | None = None,
    +    root_dir: StrPath | None = None,
    +) -> Callable:
    +    """Given a qualified class name, return the associated class object"""
    +    root_dir = root_dir or os.getcwd()
    +    idx = qualified_class_name.rfind('.')
    +    class_name = qualified_class_name[idx + 1 :]
    +    pkg_name = qualified_class_name[:idx]
    +
    +    path = _find_module(pkg_name, package_dir, root_dir)
    +    module = _load_spec(_find_spec(pkg_name, path), pkg_name)
    +    return getattr(module, class_name)
    +
    +
    +def cmdclass(
    +    values: dict[str, str],
    +    package_dir: Mapping[str, str] | None = None,
    +    root_dir: StrPath | None = None,
    +) -> dict[str, Callable]:
    +    """Given a dictionary mapping command names to strings for qualified class
    +    names, apply :func:`resolve_class` to the dict values.
    +    """
    +    return {k: resolve_class(v, package_dir, root_dir) for k, v in values.items()}
    +
    +
    +def find_packages(
    +    *,
    +    namespaces=True,
    +    fill_package_dir: dict[str, str] | None = None,
    +    root_dir: StrPath | None = None,
    +    **kwargs,
    +) -> list[str]:
    +    """Works similarly to :func:`setuptools.find_packages`, but with all
    +    arguments given as keyword arguments. Moreover, ``where`` can be given
    +    as a list (the results will be simply concatenated).
    +
    +    When the additional keyword argument ``namespaces`` is ``True``, it will
    +    behave like :func:`setuptools.find_namespace_packages`` (i.e. include
    +    implicit namespaces as per :pep:`420`).
    +
    +    The ``where`` argument will be considered relative to ``root_dir`` (or the current
    +    working directory when ``root_dir`` is not given).
    +
    +    If the ``fill_package_dir`` argument is passed, this function will consider it as a
    +    similar data structure to the ``package_dir`` configuration parameter add fill-in
    +    any missing package location.
    +
    +    :rtype: list
    +    """
    +    from more_itertools import always_iterable, unique_everseen
    +
    +    from setuptools.discovery import construct_package_dir
    +
    +    # check "not namespaces" first due to python/mypy#6232
    +    if not namespaces:
    +        from setuptools.discovery import PackageFinder
    +    else:
    +        from setuptools.discovery import PEP420PackageFinder as PackageFinder
    +
    +    root_dir = root_dir or os.curdir
    +    where = kwargs.pop('where', ['.'])
    +    packages: list[str] = []
    +    fill_package_dir = {} if fill_package_dir is None else fill_package_dir
    +    search = list(unique_everseen(always_iterable(where)))
    +
    +    if len(search) == 1 and all(not _same_path(search[0], x) for x in (".", root_dir)):
    +        fill_package_dir.setdefault("", search[0])
    +
    +    for path in search:
    +        package_path = _nest_path(root_dir, path)
    +        pkgs = PackageFinder.find(package_path, **kwargs)
    +        packages.extend(pkgs)
    +        if pkgs and not (
    +            fill_package_dir.get("") == path or os.path.samefile(package_path, root_dir)
    +        ):
    +            fill_package_dir.update(construct_package_dir(pkgs, path))
    +
    +    return packages
    +
    +
    +def _nest_path(parent: StrPath, path: StrPath) -> str:
    +    path = parent if path in {".", ""} else os.path.join(parent, path)
    +    return os.path.normpath(path)
    +
    +
    +def version(value: Callable | Iterable[str | int] | str) -> str:
    +    """When getting the version directly from an attribute,
    +    it should be normalised to string.
    +    """
    +    _value = value() if callable(value) else value
    +
    +    if isinstance(_value, str):
    +        return _value
    +    if hasattr(_value, '__iter__'):
    +        return '.'.join(map(str, _value))
    +    return f'{_value}'
    +
    +
    +def canonic_package_data(package_data: dict) -> dict:
    +    if "*" in package_data:
    +        package_data[""] = package_data.pop("*")
    +    return package_data
    +
    +
    +def canonic_data_files(
    +    data_files: list | dict, root_dir: StrPath | None = None
    +) -> list[tuple[str, list[str]]]:
    +    """For compatibility with ``setup.py``, ``data_files`` should be a list
    +    of pairs instead of a dict.
    +
    +    This function also expands glob patterns.
    +    """
    +    if isinstance(data_files, list):
    +        return data_files
    +
    +    return [
    +        (dest, glob_relative(patterns, root_dir))
    +        for dest, patterns in data_files.items()
    +    ]
    +
    +
    +def entry_points(
    +    text: str, text_source: str = "entry-points"
    +) -> dict[str, dict[str, str]]:
    +    """Given the contents of entry-points file,
    +    process it into a 2-level dictionary (``dict[str, dict[str, str]]``).
    +    The first level keys are entry-point groups, the second level keys are
    +    entry-point names, and the second level values are references to objects
    +    (that correspond to the entry-point value).
    +    """
    +    # Using undocumented behaviour, see python/typeshed#12700
    +    parser = ConfigParser(default_section=None, delimiters=("=",))  # type: ignore[call-overload]
    +    parser.optionxform = str  # case sensitive
    +    parser.read_string(text, text_source)
    +    groups = {k: dict(v.items()) for k, v in parser.items()}
    +    groups.pop(parser.default_section, None)
    +    return groups
    +
    +
    +class EnsurePackagesDiscovered:
    +    """Some expand functions require all the packages to already be discovered before
    +    they run, e.g. :func:`read_attr`, :func:`resolve_class`, :func:`cmdclass`.
    +
    +    Therefore in some cases we will need to run autodiscovery during the evaluation of
    +    the configuration. However, it is better to postpone calling package discovery as
    +    much as possible, because some parameters can influence it (e.g. ``package_dir``),
    +    and those might not have been processed yet.
    +    """
    +
    +    def __init__(self, distribution: Distribution) -> None:
    +        self._dist = distribution
    +        self._called = False
    +
    +    def __call__(self):
    +        """Trigger the automatic package discovery, if it is still necessary."""
    +        if not self._called:
    +            self._called = True
    +            self._dist.set_defaults(name=False)  # Skip name, we can still be parsing
    +
    +    def __enter__(self) -> Self:
    +        return self
    +
    +    def __exit__(
    +        self,
    +        exc_type: type[BaseException] | None,
    +        exc_value: BaseException | None,
    +        traceback: TracebackType | None,
    +    ):
    +        if self._called:
    +            self._dist.set_defaults.analyse_name()  # Now we can set a default name
    +
    +    def _get_package_dir(self) -> Mapping[str, str]:
    +        self()
    +        pkg_dir = self._dist.package_dir
    +        return {} if pkg_dir is None else pkg_dir
    +
    +    @property
    +    def package_dir(self) -> Mapping[str, str]:
    +        """Proxy to ``package_dir`` that may trigger auto-discovery when used."""
    +        return LazyMappingProxy(self._get_package_dir)
    +
    +
    +class LazyMappingProxy(Mapping[_K, _V_co]):
    +    """Mapping proxy that delays resolving the target object, until really needed.
    +
    +    >>> def obtain_mapping():
    +    ...     print("Running expensive function!")
    +    ...     return {"key": "value", "other key": "other value"}
    +    >>> mapping = LazyMappingProxy(obtain_mapping)
    +    >>> mapping["key"]
    +    Running expensive function!
    +    'value'
    +    >>> mapping["other key"]
    +    'other value'
    +    """
    +
    +    def __init__(self, obtain_mapping_value: Callable[[], Mapping[_K, _V_co]]) -> None:
    +        self._obtain = obtain_mapping_value
    +        self._value: Mapping[_K, _V_co] | None = None
    +
    +    def _target(self) -> Mapping[_K, _V_co]:
    +        if self._value is None:
    +            self._value = self._obtain()
    +        return self._value
    +
    +    def __getitem__(self, key: _K) -> _V_co:
    +        return self._target()[key]
    +
    +    def __len__(self) -> int:
    +        return len(self._target())
    +
    +    def __iter__(self) -> Iterator[_K]:
    +        return iter(self._target())
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/pyprojecttoml.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/pyprojecttoml.py
    new file mode 100644
    index 000000000..fd6c5968c
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/pyprojecttoml.py
    @@ -0,0 +1,468 @@
    +"""
    +Load setuptools configuration from ``pyproject.toml`` files.
    +
    +**PRIVATE MODULE**: API reserved for setuptools internal usage only.
    +
    +To read project metadata, consider using
    +``build.util.project_wheel_metadata`` (https://pypi.org/project/build/).
    +For simple scenarios, you can also try parsing the file directly
    +with the help of ``tomllib`` or ``tomli``.
    +"""
    +
    +from __future__ import annotations
    +
    +import logging
    +import os
    +from collections.abc import Mapping
    +from contextlib import contextmanager
    +from functools import partial
    +from types import TracebackType
    +from typing import TYPE_CHECKING, Any, Callable
    +
    +from .._path import StrPath
    +from ..errors import FileError, InvalidConfigError
    +from ..warnings import SetuptoolsWarning
    +from . import expand as _expand
    +from ._apply_pyprojecttoml import _PREVIOUSLY_DEFINED, _MissingDynamic, apply as _apply
    +
    +if TYPE_CHECKING:
    +    from typing_extensions import Self
    +
    +    from setuptools.dist import Distribution
    +
    +_logger = logging.getLogger(__name__)
    +
    +
    +def load_file(filepath: StrPath) -> dict:
    +    from ..compat.py310 import tomllib
    +
    +    with open(filepath, "rb") as file:
    +        return tomllib.load(file)
    +
    +
    +def validate(config: dict, filepath: StrPath) -> bool:
    +    from . import _validate_pyproject as validator
    +
    +    trove_classifier = validator.FORMAT_FUNCTIONS.get("trove-classifier")
    +    if hasattr(trove_classifier, "_disable_download"):
    +        # Improve reproducibility by default. See abravalheri/validate-pyproject#31
    +        trove_classifier._disable_download()  # type: ignore[union-attr]
    +
    +    try:
    +        return validator.validate(config)
    +    except validator.ValidationError as ex:
    +        summary = f"configuration error: {ex.summary}"
    +        if ex.name.strip("`") != "project":
    +            # Probably it is just a field missing/misnamed, not worthy the verbosity...
    +            _logger.debug(summary)
    +            _logger.debug(ex.details)
    +
    +        error = f"invalid pyproject.toml config: {ex.name}."
    +        raise ValueError(f"{error}\n{summary}") from None
    +
    +
    +def apply_configuration(
    +    dist: Distribution,
    +    filepath: StrPath,
    +    ignore_option_errors: bool = False,
    +) -> Distribution:
    +    """Apply the configuration from a ``pyproject.toml`` file into an existing
    +    distribution object.
    +    """
    +    config = read_configuration(filepath, True, ignore_option_errors, dist)
    +    return _apply(dist, config, filepath)
    +
    +
    +def read_configuration(
    +    filepath: StrPath,
    +    expand: bool = True,
    +    ignore_option_errors: bool = False,
    +    dist: Distribution | None = None,
    +) -> dict[str, Any]:
    +    """Read given configuration file and returns options from it as a dict.
    +
    +    :param str|unicode filepath: Path to configuration file in the ``pyproject.toml``
    +        format.
    +
    +    :param bool expand: Whether to expand directives and other computed values
    +        (i.e. post-process the given configuration)
    +
    +    :param bool ignore_option_errors: Whether to silently ignore
    +        options, values of which could not be resolved (e.g. due to exceptions
    +        in directives such as file:, attr:, etc.).
    +        If False exceptions are propagated as expected.
    +
    +    :param Distribution|None: Distribution object to which the configuration refers.
    +        If not given a dummy object will be created and discarded after the
    +        configuration is read. This is used for auto-discovery of packages and in the
    +        case a dynamic configuration (e.g. ``attr`` or ``cmdclass``) is expanded.
    +        When ``expand=False`` this object is simply ignored.
    +
    +    :rtype: dict
    +    """
    +    filepath = os.path.abspath(filepath)
    +
    +    if not os.path.isfile(filepath):
    +        raise FileError(f"Configuration file {filepath!r} does not exist.")
    +
    +    asdict = load_file(filepath) or {}
    +    project_table = asdict.get("project", {})
    +    tool_table = asdict.get("tool", {})
    +    setuptools_table = tool_table.get("setuptools", {})
    +    if not asdict or not (project_table or setuptools_table):
    +        return {}  # User is not using pyproject to configure setuptools
    +
    +    if "setuptools" in asdict.get("tools", {}):
    +        # let the user know they probably have a typo in their metadata
    +        _ToolsTypoInMetadata.emit()
    +
    +    if "distutils" in tool_table:
    +        _ExperimentalConfiguration.emit(subject="[tool.distutils]")
    +
    +    # There is an overall sense in the community that making include_package_data=True
    +    # the default would be an improvement.
    +    # `ini2toml` backfills include_package_data=False when nothing is explicitly given,
    +    # therefore setting a default here is backwards compatible.
    +    if dist and dist.include_package_data is not None:
    +        setuptools_table.setdefault("include-package-data", dist.include_package_data)
    +    else:
    +        setuptools_table.setdefault("include-package-data", True)
    +    # Persist changes:
    +    asdict["tool"] = tool_table
    +    tool_table["setuptools"] = setuptools_table
    +
    +    if "ext-modules" in setuptools_table:
    +        _ExperimentalConfiguration.emit(subject="[tool.setuptools.ext-modules]")
    +
    +    with _ignore_errors(ignore_option_errors):
    +        # Don't complain about unrelated errors (e.g. tools not using the "tool" table)
    +        subset = {"project": project_table, "tool": {"setuptools": setuptools_table}}
    +        validate(subset, filepath)
    +
    +    if expand:
    +        root_dir = os.path.dirname(filepath)
    +        return expand_configuration(asdict, root_dir, ignore_option_errors, dist)
    +
    +    return asdict
    +
    +
    +def expand_configuration(
    +    config: dict,
    +    root_dir: StrPath | None = None,
    +    ignore_option_errors: bool = False,
    +    dist: Distribution | None = None,
    +) -> dict:
    +    """Given a configuration with unresolved fields (e.g. dynamic, cmdclass, ...)
    +    find their final values.
    +
    +    :param dict config: Dict containing the configuration for the distribution
    +    :param str root_dir: Top-level directory for the distribution/project
    +        (the same directory where ``pyproject.toml`` is place)
    +    :param bool ignore_option_errors: see :func:`read_configuration`
    +    :param Distribution|None: Distribution object to which the configuration refers.
    +        If not given a dummy object will be created and discarded after the
    +        configuration is read. Used in the case a dynamic configuration
    +        (e.g. ``attr`` or ``cmdclass``).
    +
    +    :rtype: dict
    +    """
    +    return _ConfigExpander(config, root_dir, ignore_option_errors, dist).expand()
    +
    +
    +class _ConfigExpander:
    +    def __init__(
    +        self,
    +        config: dict,
    +        root_dir: StrPath | None = None,
    +        ignore_option_errors: bool = False,
    +        dist: Distribution | None = None,
    +    ) -> None:
    +        self.config = config
    +        self.root_dir = root_dir or os.getcwd()
    +        self.project_cfg = config.get("project", {})
    +        self.dynamic = self.project_cfg.get("dynamic", [])
    +        self.setuptools_cfg = config.get("tool", {}).get("setuptools", {})
    +        self.dynamic_cfg = self.setuptools_cfg.get("dynamic", {})
    +        self.ignore_option_errors = ignore_option_errors
    +        self._dist = dist
    +        self._referenced_files = set[str]()
    +
    +    def _ensure_dist(self) -> Distribution:
    +        from setuptools.dist import Distribution
    +
    +        attrs = {"src_root": self.root_dir, "name": self.project_cfg.get("name", None)}
    +        return self._dist or Distribution(attrs)
    +
    +    def _process_field(self, container: dict, field: str, fn: Callable):
    +        if field in container:
    +            with _ignore_errors(self.ignore_option_errors):
    +                container[field] = fn(container[field])
    +
    +    def _canonic_package_data(self, field="package-data"):
    +        package_data = self.setuptools_cfg.get(field, {})
    +        return _expand.canonic_package_data(package_data)
    +
    +    def expand(self):
    +        self._expand_packages()
    +        self._canonic_package_data()
    +        self._canonic_package_data("exclude-package-data")
    +
    +        # A distribution object is required for discovering the correct package_dir
    +        dist = self._ensure_dist()
    +        ctx = _EnsurePackagesDiscovered(dist, self.project_cfg, self.setuptools_cfg)
    +        with ctx as ensure_discovered:
    +            package_dir = ensure_discovered.package_dir
    +            self._expand_data_files()
    +            self._expand_cmdclass(package_dir)
    +            self._expand_all_dynamic(dist, package_dir)
    +
    +        dist._referenced_files.update(self._referenced_files)
    +        return self.config
    +
    +    def _expand_packages(self):
    +        packages = self.setuptools_cfg.get("packages")
    +        if packages is None or isinstance(packages, (list, tuple)):
    +            return
    +
    +        find = packages.get("find")
    +        if isinstance(find, dict):
    +            find["root_dir"] = self.root_dir
    +            find["fill_package_dir"] = self.setuptools_cfg.setdefault("package-dir", {})
    +            with _ignore_errors(self.ignore_option_errors):
    +                self.setuptools_cfg["packages"] = _expand.find_packages(**find)
    +
    +    def _expand_data_files(self):
    +        data_files = partial(_expand.canonic_data_files, root_dir=self.root_dir)
    +        self._process_field(self.setuptools_cfg, "data-files", data_files)
    +
    +    def _expand_cmdclass(self, package_dir: Mapping[str, str]):
    +        root_dir = self.root_dir
    +        cmdclass = partial(_expand.cmdclass, package_dir=package_dir, root_dir=root_dir)
    +        self._process_field(self.setuptools_cfg, "cmdclass", cmdclass)
    +
    +    def _expand_all_dynamic(self, dist: Distribution, package_dir: Mapping[str, str]):
    +        special = (  # need special handling
    +            "version",
    +            "readme",
    +            "entry-points",
    +            "scripts",
    +            "gui-scripts",
    +            "classifiers",
    +            "dependencies",
    +            "optional-dependencies",
    +        )
    +        # `_obtain` functions are assumed to raise appropriate exceptions/warnings.
    +        obtained_dynamic = {
    +            field: self._obtain(dist, field, package_dir)
    +            for field in self.dynamic
    +            if field not in special
    +        }
    +        obtained_dynamic.update(
    +            self._obtain_entry_points(dist, package_dir) or {},
    +            version=self._obtain_version(dist, package_dir),
    +            readme=self._obtain_readme(dist),
    +            classifiers=self._obtain_classifiers(dist),
    +            dependencies=self._obtain_dependencies(dist),
    +            optional_dependencies=self._obtain_optional_dependencies(dist),
    +        )
    +        # `None` indicates there is nothing in `tool.setuptools.dynamic` but the value
    +        # might have already been set by setup.py/extensions, so avoid overwriting.
    +        updates = {k: v for k, v in obtained_dynamic.items() if v is not None}
    +        self.project_cfg.update(updates)
    +
    +    def _ensure_previously_set(self, dist: Distribution, field: str):
    +        previous = _PREVIOUSLY_DEFINED[field](dist)
    +        if previous is None and not self.ignore_option_errors:
    +            msg = (
    +                f"No configuration found for dynamic {field!r}.\n"
    +                "Some dynamic fields need to be specified via `tool.setuptools.dynamic`"
    +                "\nothers must be specified via the equivalent attribute in `setup.py`."
    +            )
    +            raise InvalidConfigError(msg)
    +
    +    def _expand_directive(
    +        self, specifier: str, directive, package_dir: Mapping[str, str]
    +    ):
    +        from more_itertools import always_iterable
    +
    +        with _ignore_errors(self.ignore_option_errors):
    +            root_dir = self.root_dir
    +            if "file" in directive:
    +                self._referenced_files.update(always_iterable(directive["file"]))
    +                return _expand.read_files(directive["file"], root_dir)
    +            if "attr" in directive:
    +                return _expand.read_attr(directive["attr"], package_dir, root_dir)
    +            raise ValueError(f"invalid `{specifier}`: {directive!r}")
    +        return None
    +
    +    def _obtain(self, dist: Distribution, field: str, package_dir: Mapping[str, str]):
    +        if field in self.dynamic_cfg:
    +            return self._expand_directive(
    +                f"tool.setuptools.dynamic.{field}",
    +                self.dynamic_cfg[field],
    +                package_dir,
    +            )
    +        self._ensure_previously_set(dist, field)
    +        return None
    +
    +    def _obtain_version(self, dist: Distribution, package_dir: Mapping[str, str]):
    +        # Since plugins can set version, let's silently skip if it cannot be obtained
    +        if "version" in self.dynamic and "version" in self.dynamic_cfg:
    +            return _expand.version(
    +                # We already do an early check for the presence of "version"
    +                self._obtain(dist, "version", package_dir)  # pyright: ignore[reportArgumentType]
    +            )
    +        return None
    +
    +    def _obtain_readme(self, dist: Distribution) -> dict[str, str] | None:
    +        if "readme" not in self.dynamic:
    +            return None
    +
    +        dynamic_cfg = self.dynamic_cfg
    +        if "readme" in dynamic_cfg:
    +            return {
    +                # We already do an early check for the presence of "readme"
    +                "text": self._obtain(dist, "readme", {}),
    +                "content-type": dynamic_cfg["readme"].get("content-type", "text/x-rst"),
    +            }  # pyright: ignore[reportReturnType]
    +
    +        self._ensure_previously_set(dist, "readme")
    +        return None
    +
    +    def _obtain_entry_points(
    +        self, dist: Distribution, package_dir: Mapping[str, str]
    +    ) -> dict[str, dict[str, Any]] | None:
    +        fields = ("entry-points", "scripts", "gui-scripts")
    +        if not any(field in self.dynamic for field in fields):
    +            return None
    +
    +        text = self._obtain(dist, "entry-points", package_dir)
    +        if text is None:
    +            return None
    +
    +        groups = _expand.entry_points(text)
    +        # Any is str | dict[str, str], but causes variance issues
    +        expanded: dict[str, dict[str, Any]] = {"entry-points": groups}
    +
    +        def _set_scripts(field: str, group: str):
    +            if group in groups:
    +                value = groups.pop(group)
    +                if field not in self.dynamic:
    +                    raise InvalidConfigError(_MissingDynamic.details(field, value))
    +                expanded[field] = value
    +
    +        _set_scripts("scripts", "console_scripts")
    +        _set_scripts("gui-scripts", "gui_scripts")
    +
    +        return expanded
    +
    +    def _obtain_classifiers(self, dist: Distribution):
    +        if "classifiers" in self.dynamic:
    +            value = self._obtain(dist, "classifiers", {})
    +            if value:
    +                return value.splitlines()
    +        return None
    +
    +    def _obtain_dependencies(self, dist: Distribution):
    +        if "dependencies" in self.dynamic:
    +            value = self._obtain(dist, "dependencies", {})
    +            if value:
    +                return _parse_requirements_list(value)
    +        return None
    +
    +    def _obtain_optional_dependencies(self, dist: Distribution):
    +        if "optional-dependencies" not in self.dynamic:
    +            return None
    +        if "optional-dependencies" in self.dynamic_cfg:
    +            optional_dependencies_map = self.dynamic_cfg["optional-dependencies"]
    +            assert isinstance(optional_dependencies_map, dict)
    +            return {
    +                group: _parse_requirements_list(
    +                    self._expand_directive(
    +                        f"tool.setuptools.dynamic.optional-dependencies.{group}",
    +                        directive,
    +                        {},
    +                    )
    +                )
    +                for group, directive in optional_dependencies_map.items()
    +            }
    +        self._ensure_previously_set(dist, "optional-dependencies")
    +        return None
    +
    +
    +def _parse_requirements_list(value):
    +    return [
    +        line
    +        for line in value.splitlines()
    +        if line.strip() and not line.strip().startswith("#")
    +    ]
    +
    +
    +@contextmanager
    +def _ignore_errors(ignore_option_errors: bool):
    +    if not ignore_option_errors:
    +        yield
    +        return
    +
    +    try:
    +        yield
    +    except Exception as ex:
    +        _logger.debug(f"ignored error: {ex.__class__.__name__} - {ex}")
    +
    +
    +class _EnsurePackagesDiscovered(_expand.EnsurePackagesDiscovered):
    +    def __init__(
    +        self, distribution: Distribution, project_cfg: dict, setuptools_cfg: dict
    +    ) -> None:
    +        super().__init__(distribution)
    +        self._project_cfg = project_cfg
    +        self._setuptools_cfg = setuptools_cfg
    +
    +    def __enter__(self) -> Self:
    +        """When entering the context, the values of ``packages``, ``py_modules`` and
    +        ``package_dir`` that are missing in ``dist`` are copied from ``setuptools_cfg``.
    +        """
    +        dist, cfg = self._dist, self._setuptools_cfg
    +        package_dir: dict[str, str] = cfg.setdefault("package-dir", {})
    +        package_dir.update(dist.package_dir or {})
    +        dist.package_dir = package_dir  # needs to be the same object
    +
    +        dist.set_defaults._ignore_ext_modules()  # pyproject.toml-specific behaviour
    +
    +        # Set `name`, `py_modules` and `packages` in dist to short-circuit
    +        # auto-discovery, but avoid overwriting empty lists purposefully set by users.
    +        if dist.metadata.name is None:
    +            dist.metadata.name = self._project_cfg.get("name")
    +        if dist.py_modules is None:
    +            dist.py_modules = cfg.get("py-modules")
    +        if dist.packages is None:
    +            dist.packages = cfg.get("packages")
    +
    +        return super().__enter__()
    +
    +    def __exit__(
    +        self,
    +        exc_type: type[BaseException] | None,
    +        exc_value: BaseException | None,
    +        traceback: TracebackType | None,
    +    ) -> None:
    +        """When exiting the context, if values of ``packages``, ``py_modules`` and
    +        ``package_dir`` are missing in ``setuptools_cfg``, copy from ``dist``.
    +        """
    +        # If anything was discovered set them back, so they count in the final config.
    +        self._setuptools_cfg.setdefault("packages", self._dist.packages)
    +        self._setuptools_cfg.setdefault("py-modules", self._dist.py_modules)
    +        return super().__exit__(exc_type, exc_value, traceback)
    +
    +
    +class _ExperimentalConfiguration(SetuptoolsWarning):
    +    _SUMMARY = (
    +        "`{subject}` in `pyproject.toml` is still *experimental* "
    +        "and likely to change in future releases."
    +    )
    +
    +
    +class _ToolsTypoInMetadata(SetuptoolsWarning):
    +    _SUMMARY = (
    +        "Ignoring [tools.setuptools] in pyproject.toml, did you mean [tool.setuptools]?"
    +    )
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/setupcfg.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/setupcfg.py
    new file mode 100644
    index 000000000..633aa9d45
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/setupcfg.py
    @@ -0,0 +1,780 @@
    +"""
    +Load setuptools configuration from ``setup.cfg`` files.
    +
    +**API will be made private in the future**
    +
    +To read project metadata, consider using
    +``build.util.project_wheel_metadata`` (https://pypi.org/project/build/).
    +For simple scenarios, you can also try parsing the file directly
    +with the help of ``configparser``.
    +"""
    +
    +from __future__ import annotations
    +
    +import contextlib
    +import functools
    +import os
    +from collections import defaultdict
    +from collections.abc import Iterable, Iterator
    +from functools import partial, wraps
    +from typing import TYPE_CHECKING, Any, Callable, ClassVar, Generic, TypeVar, cast
    +
    +from packaging.markers import default_environment as marker_env
    +from packaging.requirements import InvalidRequirement, Requirement
    +from packaging.version import InvalidVersion, Version
    +
    +from .. import _static
    +from .._path import StrPath
    +from ..errors import FileError, OptionError
    +from ..warnings import SetuptoolsDeprecationWarning
    +from . import expand
    +
    +if TYPE_CHECKING:
    +    from typing_extensions import TypeAlias
    +
    +    from setuptools.dist import Distribution
    +
    +    from distutils.dist import DistributionMetadata
    +
    +SingleCommandOptions: TypeAlias = dict[str, tuple[str, Any]]
    +"""Dict that associate the name of the options of a particular command to a
    +tuple. The first element of the tuple indicates the origin of the option value
    +(e.g. the name of the configuration file where it was read from),
    +while the second element of the tuple is the option value itself
    +"""
    +AllCommandOptions: TypeAlias = dict[str, SingleCommandOptions]
    +"""cmd name => its options"""
    +Target = TypeVar("Target", "Distribution", "DistributionMetadata")
    +
    +
    +def read_configuration(
    +    filepath: StrPath, find_others: bool = False, ignore_option_errors: bool = False
    +) -> dict:
    +    """Read given configuration file and returns options from it as a dict.
    +
    +    :param str|unicode filepath: Path to configuration file
    +        to get options from.
    +
    +    :param bool find_others: Whether to search for other configuration files
    +        which could be on in various places.
    +
    +    :param bool ignore_option_errors: Whether to silently ignore
    +        options, values of which could not be resolved (e.g. due to exceptions
    +        in directives such as file:, attr:, etc.).
    +        If False exceptions are propagated as expected.
    +
    +    :rtype: dict
    +    """
    +    from setuptools.dist import Distribution
    +
    +    dist = Distribution()
    +    filenames = dist.find_config_files() if find_others else []
    +    handlers = _apply(dist, filepath, filenames, ignore_option_errors)
    +    return configuration_to_dict(handlers)
    +
    +
    +def apply_configuration(dist: Distribution, filepath: StrPath) -> Distribution:
    +    """Apply the configuration from a ``setup.cfg`` file into an existing
    +    distribution object.
    +    """
    +    _apply(dist, filepath)
    +    dist._finalize_requires()
    +    return dist
    +
    +
    +def _apply(
    +    dist: Distribution,
    +    filepath: StrPath,
    +    other_files: Iterable[StrPath] = (),
    +    ignore_option_errors: bool = False,
    +) -> tuple[ConfigMetadataHandler, ConfigOptionsHandler]:
    +    """Read configuration from ``filepath`` and applies to the ``dist`` object."""
    +    from setuptools.dist import _Distribution
    +
    +    filepath = os.path.abspath(filepath)
    +
    +    if not os.path.isfile(filepath):
    +        raise FileError(f'Configuration file {filepath} does not exist.')
    +
    +    current_directory = os.getcwd()
    +    os.chdir(os.path.dirname(filepath))
    +    filenames = [*other_files, filepath]
    +
    +    try:
    +        # TODO: Temporary cast until mypy 1.12 is released with upstream fixes from typeshed
    +        _Distribution.parse_config_files(dist, filenames=cast(list[str], filenames))
    +        handlers = parse_configuration(
    +            dist, dist.command_options, ignore_option_errors=ignore_option_errors
    +        )
    +        dist._finalize_license_files()
    +    finally:
    +        os.chdir(current_directory)
    +
    +    return handlers
    +
    +
    +def _get_option(target_obj: Distribution | DistributionMetadata, key: str):
    +    """
    +    Given a target object and option key, get that option from
    +    the target object, either through a get_{key} method or
    +    from an attribute directly.
    +    """
    +    getter_name = f'get_{key}'
    +    by_attribute = functools.partial(getattr, target_obj, key)
    +    getter = getattr(target_obj, getter_name, by_attribute)
    +    return getter()
    +
    +
    +def configuration_to_dict(
    +    handlers: Iterable[
    +        ConfigHandler[Distribution] | ConfigHandler[DistributionMetadata]
    +    ],
    +) -> dict:
    +    """Returns configuration data gathered by given handlers as a dict.
    +
    +    :param Iterable[ConfigHandler] handlers: Handlers list,
    +        usually from parse_configuration()
    +
    +    :rtype: dict
    +    """
    +    config_dict: dict = defaultdict(dict)
    +
    +    for handler in handlers:
    +        for option in handler.set_options:
    +            value = _get_option(handler.target_obj, option)
    +            config_dict[handler.section_prefix][option] = value
    +
    +    return config_dict
    +
    +
    +def parse_configuration(
    +    distribution: Distribution,
    +    command_options: AllCommandOptions,
    +    ignore_option_errors: bool = False,
    +) -> tuple[ConfigMetadataHandler, ConfigOptionsHandler]:
    +    """Performs additional parsing of configuration options
    +    for a distribution.
    +
    +    Returns a list of used option handlers.
    +
    +    :param Distribution distribution:
    +    :param dict command_options:
    +    :param bool ignore_option_errors: Whether to silently ignore
    +        options, values of which could not be resolved (e.g. due to exceptions
    +        in directives such as file:, attr:, etc.).
    +        If False exceptions are propagated as expected.
    +    :rtype: list
    +    """
    +    with expand.EnsurePackagesDiscovered(distribution) as ensure_discovered:
    +        options = ConfigOptionsHandler(
    +            distribution,
    +            command_options,
    +            ignore_option_errors,
    +            ensure_discovered,
    +        )
    +
    +        options.parse()
    +        if not distribution.package_dir:
    +            distribution.package_dir = options.package_dir  # Filled by `find_packages`
    +
    +        meta = ConfigMetadataHandler(
    +            distribution.metadata,
    +            command_options,
    +            ignore_option_errors,
    +            ensure_discovered,
    +            distribution.package_dir,
    +            distribution.src_root,
    +        )
    +        meta.parse()
    +        distribution._referenced_files.update(
    +            options._referenced_files, meta._referenced_files
    +        )
    +
    +    return meta, options
    +
    +
    +def _warn_accidental_env_marker_misconfig(label: str, orig_value: str, parsed: list):
    +    """Because users sometimes misinterpret this configuration:
    +
    +    [options.extras_require]
    +    foo = bar;python_version<"4"
    +
    +    It looks like one requirement with an environment marker
    +    but because there is no newline, it's parsed as two requirements
    +    with a semicolon as separator.
    +
    +    Therefore, if:
    +        * input string does not contain a newline AND
    +        * parsed result contains two requirements AND
    +        * parsing of the two parts from the result (";")
    +        leads in a valid Requirement with a valid marker
    +    a UserWarning is shown to inform the user about the possible problem.
    +    """
    +    if "\n" in orig_value or len(parsed) != 2:
    +        return
    +
    +    markers = marker_env().keys()
    +
    +    try:
    +        req = Requirement(parsed[1])
    +        if req.name in markers:
    +            _AmbiguousMarker.emit(field=label, req=parsed[1])
    +    except InvalidRequirement as ex:
    +        if any(parsed[1].startswith(marker) for marker in markers):
    +            msg = _AmbiguousMarker.message(field=label, req=parsed[1])
    +            raise InvalidRequirement(msg) from ex
    +
    +
    +class ConfigHandler(Generic[Target]):
    +    """Handles metadata supplied in configuration files."""
    +
    +    section_prefix: str
    +    """Prefix for config sections handled by this handler.
    +    Must be provided by class heirs.
    +
    +    """
    +
    +    aliases: ClassVar[dict[str, str]] = {}
    +    """Options aliases.
    +    For compatibility with various packages. E.g.: d2to1 and pbr.
    +    Note: `-` in keys is replaced with `_` by config parser.
    +
    +    """
    +
    +    def __init__(
    +        self,
    +        target_obj: Target,
    +        options: AllCommandOptions,
    +        ignore_option_errors,
    +        ensure_discovered: expand.EnsurePackagesDiscovered,
    +    ) -> None:
    +        self.ignore_option_errors = ignore_option_errors
    +        self.target_obj: Target = target_obj
    +        self.sections = dict(self._section_options(options))
    +        self.set_options: list[str] = []
    +        self.ensure_discovered = ensure_discovered
    +        self._referenced_files = set[str]()
    +        """After parsing configurations, this property will enumerate
    +        all files referenced by the "file:" directive. Private API for setuptools only.
    +        """
    +
    +    @classmethod
    +    def _section_options(
    +        cls, options: AllCommandOptions
    +    ) -> Iterator[tuple[str, SingleCommandOptions]]:
    +        for full_name, value in options.items():
    +            pre, _sep, name = full_name.partition(cls.section_prefix)
    +            if pre:
    +                continue
    +            yield name.lstrip('.'), value
    +
    +    @property
    +    def parsers(self):
    +        """Metadata item name to parser function mapping."""
    +        raise NotImplementedError(
    +            f'{self.__class__.__name__} must provide .parsers property'
    +        )
    +
    +    def __setitem__(self, option_name, value) -> None:
    +        target_obj = self.target_obj
    +
    +        # Translate alias into real name.
    +        option_name = self.aliases.get(option_name, option_name)
    +
    +        try:
    +            current_value = getattr(target_obj, option_name)
    +        except AttributeError as e:
    +            raise KeyError(option_name) from e
    +
    +        if current_value:
    +            # Already inhabited. Skipping.
    +            return
    +
    +        try:
    +            parsed = self.parsers.get(option_name, lambda x: x)(value)
    +        except (Exception,) * self.ignore_option_errors:
    +            return
    +
    +        simple_setter = functools.partial(target_obj.__setattr__, option_name)
    +        setter = getattr(target_obj, f"set_{option_name}", simple_setter)
    +        setter(parsed)
    +
    +        self.set_options.append(option_name)
    +
    +    @classmethod
    +    def _parse_list(cls, value, separator=','):
    +        """Represents value as a list.
    +
    +        Value is split either by separator (defaults to comma) or by lines.
    +
    +        :param value:
    +        :param separator: List items separator character.
    +        :rtype: list
    +        """
    +        if isinstance(value, list):  # _get_parser_compound case
    +            return value
    +
    +        if '\n' in value:
    +            value = value.splitlines()
    +        else:
    +            value = value.split(separator)
    +
    +        return [chunk.strip() for chunk in value if chunk.strip()]
    +
    +    @classmethod
    +    def _parse_dict(cls, value):
    +        """Represents value as a dict.
    +
    +        :param value:
    +        :rtype: dict
    +        """
    +        separator = '='
    +        result = {}
    +        for line in cls._parse_list(value):
    +            key, sep, val = line.partition(separator)
    +            if sep != separator:
    +                raise OptionError(f"Unable to parse option value to dict: {value}")
    +            result[key.strip()] = val.strip()
    +
    +        return result
    +
    +    @classmethod
    +    def _parse_bool(cls, value):
    +        """Represents value as boolean.
    +
    +        :param value:
    +        :rtype: bool
    +        """
    +        value = value.lower()
    +        return value in ('1', 'true', 'yes')
    +
    +    @classmethod
    +    def _exclude_files_parser(cls, key):
    +        """Returns a parser function to make sure field inputs
    +        are not files.
    +
    +        Parses a value after getting the key so error messages are
    +        more informative.
    +
    +        :param key:
    +        :rtype: callable
    +        """
    +
    +        def parser(value):
    +            exclude_directive = 'file:'
    +            if value.startswith(exclude_directive):
    +                raise ValueError(
    +                    f'Only strings are accepted for the {key} field, '
    +                    'files are not accepted'
    +                )
    +            return _static.Str(value)
    +
    +        return parser
    +
    +    def _parse_file(self, value, root_dir: StrPath | None):
    +        """Represents value as a string, allowing including text
    +        from nearest files using `file:` directive.
    +
    +        Directive is sandboxed and won't reach anything outside
    +        directory with setup.py.
    +
    +        Examples:
    +            file: README.rst, CHANGELOG.md, src/file.txt
    +
    +        :param str value:
    +        :rtype: str
    +        """
    +        include_directive = 'file:'
    +
    +        if not isinstance(value, str):
    +            return value
    +
    +        if not value.startswith(include_directive):
    +            return _static.Str(value)
    +
    +        spec = value[len(include_directive) :]
    +        filepaths = [path.strip() for path in spec.split(',')]
    +        self._referenced_files.update(filepaths)
    +        # XXX: Is marking as static contents coming from files too optimistic?
    +        return _static.Str(expand.read_files(filepaths, root_dir))
    +
    +    def _parse_attr(self, value, package_dir, root_dir: StrPath):
    +        """Represents value as a module attribute.
    +
    +        Examples:
    +            attr: package.attr
    +            attr: package.module.attr
    +
    +        :param str value:
    +        :rtype: str
    +        """
    +        attr_directive = 'attr:'
    +        if not value.startswith(attr_directive):
    +            return _static.Str(value)
    +
    +        attr_desc = value.replace(attr_directive, '')
    +
    +        # Make sure package_dir is populated correctly, so `attr:` directives can work
    +        package_dir.update(self.ensure_discovered.package_dir)
    +        return expand.read_attr(attr_desc, package_dir, root_dir)
    +
    +    @classmethod
    +    def _get_parser_compound(cls, *parse_methods):
    +        """Returns parser function to represents value as a list.
    +
    +        Parses a value applying given methods one after another.
    +
    +        :param parse_methods:
    +        :rtype: callable
    +        """
    +
    +        def parse(value):
    +            parsed = value
    +
    +            for method in parse_methods:
    +                parsed = method(parsed)
    +
    +            return parsed
    +
    +        return parse
    +
    +    @classmethod
    +    def _parse_section_to_dict_with_key(cls, section_options, values_parser):
    +        """Parses section options into a dictionary.
    +
    +        Applies a given parser to each option in a section.
    +
    +        :param dict section_options:
    +        :param callable values_parser: function with 2 args corresponding to key, value
    +        :rtype: dict
    +        """
    +        value = {}
    +        for key, (_, val) in section_options.items():
    +            value[key] = values_parser(key, val)
    +        return value
    +
    +    @classmethod
    +    def _parse_section_to_dict(cls, section_options, values_parser=None):
    +        """Parses section options into a dictionary.
    +
    +        Optionally applies a given parser to each value.
    +
    +        :param dict section_options:
    +        :param callable values_parser: function with 1 arg corresponding to option value
    +        :rtype: dict
    +        """
    +        parser = (lambda _, v: values_parser(v)) if values_parser else (lambda _, v: v)
    +        return cls._parse_section_to_dict_with_key(section_options, parser)
    +
    +    def parse_section(self, section_options) -> None:
    +        """Parses configuration file section.
    +
    +        :param dict section_options:
    +        """
    +        for name, (_, value) in section_options.items():
    +            with contextlib.suppress(KeyError):
    +                # Keep silent for a new option may appear anytime.
    +                self[name] = value
    +
    +    def parse(self) -> None:
    +        """Parses configuration file items from one
    +        or more related sections.
    +
    +        """
    +        for section_name, section_options in self.sections.items():
    +            method_postfix = ''
    +            if section_name:  # [section.option] variant
    +                method_postfix = f"_{section_name}"
    +
    +            section_parser_method: Callable | None = getattr(
    +                self,
    +                # Dots in section names are translated into dunderscores.
    +                f'parse_section{method_postfix}'.replace('.', '__'),
    +                None,
    +            )
    +
    +            if section_parser_method is None:
    +                raise OptionError(
    +                    "Unsupported distribution option section: "
    +                    f"[{self.section_prefix}.{section_name}]"
    +                )
    +
    +            section_parser_method(section_options)
    +
    +    def _deprecated_config_handler(self, func, msg, **kw):
    +        """this function will wrap around parameters that are deprecated
    +
    +        :param msg: deprecation message
    +        :param func: function to be wrapped around
    +        """
    +
    +        @wraps(func)
    +        def config_handler(*args, **kwargs):
    +            kw.setdefault("stacklevel", 2)
    +            _DeprecatedConfig.emit("Deprecated config in `setup.cfg`", msg, **kw)
    +            return func(*args, **kwargs)
    +
    +        return config_handler
    +
    +
    +class ConfigMetadataHandler(ConfigHandler["DistributionMetadata"]):
    +    section_prefix = 'metadata'
    +
    +    aliases = {
    +        'home_page': 'url',
    +        'summary': 'description',
    +        'classifier': 'classifiers',
    +        'platform': 'platforms',
    +    }
    +
    +    strict_mode = False
    +    """We need to keep it loose, to be partially compatible with
    +    `pbr` and `d2to1` packages which also uses `metadata` section.
    +
    +    """
    +
    +    def __init__(
    +        self,
    +        target_obj: DistributionMetadata,
    +        options: AllCommandOptions,
    +        ignore_option_errors: bool,
    +        ensure_discovered: expand.EnsurePackagesDiscovered,
    +        package_dir: dict | None = None,
    +        root_dir: StrPath | None = os.curdir,
    +    ) -> None:
    +        super().__init__(target_obj, options, ignore_option_errors, ensure_discovered)
    +        self.package_dir = package_dir
    +        self.root_dir = root_dir
    +
    +    @property
    +    def parsers(self):
    +        """Metadata item name to parser function mapping."""
    +        parse_list_static = self._get_parser_compound(self._parse_list, _static.List)
    +        parse_dict_static = self._get_parser_compound(self._parse_dict, _static.Dict)
    +        parse_file = partial(self._parse_file, root_dir=self.root_dir)
    +        exclude_files_parser = self._exclude_files_parser
    +
    +        return {
    +            'author': _static.Str,
    +            'author_email': _static.Str,
    +            'maintainer': _static.Str,
    +            'maintainer_email': _static.Str,
    +            'platforms': parse_list_static,
    +            'keywords': parse_list_static,
    +            'provides': parse_list_static,
    +            'obsoletes': parse_list_static,
    +            'classifiers': self._get_parser_compound(parse_file, parse_list_static),
    +            'license': exclude_files_parser('license'),
    +            'license_files': parse_list_static,
    +            'description': parse_file,
    +            'long_description': parse_file,
    +            'long_description_content_type': _static.Str,
    +            'version': self._parse_version,  # Cannot be marked as dynamic
    +            'url': _static.Str,
    +            'project_urls': parse_dict_static,
    +        }
    +
    +    def _parse_version(self, value):
    +        """Parses `version` option value.
    +
    +        :param value:
    +        :rtype: str
    +
    +        """
    +        version = self._parse_file(value, self.root_dir)
    +
    +        if version != value:
    +            version = version.strip()
    +            # Be strict about versions loaded from file because it's easy to
    +            # accidentally include newlines and other unintended content
    +            try:
    +                Version(version)
    +            except InvalidVersion as e:
    +                raise OptionError(
    +                    f'Version loaded from {value} does not '
    +                    f'comply with PEP 440: {version}'
    +                ) from e
    +
    +            return version
    +
    +        return expand.version(self._parse_attr(value, self.package_dir, self.root_dir))
    +
    +
    +class ConfigOptionsHandler(ConfigHandler["Distribution"]):
    +    section_prefix = 'options'
    +
    +    def __init__(
    +        self,
    +        target_obj: Distribution,
    +        options: AllCommandOptions,
    +        ignore_option_errors: bool,
    +        ensure_discovered: expand.EnsurePackagesDiscovered,
    +    ) -> None:
    +        super().__init__(target_obj, options, ignore_option_errors, ensure_discovered)
    +        self.root_dir = target_obj.src_root
    +        self.package_dir: dict[str, str] = {}  # To be filled by `find_packages`
    +
    +    @classmethod
    +    def _parse_list_semicolon(cls, value):
    +        return cls._parse_list(value, separator=';')
    +
    +    def _parse_file_in_root(self, value):
    +        return self._parse_file(value, root_dir=self.root_dir)
    +
    +    def _parse_requirements_list(self, label: str, value: str):
    +        # Parse a requirements list, either by reading in a `file:`, or a list.
    +        parsed = self._parse_list_semicolon(self._parse_file_in_root(value))
    +        _warn_accidental_env_marker_misconfig(label, value, parsed)
    +        # Filter it to only include lines that are not comments. `parse_list`
    +        # will have stripped each line and filtered out empties.
    +        return _static.List(line for line in parsed if not line.startswith("#"))
    +        # ^-- Use `_static.List` to mark a non-`Dynamic` Core Metadata
    +
    +    @property
    +    def parsers(self):
    +        """Metadata item name to parser function mapping."""
    +        parse_list = self._parse_list
    +        parse_bool = self._parse_bool
    +        parse_cmdclass = self._parse_cmdclass
    +
    +        return {
    +            'zip_safe': parse_bool,
    +            'include_package_data': parse_bool,
    +            'package_dir': self._parse_dict,
    +            'scripts': parse_list,
    +            'eager_resources': parse_list,
    +            'dependency_links': parse_list,
    +            'namespace_packages': self._deprecated_config_handler(
    +                parse_list,
    +                "The namespace_packages parameter is deprecated, "
    +                "consider using implicit namespaces instead (PEP 420).",
    +                # TODO: define due date, see setuptools.dist:check_nsp.
    +            ),
    +            'install_requires': partial(  # Core Metadata
    +                self._parse_requirements_list, "install_requires"
    +            ),
    +            'setup_requires': self._parse_list_semicolon,
    +            'packages': self._parse_packages,
    +            'entry_points': self._parse_file_in_root,
    +            'py_modules': parse_list,
    +            'python_requires': _static.SpecifierSet,  # Core Metadata
    +            'cmdclass': parse_cmdclass,
    +        }
    +
    +    def _parse_cmdclass(self, value):
    +        package_dir = self.ensure_discovered.package_dir
    +        return expand.cmdclass(self._parse_dict(value), package_dir, self.root_dir)
    +
    +    def _parse_packages(self, value):
    +        """Parses `packages` option value.
    +
    +        :param value:
    +        :rtype: list
    +        """
    +        find_directives = ['find:', 'find_namespace:']
    +        trimmed_value = value.strip()
    +
    +        if trimmed_value not in find_directives:
    +            return self._parse_list(value)
    +
    +        # Read function arguments from a dedicated section.
    +        find_kwargs = self.parse_section_packages__find(
    +            self.sections.get('packages.find', {})
    +        )
    +
    +        find_kwargs.update(
    +            namespaces=(trimmed_value == find_directives[1]),
    +            root_dir=self.root_dir,
    +            fill_package_dir=self.package_dir,
    +        )
    +
    +        return expand.find_packages(**find_kwargs)
    +
    +    def parse_section_packages__find(self, section_options):
    +        """Parses `packages.find` configuration file section.
    +
    +        To be used in conjunction with _parse_packages().
    +
    +        :param dict section_options:
    +        """
    +        section_data = self._parse_section_to_dict(section_options, self._parse_list)
    +
    +        valid_keys = ['where', 'include', 'exclude']
    +        find_kwargs = {k: v for k, v in section_data.items() if k in valid_keys and v}
    +
    +        where = find_kwargs.get('where')
    +        if where is not None:
    +            find_kwargs['where'] = where[0]  # cast list to single val
    +
    +        return find_kwargs
    +
    +    def parse_section_entry_points(self, section_options) -> None:
    +        """Parses `entry_points` configuration file section.
    +
    +        :param dict section_options:
    +        """
    +        parsed = self._parse_section_to_dict(section_options, self._parse_list)
    +        self['entry_points'] = parsed
    +
    +    def _parse_package_data(self, section_options):
    +        package_data = self._parse_section_to_dict(section_options, self._parse_list)
    +        return expand.canonic_package_data(package_data)
    +
    +    def parse_section_package_data(self, section_options) -> None:
    +        """Parses `package_data` configuration file section.
    +
    +        :param dict section_options:
    +        """
    +        self['package_data'] = self._parse_package_data(section_options)
    +
    +    def parse_section_exclude_package_data(self, section_options) -> None:
    +        """Parses `exclude_package_data` configuration file section.
    +
    +        :param dict section_options:
    +        """
    +        self['exclude_package_data'] = self._parse_package_data(section_options)
    +
    +    def parse_section_extras_require(self, section_options) -> None:  # Core Metadata
    +        """Parses `extras_require` configuration file section.
    +
    +        :param dict section_options:
    +        """
    +        parsed = self._parse_section_to_dict_with_key(
    +            section_options,
    +            lambda k, v: self._parse_requirements_list(f"extras_require[{k}]", v),
    +        )
    +
    +        self['extras_require'] = _static.Dict(parsed)
    +        # ^-- Use `_static.Dict` to mark a non-`Dynamic` Core Metadata
    +
    +    def parse_section_data_files(self, section_options) -> None:
    +        """Parses `data_files` configuration file section.
    +
    +        :param dict section_options:
    +        """
    +        parsed = self._parse_section_to_dict(section_options, self._parse_list)
    +        self['data_files'] = expand.canonic_data_files(parsed, self.root_dir)
    +
    +
    +class _AmbiguousMarker(SetuptoolsDeprecationWarning):
    +    _SUMMARY = "Ambiguous requirement marker."
    +    _DETAILS = """
    +    One of the parsed requirements in `{field}` looks like a valid environment marker:
    +
    +        {req!r}
    +
    +    Please make sure that the configuration file is correct.
    +    You can use dangling lines to avoid this problem.
    +    """
    +    _SEE_DOCS = "userguide/declarative_config.html#opt-2"
    +    # TODO: should we include due_date here? Initially introduced in 6 Aug 2022.
    +    # Does this make sense with latest version of packaging?
    +
    +    @classmethod
    +    def message(cls, **kw):
    +        docs = f"https://setuptools.pypa.io/en/latest/{cls._SEE_DOCS}"
    +        return cls._format(cls._SUMMARY, cls._DETAILS, see_url=docs, format_args=kw)
    +
    +
    +class _DeprecatedConfig(SetuptoolsDeprecationWarning):
    +    _SEE_DOCS = "userguide/declarative_config.html"
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/setuptools.schema.json b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/setuptools.schema.json
    new file mode 100644
    index 000000000..ec887b357
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/config/setuptools.schema.json
    @@ -0,0 +1,433 @@
    +{
    +  "$schema": "http://json-schema.org/draft-07/schema#",
    +
    +  "$id": "https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html",
    +  "title": "``tool.setuptools`` table",
    +  "$$description": [
    +    "``setuptools``-specific configurations that can be set by users that require",
    +    "customization.",
    +    "These configurations are completely optional and probably can be skipped when",
    +    "creating simple packages. They are equivalent to some of the `Keywords",
    +    "`_",
    +    "used by the ``setup.py`` file, and can be set via the ``tool.setuptools`` table.",
    +    "It considers only ``setuptools`` `parameters",
    +    "`_",
    +    "that are not covered by :pep:`621`; and intentionally excludes ``dependency_links``",
    +    "and ``setup_requires`` (incompatible with modern workflows/standards)."
    +  ],
    +
    +  "type": "object",
    +  "additionalProperties": false,
    +  "properties": {
    +    "platforms": {
    +      "type": "array",
    +      "items": {"type": "string"}
    +    },
    +    "provides": {
    +      "$$description": [
    +        "Package and virtual package names contained within this package",
    +        "**(not supported by pip)**"
    +      ],
    +      "type": "array",
    +      "items": {"type": "string", "format": "pep508-identifier"}
    +    },
    +    "obsoletes": {
    +      "$$description": [
    +        "Packages which this package renders obsolete",
    +        "**(not supported by pip)**"
    +      ],
    +      "type": "array",
    +      "items": {"type": "string", "format": "pep508-identifier"}
    +    },
    +    "zip-safe": {
    +      "$$description": [
    +        "Whether the project can be safely installed and run from a zip file.",
    +        "**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and",
    +        "``setup.py install`` in the context of ``eggs`` (**DEPRECATED**)."
    +      ],
    +      "type": "boolean"
    +    },
    +    "script-files": {
    +      "$$description": [
    +        "Legacy way of defining scripts (entry-points are preferred).",
    +        "Equivalent to the ``script`` keyword in ``setup.py``",
    +        "(it was renamed to avoid confusion with entry-point based ``project.scripts``",
    +        "defined in :pep:`621`).",
    +        "**DISCOURAGED**: generic script wrappers are tricky and may not work properly.",
    +        "Whenever possible, please use ``project.scripts`` instead."
    +      ],
    +      "type": "array",
    +      "items": {"type": "string"},
    +      "$comment": "TODO: is this field deprecated/should be removed?"
    +    },
    +    "eager-resources": {
    +      "$$description": [
    +        "Resources that should be extracted together, if any of them is needed,",
    +        "or if any C extensions included in the project are imported.",
    +        "**OBSOLETE**: only relevant for ``pkg_resources``, ``easy_install`` and",
    +        "``setup.py install`` in the context of ``eggs`` (**DEPRECATED**)."
    +      ],
    +      "type": "array",
    +      "items": {"type": "string"}
    +    },
    +    "packages": {
    +      "$$description": [
    +        "Packages that should be included in the distribution.",
    +        "It can be given either as a list of package identifiers",
    +        "or as a ``dict``-like structure with a single key ``find``",
    +        "which corresponds to a dynamic call to",
    +        "``setuptools.config.expand.find_packages`` function.",
    +        "The ``find`` key is associated with a nested ``dict``-like structure that can",
    +        "contain ``where``, ``include``, ``exclude`` and ``namespaces`` keys,",
    +        "mimicking the keyword arguments of the associated function."
    +      ],
    +      "oneOf": [
    +        {
    +          "title": "Array of Python package identifiers",
    +          "type": "array",
    +          "items": {"$ref": "#/definitions/package-name"}
    +        },
    +        {"$ref": "#/definitions/find-directive"}
    +      ]
    +    },
    +    "package-dir": {
    +      "$$description": [
    +        ":class:`dict`-like structure mapping from package names to directories where their",
    +        "code can be found.",
    +        "The empty string (as key) means that all packages are contained inside",
    +        "the given directory will be included in the distribution."
    +      ],
    +      "type": "object",
    +      "additionalProperties": false,
    +      "propertyNames": {
    +        "anyOf": [{"const": ""}, {"$ref": "#/definitions/package-name"}]
    +      },
    +      "patternProperties": {
    +        "^.*$": {"type": "string" }
    +      }
    +    },
    +    "package-data": {
    +      "$$description": [
    +        "Mapping from package names to lists of glob patterns.",
    +        "Usually this option is not needed when using ``include-package-data = true``",
    +        "For more information on how to include data files, check ``setuptools`` `docs",
    +        "`_."
    +      ],
    +      "type": "object",
    +      "additionalProperties": false,
    +      "propertyNames": {
    +        "anyOf": [{"type": "string", "format": "python-module-name"}, {"const": "*"}]
    +      },
    +      "patternProperties": {
    +        "^.*$": {"type": "array", "items": {"type": "string"}}
    +      }
    +    },
    +    "include-package-data": {
    +      "$$description": [
    +        "Automatically include any data files inside the package directories",
    +        "that are specified by ``MANIFEST.in``",
    +        "For more information on how to include data files, check ``setuptools`` `docs",
    +        "`_."
    +      ],
    +      "type": "boolean"
    +    },
    +    "exclude-package-data": {
    +      "$$description": [
    +        "Mapping from package names to lists of glob patterns that should be excluded",
    +        "For more information on how to include data files, check ``setuptools`` `docs",
    +        "`_."
    +      ],
    +      "type": "object",
    +      "additionalProperties": false,
    +      "propertyNames": {
    +        "anyOf": [{"type": "string", "format": "python-module-name"}, {"const": "*"}]
    +      },
    +      "patternProperties": {
    +          "^.*$": {"type": "array", "items": {"type": "string"}}
    +      }
    +    },
    +    "namespace-packages": {
    +      "type": "array",
    +      "items": {"type": "string", "format": "python-module-name-relaxed"},
    +      "$comment": "https://setuptools.pypa.io/en/latest/userguide/package_discovery.html",
    +      "description": "**DEPRECATED**: use implicit namespaces instead (:pep:`420`)."
    +    },
    +    "py-modules": {
    +      "description": "Modules that setuptools will manipulate",
    +      "type": "array",
    +      "items": {"type": "string", "format": "python-module-name-relaxed"},
    +      "$comment": "TODO: clarify the relationship with ``packages``"
    +    },
    +    "ext-modules": {
    +      "description": "Extension modules to be compiled by setuptools",
    +      "type": "array",
    +      "items": {"$ref": "#/definitions/ext-module"}
    +    },
    +    "data-files": {
    +      "$$description": [
    +        "``dict``-like structure where each key represents a directory and",
    +        "the value is a list of glob patterns that should be installed in them.",
    +        "**DISCOURAGED**: please notice this might not work as expected with wheels.",
    +        "Whenever possible, consider using data files inside the package directories",
    +        "(or create a new namespace package that only contains data files).",
    +        "See `data files support",
    +        "`_."
    +      ],
    +      "type": "object",
    +      "patternProperties": {
    +          "^.*$": {"type": "array", "items": {"type": "string"}}
    +      }
    +    },
    +    "cmdclass": {
    +      "$$description": [
    +        "Mapping of distutils-style command names to ``setuptools.Command`` subclasses",
    +        "which in turn should be represented by strings with a qualified class name",
    +        "(i.e., \"dotted\" form with module), e.g.::\n\n",
    +        "    cmdclass = {mycmd = \"pkg.subpkg.module.CommandClass\"}\n\n",
    +        "The command class should be a directly defined at the top-level of the",
    +        "containing module (no class nesting)."
    +      ],
    +      "type": "object",
    +      "patternProperties": {
    +          "^.*$": {"type": "string", "format": "python-qualified-identifier"}
    +      }
    +    },
    +    "license-files": {
    +      "type": "array",
    +      "items": {"type": "string"},
    +      "$$description": [
    +        "**PROVISIONAL**: list of glob patterns for all license files being distributed.",
    +        "(likely to become standard with :pep:`639`).",
    +        "By default: ``['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']``"
    +      ],
    +      "$comment": "TODO: revise if PEP 639 is accepted. Probably ``project.license-files``?"
    +    },
    +    "dynamic": {
    +      "type": "object",
    +      "description": "Instructions for loading :pep:`621`-related metadata dynamically",
    +      "additionalProperties": false,
    +      "properties": {
    +        "version": {
    +          "$$description": [
    +            "A version dynamically loaded via either the ``attr:`` or ``file:``",
    +            "directives. Please make sure the given file or attribute respects :pep:`440`.",
    +            "Also ensure to set ``project.dynamic`` accordingly."
    +          ],
    +          "oneOf": [
    +            {"$ref": "#/definitions/attr-directive"},
    +            {"$ref": "#/definitions/file-directive"}
    +          ]
    +        },
    +        "classifiers": {"$ref": "#/definitions/file-directive"},
    +        "description": {"$ref": "#/definitions/file-directive"},
    +        "entry-points": {"$ref": "#/definitions/file-directive"},
    +        "dependencies": {"$ref": "#/definitions/file-directive-for-dependencies"},
    +        "optional-dependencies": {
    +          "type": "object",
    +          "propertyNames": {"type": "string", "format": "pep508-identifier"},
    +          "additionalProperties": false,
    +          "patternProperties": {
    +            ".+": {"$ref": "#/definitions/file-directive-for-dependencies"}
    +          }
    +        },
    +        "readme": {
    +          "type": "object",
    +          "anyOf": [
    +            {"$ref": "#/definitions/file-directive"},
    +            {
    +              "type": "object",
    +              "properties": {
    +                "content-type": {"type": "string"},
    +                "file": { "$ref": "#/definitions/file-directive/properties/file" }
    +              },
    +              "additionalProperties": false}
    +          ],
    +          "required": ["file"]
    +        }
    +      }
    +    }
    +  },
    +
    +  "definitions": {
    +    "package-name": {
    +      "$id": "#/definitions/package-name",
    +      "title": "Valid package name",
    +      "description": "Valid package name (importable or :pep:`561`).",
    +      "type": "string",
    +      "anyOf": [
    +        {"type": "string", "format": "python-module-name-relaxed"},
    +        {"type": "string", "format": "pep561-stub-name"}
    +      ]
    +    },
    +    "ext-module": {
    +      "$id": "#/definitions/ext-module",
    +      "title": "Extension module",
    +      "description": "Parameters to construct a :class:`setuptools.Extension` object",
    +      "type": "object",
    +      "required": ["name", "sources"],
    +      "additionalProperties": false,
    +      "properties": {
    +        "name": {
    +          "type": "string",
    +          "format": "python-module-name-relaxed"
    +        },
    +        "sources": {
    +          "type": "array",
    +          "items": {"type": "string"}
    +        },
    +        "include-dirs":{
    +          "type": "array",
    +          "items": {"type": "string"}
    +        },
    +        "define-macros": {
    +          "type": "array",
    +          "items": {
    +            "type": "array",
    +            "items": [
    +              {"description": "macro name", "type": "string"},
    +              {"description": "macro value", "oneOf": [{"type": "string"}, {"type": "null"}]}
    +            ],
    +            "additionalItems": false
    +          }
    +        },
    +        "undef-macros": {
    +          "type": "array",
    +          "items": {"type": "string"}
    +        },
    +        "library-dirs": {
    +          "type": "array",
    +          "items": {"type": "string"}
    +        },
    +        "libraries": {
    +          "type": "array",
    +          "items": {"type": "string"}
    +        },
    +        "runtime-library-dirs": {
    +          "type": "array",
    +          "items": {"type": "string"}
    +        },
    +        "extra-objects": {
    +          "type": "array",
    +          "items": {"type": "string"}
    +        },
    +        "extra-compile-args": {
    +          "type": "array",
    +          "items": {"type": "string"}
    +        },
    +        "extra-link-args": {
    +          "type": "array",
    +          "items": {"type": "string"}
    +        },
    +        "export-symbols": {
    +          "type": "array",
    +          "items": {"type": "string"}
    +        },
    +        "swig-opts": {
    +          "type": "array",
    +          "items": {"type": "string"}
    +        },
    +        "depends": {
    +          "type": "array",
    +          "items": {"type": "string"}
    +        },
    +        "language": {"type": "string"},
    +        "optional": {"type": "boolean"},
    +        "py-limited-api": {"type": "boolean"}
    +      }
    +    },
    +    "file-directive": {
    +      "$id": "#/definitions/file-directive",
    +      "title": "'file:' directive",
    +      "description":
    +        "Value is read from a file (or list of files and then concatenated)",
    +      "type": "object",
    +      "additionalProperties": false,
    +      "properties": {
    +        "file": {
    +          "oneOf": [
    +            {"type": "string"},
    +            {"type": "array", "items": {"type": "string"}}
    +          ]
    +        }
    +      },
    +      "required": ["file"]
    +    },
    +    "file-directive-for-dependencies": {
    +      "title": "'file:' directive for dependencies",
    +      "allOf": [
    +        {
    +          "$$description": [
    +            "**BETA**: subset of the ``requirements.txt`` format",
    +            "without ``pip`` flags and options",
    +            "(one :pep:`508`-compliant string per line,",
    +            "lines that are blank or start with ``#`` are excluded).",
    +            "See `dynamic metadata",
    +            "`_."
    +          ]
    +        },
    +        {"$ref": "#/definitions/file-directive"}
    +      ]
    +    },
    +    "attr-directive": {
    +      "title": "'attr:' directive",
    +      "$id": "#/definitions/attr-directive",
    +      "$$description": [
    +        "Value is read from a module attribute. Supports callables and iterables;",
    +        "unsupported types are cast via ``str()``"
    +      ],
    +      "type": "object",
    +      "additionalProperties": false,
    +      "properties": {
    +        "attr": {"type": "string", "format": "python-qualified-identifier"}
    +      },
    +      "required": ["attr"]
    +    },
    +    "find-directive": {
    +      "$id": "#/definitions/find-directive",
    +      "title": "'find:' directive",
    +      "type": "object",
    +      "additionalProperties": false,
    +      "properties": {
    +        "find": {
    +          "type": "object",
    +          "$$description": [
    +            "Dynamic `package discovery",
    +            "`_."
    +          ],
    +          "additionalProperties": false,
    +          "properties": {
    +            "where": {
    +              "description":
    +                "Directories to be searched for packages (Unix-style relative path)",
    +              "type": "array",
    +              "items": {"type": "string"}
    +            },
    +            "exclude": {
    +              "type": "array",
    +              "$$description": [
    +                "Exclude packages that match the values listed in this field.",
    +                "Can container shell-style wildcards (e.g. ``'pkg.*'``)"
    +              ],
    +              "items": {"type": "string"}
    +            },
    +            "include": {
    +              "type": "array",
    +              "$$description": [
    +                "Restrict the found packages to just the ones listed in this field.",
    +                "Can container shell-style wildcards (e.g. ``'pkg.*'``)"
    +              ],
    +              "items": {"type": "string"}
    +            },
    +            "namespaces": {
    +              "type": "boolean",
    +              "$$description": [
    +                "When ``True``, directories without a ``__init__.py`` file will also",
    +                "be scanned for :pep:`420`-style implicit namespaces"
    +              ]
    +            }
    +          }
    +        }
    +      }
    +    }
    +  }
    +}
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/depends.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/depends.py
    new file mode 100644
    index 000000000..e5223b795
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/depends.py
    @@ -0,0 +1,185 @@
    +from __future__ import annotations
    +
    +import contextlib
    +import dis
    +import marshal
    +import sys
    +from types import CodeType
    +from typing import Any, Literal, TypeVar
    +
    +from packaging.version import Version
    +
    +from . import _imp
    +from ._imp import PY_COMPILED, PY_FROZEN, PY_SOURCE, find_module
    +
    +_T = TypeVar("_T")
    +
    +__all__ = ['Require', 'find_module']
    +
    +
    +class Require:
    +    """A prerequisite to building or installing a distribution"""
    +
    +    def __init__(
    +        self,
    +        name,
    +        requested_version,
    +        module,
    +        homepage: str = '',
    +        attribute=None,
    +        format=None,
    +    ) -> None:
    +        if format is None and requested_version is not None:
    +            format = Version
    +
    +        if format is not None:
    +            requested_version = format(requested_version)
    +            if attribute is None:
    +                attribute = '__version__'
    +
    +        self.__dict__.update(locals())
    +        del self.self
    +
    +    def full_name(self):
    +        """Return full package/distribution name, w/version"""
    +        if self.requested_version is not None:
    +            return f'{self.name}-{self.requested_version}'
    +        return self.name
    +
    +    def version_ok(self, version):
    +        """Is 'version' sufficiently up-to-date?"""
    +        return (
    +            self.attribute is None
    +            or self.format is None
    +            or str(version) != "unknown"
    +            and self.format(version) >= self.requested_version
    +        )
    +
    +    def get_version(
    +        self, paths=None, default: _T | Literal["unknown"] = "unknown"
    +    ) -> _T | Literal["unknown"] | None | Any:
    +        """Get version number of installed module, 'None', or 'default'
    +
    +        Search 'paths' for module.  If not found, return 'None'.  If found,
    +        return the extracted version attribute, or 'default' if no version
    +        attribute was specified, or the value cannot be determined without
    +        importing the module.  The version is formatted according to the
    +        requirement's version format (if any), unless it is 'None' or the
    +        supplied 'default'.
    +        """
    +
    +        if self.attribute is None:
    +            try:
    +                f, _p, _i = find_module(self.module, paths)
    +            except ImportError:
    +                return None
    +            if f:
    +                f.close()
    +            return default
    +
    +        v = get_module_constant(self.module, self.attribute, default, paths)
    +
    +        if v is not None and v is not default and self.format is not None:
    +            return self.format(v)
    +
    +        return v
    +
    +    def is_present(self, paths=None):
    +        """Return true if dependency is present on 'paths'"""
    +        return self.get_version(paths) is not None
    +
    +    def is_current(self, paths=None):
    +        """Return true if dependency is present and up-to-date on 'paths'"""
    +        version = self.get_version(paths)
    +        if version is None:
    +            return False
    +        return self.version_ok(str(version))
    +
    +
    +def maybe_close(f):
    +    @contextlib.contextmanager
    +    def empty():
    +        yield
    +        return
    +
    +    if not f:
    +        return empty()
    +
    +    return contextlib.closing(f)
    +
    +
    +# Some objects are not available on some platforms.
    +# XXX it'd be better to test assertions about bytecode instead.
    +if not sys.platform.startswith('java') and sys.platform != 'cli':
    +
    +    def get_module_constant(
    +        module, symbol, default: _T | int = -1, paths=None
    +    ) -> _T | int | None | Any:
    +        """Find 'module' by searching 'paths', and extract 'symbol'
    +
    +        Return 'None' if 'module' does not exist on 'paths', or it does not define
    +        'symbol'.  If the module defines 'symbol' as a constant, return the
    +        constant.  Otherwise, return 'default'."""
    +
    +        try:
    +            f, path, (_suffix, _mode, kind) = info = find_module(module, paths)
    +        except ImportError:
    +            # Module doesn't exist
    +            return None
    +
    +        with maybe_close(f):
    +            if kind == PY_COMPILED:
    +                f.read(8)  # skip magic & date
    +                code = marshal.load(f)
    +            elif kind == PY_FROZEN:
    +                code = _imp.get_frozen_object(module, paths)
    +            elif kind == PY_SOURCE:
    +                code = compile(f.read(), path, 'exec')
    +            else:
    +                # Not something we can parse; we'll have to import it.  :(
    +                imported = _imp.get_module(module, paths, info)
    +                return getattr(imported, symbol, None)
    +
    +        return extract_constant(code, symbol, default)
    +
    +    def extract_constant(
    +        code: CodeType, symbol: str, default: _T | int = -1
    +    ) -> _T | int | None | Any:
    +        """Extract the constant value of 'symbol' from 'code'
    +
    +        If the name 'symbol' is bound to a constant value by the Python code
    +        object 'code', return that value.  If 'symbol' is bound to an expression,
    +        return 'default'.  Otherwise, return 'None'.
    +
    +        Return value is based on the first assignment to 'symbol'.  'symbol' must
    +        be a global, or at least a non-"fast" local in the code block.  That is,
    +        only 'STORE_NAME' and 'STORE_GLOBAL' opcodes are checked, and 'symbol'
    +        must be present in 'code.co_names'.
    +        """
    +        if symbol not in code.co_names:
    +            # name's not there, can't possibly be an assignment
    +            return None
    +
    +        name_idx = list(code.co_names).index(symbol)
    +
    +        STORE_NAME = dis.opmap['STORE_NAME']
    +        STORE_GLOBAL = dis.opmap['STORE_GLOBAL']
    +        LOAD_CONST = dis.opmap['LOAD_CONST']
    +
    +        const = default
    +
    +        for byte_code in dis.Bytecode(code):
    +            op = byte_code.opcode
    +            arg = byte_code.arg
    +
    +            if op == LOAD_CONST:
    +                assert arg is not None
    +                const = code.co_consts[arg]
    +            elif arg == name_idx and (op == STORE_NAME or op == STORE_GLOBAL):
    +                return const
    +            else:
    +                const = default
    +
    +        return None
    +
    +    __all__ += ['get_module_constant', 'extract_constant']
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/discovery.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/discovery.py
    new file mode 100644
    index 000000000..c88839918
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/discovery.py
    @@ -0,0 +1,614 @@
    +"""Automatic discovery of Python modules and packages (for inclusion in the
    +distribution) and other config values.
    +
    +For the purposes of this module, the following nomenclature is used:
    +
    +- "src-layout": a directory representing a Python project that contains a "src"
    +  folder. Everything under the "src" folder is meant to be included in the
    +  distribution when packaging the project. Example::
    +
    +    .
    +    ├── tox.ini
    +    ├── pyproject.toml
    +    └── src/
    +        └── mypkg/
    +            ├── __init__.py
    +            ├── mymodule.py
    +            └── my_data_file.txt
    +
    +- "flat-layout": a Python project that does not use "src-layout" but instead
    +  have a directory under the project root for each package::
    +
    +    .
    +    ├── tox.ini
    +    ├── pyproject.toml
    +    └── mypkg/
    +        ├── __init__.py
    +        ├── mymodule.py
    +        └── my_data_file.txt
    +
    +- "single-module": a project that contains a single Python script direct under
    +  the project root (no directory used)::
    +
    +    .
    +    ├── tox.ini
    +    ├── pyproject.toml
    +    └── mymodule.py
    +
    +"""
    +
    +from __future__ import annotations
    +
    +import itertools
    +import os
    +from collections.abc import Iterable, Iterator, Mapping
    +from fnmatch import fnmatchcase
    +from glob import glob
    +from pathlib import Path
    +from typing import TYPE_CHECKING, ClassVar
    +
    +import _distutils_hack.override  # noqa: F401
    +
    +from ._path import StrPath
    +
    +from distutils import log
    +from distutils.util import convert_path
    +
    +if TYPE_CHECKING:
    +    from setuptools import Distribution
    +
    +chain_iter = itertools.chain.from_iterable
    +
    +
    +def _valid_name(path: StrPath) -> bool:
    +    # Ignore invalid names that cannot be imported directly
    +    return os.path.basename(path).isidentifier()
    +
    +
    +class _Filter:
    +    """
    +    Given a list of patterns, create a callable that will be true only if
    +    the input matches at least one of the patterns.
    +    """
    +
    +    def __init__(self, *patterns: str) -> None:
    +        self._patterns = dict.fromkeys(patterns)
    +
    +    def __call__(self, item: str) -> bool:
    +        return any(fnmatchcase(item, pat) for pat in self._patterns)
    +
    +    def __contains__(self, item: str) -> bool:
    +        return item in self._patterns
    +
    +
    +class _Finder:
    +    """Base class that exposes functionality for module/package finders"""
    +
    +    ALWAYS_EXCLUDE: ClassVar[tuple[str, ...]] = ()
    +    DEFAULT_EXCLUDE: ClassVar[tuple[str, ...]] = ()
    +
    +    @classmethod
    +    def find(
    +        cls,
    +        where: StrPath = '.',
    +        exclude: Iterable[str] = (),
    +        include: Iterable[str] = ('*',),
    +    ) -> list[str]:
    +        """Return a list of all Python items (packages or modules, depending on
    +        the finder implementation) found within directory 'where'.
    +
    +        'where' is the root directory which will be searched.
    +        It should be supplied as a "cross-platform" (i.e. URL-style) path;
    +        it will be converted to the appropriate local path syntax.
    +
    +        'exclude' is a sequence of names to exclude; '*' can be used
    +        as a wildcard in the names.
    +        When finding packages, 'foo.*' will exclude all subpackages of 'foo'
    +        (but not 'foo' itself).
    +
    +        'include' is a sequence of names to include.
    +        If it's specified, only the named items will be included.
    +        If it's not specified, all found items will be included.
    +        'include' can contain shell style wildcard patterns just like
    +        'exclude'.
    +        """
    +
    +        exclude = exclude or cls.DEFAULT_EXCLUDE
    +        return list(
    +            cls._find_iter(
    +                convert_path(str(where)),
    +                _Filter(*cls.ALWAYS_EXCLUDE, *exclude),
    +                _Filter(*include),
    +            )
    +        )
    +
    +    @classmethod
    +    def _find_iter(
    +        cls, where: StrPath, exclude: _Filter, include: _Filter
    +    ) -> Iterator[str]:
    +        raise NotImplementedError
    +
    +
    +class PackageFinder(_Finder):
    +    """
    +    Generate a list of all Python packages found within a directory
    +    """
    +
    +    ALWAYS_EXCLUDE = ("ez_setup", "*__pycache__")
    +
    +    @classmethod
    +    def _find_iter(
    +        cls, where: StrPath, exclude: _Filter, include: _Filter
    +    ) -> Iterator[str]:
    +        """
    +        All the packages found in 'where' that pass the 'include' filter, but
    +        not the 'exclude' filter.
    +        """
    +        for root, dirs, files in os.walk(str(where), followlinks=True):
    +            # Copy dirs to iterate over it, then empty dirs.
    +            all_dirs = dirs[:]
    +            dirs[:] = []
    +
    +            for dir in all_dirs:
    +                full_path = os.path.join(root, dir)
    +                rel_path = os.path.relpath(full_path, where)
    +                package = rel_path.replace(os.path.sep, '.')
    +
    +                # Skip directory trees that are not valid packages
    +                if '.' in dir or not cls._looks_like_package(full_path, package):
    +                    continue
    +
    +                # Should this package be included?
    +                if include(package) and not exclude(package):
    +                    yield package
    +
    +                # Early pruning if there is nothing else to be scanned
    +                if f"{package}*" in exclude or f"{package}.*" in exclude:
    +                    continue
    +
    +                # Keep searching subdirectories, as there may be more packages
    +                # down there, even if the parent was excluded.
    +                dirs.append(dir)
    +
    +    @staticmethod
    +    def _looks_like_package(path: StrPath, _package_name: str) -> bool:
    +        """Does a directory look like a package?"""
    +        return os.path.isfile(os.path.join(path, '__init__.py'))
    +
    +
    +class PEP420PackageFinder(PackageFinder):
    +    @staticmethod
    +    def _looks_like_package(_path: StrPath, _package_name: str) -> bool:
    +        return True
    +
    +
    +class ModuleFinder(_Finder):
    +    """Find isolated Python modules.
    +    This function will **not** recurse subdirectories.
    +    """
    +
    +    @classmethod
    +    def _find_iter(
    +        cls, where: StrPath, exclude: _Filter, include: _Filter
    +    ) -> Iterator[str]:
    +        for file in glob(os.path.join(where, "*.py")):
    +            module, _ext = os.path.splitext(os.path.basename(file))
    +
    +            if not cls._looks_like_module(module):
    +                continue
    +
    +            if include(module) and not exclude(module):
    +                yield module
    +
    +    _looks_like_module = staticmethod(_valid_name)
    +
    +
    +# We have to be extra careful in the case of flat layout to not include files
    +# and directories not meant for distribution (e.g. tool-related)
    +
    +
    +class FlatLayoutPackageFinder(PEP420PackageFinder):
    +    _EXCLUDE = (
    +        "ci",
    +        "bin",
    +        "debian",
    +        "doc",
    +        "docs",
    +        "documentation",
    +        "manpages",
    +        "news",
    +        "newsfragments",
    +        "changelog",
    +        "test",
    +        "tests",
    +        "unit_test",
    +        "unit_tests",
    +        "example",
    +        "examples",
    +        "scripts",
    +        "tools",
    +        "util",
    +        "utils",
    +        "python",
    +        "build",
    +        "dist",
    +        "venv",
    +        "env",
    +        "requirements",
    +        # ---- Task runners / Build tools ----
    +        "tasks",  # invoke
    +        "fabfile",  # fabric
    +        "site_scons",  # SCons
    +        # ---- Other tools ----
    +        "benchmark",
    +        "benchmarks",
    +        "exercise",
    +        "exercises",
    +        "htmlcov",  # Coverage.py
    +        # ---- Hidden directories/Private packages ----
    +        "[._]*",
    +    )
    +
    +    DEFAULT_EXCLUDE = tuple(chain_iter((p, f"{p}.*") for p in _EXCLUDE))
    +    """Reserved package names"""
    +
    +    @staticmethod
    +    def _looks_like_package(_path: StrPath, package_name: str) -> bool:
    +        names = package_name.split('.')
    +        # Consider PEP 561
    +        root_pkg_is_valid = names[0].isidentifier() or names[0].endswith("-stubs")
    +        return root_pkg_is_valid and all(name.isidentifier() for name in names[1:])
    +
    +
    +class FlatLayoutModuleFinder(ModuleFinder):
    +    DEFAULT_EXCLUDE = (
    +        "setup",
    +        "conftest",
    +        "test",
    +        "tests",
    +        "example",
    +        "examples",
    +        "build",
    +        # ---- Task runners ----
    +        "toxfile",
    +        "noxfile",
    +        "pavement",
    +        "dodo",
    +        "tasks",
    +        "fabfile",
    +        # ---- Other tools ----
    +        "[Ss][Cc]onstruct",  # SCons
    +        "conanfile",  # Connan: C/C++ build tool
    +        "manage",  # Django
    +        "benchmark",
    +        "benchmarks",
    +        "exercise",
    +        "exercises",
    +        # ---- Hidden files/Private modules ----
    +        "[._]*",
    +    )
    +    """Reserved top-level module names"""
    +
    +
    +def _find_packages_within(root_pkg: str, pkg_dir: StrPath) -> list[str]:
    +    nested = PEP420PackageFinder.find(pkg_dir)
    +    return [root_pkg] + [".".join((root_pkg, n)) for n in nested]
    +
    +
    +class ConfigDiscovery:
    +    """Fill-in metadata and options that can be automatically derived
    +    (from other metadata/options, the file system or conventions)
    +    """
    +
    +    def __init__(self, distribution: Distribution) -> None:
    +        self.dist = distribution
    +        self._called = False
    +        self._disabled = False
    +        self._skip_ext_modules = False
    +
    +    def _disable(self):
    +        """Internal API to disable automatic discovery"""
    +        self._disabled = True
    +
    +    def _ignore_ext_modules(self):
    +        """Internal API to disregard ext_modules.
    +
    +        Normally auto-discovery would not be triggered if ``ext_modules`` are set
    +        (this is done for backward compatibility with existing packages relying on
    +        ``setup.py`` or ``setup.cfg``). However, ``setuptools`` can call this function
    +        to ignore given ``ext_modules`` and proceed with the auto-discovery if
    +        ``packages`` and ``py_modules`` are not given (e.g. when using pyproject.toml
    +        metadata).
    +        """
    +        self._skip_ext_modules = True
    +
    +    @property
    +    def _root_dir(self) -> StrPath:
    +        # The best is to wait until `src_root` is set in dist, before using _root_dir.
    +        return self.dist.src_root or os.curdir
    +
    +    @property
    +    def _package_dir(self) -> dict[str, str]:
    +        if self.dist.package_dir is None:
    +            return {}
    +        return self.dist.package_dir
    +
    +    def __call__(
    +        self, force: bool = False, name: bool = True, ignore_ext_modules: bool = False
    +    ):
    +        """Automatically discover missing configuration fields
    +        and modifies the given ``distribution`` object in-place.
    +
    +        Note that by default this will only have an effect the first time the
    +        ``ConfigDiscovery`` object is called.
    +
    +        To repeatedly invoke automatic discovery (e.g. when the project
    +        directory changes), please use ``force=True`` (or create a new
    +        ``ConfigDiscovery`` instance).
    +        """
    +        if force is False and (self._called or self._disabled):
    +            # Avoid overhead of multiple calls
    +            return
    +
    +        self._analyse_package_layout(ignore_ext_modules)
    +        if name:
    +            self.analyse_name()  # depends on ``packages`` and ``py_modules``
    +
    +        self._called = True
    +
    +    def _explicitly_specified(self, ignore_ext_modules: bool) -> bool:
    +        """``True`` if the user has specified some form of package/module listing"""
    +        ignore_ext_modules = ignore_ext_modules or self._skip_ext_modules
    +        ext_modules = not (self.dist.ext_modules is None or ignore_ext_modules)
    +        return (
    +            self.dist.packages is not None
    +            or self.dist.py_modules is not None
    +            or ext_modules
    +            or hasattr(self.dist, "configuration")
    +            and self.dist.configuration
    +            # ^ Some projects use numpy.distutils.misc_util.Configuration
    +        )
    +
    +    def _analyse_package_layout(self, ignore_ext_modules: bool) -> bool:
    +        if self._explicitly_specified(ignore_ext_modules):
    +            # For backward compatibility, just try to find modules/packages
    +            # when nothing is given
    +            return True
    +
    +        log.debug(
    +            "No `packages` or `py_modules` configuration, performing "
    +            "automatic discovery."
    +        )
    +
    +        return (
    +            self._analyse_explicit_layout()
    +            or self._analyse_src_layout()
    +            # flat-layout is the trickiest for discovery so it should be last
    +            or self._analyse_flat_layout()
    +        )
    +
    +    def _analyse_explicit_layout(self) -> bool:
    +        """The user can explicitly give a package layout via ``package_dir``"""
    +        package_dir = self._package_dir.copy()  # don't modify directly
    +        package_dir.pop("", None)  # This falls under the "src-layout" umbrella
    +        root_dir = self._root_dir
    +
    +        if not package_dir:
    +            return False
    +
    +        log.debug(f"`explicit-layout` detected -- analysing {package_dir}")
    +        pkgs = chain_iter(
    +            _find_packages_within(pkg, os.path.join(root_dir, parent_dir))
    +            for pkg, parent_dir in package_dir.items()
    +        )
    +        self.dist.packages = list(pkgs)
    +        log.debug(f"discovered packages -- {self.dist.packages}")
    +        return True
    +
    +    def _analyse_src_layout(self) -> bool:
    +        """Try to find all packages or modules under the ``src`` directory
    +        (or anything pointed by ``package_dir[""]``).
    +
    +        The "src-layout" is relatively safe for automatic discovery.
    +        We assume that everything within is meant to be included in the
    +        distribution.
    +
    +        If ``package_dir[""]`` is not given, but the ``src`` directory exists,
    +        this function will set ``package_dir[""] = "src"``.
    +        """
    +        package_dir = self._package_dir
    +        src_dir = os.path.join(self._root_dir, package_dir.get("", "src"))
    +        if not os.path.isdir(src_dir):
    +            return False
    +
    +        log.debug(f"`src-layout` detected -- analysing {src_dir}")
    +        package_dir.setdefault("", os.path.basename(src_dir))
    +        self.dist.package_dir = package_dir  # persist eventual modifications
    +        self.dist.packages = PEP420PackageFinder.find(src_dir)
    +        self.dist.py_modules = ModuleFinder.find(src_dir)
    +        log.debug(f"discovered packages -- {self.dist.packages}")
    +        log.debug(f"discovered py_modules -- {self.dist.py_modules}")
    +        return True
    +
    +    def _analyse_flat_layout(self) -> bool:
    +        """Try to find all packages and modules under the project root.
    +
    +        Since the ``flat-layout`` is more dangerous in terms of accidentally including
    +        extra files/directories, this function is more conservative and will raise an
    +        error if multiple packages or modules are found.
    +
    +        This assumes that multi-package dists are uncommon and refuse to support that
    +        use case in order to be able to prevent unintended errors.
    +        """
    +        log.debug(f"`flat-layout` detected -- analysing {self._root_dir}")
    +        return self._analyse_flat_packages() or self._analyse_flat_modules()
    +
    +    def _analyse_flat_packages(self) -> bool:
    +        self.dist.packages = FlatLayoutPackageFinder.find(self._root_dir)
    +        top_level = remove_nested_packages(remove_stubs(self.dist.packages))
    +        log.debug(f"discovered packages -- {self.dist.packages}")
    +        self._ensure_no_accidental_inclusion(top_level, "packages")
    +        return bool(top_level)
    +
    +    def _analyse_flat_modules(self) -> bool:
    +        self.dist.py_modules = FlatLayoutModuleFinder.find(self._root_dir)
    +        log.debug(f"discovered py_modules -- {self.dist.py_modules}")
    +        self._ensure_no_accidental_inclusion(self.dist.py_modules, "modules")
    +        return bool(self.dist.py_modules)
    +
    +    def _ensure_no_accidental_inclusion(self, detected: list[str], kind: str):
    +        if len(detected) > 1:
    +            from inspect import cleandoc
    +
    +            from setuptools.errors import PackageDiscoveryError
    +
    +            msg = f"""Multiple top-level {kind} discovered in a flat-layout: {detected}.
    +
    +            To avoid accidental inclusion of unwanted files or directories,
    +            setuptools will not proceed with this build.
    +
    +            If you are trying to create a single distribution with multiple {kind}
    +            on purpose, you should not rely on automatic discovery.
    +            Instead, consider the following options:
    +
    +            1. set up custom discovery (`find` directive with `include` or `exclude`)
    +            2. use a `src-layout`
    +            3. explicitly set `py_modules` or `packages` with a list of names
    +
    +            To find more information, look for "package discovery" on setuptools docs.
    +            """
    +            raise PackageDiscoveryError(cleandoc(msg))
    +
    +    def analyse_name(self) -> None:
    +        """The packages/modules are the essential contribution of the author.
    +        Therefore the name of the distribution can be derived from them.
    +        """
    +        if self.dist.metadata.name or self.dist.name:
    +            # get_name() is not reliable (can return "UNKNOWN")
    +            return
    +
    +        log.debug("No `name` configuration, performing automatic discovery")
    +
    +        name = (
    +            self._find_name_single_package_or_module()
    +            or self._find_name_from_packages()
    +        )
    +        if name:
    +            self.dist.metadata.name = name
    +
    +    def _find_name_single_package_or_module(self) -> str | None:
    +        """Exactly one module or package"""
    +        for field in ('packages', 'py_modules'):
    +            items = getattr(self.dist, field, None) or []
    +            if items and len(items) == 1:
    +                log.debug(f"Single module/package detected, name: {items[0]}")
    +                return items[0]
    +
    +        return None
    +
    +    def _find_name_from_packages(self) -> str | None:
    +        """Try to find the root package that is not a PEP 420 namespace"""
    +        if not self.dist.packages:
    +            return None
    +
    +        packages = remove_stubs(sorted(self.dist.packages, key=len))
    +        package_dir = self.dist.package_dir or {}
    +
    +        parent_pkg = find_parent_package(packages, package_dir, self._root_dir)
    +        if parent_pkg:
    +            log.debug(f"Common parent package detected, name: {parent_pkg}")
    +            return parent_pkg
    +
    +        log.warn("No parent package detected, impossible to derive `name`")
    +        return None
    +
    +
    +def remove_nested_packages(packages: list[str]) -> list[str]:
    +    """Remove nested packages from a list of packages.
    +
    +    >>> remove_nested_packages(["a", "a.b1", "a.b2", "a.b1.c1"])
    +    ['a']
    +    >>> remove_nested_packages(["a", "b", "c.d", "c.d.e.f", "g.h", "a.a1"])
    +    ['a', 'b', 'c.d', 'g.h']
    +    """
    +    pkgs = sorted(packages, key=len)
    +    top_level = pkgs[:]
    +    size = len(pkgs)
    +    for i, name in enumerate(reversed(pkgs)):
    +        if any(name.startswith(f"{other}.") for other in top_level):
    +            top_level.pop(size - i - 1)
    +
    +    return top_level
    +
    +
    +def remove_stubs(packages: list[str]) -> list[str]:
    +    """Remove type stubs (:pep:`561`) from a list of packages.
    +
    +    >>> remove_stubs(["a", "a.b", "a-stubs", "a-stubs.b.c", "b", "c-stubs"])
    +    ['a', 'a.b', 'b']
    +    """
    +    return [pkg for pkg in packages if not pkg.split(".")[0].endswith("-stubs")]
    +
    +
    +def find_parent_package(
    +    packages: list[str], package_dir: Mapping[str, str], root_dir: StrPath
    +) -> str | None:
    +    """Find the parent package that is not a namespace."""
    +    packages = sorted(packages, key=len)
    +    common_ancestors = []
    +    for i, name in enumerate(packages):
    +        if not all(n.startswith(f"{name}.") for n in packages[i + 1 :]):
    +            # Since packages are sorted by length, this condition is able
    +            # to find a list of all common ancestors.
    +            # When there is divergence (e.g. multiple root packages)
    +            # the list will be empty
    +            break
    +        common_ancestors.append(name)
    +
    +    for name in common_ancestors:
    +        pkg_path = find_package_path(name, package_dir, root_dir)
    +        init = os.path.join(pkg_path, "__init__.py")
    +        if os.path.isfile(init):
    +            return name
    +
    +    return None
    +
    +
    +def find_package_path(
    +    name: str, package_dir: Mapping[str, str], root_dir: StrPath
    +) -> str:
    +    """Given a package name, return the path where it should be found on
    +    disk, considering the ``package_dir`` option.
    +
    +    >>> path = find_package_path("my.pkg", {"": "root/is/nested"}, ".")
    +    >>> path.replace(os.sep, "/")
    +    './root/is/nested/my/pkg'
    +
    +    >>> path = find_package_path("my.pkg", {"my": "root/is/nested"}, ".")
    +    >>> path.replace(os.sep, "/")
    +    './root/is/nested/pkg'
    +
    +    >>> path = find_package_path("my.pkg", {"my.pkg": "root/is/nested"}, ".")
    +    >>> path.replace(os.sep, "/")
    +    './root/is/nested'
    +
    +    >>> path = find_package_path("other.pkg", {"my.pkg": "root/is/nested"}, ".")
    +    >>> path.replace(os.sep, "/")
    +    './other/pkg'
    +    """
    +    parts = name.split(".")
    +    for i in range(len(parts), 0, -1):
    +        # Look backwards, the most specific package_dir first
    +        partial_name = ".".join(parts[:i])
    +        if partial_name in package_dir:
    +            parent = package_dir[partial_name]
    +            return os.path.join(root_dir, parent, *parts[i:])
    +
    +    parent = package_dir.get("") or ""
    +    return os.path.join(root_dir, *parent.split("/"), *parts)
    +
    +
    +def construct_package_dir(packages: list[str], package_path: StrPath) -> dict[str, str]:
    +    parent_pkgs = remove_nested_packages(packages)
    +    prefix = Path(package_path).parts
    +    return {pkg: "/".join([*prefix, *pkg.split(".")]) for pkg in parent_pkgs}
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/dist.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/dist.py
    new file mode 100644
    index 000000000..f06298c86
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/dist.py
    @@ -0,0 +1,1119 @@
    +from __future__ import annotations
    +
    +import functools
    +import io
    +import itertools
    +import numbers
    +import os
    +import re
    +import sys
    +from collections.abc import Iterable, Iterator, MutableMapping, Sequence
    +from glob import glob
    +from pathlib import Path
    +from typing import TYPE_CHECKING, Any, Union
    +
    +from more_itertools import partition, unique_everseen
    +from packaging.markers import InvalidMarker, Marker
    +from packaging.specifiers import InvalidSpecifier, SpecifierSet
    +from packaging.version import Version
    +
    +from . import (
    +    _entry_points,
    +    _reqs,
    +    _static,
    +    command as _,  # noqa: F401 # imported for side-effects
    +)
    +from ._importlib import metadata
    +from ._normalization import _canonicalize_license_expression
    +from ._path import StrPath
    +from ._reqs import _StrOrIter
    +from .config import pyprojecttoml, setupcfg
    +from .discovery import ConfigDiscovery
    +from .errors import InvalidConfigError
    +from .monkey import get_unpatched
    +from .warnings import InformationOnly, SetuptoolsDeprecationWarning
    +
    +import distutils.cmd
    +import distutils.command
    +import distutils.core
    +import distutils.dist
    +import distutils.log
    +from distutils.debug import DEBUG
    +from distutils.errors import DistutilsOptionError, DistutilsSetupError
    +from distutils.fancy_getopt import translate_longopt
    +from distutils.util import strtobool
    +
    +if TYPE_CHECKING:
    +    from typing_extensions import TypeAlias
    +
    +
    +__all__ = ['Distribution']
    +
    +_sequence = tuple, list
    +"""
    +:meta private:
    +
    +Supported iterable types that are known to be:
    +- ordered (which `set` isn't)
    +- not match a str (which `Sequence[str]` does)
    +- not imply a nested type (like `dict`)
    +for use with `isinstance`.
    +"""
    +_Sequence: TypeAlias = Union[tuple[str, ...], list[str]]
    +# This is how stringifying _Sequence would look in Python 3.10
    +_sequence_type_repr = "tuple[str, ...] | list[str]"
    +_OrderedStrSequence: TypeAlias = Union[str, dict[str, Any], Sequence[str]]
    +"""
    +:meta private:
    +Avoid single-use iterable. Disallow sets.
    +A poor approximation of an OrderedSequence (dict doesn't match a Sequence).
    +"""
    +
    +
    +def __getattr__(name: str) -> Any:  # pragma: no cover
    +    if name == "sequence":
    +        SetuptoolsDeprecationWarning.emit(
    +            "`setuptools.dist.sequence` is an internal implementation detail.",
    +            "Please define your own `sequence = tuple, list` instead.",
    +            due_date=(2025, 8, 28),  # Originally added on 2024-08-27
    +        )
    +        return _sequence
    +    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
    +
    +
    +def check_importable(dist, attr, value):
    +    try:
    +        ep = metadata.EntryPoint(value=value, name=None, group=None)
    +        assert not ep.extras
    +    except (TypeError, ValueError, AttributeError, AssertionError) as e:
    +        raise DistutilsSetupError(
    +            f"{attr!r} must be importable 'module:attrs' string (got {value!r})"
    +        ) from e
    +
    +
    +def assert_string_list(dist, attr: str, value: _Sequence) -> None:
    +    """Verify that value is a string list"""
    +    try:
    +        # verify that value is a list or tuple to exclude unordered
    +        # or single-use iterables
    +        assert isinstance(value, _sequence)
    +        # verify that elements of value are strings
    +        assert ''.join(value) != value
    +    except (TypeError, ValueError, AttributeError, AssertionError) as e:
    +        raise DistutilsSetupError(
    +            f"{attr!r} must be of type <{_sequence_type_repr}> (got {value!r})"
    +        ) from e
    +
    +
    +def check_nsp(dist, attr, value):
    +    """Verify that namespace packages are valid"""
    +    ns_packages = value
    +    assert_string_list(dist, attr, ns_packages)
    +    for nsp in ns_packages:
    +        if not dist.has_contents_for(nsp):
    +            raise DistutilsSetupError(
    +                f"Distribution contains no modules or packages for namespace package {nsp!r}"
    +            )
    +        parent, _sep, _child = nsp.rpartition('.')
    +        if parent and parent not in ns_packages:
    +            distutils.log.warn(
    +                "WARNING: %r is declared as a package namespace, but %r"
    +                " is not: please correct this in setup.py",
    +                nsp,
    +                parent,
    +            )
    +        SetuptoolsDeprecationWarning.emit(
    +            "The namespace_packages parameter is deprecated.",
    +            "Please replace its usage with implicit namespaces (PEP 420).",
    +            see_docs="references/keywords.html#keyword-namespace-packages",
    +            # TODO: define due_date, it may break old packages that are no longer
    +            # maintained (e.g. sphinxcontrib extensions) when installed from source.
    +            # Warning officially introduced in May 2022, however the deprecation
    +            # was mentioned much earlier in the docs (May 2020, see #2149).
    +        )
    +
    +
    +def check_extras(dist, attr, value):
    +    """Verify that extras_require mapping is valid"""
    +    try:
    +        list(itertools.starmap(_check_extra, value.items()))
    +    except (TypeError, ValueError, AttributeError) as e:
    +        raise DistutilsSetupError(
    +            "'extras_require' must be a dictionary whose values are "
    +            "strings or lists of strings containing valid project/version "
    +            "requirement specifiers."
    +        ) from e
    +
    +
    +def _check_extra(extra, reqs):
    +    _name, _sep, marker = extra.partition(':')
    +    try:
    +        _check_marker(marker)
    +    except InvalidMarker:
    +        msg = f"Invalid environment marker: {marker} ({extra!r})"
    +        raise DistutilsSetupError(msg) from None
    +    list(_reqs.parse(reqs))
    +
    +
    +def _check_marker(marker):
    +    if not marker:
    +        return
    +    m = Marker(marker)
    +    m.evaluate()
    +
    +
    +def assert_bool(dist, attr, value):
    +    """Verify that value is True, False, 0, or 1"""
    +    if bool(value) != value:
    +        raise DistutilsSetupError(f"{attr!r} must be a boolean value (got {value!r})")
    +
    +
    +def invalid_unless_false(dist, attr, value):
    +    if not value:
    +        DistDeprecationWarning.emit(f"{attr} is ignored.")
    +        # TODO: should there be a `due_date` here?
    +        return
    +    raise DistutilsSetupError(f"{attr} is invalid.")
    +
    +
    +def check_requirements(dist, attr: str, value: _OrderedStrSequence) -> None:
    +    """Verify that install_requires is a valid requirements list"""
    +    try:
    +        list(_reqs.parse(value))
    +        if isinstance(value, set):
    +            raise TypeError("Unordered types are not allowed")
    +    except (TypeError, ValueError) as error:
    +        msg = (
    +            f"{attr!r} must be a string or iterable of strings "
    +            f"containing valid project/version requirement specifiers; {error}"
    +        )
    +        raise DistutilsSetupError(msg) from error
    +
    +
    +def check_specifier(dist, attr, value):
    +    """Verify that value is a valid version specifier"""
    +    try:
    +        SpecifierSet(value)
    +    except (InvalidSpecifier, AttributeError) as error:
    +        msg = f"{attr!r} must be a string containing valid version specifiers; {error}"
    +        raise DistutilsSetupError(msg) from error
    +
    +
    +def check_entry_points(dist, attr, value):
    +    """Verify that entry_points map is parseable"""
    +    try:
    +        _entry_points.load(value)
    +    except Exception as e:
    +        raise DistutilsSetupError(e) from e
    +
    +
    +def check_package_data(dist, attr, value):
    +    """Verify that value is a dictionary of package names to glob lists"""
    +    if not isinstance(value, dict):
    +        raise DistutilsSetupError(
    +            f"{attr!r} must be a dictionary mapping package names to lists of "
    +            "string wildcard patterns"
    +        )
    +    for k, v in value.items():
    +        if not isinstance(k, str):
    +            raise DistutilsSetupError(
    +                f"keys of {attr!r} dict must be strings (got {k!r})"
    +            )
    +        assert_string_list(dist, f'values of {attr!r} dict', v)
    +
    +
    +def check_packages(dist, attr, value):
    +    for pkgname in value:
    +        if not re.match(r'\w+(\.\w+)*', pkgname):
    +            distutils.log.warn(
    +                "WARNING: %r not a valid package name; please use only "
    +                ".-separated package names in setup.py",
    +                pkgname,
    +            )
    +
    +
    +if TYPE_CHECKING:
    +    # Work around a mypy issue where type[T] can't be used as a base: https://github.com/python/mypy/issues/10962
    +    from distutils.core import Distribution as _Distribution
    +else:
    +    _Distribution = get_unpatched(distutils.core.Distribution)
    +
    +
    +class Distribution(_Distribution):
    +    """Distribution with support for tests and package data
    +
    +    This is an enhanced version of 'distutils.dist.Distribution' that
    +    effectively adds the following new optional keyword arguments to 'setup()':
    +
    +     'install_requires' -- a string or sequence of strings specifying project
    +        versions that the distribution requires when installed, in the format
    +        used by 'pkg_resources.require()'.  They will be installed
    +        automatically when the package is installed.  If you wish to use
    +        packages that are not available in PyPI, or want to give your users an
    +        alternate download location, you can add a 'find_links' option to the
    +        '[easy_install]' section of your project's 'setup.cfg' file, and then
    +        setuptools will scan the listed web pages for links that satisfy the
    +        requirements.
    +
    +     'extras_require' -- a dictionary mapping names of optional "extras" to the
    +        additional requirement(s) that using those extras incurs. For example,
    +        this::
    +
    +            extras_require = dict(reST = ["docutils>=0.3", "reSTedit"])
    +
    +        indicates that the distribution can optionally provide an extra
    +        capability called "reST", but it can only be used if docutils and
    +        reSTedit are installed.  If the user installs your package using
    +        EasyInstall and requests one of your extras, the corresponding
    +        additional requirements will be installed if needed.
    +
    +     'package_data' -- a dictionary mapping package names to lists of filenames
    +        or globs to use to find data files contained in the named packages.
    +        If the dictionary has filenames or globs listed under '""' (the empty
    +        string), those names will be searched for in every package, in addition
    +        to any names for the specific package.  Data files found using these
    +        names/globs will be installed along with the package, in the same
    +        location as the package.  Note that globs are allowed to reference
    +        the contents of non-package subdirectories, as long as you use '/' as
    +        a path separator.  (Globs are automatically converted to
    +        platform-specific paths at runtime.)
    +
    +    In addition to these new keywords, this class also has several new methods
    +    for manipulating the distribution's contents.  For example, the 'include()'
    +    and 'exclude()' methods can be thought of as in-place add and subtract
    +    commands that add or remove packages, modules, extensions, and so on from
    +    the distribution.
    +    """
    +
    +    _DISTUTILS_UNSUPPORTED_METADATA = {
    +        'long_description_content_type': lambda: None,
    +        'project_urls': dict,
    +        'provides_extras': dict,  # behaves like an ordered set
    +        'license_expression': lambda: None,
    +        'license_file': lambda: None,
    +        'license_files': lambda: None,
    +        'install_requires': list,
    +        'extras_require': dict,
    +    }
    +
    +    # Used by build_py, editable_wheel and install_lib commands for legacy namespaces
    +    namespace_packages: list[str]  #: :meta private: DEPRECATED
    +
    +    # Any: Dynamic assignment results in Incompatible types in assignment
    +    def __init__(self, attrs: MutableMapping[str, Any] | None = None) -> None:
    +        have_package_data = hasattr(self, "package_data")
    +        if not have_package_data:
    +            self.package_data: dict[str, list[str]] = {}
    +        attrs = attrs or {}
    +        self.dist_files: list[tuple[str, str, str]] = []
    +        self.include_package_data: bool | None = None
    +        self.exclude_package_data: dict[str, list[str]] | None = None
    +        # Filter-out setuptools' specific options.
    +        self.src_root: str | None = attrs.pop("src_root", None)
    +        self.dependency_links: list[str] = attrs.pop('dependency_links', [])
    +        self.setup_requires: list[str] = attrs.pop('setup_requires', [])
    +        for ep in metadata.entry_points(group='distutils.setup_keywords'):
    +            vars(self).setdefault(ep.name, None)
    +
    +        metadata_only = set(self._DISTUTILS_UNSUPPORTED_METADATA)
    +        metadata_only -= {"install_requires", "extras_require"}
    +        dist_attrs = {k: v for k, v in attrs.items() if k not in metadata_only}
    +        _Distribution.__init__(self, dist_attrs)
    +
    +        # Private API (setuptools-use only, not restricted to Distribution)
    +        # Stores files that are referenced by the configuration and need to be in the
    +        # sdist (e.g. `version = file: VERSION.txt`)
    +        self._referenced_files = set[str]()
    +
    +        self.set_defaults = ConfigDiscovery(self)
    +
    +        self._set_metadata_defaults(attrs)
    +
    +        self.metadata.version = self._normalize_version(self.metadata.version)
    +        self._finalize_requires()
    +
    +    def _validate_metadata(self):
    +        required = {"name"}
    +        provided = {
    +            key
    +            for key in vars(self.metadata)
    +            if getattr(self.metadata, key, None) is not None
    +        }
    +        missing = required - provided
    +
    +        if missing:
    +            msg = f"Required package metadata is missing: {missing}"
    +            raise DistutilsSetupError(msg)
    +
    +    def _set_metadata_defaults(self, attrs):
    +        """
    +        Fill-in missing metadata fields not supported by distutils.
    +        Some fields may have been set by other tools (e.g. pbr).
    +        Those fields (vars(self.metadata)) take precedence to
    +        supplied attrs.
    +        """
    +        for option, default in self._DISTUTILS_UNSUPPORTED_METADATA.items():
    +            vars(self.metadata).setdefault(option, attrs.get(option, default()))
    +
    +    @staticmethod
    +    def _normalize_version(version):
    +        from . import sic
    +
    +        if isinstance(version, numbers.Number):
    +            # Some people apparently take "version number" too literally :)
    +            version = str(version)
    +        elif isinstance(version, sic) or version is None:
    +            return version
    +
    +        normalized = str(Version(version))
    +        if version != normalized:
    +            InformationOnly.emit(f"Normalizing '{version}' to '{normalized}'")
    +            return normalized
    +        return version
    +
    +    def _finalize_requires(self):
    +        """
    +        Set `metadata.python_requires` and fix environment markers
    +        in `install_requires` and `extras_require`.
    +        """
    +        if getattr(self, 'python_requires', None):
    +            self.metadata.python_requires = self.python_requires
    +
    +        self._normalize_requires()
    +        self.metadata.install_requires = self.install_requires
    +        self.metadata.extras_require = self.extras_require
    +
    +        if self.extras_require:
    +            for extra in self.extras_require.keys():
    +                # Setuptools allows a weird ": syntax for extras
    +                extra = extra.split(':')[0]
    +                if extra:
    +                    self.metadata.provides_extras.setdefault(extra)
    +
    +    def _normalize_requires(self):
    +        """Make sure requirement-related attributes exist and are normalized"""
    +        install_requires = getattr(self, "install_requires", None) or []
    +        extras_require = getattr(self, "extras_require", None) or {}
    +
    +        # Preserve the "static"-ness of values parsed from config files
    +        list_ = _static.List if _static.is_static(install_requires) else list
    +        self.install_requires = list_(map(str, _reqs.parse(install_requires)))
    +
    +        dict_ = _static.Dict if _static.is_static(extras_require) else dict
    +        self.extras_require = dict_(
    +            (k, list(map(str, _reqs.parse(v or [])))) for k, v in extras_require.items()
    +        )
    +
    +    def _finalize_license_expression(self) -> None:
    +        """
    +        Normalize license and license_expression.
    +        >>> dist = Distribution({"license_expression": _static.Str("mit aNd  gpl-3.0-OR-later")})
    +        >>> _static.is_static(dist.metadata.license_expression)
    +        True
    +        >>> dist._finalize_license_expression()
    +        >>> _static.is_static(dist.metadata.license_expression)  # preserve "static-ness"
    +        True
    +        >>> print(dist.metadata.license_expression)
    +        MIT AND GPL-3.0-or-later
    +        """
    +        classifiers = self.metadata.get_classifiers()
    +        license_classifiers = [cl for cl in classifiers if cl.startswith("License :: ")]
    +
    +        license_expr = self.metadata.license_expression
    +        if license_expr:
    +            str_ = _static.Str if _static.is_static(license_expr) else str
    +            normalized = str_(_canonicalize_license_expression(license_expr))
    +            if license_expr != normalized:
    +                InformationOnly.emit(f"Normalizing '{license_expr}' to '{normalized}'")
    +                self.metadata.license_expression = normalized
    +            if license_classifiers:
    +                raise InvalidConfigError(
    +                    "License classifiers have been superseded by license expressions "
    +                    "(see https://peps.python.org/pep-0639/). Please remove:\n\n"
    +                    + "\n".join(license_classifiers),
    +                )
    +        elif license_classifiers:
    +            pypa_guides = "guides/writing-pyproject-toml/#license"
    +            SetuptoolsDeprecationWarning.emit(
    +                "License classifiers are deprecated.",
    +                "Please consider removing the following classifiers in favor of a "
    +                "SPDX license expression:\n\n" + "\n".join(license_classifiers),
    +                see_url=f"https://packaging.python.org/en/latest/{pypa_guides}",
    +                # Warning introduced on 2025-02-17
    +                # TODO: Should we add a due date? It may affect old/unmaintained
    +                #       packages in the ecosystem and cause problems...
    +            )
    +
    +    def _finalize_license_files(self) -> None:
    +        """Compute names of all license files which should be included."""
    +        license_files: list[str] | None = self.metadata.license_files
    +        patterns = license_files or []
    +
    +        license_file: str | None = self.metadata.license_file
    +        if license_file and license_file not in patterns:
    +            patterns.append(license_file)
    +
    +        if license_files is None and license_file is None:
    +            # Default patterns match the ones wheel uses
    +            # See https://wheel.readthedocs.io/en/stable/user_guide.html
    +            # -> 'Including license files in the generated wheel file'
    +            patterns = ['LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*']
    +            files = self._expand_patterns(patterns, enforce_match=False)
    +        else:  # Patterns explicitly given by the user
    +            files = self._expand_patterns(patterns, enforce_match=True)
    +
    +        self.metadata.license_files = list(unique_everseen(files))
    +
    +    @classmethod
    +    def _expand_patterns(
    +        cls, patterns: list[str], enforce_match: bool = True
    +    ) -> Iterator[str]:
    +        """
    +        >>> getfixture('sample_project_cwd')
    +        >>> list(Distribution._expand_patterns(['LICENSE.txt']))
    +        ['LICENSE.txt']
    +        >>> list(Distribution._expand_patterns(['pyproject.toml', 'LIC*']))
    +        ['pyproject.toml', 'LICENSE.txt']
    +        >>> list(Distribution._expand_patterns(['src/**/*.dat']))
    +        ['src/sample/package_data.dat']
    +        """
    +        return (
    +            path.replace(os.sep, "/")
    +            for pattern in patterns
    +            for path in sorted(cls._find_pattern(pattern, enforce_match))
    +            if not path.endswith('~') and os.path.isfile(path)
    +        )
    +
    +    @staticmethod
    +    def _find_pattern(pattern: str, enforce_match: bool = True) -> list[str]:
    +        r"""
    +        >>> getfixture('sample_project_cwd')
    +        >>> Distribution._find_pattern("LICENSE.txt")
    +        ['LICENSE.txt']
    +        >>> Distribution._find_pattern("/LICENSE.MIT")
    +        Traceback (most recent call last):
    +        ...
    +        setuptools.errors.InvalidConfigError: Pattern '/LICENSE.MIT' should be relative...
    +        >>> Distribution._find_pattern("../LICENSE.MIT")
    +        Traceback (most recent call last):
    +        ...
    +        setuptools.warnings.SetuptoolsDeprecationWarning: ...Pattern '../LICENSE.MIT' cannot contain '..'...
    +        >>> Distribution._find_pattern("LICEN{CSE*")
    +        Traceback (most recent call last):
    +        ...
    +        setuptools.warnings.SetuptoolsDeprecationWarning: ...Pattern 'LICEN{CSE*' contains invalid characters...
    +        """
    +        pypa_guides = "specifications/glob-patterns/"
    +        if ".." in pattern:
    +            SetuptoolsDeprecationWarning.emit(
    +                f"Pattern {pattern!r} cannot contain '..'",
    +                """
    +                Please ensure the files specified are contained by the root
    +                of the Python package (normally marked by `pyproject.toml`).
    +                """,
    +                see_url=f"https://packaging.python.org/en/latest/{pypa_guides}",
    +                due_date=(2026, 3, 20),  # Introduced in 2025-03-20
    +                # Replace with InvalidConfigError after deprecation
    +            )
    +        if pattern.startswith((os.sep, "/")) or ":\\" in pattern:
    +            raise InvalidConfigError(
    +                f"Pattern {pattern!r} should be relative and must not start with '/'"
    +            )
    +        if re.match(r'^[\w\-\.\/\*\?\[\]]+$', pattern) is None:
    +            SetuptoolsDeprecationWarning.emit(
    +                "Please provide a valid glob pattern.",
    +                "Pattern {pattern!r} contains invalid characters.",
    +                pattern=pattern,
    +                see_url=f"https://packaging.python.org/en/latest/{pypa_guides}",
    +                due_date=(2026, 3, 20),  # Introduced in 2025-02-20
    +            )
    +
    +        found = glob(pattern, recursive=True)
    +
    +        if enforce_match and not found:
    +            SetuptoolsDeprecationWarning.emit(
    +                "Cannot find any files for the given pattern.",
    +                "Pattern {pattern!r} did not match any files.",
    +                pattern=pattern,
    +                due_date=(2026, 3, 20),  # Introduced in 2025-02-20
    +                # PEP 639 requires us to error, but as a transition period
    +                # we will only issue a warning to give people time to prepare.
    +                # After the transition, this should raise an InvalidConfigError.
    +            )
    +        return found
    +
    +    # FIXME: 'Distribution._parse_config_files' is too complex (14)
    +    def _parse_config_files(self, filenames=None):  # noqa: C901
    +        """
    +        Adapted from distutils.dist.Distribution.parse_config_files,
    +        this method provides the same functionality in subtly-improved
    +        ways.
    +        """
    +        from configparser import ConfigParser
    +
    +        # Ignore install directory options if we have a venv
    +        ignore_options = (
    +            []
    +            if sys.prefix == sys.base_prefix
    +            else [
    +                'install-base',
    +                'install-platbase',
    +                'install-lib',
    +                'install-platlib',
    +                'install-purelib',
    +                'install-headers',
    +                'install-scripts',
    +                'install-data',
    +                'prefix',
    +                'exec-prefix',
    +                'home',
    +                'user',
    +                'root',
    +            ]
    +        )
    +
    +        ignore_options = frozenset(ignore_options)
    +
    +        if filenames is None:
    +            filenames = self.find_config_files()
    +
    +        if DEBUG:
    +            self.announce("Distribution.parse_config_files():")
    +
    +        parser = ConfigParser()
    +        parser.optionxform = str
    +        for filename in filenames:
    +            with open(filename, encoding='utf-8') as reader:
    +                if DEBUG:
    +                    self.announce("  reading {filename}".format(**locals()))
    +                parser.read_file(reader)
    +            for section in parser.sections():
    +                options = parser.options(section)
    +                opt_dict = self.get_option_dict(section)
    +
    +                for opt in options:
    +                    if opt == '__name__' or opt in ignore_options:
    +                        continue
    +
    +                    val = parser.get(section, opt)
    +                    opt = self._enforce_underscore(opt, section)
    +                    opt = self._enforce_option_lowercase(opt, section)
    +                    opt_dict[opt] = (filename, val)
    +
    +            # Make the ConfigParser forget everything (so we retain
    +            # the original filenames that options come from)
    +            parser.__init__()
    +
    +        if 'global' not in self.command_options:
    +            return
    +
    +        # If there was a "global" section in the config file, use it
    +        # to set Distribution options.
    +
    +        for opt, (src, val) in self.command_options['global'].items():
    +            alias = self.negative_opt.get(opt)
    +            if alias:
    +                val = not strtobool(val)
    +            elif opt in ('verbose', 'dry_run'):  # ugh!
    +                val = strtobool(val)
    +
    +            try:
    +                setattr(self, alias or opt, val)
    +            except ValueError as e:
    +                raise DistutilsOptionError(e) from e
    +
    +    def _enforce_underscore(self, opt: str, section: str) -> str:
    +        if "-" not in opt or self._skip_setupcfg_normalization(section):
    +            return opt
    +
    +        underscore_opt = opt.replace('-', '_')
    +        affected = f"(Affected: {self.metadata.name})." if self.metadata.name else ""
    +        SetuptoolsDeprecationWarning.emit(
    +            f"Invalid dash-separated key {opt!r} in {section!r} (setup.cfg), "
    +            f"please use the underscore name {underscore_opt!r} instead.",
    +            f"""
    +            Usage of dash-separated {opt!r} will not be supported in future
    +            versions. Please use the underscore name {underscore_opt!r} instead.
    +            {affected}
    +            """,
    +            see_docs="userguide/declarative_config.html",
    +            due_date=(2026, 3, 3),
    +            # Warning initially introduced in 3 Mar 2021
    +        )
    +        return underscore_opt
    +
    +    def _enforce_option_lowercase(self, opt: str, section: str) -> str:
    +        if opt.islower() or self._skip_setupcfg_normalization(section):
    +            return opt
    +
    +        lowercase_opt = opt.lower()
    +        affected = f"(Affected: {self.metadata.name})." if self.metadata.name else ""
    +        SetuptoolsDeprecationWarning.emit(
    +            f"Invalid uppercase key {opt!r} in {section!r} (setup.cfg), "
    +            f"please use lowercase {lowercase_opt!r} instead.",
    +            f"""
    +            Usage of uppercase key {opt!r} in {section!r} will not be supported in
    +            future versions. Please use lowercase {lowercase_opt!r} instead.
    +            {affected}
    +            """,
    +            see_docs="userguide/declarative_config.html",
    +            due_date=(2026, 3, 3),
    +            # Warning initially introduced in 6 Mar 2021
    +        )
    +        return lowercase_opt
    +
    +    def _skip_setupcfg_normalization(self, section: str) -> bool:
    +        skip = (
    +            'options.extras_require',
    +            'options.data_files',
    +            'options.entry_points',
    +            'options.package_data',
    +            'options.exclude_package_data',
    +        )
    +        return section in skip or not self._is_setuptools_section(section)
    +
    +    def _is_setuptools_section(self, section: str) -> bool:
    +        return (
    +            section == "metadata"
    +            or section.startswith("options")
    +            or section in _setuptools_commands()
    +        )
    +
    +    # FIXME: 'Distribution._set_command_options' is too complex (14)
    +    def _set_command_options(self, command_obj, option_dict=None):  # noqa: C901
    +        """
    +        Set the options for 'command_obj' from 'option_dict'.  Basically
    +        this means copying elements of a dictionary ('option_dict') to
    +        attributes of an instance ('command').
    +
    +        'command_obj' must be a Command instance.  If 'option_dict' is not
    +        supplied, uses the standard option dictionary for this command
    +        (from 'self.command_options').
    +
    +        (Adopted from distutils.dist.Distribution._set_command_options)
    +        """
    +        command_name = command_obj.get_command_name()
    +        if option_dict is None:
    +            option_dict = self.get_option_dict(command_name)
    +
    +        if DEBUG:
    +            self.announce(f"  setting options for '{command_name}' command:")
    +        for option, (source, value) in option_dict.items():
    +            if DEBUG:
    +                self.announce(f"    {option} = {value} (from {source})")
    +            try:
    +                bool_opts = [translate_longopt(o) for o in command_obj.boolean_options]
    +            except AttributeError:
    +                bool_opts = []
    +            try:
    +                neg_opt = command_obj.negative_opt
    +            except AttributeError:
    +                neg_opt = {}
    +
    +            try:
    +                is_string = isinstance(value, str)
    +                if option in neg_opt and is_string:
    +                    setattr(command_obj, neg_opt[option], not strtobool(value))
    +                elif option in bool_opts and is_string:
    +                    setattr(command_obj, option, strtobool(value))
    +                elif hasattr(command_obj, option):
    +                    setattr(command_obj, option, value)
    +                else:
    +                    raise DistutilsOptionError(
    +                        f"error in {source}: command '{command_name}' has no such option '{option}'"
    +                    )
    +            except ValueError as e:
    +                raise DistutilsOptionError(e) from e
    +
    +    def _get_project_config_files(self, filenames: Iterable[StrPath] | None):
    +        """Add default file and split between INI and TOML"""
    +        tomlfiles = []
    +        standard_project_metadata = Path(self.src_root or os.curdir, "pyproject.toml")
    +        if filenames is not None:
    +            parts = partition(lambda f: Path(f).suffix == ".toml", filenames)
    +            filenames = list(parts[0])  # 1st element => predicate is False
    +            tomlfiles = list(parts[1])  # 2nd element => predicate is True
    +        elif standard_project_metadata.exists():
    +            tomlfiles = [standard_project_metadata]
    +        return filenames, tomlfiles
    +
    +    def parse_config_files(
    +        self,
    +        filenames: Iterable[StrPath] | None = None,
    +        ignore_option_errors: bool = False,
    +    ) -> None:
    +        """Parses configuration files from various levels
    +        and loads configuration.
    +        """
    +        inifiles, tomlfiles = self._get_project_config_files(filenames)
    +
    +        self._parse_config_files(filenames=inifiles)
    +
    +        setupcfg.parse_configuration(
    +            self, self.command_options, ignore_option_errors=ignore_option_errors
    +        )
    +        for filename in tomlfiles:
    +            pyprojecttoml.apply_configuration(self, filename, ignore_option_errors)
    +
    +        self._finalize_requires()
    +        self._finalize_license_expression()
    +        self._finalize_license_files()
    +
    +    def fetch_build_eggs(self, requires: _StrOrIter) -> list[metadata.Distribution]:
    +        """Resolve pre-setup requirements"""
    +        from .installer import _fetch_build_eggs
    +
    +        return _fetch_build_eggs(self, requires)
    +
    +    def finalize_options(self) -> None:
    +        """
    +        Allow plugins to apply arbitrary operations to the
    +        distribution. Each hook may optionally define a 'order'
    +        to influence the order of execution. Smaller numbers
    +        go first and the default is 0.
    +        """
    +        group = 'setuptools.finalize_distribution_options'
    +
    +        def by_order(hook):
    +            return getattr(hook, 'order', 0)
    +
    +        defined = metadata.entry_points(group=group)
    +        filtered = itertools.filterfalse(self._removed, defined)
    +        loaded = map(lambda e: e.load(), filtered)
    +        for ep in sorted(loaded, key=by_order):
    +            ep(self)
    +
    +    @staticmethod
    +    def _removed(ep):
    +        """
    +        When removing an entry point, if metadata is loaded
    +        from an older version of Setuptools, that removed
    +        entry point will attempt to be loaded and will fail.
    +        See #2765 for more details.
    +        """
    +        removed = {
    +            # removed 2021-09-05
    +            '2to3_doctests',
    +        }
    +        return ep.name in removed
    +
    +    def _finalize_setup_keywords(self):
    +        for ep in metadata.entry_points(group='distutils.setup_keywords'):
    +            value = getattr(self, ep.name, None)
    +            if value is not None:
    +                ep.load()(self, ep.name, value)
    +
    +    def get_egg_cache_dir(self):
    +        from . import windows_support
    +
    +        egg_cache_dir = os.path.join(os.curdir, '.eggs')
    +        if not os.path.exists(egg_cache_dir):
    +            os.mkdir(egg_cache_dir)
    +            windows_support.hide_file(egg_cache_dir)
    +            readme_txt_filename = os.path.join(egg_cache_dir, 'README.txt')
    +            with open(readme_txt_filename, 'w', encoding="utf-8") as f:
    +                f.write(
    +                    'This directory contains eggs that were downloaded '
    +                    'by setuptools to build, test, and run plug-ins.\n\n'
    +                )
    +                f.write(
    +                    'This directory caches those eggs to prevent '
    +                    'repeated downloads.\n\n'
    +                )
    +                f.write('However, it is safe to delete this directory.\n\n')
    +
    +        return egg_cache_dir
    +
    +    def fetch_build_egg(self, req):
    +        """Fetch an egg needed for building"""
    +        from .installer import fetch_build_egg
    +
    +        return fetch_build_egg(self, req)
    +
    +    def get_command_class(self, command: str) -> type[distutils.cmd.Command]:  # type: ignore[override] # Not doing complex overrides yet
    +        """Pluggable version of get_command_class()"""
    +        if command in self.cmdclass:
    +            return self.cmdclass[command]
    +
    +        # Special case bdist_wheel so it's never loaded from "wheel"
    +        if command == 'bdist_wheel':
    +            from .command.bdist_wheel import bdist_wheel
    +
    +            return bdist_wheel
    +
    +        eps = metadata.entry_points(group='distutils.commands', name=command)
    +        for ep in eps:
    +            self.cmdclass[command] = cmdclass = ep.load()
    +            return cmdclass
    +        else:
    +            return _Distribution.get_command_class(self, command)
    +
    +    def print_commands(self):
    +        for ep in metadata.entry_points(group='distutils.commands'):
    +            if ep.name not in self.cmdclass:
    +                cmdclass = ep.load()
    +                self.cmdclass[ep.name] = cmdclass
    +        return _Distribution.print_commands(self)
    +
    +    def get_command_list(self):
    +        for ep in metadata.entry_points(group='distutils.commands'):
    +            if ep.name not in self.cmdclass:
    +                cmdclass = ep.load()
    +                self.cmdclass[ep.name] = cmdclass
    +        return _Distribution.get_command_list(self)
    +
    +    def include(self, **attrs) -> None:
    +        """Add items to distribution that are named in keyword arguments
    +
    +        For example, 'dist.include(py_modules=["x"])' would add 'x' to
    +        the distribution's 'py_modules' attribute, if it was not already
    +        there.
    +
    +        Currently, this method only supports inclusion for attributes that are
    +        lists or tuples.  If you need to add support for adding to other
    +        attributes in this or a subclass, you can add an '_include_X' method,
    +        where 'X' is the name of the attribute.  The method will be called with
    +        the value passed to 'include()'.  So, 'dist.include(foo={"bar":"baz"})'
    +        will try to call 'dist._include_foo({"bar":"baz"})', which can then
    +        handle whatever special inclusion logic is needed.
    +        """
    +        for k, v in attrs.items():
    +            include = getattr(self, '_include_' + k, None)
    +            if include:
    +                include(v)
    +            else:
    +                self._include_misc(k, v)
    +
    +    def exclude_package(self, package: str) -> None:
    +        """Remove packages, modules, and extensions in named package"""
    +
    +        pfx = package + '.'
    +        if self.packages:
    +            self.packages = [
    +                p for p in self.packages if p != package and not p.startswith(pfx)
    +            ]
    +
    +        if self.py_modules:
    +            self.py_modules = [
    +                p for p in self.py_modules if p != package and not p.startswith(pfx)
    +            ]
    +
    +        if self.ext_modules:
    +            self.ext_modules = [
    +                p
    +                for p in self.ext_modules
    +                if p.name != package and not p.name.startswith(pfx)
    +            ]
    +
    +    def has_contents_for(self, package: str) -> bool:
    +        """Return true if 'exclude_package(package)' would do something"""
    +
    +        pfx = package + '.'
    +
    +        for p in self.iter_distribution_names():
    +            if p == package or p.startswith(pfx):
    +                return True
    +
    +        return False
    +
    +    def _exclude_misc(self, name: str, value: _Sequence) -> None:
    +        """Handle 'exclude()' for list/tuple attrs without a special handler"""
    +        if not isinstance(value, _sequence):
    +            raise DistutilsSetupError(
    +                f"{name}: setting must be of type <{_sequence_type_repr}> (got {value!r})"
    +            )
    +        try:
    +            old = getattr(self, name)
    +        except AttributeError as e:
    +            raise DistutilsSetupError(f"{name}: No such distribution setting") from e
    +        if old is not None and not isinstance(old, _sequence):
    +            raise DistutilsSetupError(
    +                name + ": this setting cannot be changed via include/exclude"
    +            )
    +        elif old:
    +            setattr(self, name, [item for item in old if item not in value])
    +
    +    def _include_misc(self, name: str, value: _Sequence) -> None:
    +        """Handle 'include()' for list/tuple attrs without a special handler"""
    +
    +        if not isinstance(value, _sequence):
    +            raise DistutilsSetupError(
    +                f"{name}: setting must be of type <{_sequence_type_repr}> (got {value!r})"
    +            )
    +        try:
    +            old = getattr(self, name)
    +        except AttributeError as e:
    +            raise DistutilsSetupError(f"{name}: No such distribution setting") from e
    +        if old is None:
    +            setattr(self, name, value)
    +        elif not isinstance(old, _sequence):
    +            raise DistutilsSetupError(
    +                name + ": this setting cannot be changed via include/exclude"
    +            )
    +        else:
    +            new = [item for item in value if item not in old]
    +            setattr(self, name, list(old) + new)
    +
    +    def exclude(self, **attrs) -> None:
    +        """Remove items from distribution that are named in keyword arguments
    +
    +        For example, 'dist.exclude(py_modules=["x"])' would remove 'x' from
    +        the distribution's 'py_modules' attribute.  Excluding packages uses
    +        the 'exclude_package()' method, so all of the package's contained
    +        packages, modules, and extensions are also excluded.
    +
    +        Currently, this method only supports exclusion from attributes that are
    +        lists or tuples.  If you need to add support for excluding from other
    +        attributes in this or a subclass, you can add an '_exclude_X' method,
    +        where 'X' is the name of the attribute.  The method will be called with
    +        the value passed to 'exclude()'.  So, 'dist.exclude(foo={"bar":"baz"})'
    +        will try to call 'dist._exclude_foo({"bar":"baz"})', which can then
    +        handle whatever special exclusion logic is needed.
    +        """
    +        for k, v in attrs.items():
    +            exclude = getattr(self, '_exclude_' + k, None)
    +            if exclude:
    +                exclude(v)
    +            else:
    +                self._exclude_misc(k, v)
    +
    +    def _exclude_packages(self, packages: _Sequence) -> None:
    +        if not isinstance(packages, _sequence):
    +            raise DistutilsSetupError(
    +                f"packages: setting must be of type <{_sequence_type_repr}> (got {packages!r})"
    +            )
    +        list(map(self.exclude_package, packages))
    +
    +    def _parse_command_opts(self, parser, args):
    +        # Remove --with-X/--without-X options when processing command args
    +        self.global_options = self.__class__.global_options
    +        self.negative_opt = self.__class__.negative_opt
    +
    +        # First, expand any aliases
    +        command = args[0]
    +        aliases = self.get_option_dict('aliases')
    +        while command in aliases:
    +            _src, alias = aliases[command]
    +            del aliases[command]  # ensure each alias can expand only once!
    +            import shlex
    +
    +            args[:1] = shlex.split(alias, True)
    +            command = args[0]
    +
    +        nargs = _Distribution._parse_command_opts(self, parser, args)
    +
    +        # Handle commands that want to consume all remaining arguments
    +        cmd_class = self.get_command_class(command)
    +        if getattr(cmd_class, 'command_consumes_arguments', None):
    +            self.get_option_dict(command)['args'] = ("command line", nargs)
    +            if nargs is not None:
    +                return []
    +
    +        return nargs
    +
    +    def get_cmdline_options(self) -> dict[str, dict[str, str | None]]:
    +        """Return a '{cmd: {opt:val}}' map of all command-line options
    +
    +        Option names are all long, but do not include the leading '--', and
    +        contain dashes rather than underscores.  If the option doesn't take
    +        an argument (e.g. '--quiet'), the 'val' is 'None'.
    +
    +        Note that options provided by config files are intentionally excluded.
    +        """
    +
    +        d: dict[str, dict[str, str | None]] = {}
    +
    +        for cmd, opts in self.command_options.items():
    +            val: str | None
    +            for opt, (src, val) in opts.items():
    +                if src != "command line":
    +                    continue
    +
    +                opt = opt.replace('_', '-')
    +
    +                if val == 0:
    +                    cmdobj = self.get_command_obj(cmd)
    +                    neg_opt = self.negative_opt.copy()
    +                    neg_opt.update(getattr(cmdobj, 'negative_opt', {}))
    +                    for neg, pos in neg_opt.items():
    +                        if pos == opt:
    +                            opt = neg
    +                            val = None
    +                            break
    +                    else:
    +                        raise AssertionError("Shouldn't be able to get here")
    +
    +                elif val == 1:
    +                    val = None
    +
    +                d.setdefault(cmd, {})[opt] = val
    +
    +        return d
    +
    +    def iter_distribution_names(self):
    +        """Yield all packages, modules, and extension names in distribution"""
    +
    +        yield from self.packages or ()
    +
    +        yield from self.py_modules or ()
    +
    +        for ext in self.ext_modules or ():
    +            if isinstance(ext, tuple):
    +                name, _buildinfo = ext
    +            else:
    +                name = ext.name
    +            if name.endswith('module'):
    +                name = name[:-6]
    +            yield name
    +
    +    def handle_display_options(self, option_order):
    +        """If there were any non-global "display-only" options
    +        (--help-commands or the metadata display options) on the command
    +        line, display the requested info and return true; else return
    +        false.
    +        """
    +        import sys
    +
    +        if self.help_commands:
    +            return _Distribution.handle_display_options(self, option_order)
    +
    +        # Stdout may be StringIO (e.g. in tests)
    +        if not isinstance(sys.stdout, io.TextIOWrapper):
    +            return _Distribution.handle_display_options(self, option_order)
    +
    +        # Don't wrap stdout if utf-8 is already the encoding. Provides
    +        #  workaround for #334.
    +        if sys.stdout.encoding.lower() in ('utf-8', 'utf8'):
    +            return _Distribution.handle_display_options(self, option_order)
    +
    +        # Print metadata in UTF-8 no matter the platform
    +        encoding = sys.stdout.encoding
    +        sys.stdout.reconfigure(encoding='utf-8')
    +        try:
    +            return _Distribution.handle_display_options(self, option_order)
    +        finally:
    +            sys.stdout.reconfigure(encoding=encoding)
    +
    +    def run_command(self, command) -> None:
    +        self.set_defaults()
    +        # Postpone defaults until all explicit configuration is considered
    +        # (setup() args, config files, command line and plugins)
    +
    +        super().run_command(command)
    +
    +
    +@functools.cache
    +def _setuptools_commands() -> set[str]:
    +    try:
    +        # Use older API for importlib.metadata compatibility
    +        entry_points = metadata.distribution('setuptools').entry_points
    +        eps: Iterable[str] = (ep.name for ep in entry_points)
    +    except metadata.PackageNotFoundError:
    +        # during bootstrapping, distribution doesn't exist
    +        eps = []
    +    return {*distutils.command.__all__, *eps}
    +
    +
    +class DistDeprecationWarning(SetuptoolsDeprecationWarning):
    +    """Class for warning about deprecations in dist in
    +    setuptools. Not ignored by default, unlike DeprecationWarning."""
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/errors.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/errors.py
    new file mode 100644
    index 000000000..990ecbf4e
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/errors.py
    @@ -0,0 +1,67 @@
    +"""setuptools.errors
    +
    +Provides exceptions used by setuptools modules.
    +"""
    +
    +from __future__ import annotations
    +
    +from distutils import errors as _distutils_errors
    +
    +# Re-export errors from distutils to facilitate the migration to PEP632
    +
    +ByteCompileError = _distutils_errors.DistutilsByteCompileError
    +CCompilerError = _distutils_errors.CCompilerError
    +ClassError = _distutils_errors.DistutilsClassError
    +CompileError = _distutils_errors.CompileError
    +ExecError = _distutils_errors.DistutilsExecError
    +FileError = _distutils_errors.DistutilsFileError
    +InternalError = _distutils_errors.DistutilsInternalError
    +LibError = _distutils_errors.LibError
    +LinkError = _distutils_errors.LinkError
    +ModuleError = _distutils_errors.DistutilsModuleError
    +OptionError = _distutils_errors.DistutilsOptionError
    +PlatformError = _distutils_errors.DistutilsPlatformError
    +PreprocessError = _distutils_errors.PreprocessError
    +SetupError = _distutils_errors.DistutilsSetupError
    +TemplateError = _distutils_errors.DistutilsTemplateError
    +UnknownFileError = _distutils_errors.UnknownFileError
    +
    +# The root error class in the hierarchy
    +BaseError = _distutils_errors.DistutilsError
    +
    +
    +class InvalidConfigError(OptionError):  # type: ignore[valid-type, misc] # distutils imports are `Any` on python 3.12+
    +    """Error used for invalid configurations."""
    +
    +
    +class RemovedConfigError(OptionError):  # type: ignore[valid-type, misc] # distutils imports are `Any` on python 3.12+
    +    """Error used for configurations that were deprecated and removed."""
    +
    +
    +class RemovedCommandError(BaseError, RuntimeError):  # type: ignore[valid-type, misc] # distutils imports are `Any` on python 3.12+
    +    """Error used for commands that have been removed in setuptools.
    +
    +    Since ``setuptools`` is built on ``distutils``, simply removing a command
    +    from ``setuptools`` will make the behavior fall back to ``distutils``; this
    +    error is raised if a command exists in ``distutils`` but has been actively
    +    removed in ``setuptools``.
    +    """
    +
    +
    +class PackageDiscoveryError(BaseError, RuntimeError):  # type: ignore[valid-type, misc] # distutils imports are `Any` on python 3.12+
    +    """Impossible to perform automatic discovery of packages and/or modules.
    +
    +    The current project layout or given discovery options can lead to problems when
    +    scanning the project directory.
    +
    +    Setuptools might also refuse to complete auto-discovery if an error prone condition
    +    is detected (e.g. when a project is organised as a flat-layout but contains
    +    multiple directories that can be taken as top-level packages inside a single
    +    distribution [*]_). In these situations the users are encouraged to be explicit
    +    about which packages to include or to make the discovery parameters more specific.
    +
    +    .. [*] Since multi-package distributions are uncommon it is very likely that the
    +       developers did not intend for all the directories to be packaged, and are just
    +       leaving auxiliary code in the repository top-level, such as maintenance-related
    +       scripts.
    +    """
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/extension.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/extension.py
    new file mode 100644
    index 000000000..76e03d9d6
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/extension.py
    @@ -0,0 +1,177 @@
    +from __future__ import annotations
    +
    +import functools
    +import re
    +from typing import TYPE_CHECKING
    +
    +from setuptools._path import StrPath
    +
    +from .monkey import get_unpatched
    +
    +import distutils.core
    +import distutils.errors
    +import distutils.extension
    +
    +
    +def _have_cython():
    +    """
    +    Return True if Cython can be imported.
    +    """
    +    cython_impl = 'Cython.Distutils.build_ext'
    +    try:
    +        # from (cython_impl) import build_ext
    +        __import__(cython_impl, fromlist=['build_ext']).build_ext
    +    except Exception:
    +        return False
    +    return True
    +
    +
    +# for compatibility
    +have_pyrex = _have_cython
    +if TYPE_CHECKING:
    +    # Work around a mypy issue where type[T] can't be used as a base: https://github.com/python/mypy/issues/10962
    +    from distutils.core import Extension as _Extension
    +else:
    +    _Extension = get_unpatched(distutils.core.Extension)
    +
    +
    +class Extension(_Extension):
    +    """
    +    Describes a single extension module.
    +
    +    This means that all source files will be compiled into a single binary file
    +    ``.`` (with ```` derived from ``name`` and
    +    ```` defined by one of the values in
    +    ``importlib.machinery.EXTENSION_SUFFIXES``).
    +
    +    In the case ``.pyx`` files are passed as ``sources and`` ``Cython`` is **not**
    +    installed in the build environment, ``setuptools`` may also try to look for the
    +    equivalent ``.cpp`` or ``.c`` files.
    +
    +    :arg str name:
    +      the full name of the extension, including any packages -- ie.
    +      *not* a filename or pathname, but Python dotted name
    +
    +    :arg list[str|os.PathLike[str]] sources:
    +      list of source filenames, relative to the distribution root
    +      (where the setup script lives), in Unix form (slash-separated)
    +      for portability.  Source files may be C, C++, SWIG (.i),
    +      platform-specific resource files, or whatever else is recognized
    +      by the "build_ext" command as source for a Python extension.
    +
    +    :keyword list[str] include_dirs:
    +      list of directories to search for C/C++ header files (in Unix
    +      form for portability)
    +
    +    :keyword list[tuple[str, str|None]] define_macros:
    +      list of macros to define; each macro is defined using a 2-tuple:
    +      the first item corresponding to the name of the macro and the second
    +      item either a string with its value or None to
    +      define it without a particular value (equivalent of "#define
    +      FOO" in source or -DFOO on Unix C compiler command line)
    +
    +    :keyword list[str] undef_macros:
    +      list of macros to undefine explicitly
    +
    +    :keyword list[str] library_dirs:
    +      list of directories to search for C/C++ libraries at link time
    +
    +    :keyword list[str] libraries:
    +      list of library names (not filenames or paths) to link against
    +
    +    :keyword list[str] runtime_library_dirs:
    +      list of directories to search for C/C++ libraries at run time
    +      (for shared extensions, this is when the extension is loaded).
    +      Setting this will cause an exception during build on Windows
    +      platforms.
    +
    +    :keyword list[str] extra_objects:
    +      list of extra files to link with (eg. object files not implied
    +      by 'sources', static library that must be explicitly specified,
    +      binary resource files, etc.)
    +
    +    :keyword list[str] extra_compile_args:
    +      any extra platform- and compiler-specific information to use
    +      when compiling the source files in 'sources'.  For platforms and
    +      compilers where "command line" makes sense, this is typically a
    +      list of command-line arguments, but for other platforms it could
    +      be anything.
    +
    +    :keyword list[str] extra_link_args:
    +      any extra platform- and compiler-specific information to use
    +      when linking object files together to create the extension (or
    +      to create a new static Python interpreter).  Similar
    +      interpretation as for 'extra_compile_args'.
    +
    +    :keyword list[str] export_symbols:
    +      list of symbols to be exported from a shared extension.  Not
    +      used on all platforms, and not generally necessary for Python
    +      extensions, which typically export exactly one symbol: "init" +
    +      extension_name.
    +
    +    :keyword list[str] swig_opts:
    +      any extra options to pass to SWIG if a source file has the .i
    +      extension.
    +
    +    :keyword list[str] depends:
    +      list of files that the extension depends on
    +
    +    :keyword str language:
    +      extension language (i.e. "c", "c++", "objc"). Will be detected
    +      from the source extensions if not provided.
    +
    +    :keyword bool optional:
    +      specifies that a build failure in the extension should not abort the
    +      build process, but simply not install the failing extension.
    +
    +    :keyword bool py_limited_api:
    +      opt-in flag for the usage of :doc:`Python's limited API `.
    +
    +    :raises setuptools.errors.PlatformError: if ``runtime_library_dirs`` is
    +      specified on Windows. (since v63)
    +    """
    +
    +    # These 4 are set and used in setuptools/command/build_ext.py
    +    # The lack of a default value and risk of `AttributeError` is purposeful
    +    # to avoid people forgetting to call finalize_options if they modify the extension list.
    +    # See example/rationale in https://github.com/pypa/setuptools/issues/4529.
    +    _full_name: str  #: Private API, internal use only.
    +    _links_to_dynamic: bool  #: Private API, internal use only.
    +    _needs_stub: bool  #: Private API, internal use only.
    +    _file_name: str  #: Private API, internal use only.
    +
    +    def __init__(
    +        self,
    +        name: str,
    +        sources: list[StrPath],
    +        *args,
    +        py_limited_api: bool = False,
    +        **kw,
    +    ) -> None:
    +        # The *args is needed for compatibility as calls may use positional
    +        # arguments. py_limited_api may be set only via keyword.
    +        self.py_limited_api = py_limited_api
    +        super().__init__(
    +            name,
    +            sources,  # type: ignore[arg-type] # Vendored version of setuptools supports PathLike
    +            *args,
    +            **kw,
    +        )
    +
    +    def _convert_pyx_sources_to_lang(self):
    +        """
    +        Replace sources with .pyx extensions to sources with the target
    +        language extension. This mechanism allows language authors to supply
    +        pre-converted sources but to prefer the .pyx sources.
    +        """
    +        if _have_cython():
    +            # the build has Cython, so allow it to compile the .pyx files
    +            return
    +        lang = self.language or ''
    +        target_ext = '.cpp' if lang.lower() == 'c++' else '.c'
    +        sub = functools.partial(re.sub, '.pyx$', target_ext)
    +        self.sources = list(map(sub, self.sources))
    +
    +
    +class Library(Extension):
    +    """Just like a regular Extension, but built as a library instead"""
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/glob.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/glob.py
    new file mode 100644
    index 000000000..1dfff2cd5
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/glob.py
    @@ -0,0 +1,185 @@
    +"""
    +Filename globbing utility. Mostly a copy of `glob` from Python 3.5.
    +
    +Changes include:
    + * `yield from` and PEP3102 `*` removed.
    + * Hidden files are not ignored.
    +"""
    +
    +from __future__ import annotations
    +
    +import fnmatch
    +import os
    +import re
    +from collections.abc import Iterable, Iterator
    +from typing import TYPE_CHECKING, AnyStr, overload
    +
    +if TYPE_CHECKING:
    +    from _typeshed import BytesPath, StrOrBytesPath, StrPath
    +
    +__all__ = ["glob", "iglob", "escape"]
    +
    +
    +def glob(pathname: AnyStr, recursive: bool = False) -> list[AnyStr]:
    +    """Return a list of paths matching a pathname pattern.
    +
    +    The pattern may contain simple shell-style wildcards a la
    +    fnmatch. However, unlike fnmatch, filenames starting with a
    +    dot are special cases that are not matched by '*' and '?'
    +    patterns.
    +
    +    If recursive is true, the pattern '**' will match any files and
    +    zero or more directories and subdirectories.
    +    """
    +    return list(iglob(pathname, recursive=recursive))
    +
    +
    +def iglob(pathname: AnyStr, recursive: bool = False) -> Iterator[AnyStr]:
    +    """Return an iterator which yields the paths matching a pathname pattern.
    +
    +    The pattern may contain simple shell-style wildcards a la
    +    fnmatch. However, unlike fnmatch, filenames starting with a
    +    dot are special cases that are not matched by '*' and '?'
    +    patterns.
    +
    +    If recursive is true, the pattern '**' will match any files and
    +    zero or more directories and subdirectories.
    +    """
    +    it = _iglob(pathname, recursive)
    +    if recursive and _isrecursive(pathname):
    +        s = next(it)  # skip empty string
    +        assert not s
    +    return it
    +
    +
    +def _iglob(pathname: AnyStr, recursive: bool) -> Iterator[AnyStr]:
    +    dirname, basename = os.path.split(pathname)
    +    glob_in_dir = glob2 if recursive and _isrecursive(basename) else glob1
    +
    +    if not has_magic(pathname):
    +        if basename:
    +            if os.path.lexists(pathname):
    +                yield pathname
    +        else:
    +            # Patterns ending with a slash should match only directories
    +            if os.path.isdir(dirname):
    +                yield pathname
    +        return
    +
    +    if not dirname:
    +        yield from glob_in_dir(dirname, basename)
    +        return
    +    # `os.path.split()` returns the argument itself as a dirname if it is a
    +    # drive or UNC path.  Prevent an infinite recursion if a drive or UNC path
    +    # contains magic characters (i.e. r'\\?\C:').
    +    if dirname != pathname and has_magic(dirname):
    +        dirs: Iterable[AnyStr] = _iglob(dirname, recursive)
    +    else:
    +        dirs = [dirname]
    +    if not has_magic(basename):
    +        glob_in_dir = glob0
    +    for dirname in dirs:
    +        for name in glob_in_dir(dirname, basename):
    +            yield os.path.join(dirname, name)
    +
    +
    +# These 2 helper functions non-recursively glob inside a literal directory.
    +# They return a list of basenames. `glob1` accepts a pattern while `glob0`
    +# takes a literal basename (so it only has to check for its existence).
    +
    +
    +@overload
    +def glob1(dirname: StrPath, pattern: str) -> list[str]: ...
    +@overload
    +def glob1(dirname: BytesPath, pattern: bytes) -> list[bytes]: ...
    +def glob1(dirname: StrOrBytesPath, pattern: str | bytes) -> list[str] | list[bytes]:
    +    if not dirname:
    +        if isinstance(pattern, bytes):
    +            dirname = os.curdir.encode('ASCII')
    +        else:
    +            dirname = os.curdir
    +    try:
    +        names = os.listdir(dirname)
    +    except OSError:
    +        return []
    +    # mypy false-positives: str or bytes type possibility is always kept in sync
    +    return fnmatch.filter(names, pattern)  # type: ignore[type-var, return-value]
    +
    +
    +def glob0(dirname, basename):
    +    if not basename:
    +        # `os.path.split()` returns an empty basename for paths ending with a
    +        # directory separator.  'q*x/' should match only directories.
    +        if os.path.isdir(dirname):
    +            return [basename]
    +    else:
    +        if os.path.lexists(os.path.join(dirname, basename)):
    +            return [basename]
    +    return []
    +
    +
    +# This helper function recursively yields relative pathnames inside a literal
    +# directory.
    +
    +
    +@overload
    +def glob2(dirname: StrPath, pattern: str) -> Iterator[str]: ...
    +@overload
    +def glob2(dirname: BytesPath, pattern: bytes) -> Iterator[bytes]: ...
    +def glob2(dirname: StrOrBytesPath, pattern: str | bytes) -> Iterator[str | bytes]:
    +    assert _isrecursive(pattern)
    +    yield pattern[:0]
    +    yield from _rlistdir(dirname)
    +
    +
    +# Recursively yields relative pathnames inside a literal directory.
    +@overload
    +def _rlistdir(dirname: StrPath) -> Iterator[str]: ...
    +@overload
    +def _rlistdir(dirname: BytesPath) -> Iterator[bytes]: ...
    +def _rlistdir(dirname: StrOrBytesPath) -> Iterator[str | bytes]:
    +    if not dirname:
    +        if isinstance(dirname, bytes):
    +            dirname = os.curdir.encode('ASCII')
    +        else:
    +            dirname = os.curdir
    +    try:
    +        names = os.listdir(dirname)
    +    except OSError:
    +        return
    +    for x in names:
    +        yield x
    +        # mypy false-positives: str or bytes type possibility is always kept in sync
    +        path = os.path.join(dirname, x) if dirname else x  # type: ignore[arg-type]
    +        for y in _rlistdir(path):
    +            yield os.path.join(x, y)  # type: ignore[arg-type]
    +
    +
    +magic_check = re.compile('([*?[])')
    +magic_check_bytes = re.compile(b'([*?[])')
    +
    +
    +def has_magic(s: str | bytes) -> bool:
    +    if isinstance(s, bytes):
    +        return magic_check_bytes.search(s) is not None
    +    else:
    +        return magic_check.search(s) is not None
    +
    +
    +def _isrecursive(pattern: str | bytes) -> bool:
    +    if isinstance(pattern, bytes):
    +        return pattern == b'**'
    +    else:
    +        return pattern == '**'
    +
    +
    +def escape(pathname):
    +    """Escape all special characters."""
    +    # Escaping is done by wrapping any of "*?[" between square brackets.
    +    # Metacharacters do not work in the drive part and shouldn't be escaped.
    +    drive, pathname = os.path.splitdrive(pathname)
    +    if isinstance(pathname, bytes):
    +        pathname = magic_check_bytes.sub(rb'[\1]', pathname)
    +    else:
    +        pathname = magic_check.sub(r'[\1]', pathname)
    +    return drive + pathname
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/gui-32.exe b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/gui-32.exe
    new file mode 100644
    index 0000000000000000000000000000000000000000..1eb430c6d614a5daea4139badc09c222a4b0e72a
    GIT binary patch
    literal 11776
    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 list[metadata.Distribution]:
    +    _DeprecatedInstaller.emit(stacklevel=3)
    +    _warn_wheel_not_available(dist)
    +
    +    parsed_reqs = _reqs.parse(requires)
    +
    +    missing_reqs = itertools.filterfalse(_present, parsed_reqs)
    +
    +    needed_reqs = (
    +        req for req in missing_reqs if not req.marker or req.marker.evaluate()
    +    )
    +    resolved_dists = [_fetch_build_egg_no_warn(dist, req) for req in needed_reqs]
    +    for dist in resolved_dists:
    +        # dist.locate_file('') is the directory containing EGG-INFO, where the importabl
    +        # contents can be found.
    +        sys.path.insert(0, str(dist.locate_file('')))
    +    return resolved_dists
    +
    +
    +def _dist_matches_req(egg_dist, req):
    +    return (
    +        packaging.utils.canonicalize_name(egg_dist.name)
    +        == packaging.utils.canonicalize_name(req.name)
    +        and egg_dist.version in req.specifier
    +    )
    +
    +
    +def _fetch_build_egg_no_warn(dist, req):  # noqa: C901  # is too complex (16)  # FIXME
    +    # Ignore environment markers; if supplied, it is required.
    +    req = strip_marker(req)
    +    # Take easy_install options into account, but do not override relevant
    +    # pip environment variables (like PIP_INDEX_URL or PIP_QUIET); they'll
    +    # take precedence.
    +    opts = dist.get_option_dict('easy_install')
    +    if 'allow_hosts' in opts:
    +        raise DistutilsError(
    +            'the `allow-hosts` option is not supported '
    +            'when using pip to install requirements.'
    +        )
    +    quiet = 'PIP_QUIET' not in os.environ and 'PIP_VERBOSE' not in os.environ
    +    if 'PIP_INDEX_URL' in os.environ:
    +        index_url = None
    +    elif 'index_url' in opts:
    +        index_url = opts['index_url'][1]
    +    else:
    +        index_url = None
    +    find_links = (
    +        _fixup_find_links(opts['find_links'][1])[:] if 'find_links' in opts else []
    +    )
    +    if dist.dependency_links:
    +        find_links.extend(dist.dependency_links)
    +    eggs_dir = os.path.realpath(dist.get_egg_cache_dir())
    +    cached_dists = metadata.Distribution.discover(path=glob.glob(f'{eggs_dir}/*.egg'))
    +    for egg_dist in cached_dists:
    +        if _dist_matches_req(egg_dist, req):
    +            return egg_dist
    +    with tempfile.TemporaryDirectory() as tmpdir:
    +        cmd = [
    +            sys.executable,
    +            '-m',
    +            'pip',
    +            '--disable-pip-version-check',
    +            'wheel',
    +            '--no-deps',
    +            '-w',
    +            tmpdir,
    +        ]
    +        if quiet:
    +            cmd.append('--quiet')
    +        if index_url is not None:
    +            cmd.extend(('--index-url', index_url))
    +        for link in find_links or []:
    +            cmd.extend(('--find-links', link))
    +        # If requirement is a PEP 508 direct URL, directly pass
    +        # the URL to pip, as `req @ url` does not work on the
    +        # command line.
    +        cmd.append(req.url or str(req))
    +        try:
    +            subprocess.check_call(cmd)
    +        except subprocess.CalledProcessError as e:
    +            raise DistutilsError(str(e)) from e
    +        wheel = Wheel(glob.glob(os.path.join(tmpdir, '*.whl'))[0])
    +        dist_location = os.path.join(eggs_dir, wheel.egg_name())
    +        wheel.install_as_egg(dist_location)
    +        return metadata.Distribution.at(dist_location + '/EGG-INFO')
    +
    +
    +def strip_marker(req):
    +    """
    +    Return a new requirement without the environment marker to avoid
    +    calling pip with something like `babel; extra == "i18n"`, which
    +    would always be ignored.
    +    """
    +    # create a copy to avoid mutating the input
    +    req = packaging.requirements.Requirement(str(req))
    +    req.marker = None
    +    return req
    +
    +
    +def _warn_wheel_not_available(dist):
    +    try:
    +        metadata.distribution('wheel')
    +    except metadata.PackageNotFoundError:
    +        dist.announce('WARNING: The wheel package is not available.', log.WARN)
    +
    +
    +class _DeprecatedInstaller(SetuptoolsDeprecationWarning):
    +    _SUMMARY = "setuptools.installer and fetch_build_eggs are deprecated."
    +    _DETAILS = """
    +    Requirements should be satisfied by a PEP 517 installer.
    +    If you are using pip, you can try `pip install --use-pep517`.
    +    """
    +    _DUE_DATE = 2025, 10, 31
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/launch.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/launch.py
    new file mode 100644
    index 000000000..0d162647d
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/launch.py
    @@ -0,0 +1,36 @@
    +"""
    +Launch the Python script on the command line after
    +setuptools is bootstrapped via import.
    +"""
    +
    +# Note that setuptools gets imported implicitly by the
    +# invocation of this script using python -m setuptools.launch
    +
    +import sys
    +import tokenize
    +
    +
    +def run() -> None:
    +    """
    +    Run the script in sys.argv[1] as if it had
    +    been invoked naturally.
    +    """
    +    __builtins__
    +    script_name = sys.argv[1]
    +    namespace = dict(
    +        __file__=script_name,
    +        __name__='__main__',
    +        __doc__=None,
    +    )
    +    sys.argv[:] = sys.argv[1:]
    +
    +    open_ = getattr(tokenize, 'open', open)
    +    with open_(script_name) as fid:
    +        script = fid.read()
    +    norm_script = script.replace('\\r\\n', '\\n')
    +    code = compile(norm_script, script_name, 'exec')
    +    exec(code, namespace)
    +
    +
    +if __name__ == '__main__':
    +    run()
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/logging.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/logging.py
    new file mode 100644
    index 000000000..532da899f
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/logging.py
    @@ -0,0 +1,40 @@
    +import inspect
    +import logging
    +import sys
    +
    +from . import monkey
    +
    +import distutils.log
    +
    +
    +def _not_warning(record):
    +    return record.levelno < logging.WARNING
    +
    +
    +def configure() -> None:
    +    """
    +    Configure logging to emit warning and above to stderr
    +    and everything else to stdout. This behavior is provided
    +    for compatibility with distutils.log but may change in
    +    the future.
    +    """
    +    err_handler = logging.StreamHandler()
    +    err_handler.setLevel(logging.WARNING)
    +    out_handler = logging.StreamHandler(sys.stdout)
    +    out_handler.addFilter(_not_warning)
    +    handlers = err_handler, out_handler
    +    logging.basicConfig(
    +        format="{message}", style='{', handlers=handlers, level=logging.DEBUG
    +    )
    +    if inspect.ismodule(distutils.dist.log):
    +        monkey.patch_func(set_threshold, distutils.log, 'set_threshold')
    +        # For some reason `distutils.log` module is getting cached in `distutils.dist`
    +        # and then loaded again when patched,
    +        # implying: id(distutils.log) != id(distutils.dist.log).
    +        # Make sure the same module object is used everywhere:
    +        distutils.dist.log = distutils.log
    +
    +
    +def set_threshold(level: int) -> int:
    +    logging.root.setLevel(level * 10)
    +    return set_threshold.unpatched(level)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/modified.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/modified.py
    new file mode 100644
    index 000000000..6ba02fab6
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/modified.py
    @@ -0,0 +1,18 @@
    +try:
    +    # Ensure a DistutilsError raised by these methods is the same as distutils.errors.DistutilsError
    +    from distutils._modified import (
    +        newer,
    +        newer_group,
    +        newer_pairwise,
    +        newer_pairwise_group,
    +    )
    +except ImportError:
    +    # fallback for SETUPTOOLS_USE_DISTUTILS=stdlib, because _modified never existed in stdlib
    +    from ._distutils._modified import (
    +        newer,
    +        newer_group,
    +        newer_pairwise,
    +        newer_pairwise_group,
    +    )
    +
    +__all__ = ['newer', 'newer_pairwise', 'newer_group', 'newer_pairwise_group']
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/monkey.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/monkey.py
    new file mode 100644
    index 000000000..6ad1abac2
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/monkey.py
    @@ -0,0 +1,126 @@
    +"""
    +Monkey patching of distutils.
    +"""
    +
    +from __future__ import annotations
    +
    +import inspect
    +import platform
    +import sys
    +import types
    +from typing import TypeVar, cast, overload
    +
    +import distutils.filelist
    +
    +_T = TypeVar("_T")
    +_UnpatchT = TypeVar("_UnpatchT", type, types.FunctionType)
    +
    +
    +__all__: list[str] = []
    +"""
    +Everything is private. Contact the project team
    +if you think you need this functionality.
    +"""
    +
    +
    +def _get_mro(cls):
    +    """
    +    Returns the bases classes for cls sorted by the MRO.
    +
    +    Works around an issue on Jython where inspect.getmro will not return all
    +    base classes if multiple classes share the same name. Instead, this
    +    function will return a tuple containing the class itself, and the contents
    +    of cls.__bases__. See https://github.com/pypa/setuptools/issues/1024.
    +    """
    +    if platform.python_implementation() == "Jython":
    +        return (cls,) + cls.__bases__
    +    return inspect.getmro(cls)
    +
    +
    +@overload
    +def get_unpatched(item: _UnpatchT) -> _UnpatchT: ...
    +@overload
    +def get_unpatched(item: object) -> None: ...
    +def get_unpatched(
    +    item: type | types.FunctionType | object,
    +) -> type | types.FunctionType | None:
    +    if isinstance(item, type):
    +        return get_unpatched_class(item)
    +    if isinstance(item, types.FunctionType):
    +        return get_unpatched_function(item)
    +    return None
    +
    +
    +def get_unpatched_class(cls: type[_T]) -> type[_T]:
    +    """Protect against re-patching the distutils if reloaded
    +
    +    Also ensures that no other distutils extension monkeypatched the distutils
    +    first.
    +    """
    +    external_bases = (
    +        cast(type[_T], cls)
    +        for cls in _get_mro(cls)
    +        if not cls.__module__.startswith('setuptools')
    +    )
    +    base = next(external_bases)
    +    if not base.__module__.startswith('distutils'):
    +        msg = f"distutils has already been patched by {cls!r}"
    +        raise AssertionError(msg)
    +    return base
    +
    +
    +def patch_all():
    +    import setuptools
    +
    +    # we can't patch distutils.cmd, alas
    +    distutils.core.Command = setuptools.Command  # type: ignore[misc,assignment] # monkeypatching
    +
    +    _patch_distribution_metadata()
    +
    +    # Install Distribution throughout the distutils
    +    for module in distutils.dist, distutils.core, distutils.cmd:
    +        module.Distribution = setuptools.dist.Distribution
    +
    +    # Install the patched Extension
    +    distutils.core.Extension = setuptools.extension.Extension  # type: ignore[misc,assignment] # monkeypatching
    +    distutils.extension.Extension = setuptools.extension.Extension  # type: ignore[misc,assignment] # monkeypatching
    +    if 'distutils.command.build_ext' in sys.modules:
    +        sys.modules[
    +            'distutils.command.build_ext'
    +        ].Extension = setuptools.extension.Extension
    +
    +
    +def _patch_distribution_metadata():
    +    from . import _core_metadata
    +
    +    """Patch write_pkg_file and read_pkg_file for higher metadata standards"""
    +    for attr in (
    +        'write_pkg_info',
    +        'write_pkg_file',
    +        'read_pkg_file',
    +        'get_metadata_version',
    +        'get_fullname',
    +    ):
    +        new_val = getattr(_core_metadata, attr)
    +        setattr(distutils.dist.DistributionMetadata, attr, new_val)
    +
    +
    +def patch_func(replacement, target_mod, func_name):
    +    """
    +    Patch func_name in target_mod with replacement
    +
    +    Important - original must be resolved by name to avoid
    +    patching an already patched function.
    +    """
    +    original = getattr(target_mod, func_name)
    +
    +    # set the 'unpatched' attribute on the replacement to
    +    # point to the original.
    +    vars(replacement).setdefault('unpatched', original)
    +
    +    # replace the function in the original module
    +    setattr(target_mod, func_name, replacement)
    +
    +
    +def get_unpatched_function(candidate):
    +    return candidate.unpatched
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/msvc.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/msvc.py
    new file mode 100644
    index 000000000..313a781ae
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/msvc.py
    @@ -0,0 +1,1536 @@
    +"""
    +Environment info about Microsoft Compilers.
    +
    +>>> getfixture('windows_only')
    +>>> ei = EnvironmentInfo('amd64')
    +"""
    +
    +from __future__ import annotations
    +
    +import contextlib
    +import itertools
    +import json
    +import os
    +import os.path
    +import platform
    +from typing import TYPE_CHECKING, TypedDict
    +
    +from more_itertools import unique_everseen
    +
    +import distutils.errors
    +
    +if TYPE_CHECKING:
    +    from typing_extensions import LiteralString, NotRequired
    +
    +# https://github.com/python/mypy/issues/8166
    +if not TYPE_CHECKING and platform.system() == 'Windows':
    +    import winreg
    +    from os import environ
    +else:
    +    # Mock winreg and environ so the module can be imported on this platform.
    +
    +    class winreg:
    +        HKEY_USERS = None
    +        HKEY_CURRENT_USER = None
    +        HKEY_LOCAL_MACHINE = None
    +        HKEY_CLASSES_ROOT = None
    +
    +    environ: dict[str, str] = dict()
    +
    +
    +class PlatformInfo:
    +    """
    +    Current and Target Architectures information.
    +
    +    Parameters
    +    ----------
    +    arch: str
    +        Target architecture.
    +    """
    +
    +    current_cpu = environ.get('processor_architecture', '').lower()
    +
    +    def __init__(self, arch) -> None:
    +        self.arch = arch.lower().replace('x64', 'amd64')
    +
    +    @property
    +    def target_cpu(self):
    +        """
    +        Return Target CPU architecture.
    +
    +        Return
    +        ------
    +        str
    +            Target CPU
    +        """
    +        return self.arch[self.arch.find('_') + 1 :]
    +
    +    def target_is_x86(self):
    +        """
    +        Return True if target CPU is x86 32 bits..
    +
    +        Return
    +        ------
    +        bool
    +            CPU is x86 32 bits
    +        """
    +        return self.target_cpu == 'x86'
    +
    +    def current_is_x86(self):
    +        """
    +        Return True if current CPU is x86 32 bits..
    +
    +        Return
    +        ------
    +        bool
    +            CPU is x86 32 bits
    +        """
    +        return self.current_cpu == 'x86'
    +
    +    def current_dir(self, hidex86=False, x64=False) -> str:
    +        """
    +        Current platform specific subfolder.
    +
    +        Parameters
    +        ----------
    +        hidex86: bool
    +            return '' and not '\x86' if architecture is x86.
    +        x64: bool
    +            return '\x64' and not '\amd64' if architecture is amd64.
    +
    +        Return
    +        ------
    +        str
    +            subfolder: '\target', or '' (see hidex86 parameter)
    +        """
    +        return (
    +            ''
    +            if (self.current_cpu == 'x86' and hidex86)
    +            else r'\x64'
    +            if (self.current_cpu == 'amd64' and x64)
    +            else rf'\{self.current_cpu}'
    +        )
    +
    +    def target_dir(self, hidex86=False, x64=False) -> str:
    +        r"""
    +        Target platform specific subfolder.
    +
    +        Parameters
    +        ----------
    +        hidex86: bool
    +            return '' and not '\x86' if architecture is x86.
    +        x64: bool
    +            return '\x64' and not '\amd64' if architecture is amd64.
    +
    +        Return
    +        ------
    +        str
    +            subfolder: '\current', or '' (see hidex86 parameter)
    +        """
    +        return (
    +            ''
    +            if (self.target_cpu == 'x86' and hidex86)
    +            else r'\x64'
    +            if (self.target_cpu == 'amd64' and x64)
    +            else rf'\{self.target_cpu}'
    +        )
    +
    +    def cross_dir(self, forcex86=False):
    +        r"""
    +        Cross platform specific subfolder.
    +
    +        Parameters
    +        ----------
    +        forcex86: bool
    +            Use 'x86' as current architecture even if current architecture is
    +            not x86.
    +
    +        Return
    +        ------
    +        str
    +            subfolder: '' if target architecture is current architecture,
    +            '\current_target' if not.
    +        """
    +        current = 'x86' if forcex86 else self.current_cpu
    +        return (
    +            ''
    +            if self.target_cpu == current
    +            else self.target_dir().replace('\\', f'\\{current}_')
    +        )
    +
    +
    +class RegistryInfo:
    +    """
    +    Microsoft Visual Studio related registry information.
    +
    +    Parameters
    +    ----------
    +    platform_info: PlatformInfo
    +        "PlatformInfo" instance.
    +    """
    +
    +    HKEYS = (
    +        winreg.HKEY_USERS,
    +        winreg.HKEY_CURRENT_USER,
    +        winreg.HKEY_LOCAL_MACHINE,
    +        winreg.HKEY_CLASSES_ROOT,
    +    )
    +
    +    def __init__(self, platform_info) -> None:
    +        self.pi = platform_info
    +
    +    @property
    +    def visualstudio(self) -> str:
    +        """
    +        Microsoft Visual Studio root registry key.
    +
    +        Return
    +        ------
    +        str
    +            Registry key
    +        """
    +        return 'VisualStudio'
    +
    +    @property
    +    def sxs(self):
    +        """
    +        Microsoft Visual Studio SxS registry key.
    +
    +        Return
    +        ------
    +        str
    +            Registry key
    +        """
    +        return os.path.join(self.visualstudio, 'SxS')
    +
    +    @property
    +    def vc(self):
    +        """
    +        Microsoft Visual C++ VC7 registry key.
    +
    +        Return
    +        ------
    +        str
    +            Registry key
    +        """
    +        return os.path.join(self.sxs, 'VC7')
    +
    +    @property
    +    def vs(self):
    +        """
    +        Microsoft Visual Studio VS7 registry key.
    +
    +        Return
    +        ------
    +        str
    +            Registry key
    +        """
    +        return os.path.join(self.sxs, 'VS7')
    +
    +    @property
    +    def vc_for_python(self) -> str:
    +        """
    +        Microsoft Visual C++ for Python registry key.
    +
    +        Return
    +        ------
    +        str
    +            Registry key
    +        """
    +        return r'DevDiv\VCForPython'
    +
    +    @property
    +    def microsoft_sdk(self) -> str:
    +        """
    +        Microsoft SDK registry key.
    +
    +        Return
    +        ------
    +        str
    +            Registry key
    +        """
    +        return 'Microsoft SDKs'
    +
    +    @property
    +    def windows_sdk(self):
    +        """
    +        Microsoft Windows/Platform SDK registry key.
    +
    +        Return
    +        ------
    +        str
    +            Registry key
    +        """
    +        return os.path.join(self.microsoft_sdk, 'Windows')
    +
    +    @property
    +    def netfx_sdk(self):
    +        """
    +        Microsoft .NET Framework SDK registry key.
    +
    +        Return
    +        ------
    +        str
    +            Registry key
    +        """
    +        return os.path.join(self.microsoft_sdk, 'NETFXSDK')
    +
    +    @property
    +    def windows_kits_roots(self) -> str:
    +        """
    +        Microsoft Windows Kits Roots registry key.
    +
    +        Return
    +        ------
    +        str
    +            Registry key
    +        """
    +        return r'Windows Kits\Installed Roots'
    +
    +    def microsoft(self, key, x86=False):
    +        """
    +        Return key in Microsoft software registry.
    +
    +        Parameters
    +        ----------
    +        key: str
    +            Registry key path where look.
    +        x86: str
    +            Force x86 software registry.
    +
    +        Return
    +        ------
    +        str
    +            Registry key
    +        """
    +        node64 = '' if self.pi.current_is_x86() or x86 else 'Wow6432Node'
    +        return os.path.join('Software', node64, 'Microsoft', key)
    +
    +    def lookup(self, key, name):
    +        """
    +        Look for values in registry in Microsoft software registry.
    +
    +        Parameters
    +        ----------
    +        key: str
    +            Registry key path where look.
    +        name: str
    +            Value name to find.
    +
    +        Return
    +        ------
    +        str
    +            value
    +        """
    +        key_read = winreg.KEY_READ
    +        openkey = winreg.OpenKey
    +        closekey = winreg.CloseKey
    +        ms = self.microsoft
    +        for hkey in self.HKEYS:
    +            bkey = None
    +            try:
    +                bkey = openkey(hkey, ms(key), 0, key_read)
    +            except OSError:
    +                if not self.pi.current_is_x86():
    +                    try:
    +                        bkey = openkey(hkey, ms(key, True), 0, key_read)
    +                    except OSError:
    +                        continue
    +                else:
    +                    continue
    +            try:
    +                return winreg.QueryValueEx(bkey, name)[0]
    +            except OSError:
    +                pass
    +            finally:
    +                if bkey:
    +                    closekey(bkey)
    +        return None
    +
    +
    +class SystemInfo:
    +    """
    +    Microsoft Windows and Visual Studio related system information.
    +
    +    Parameters
    +    ----------
    +    registry_info: RegistryInfo
    +        "RegistryInfo" instance.
    +    vc_ver: float
    +        Required Microsoft Visual C++ version.
    +    """
    +
    +    # Variables and properties in this class use originals CamelCase variables
    +    # names from Microsoft source files for more easy comparison.
    +    WinDir = environ.get('WinDir', '')
    +    ProgramFiles = environ.get('ProgramFiles', '')
    +    ProgramFilesx86 = environ.get('ProgramFiles(x86)', ProgramFiles)
    +
    +    def __init__(self, registry_info, vc_ver=None) -> None:
    +        self.ri = registry_info
    +        self.pi = self.ri.pi
    +
    +        self.known_vs_paths = self.find_programdata_vs_vers()
    +
    +        # Except for VS15+, VC version is aligned with VS version
    +        self.vs_ver = self.vc_ver = vc_ver or self._find_latest_available_vs_ver()
    +
    +    def _find_latest_available_vs_ver(self):
    +        """
    +        Find the latest VC version
    +
    +        Return
    +        ------
    +        float
    +            version
    +        """
    +        reg_vc_vers = self.find_reg_vs_vers()
    +
    +        if not (reg_vc_vers or self.known_vs_paths):
    +            raise distutils.errors.DistutilsPlatformError(
    +                'No Microsoft Visual C++ version found'
    +            )
    +
    +        vc_vers = set(reg_vc_vers)
    +        vc_vers.update(self.known_vs_paths)
    +        return sorted(vc_vers)[-1]
    +
    +    def find_reg_vs_vers(self):
    +        """
    +        Find Microsoft Visual Studio versions available in registry.
    +
    +        Return
    +        ------
    +        list of float
    +            Versions
    +        """
    +        ms = self.ri.microsoft
    +        vckeys = (self.ri.vc, self.ri.vc_for_python, self.ri.vs)
    +        vs_vers = []
    +        for hkey, key in itertools.product(self.ri.HKEYS, vckeys):
    +            try:
    +                bkey = winreg.OpenKey(hkey, ms(key), 0, winreg.KEY_READ)
    +            except OSError:
    +                continue
    +            with bkey:
    +                subkeys, values, _ = winreg.QueryInfoKey(bkey)
    +                for i in range(values):
    +                    with contextlib.suppress(ValueError):
    +                        ver = float(winreg.EnumValue(bkey, i)[0])
    +                        if ver not in vs_vers:
    +                            vs_vers.append(ver)
    +                for i in range(subkeys):
    +                    with contextlib.suppress(ValueError):
    +                        ver = float(winreg.EnumKey(bkey, i))
    +                        if ver not in vs_vers:
    +                            vs_vers.append(ver)
    +        return sorted(vs_vers)
    +
    +    def find_programdata_vs_vers(self) -> dict[float, str]:
    +        r"""
    +        Find Visual studio 2017+ versions from information in
    +        "C:\ProgramData\Microsoft\VisualStudio\Packages\_Instances".
    +
    +        Return
    +        ------
    +        dict
    +            float version as key, path as value.
    +        """
    +        vs_versions: dict[float, str] = {}
    +        instances_dir = r'C:\ProgramData\Microsoft\VisualStudio\Packages\_Instances'
    +
    +        try:
    +            hashed_names = os.listdir(instances_dir)
    +
    +        except OSError:
    +            # Directory not exists with all Visual Studio versions
    +            return vs_versions
    +
    +        for name in hashed_names:
    +            try:
    +                # Get VS installation path from "state.json" file
    +                state_path = os.path.join(instances_dir, name, 'state.json')
    +                with open(state_path, 'rt', encoding='utf-8') as state_file:
    +                    state = json.load(state_file)
    +                vs_path = state['installationPath']
    +
    +                # Raises OSError if this VS installation does not contain VC
    +                os.listdir(os.path.join(vs_path, r'VC\Tools\MSVC'))
    +
    +                # Store version and path
    +                vs_versions[self._as_float_version(state['installationVersion'])] = (
    +                    vs_path
    +                )
    +
    +            except (OSError, KeyError):
    +                # Skip if "state.json" file is missing or bad format
    +                continue
    +
    +        return vs_versions
    +
    +    @staticmethod
    +    def _as_float_version(version):
    +        """
    +        Return a string version as a simplified float version (major.minor)
    +
    +        Parameters
    +        ----------
    +        version: str
    +            Version.
    +
    +        Return
    +        ------
    +        float
    +            version
    +        """
    +        return float('.'.join(version.split('.')[:2]))
    +
    +    @property
    +    def VSInstallDir(self):
    +        """
    +        Microsoft Visual Studio directory.
    +
    +        Return
    +        ------
    +        str
    +            path
    +        """
    +        # Default path
    +        default = os.path.join(
    +            self.ProgramFilesx86, f'Microsoft Visual Studio {self.vs_ver:0.1f}'
    +        )
    +
    +        # Try to get path from registry, if fail use default path
    +        return self.ri.lookup(self.ri.vs, f'{self.vs_ver:0.1f}') or default
    +
    +    @property
    +    def VCInstallDir(self):
    +        """
    +        Microsoft Visual C++ directory.
    +
    +        Return
    +        ------
    +        str
    +            path
    +        """
    +        path = self._guess_vc() or self._guess_vc_legacy()
    +
    +        if not os.path.isdir(path):
    +            msg = 'Microsoft Visual C++ directory not found'
    +            raise distutils.errors.DistutilsPlatformError(msg)
    +
    +        return path
    +
    +    def _guess_vc(self):
    +        """
    +        Locate Visual C++ for VS2017+.
    +
    +        Return
    +        ------
    +        str
    +            path
    +        """
    +        if self.vs_ver <= 14.0:
    +            return ''
    +
    +        try:
    +            # First search in known VS paths
    +            vs_dir = self.known_vs_paths[self.vs_ver]
    +        except KeyError:
    +            # Else, search with path from registry
    +            vs_dir = self.VSInstallDir
    +
    +        guess_vc = os.path.join(vs_dir, r'VC\Tools\MSVC')
    +
    +        # Subdir with VC exact version as name
    +        try:
    +            # Update the VC version with real one instead of VS version
    +            vc_ver = os.listdir(guess_vc)[-1]
    +            self.vc_ver = self._as_float_version(vc_ver)
    +            return os.path.join(guess_vc, vc_ver)
    +        except (OSError, IndexError):
    +            return ''
    +
    +    def _guess_vc_legacy(self):
    +        """
    +        Locate Visual C++ for versions prior to 2017.
    +
    +        Return
    +        ------
    +        str
    +            path
    +        """
    +        default = os.path.join(
    +            self.ProgramFilesx86,
    +            rf'Microsoft Visual Studio {self.vs_ver:0.1f}\VC',
    +        )
    +
    +        # Try to get "VC++ for Python" path from registry as default path
    +        reg_path = os.path.join(self.ri.vc_for_python, f'{self.vs_ver:0.1f}')
    +        python_vc = self.ri.lookup(reg_path, 'installdir')
    +        default_vc = os.path.join(python_vc, 'VC') if python_vc else default
    +
    +        # Try to get path from registry, if fail use default path
    +        return self.ri.lookup(self.ri.vc, f'{self.vs_ver:0.1f}') or default_vc
    +
    +    @property
    +    def WindowsSdkVersion(self) -> tuple[LiteralString, ...]:
    +        """
    +        Microsoft Windows SDK versions for specified MSVC++ version.
    +
    +        Return
    +        ------
    +        tuple of str
    +            versions
    +        """
    +        if self.vs_ver <= 9.0:
    +            return '7.0', '6.1', '6.0a'
    +        elif self.vs_ver == 10.0:
    +            return '7.1', '7.0a'
    +        elif self.vs_ver == 11.0:
    +            return '8.0', '8.0a'
    +        elif self.vs_ver == 12.0:
    +            return '8.1', '8.1a'
    +        elif self.vs_ver >= 14.0:
    +            return '10.0', '8.1'
    +        return ()
    +
    +    @property
    +    def WindowsSdkLastVersion(self):
    +        """
    +        Microsoft Windows SDK last version.
    +
    +        Return
    +        ------
    +        str
    +            version
    +        """
    +        return self._use_last_dir_name(os.path.join(self.WindowsSdkDir, 'lib'))
    +
    +    @property
    +    def WindowsSdkDir(self) -> str | None:  # noqa: C901  # is too complex (12)  # FIXME
    +        """
    +        Microsoft Windows SDK directory.
    +
    +        Return
    +        ------
    +        str
    +            path
    +        """
    +        sdkdir: str | None = ''
    +        for ver in self.WindowsSdkVersion:
    +            # Try to get it from registry
    +            loc = os.path.join(self.ri.windows_sdk, f'v{ver}')
    +            sdkdir = self.ri.lookup(loc, 'installationfolder')
    +            if sdkdir:
    +                break
    +        if not sdkdir or not os.path.isdir(sdkdir):
    +            # Try to get "VC++ for Python" version from registry
    +            path = os.path.join(self.ri.vc_for_python, f'{self.vc_ver:0.1f}')
    +            install_base = self.ri.lookup(path, 'installdir')
    +            if install_base:
    +                sdkdir = os.path.join(install_base, 'WinSDK')
    +        if not sdkdir or not os.path.isdir(sdkdir):
    +            # If fail, use default new path
    +            for ver in self.WindowsSdkVersion:
    +                intver = ver[: ver.rfind('.')]
    +                path = rf'Microsoft SDKs\Windows Kits\{intver}'
    +                d = os.path.join(self.ProgramFiles, path)
    +                if os.path.isdir(d):
    +                    sdkdir = d
    +        if not sdkdir or not os.path.isdir(sdkdir):
    +            # If fail, use default old path
    +            for ver in self.WindowsSdkVersion:
    +                path = rf'Microsoft SDKs\Windows\v{ver}'
    +                d = os.path.join(self.ProgramFiles, path)
    +                if os.path.isdir(d):
    +                    sdkdir = d
    +        if not sdkdir:
    +            # If fail, use Platform SDK
    +            sdkdir = os.path.join(self.VCInstallDir, 'PlatformSDK')
    +        return sdkdir
    +
    +    @property
    +    def WindowsSDKExecutablePath(self):
    +        """
    +        Microsoft Windows SDK executable directory.
    +
    +        Return
    +        ------
    +        str
    +            path
    +        """
    +        # Find WinSDK NetFx Tools registry dir name
    +        if self.vs_ver <= 11.0:
    +            netfxver = 35
    +            arch = ''
    +        else:
    +            netfxver = 40
    +            hidex86 = True if self.vs_ver <= 12.0 else False
    +            arch = self.pi.current_dir(x64=True, hidex86=hidex86).replace('\\', '-')
    +        fx = f'WinSDK-NetFx{netfxver}Tools{arch}'
    +
    +        # list all possibles registry paths
    +        regpaths = []
    +        if self.vs_ver >= 14.0:
    +            for ver in self.NetFxSdkVersion:
    +                regpaths += [os.path.join(self.ri.netfx_sdk, ver, fx)]
    +
    +        for ver in self.WindowsSdkVersion:
    +            regpaths += [os.path.join(self.ri.windows_sdk, f'v{ver}A', fx)]
    +
    +        # Return installation folder from the more recent path
    +        for path in regpaths:
    +            execpath = self.ri.lookup(path, 'installationfolder')
    +            if execpath:
    +                return execpath
    +
    +        return None
    +
    +    @property
    +    def FSharpInstallDir(self):
    +        """
    +        Microsoft Visual F# directory.
    +
    +        Return
    +        ------
    +        str
    +            path
    +        """
    +        path = os.path.join(self.ri.visualstudio, rf'{self.vs_ver:0.1f}\Setup\F#')
    +        return self.ri.lookup(path, 'productdir') or ''
    +
    +    @property
    +    def UniversalCRTSdkDir(self):
    +        """
    +        Microsoft Universal CRT SDK directory.
    +
    +        Return
    +        ------
    +        str
    +            path
    +        """
    +        # Set Kit Roots versions for specified MSVC++ version
    +        vers = ('10', '81') if self.vs_ver >= 14.0 else ()
    +
    +        # Find path of the more recent Kit
    +        for ver in vers:
    +            sdkdir = self.ri.lookup(self.ri.windows_kits_roots, f'kitsroot{ver}')
    +            if sdkdir:
    +                return sdkdir or ''
    +
    +        return None
    +
    +    @property
    +    def UniversalCRTSdkLastVersion(self):
    +        """
    +        Microsoft Universal C Runtime SDK last version.
    +
    +        Return
    +        ------
    +        str
    +            version
    +        """
    +        return self._use_last_dir_name(os.path.join(self.UniversalCRTSdkDir, 'lib'))
    +
    +    @property
    +    def NetFxSdkVersion(self):
    +        """
    +        Microsoft .NET Framework SDK versions.
    +
    +        Return
    +        ------
    +        tuple of str
    +            versions
    +        """
    +        # Set FxSdk versions for specified VS version
    +        return (
    +            ('4.7.2', '4.7.1', '4.7', '4.6.2', '4.6.1', '4.6', '4.5.2', '4.5.1', '4.5')
    +            if self.vs_ver >= 14.0
    +            else ()
    +        )
    +
    +    @property
    +    def NetFxSdkDir(self):
    +        """
    +        Microsoft .NET Framework SDK directory.
    +
    +        Return
    +        ------
    +        str
    +            path
    +        """
    +        sdkdir = ''
    +        for ver in self.NetFxSdkVersion:
    +            loc = os.path.join(self.ri.netfx_sdk, ver)
    +            sdkdir = self.ri.lookup(loc, 'kitsinstallationfolder')
    +            if sdkdir:
    +                break
    +        return sdkdir
    +
    +    @property
    +    def FrameworkDir32(self):
    +        """
    +        Microsoft .NET Framework 32bit directory.
    +
    +        Return
    +        ------
    +        str
    +            path
    +        """
    +        # Default path
    +        guess_fw = os.path.join(self.WinDir, r'Microsoft.NET\Framework')
    +
    +        # Try to get path from registry, if fail use default path
    +        return self.ri.lookup(self.ri.vc, 'frameworkdir32') or guess_fw
    +
    +    @property
    +    def FrameworkDir64(self):
    +        """
    +        Microsoft .NET Framework 64bit directory.
    +
    +        Return
    +        ------
    +        str
    +            path
    +        """
    +        # Default path
    +        guess_fw = os.path.join(self.WinDir, r'Microsoft.NET\Framework64')
    +
    +        # Try to get path from registry, if fail use default path
    +        return self.ri.lookup(self.ri.vc, 'frameworkdir64') or guess_fw
    +
    +    @property
    +    def FrameworkVersion32(self) -> tuple[str, ...]:
    +        """
    +        Microsoft .NET Framework 32bit versions.
    +
    +        Return
    +        ------
    +        tuple of str
    +            versions
    +        """
    +        return self._find_dot_net_versions(32)
    +
    +    @property
    +    def FrameworkVersion64(self) -> tuple[str, ...]:
    +        """
    +        Microsoft .NET Framework 64bit versions.
    +
    +        Return
    +        ------
    +        tuple of str
    +            versions
    +        """
    +        return self._find_dot_net_versions(64)
    +
    +    def _find_dot_net_versions(self, bits) -> tuple[str, ...]:
    +        """
    +        Find Microsoft .NET Framework versions.
    +
    +        Parameters
    +        ----------
    +        bits: int
    +            Platform number of bits: 32 or 64.
    +
    +        Return
    +        ------
    +        tuple of str
    +            versions
    +        """
    +        # Find actual .NET version in registry
    +        reg_ver = self.ri.lookup(self.ri.vc, f'frameworkver{bits}')
    +        dot_net_dir = getattr(self, f'FrameworkDir{bits}')
    +        ver = reg_ver or self._use_last_dir_name(dot_net_dir, 'v') or ''
    +
    +        # Set .NET versions for specified MSVC++ version
    +        if self.vs_ver >= 12.0:
    +            return ver, 'v4.0'
    +        elif self.vs_ver >= 10.0:
    +            return 'v4.0.30319' if ver.lower()[:2] != 'v4' else ver, 'v3.5'
    +        elif self.vs_ver == 9.0:
    +            return 'v3.5', 'v2.0.50727'
    +        elif self.vs_ver == 8.0:
    +            return 'v3.0', 'v2.0.50727'
    +        return ()
    +
    +    @staticmethod
    +    def _use_last_dir_name(path, prefix=''):
    +        """
    +        Return name of the last dir in path or '' if no dir found.
    +
    +        Parameters
    +        ----------
    +        path: str
    +            Use dirs in this path
    +        prefix: str
    +            Use only dirs starting by this prefix
    +
    +        Return
    +        ------
    +        str
    +            name
    +        """
    +        matching_dirs = (
    +            dir_name
    +            for dir_name in reversed(os.listdir(path))
    +            if os.path.isdir(os.path.join(path, dir_name))
    +            and dir_name.startswith(prefix)
    +        )
    +        return next(matching_dirs, None) or ''
    +
    +
    +class _EnvironmentDict(TypedDict):
    +    include: str
    +    lib: str
    +    libpath: str
    +    path: str
    +    py_vcruntime_redist: NotRequired[str | None]
    +
    +
    +class EnvironmentInfo:
    +    """
    +    Return environment variables for specified Microsoft Visual C++ version
    +    and platform : Lib, Include, Path and libpath.
    +
    +    This function is compatible with Microsoft Visual C++ 9.0 to 14.X.
    +
    +    Script created by analysing Microsoft environment configuration files like
    +    "vcvars[...].bat", "SetEnv.Cmd", "vcbuildtools.bat", ...
    +
    +    Parameters
    +    ----------
    +    arch: str
    +        Target architecture.
    +    vc_ver: float
    +        Required Microsoft Visual C++ version. If not set, autodetect the last
    +        version.
    +    vc_min_ver: float
    +        Minimum Microsoft Visual C++ version.
    +    """
    +
    +    # Variables and properties in this class use originals CamelCase variables
    +    # names from Microsoft source files for more easy comparison.
    +
    +    def __init__(self, arch, vc_ver=None, vc_min_ver=0) -> None:
    +        self.pi = PlatformInfo(arch)
    +        self.ri = RegistryInfo(self.pi)
    +        self.si = SystemInfo(self.ri, vc_ver)
    +
    +        if self.vc_ver < vc_min_ver:
    +            err = 'No suitable Microsoft Visual C++ version found'
    +            raise distutils.errors.DistutilsPlatformError(err)
    +
    +    @property
    +    def vs_ver(self):
    +        """
    +        Microsoft Visual Studio.
    +
    +        Return
    +        ------
    +        float
    +            version
    +        """
    +        return self.si.vs_ver
    +
    +    @property
    +    def vc_ver(self):
    +        """
    +        Microsoft Visual C++ version.
    +
    +        Return
    +        ------
    +        float
    +            version
    +        """
    +        return self.si.vc_ver
    +
    +    @property
    +    def VSTools(self):
    +        """
    +        Microsoft Visual Studio Tools.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        paths = [r'Common7\IDE', r'Common7\Tools']
    +
    +        if self.vs_ver >= 14.0:
    +            arch_subdir = self.pi.current_dir(hidex86=True, x64=True)
    +            paths += [r'Common7\IDE\CommonExtensions\Microsoft\TestWindow']
    +            paths += [r'Team Tools\Performance Tools']
    +            paths += [rf'Team Tools\Performance Tools{arch_subdir}']
    +
    +        return [os.path.join(self.si.VSInstallDir, path) for path in paths]
    +
    +    @property
    +    def VCIncludes(self):
    +        """
    +        Microsoft Visual C++ & Microsoft Foundation Class Includes.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        return [
    +            os.path.join(self.si.VCInstallDir, 'Include'),
    +            os.path.join(self.si.VCInstallDir, r'ATLMFC\Include'),
    +        ]
    +
    +    @property
    +    def VCLibraries(self):
    +        """
    +        Microsoft Visual C++ & Microsoft Foundation Class Libraries.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        if self.vs_ver >= 15.0:
    +            arch_subdir = self.pi.target_dir(x64=True)
    +        else:
    +            arch_subdir = self.pi.target_dir(hidex86=True)
    +        paths = [f'Lib{arch_subdir}', rf'ATLMFC\Lib{arch_subdir}']
    +
    +        if self.vs_ver >= 14.0:
    +            paths += [rf'Lib\store{arch_subdir}']
    +
    +        return [os.path.join(self.si.VCInstallDir, path) for path in paths]
    +
    +    @property
    +    def VCStoreRefs(self):
    +        """
    +        Microsoft Visual C++ store references Libraries.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        if self.vs_ver < 14.0:
    +            return []
    +        return [os.path.join(self.si.VCInstallDir, r'Lib\store\references')]
    +
    +    @property
    +    def VCTools(self):
    +        """
    +        Microsoft Visual C++ Tools.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +
    +        When host CPU is ARM, the tools should be found for ARM.
    +
    +        >>> getfixture('windows_only')
    +        >>> mp = getfixture('monkeypatch')
    +        >>> mp.setattr(PlatformInfo, 'current_cpu', 'arm64')
    +        >>> ei = EnvironmentInfo(arch='irrelevant')
    +        >>> paths = ei.VCTools
    +        >>> any('HostARM64' in path for path in paths)
    +        True
    +        """
    +        si = self.si
    +        tools = [os.path.join(si.VCInstallDir, 'VCPackages')]
    +
    +        forcex86 = True if self.vs_ver <= 10.0 else False
    +        arch_subdir = self.pi.cross_dir(forcex86)
    +        if arch_subdir:
    +            tools += [os.path.join(si.VCInstallDir, f'Bin{arch_subdir}')]
    +
    +        if self.vs_ver == 14.0:
    +            path = f'Bin{self.pi.current_dir(hidex86=True)}'
    +            tools += [os.path.join(si.VCInstallDir, path)]
    +
    +        elif self.vs_ver >= 15.0:
    +            host_id = self.pi.current_cpu.replace('amd64', 'x64').upper()
    +            host_dir = os.path.join('bin', f'Host{host_id}%s')
    +            tools += [
    +                os.path.join(si.VCInstallDir, host_dir % self.pi.target_dir(x64=True))
    +            ]
    +
    +            if self.pi.current_cpu != self.pi.target_cpu:
    +                tools += [
    +                    os.path.join(
    +                        si.VCInstallDir, host_dir % self.pi.current_dir(x64=True)
    +                    )
    +                ]
    +
    +        else:
    +            tools += [os.path.join(si.VCInstallDir, 'Bin')]
    +
    +        return tools
    +
    +    @property
    +    def OSLibraries(self):
    +        """
    +        Microsoft Windows SDK Libraries.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        if self.vs_ver <= 10.0:
    +            arch_subdir = self.pi.target_dir(hidex86=True, x64=True)
    +            return [os.path.join(self.si.WindowsSdkDir, f'Lib{arch_subdir}')]
    +
    +        else:
    +            arch_subdir = self.pi.target_dir(x64=True)
    +            lib = os.path.join(self.si.WindowsSdkDir, 'lib')
    +            libver = self._sdk_subdir
    +            return [os.path.join(lib, f'{libver}um{arch_subdir}')]
    +
    +    @property
    +    def OSIncludes(self):
    +        """
    +        Microsoft Windows SDK Include.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        include = os.path.join(self.si.WindowsSdkDir, 'include')
    +
    +        if self.vs_ver <= 10.0:
    +            return [include, os.path.join(include, 'gl')]
    +
    +        else:
    +            if self.vs_ver >= 14.0:
    +                sdkver = self._sdk_subdir
    +            else:
    +                sdkver = ''
    +            return [
    +                os.path.join(include, f'{sdkver}shared'),
    +                os.path.join(include, f'{sdkver}um'),
    +                os.path.join(include, f'{sdkver}winrt'),
    +            ]
    +
    +    @property
    +    def OSLibpath(self):
    +        """
    +        Microsoft Windows SDK Libraries Paths.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        ref = os.path.join(self.si.WindowsSdkDir, 'References')
    +        libpath = []
    +
    +        if self.vs_ver <= 9.0:
    +            libpath += self.OSLibraries
    +
    +        if self.vs_ver >= 11.0:
    +            libpath += [os.path.join(ref, r'CommonConfiguration\Neutral')]
    +
    +        if self.vs_ver >= 14.0:
    +            libpath += [
    +                ref,
    +                os.path.join(self.si.WindowsSdkDir, 'UnionMetadata'),
    +                os.path.join(ref, 'Windows.Foundation.UniversalApiContract', '1.0.0.0'),
    +                os.path.join(ref, 'Windows.Foundation.FoundationContract', '1.0.0.0'),
    +                os.path.join(
    +                    ref, 'Windows.Networking.Connectivity.WwanContract', '1.0.0.0'
    +                ),
    +                os.path.join(
    +                    self.si.WindowsSdkDir,
    +                    'ExtensionSDKs',
    +                    'Microsoft.VCLibs',
    +                    f'{self.vs_ver:0.1f}',
    +                    'References',
    +                    'CommonConfiguration',
    +                    'neutral',
    +                ),
    +            ]
    +        return libpath
    +
    +    @property
    +    def SdkTools(self):
    +        """
    +        Microsoft Windows SDK Tools.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        return list(self._sdk_tools())
    +
    +    def _sdk_tools(self):
    +        """
    +        Microsoft Windows SDK Tools paths generator.
    +
    +        Return
    +        ------
    +        generator of str
    +            paths
    +        """
    +        if self.vs_ver < 15.0:
    +            bin_dir = 'Bin' if self.vs_ver <= 11.0 else r'Bin\x86'
    +            yield os.path.join(self.si.WindowsSdkDir, bin_dir)
    +
    +        if not self.pi.current_is_x86():
    +            arch_subdir = self.pi.current_dir(x64=True)
    +            path = f'Bin{arch_subdir}'
    +            yield os.path.join(self.si.WindowsSdkDir, path)
    +
    +        if self.vs_ver in (10.0, 11.0):
    +            if self.pi.target_is_x86():
    +                arch_subdir = ''
    +            else:
    +                arch_subdir = self.pi.current_dir(hidex86=True, x64=True)
    +            path = rf'Bin\NETFX 4.0 Tools{arch_subdir}'
    +            yield os.path.join(self.si.WindowsSdkDir, path)
    +
    +        elif self.vs_ver >= 15.0:
    +            path = os.path.join(self.si.WindowsSdkDir, 'Bin')
    +            arch_subdir = self.pi.current_dir(x64=True)
    +            sdkver = self.si.WindowsSdkLastVersion
    +            yield os.path.join(path, f'{sdkver}{arch_subdir}')
    +
    +        if self.si.WindowsSDKExecutablePath:
    +            yield self.si.WindowsSDKExecutablePath
    +
    +    @property
    +    def _sdk_subdir(self):
    +        """
    +        Microsoft Windows SDK version subdir.
    +
    +        Return
    +        ------
    +        str
    +            subdir
    +        """
    +        ucrtver = self.si.WindowsSdkLastVersion
    +        return (f'{ucrtver}\\') if ucrtver else ''
    +
    +    @property
    +    def SdkSetup(self):
    +        """
    +        Microsoft Windows SDK Setup.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        if self.vs_ver > 9.0:
    +            return []
    +
    +        return [os.path.join(self.si.WindowsSdkDir, 'Setup')]
    +
    +    @property
    +    def FxTools(self):
    +        """
    +        Microsoft .NET Framework Tools.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        pi = self.pi
    +        si = self.si
    +
    +        if self.vs_ver <= 10.0:
    +            include32 = True
    +            include64 = not pi.target_is_x86() and not pi.current_is_x86()
    +        else:
    +            include32 = pi.target_is_x86() or pi.current_is_x86()
    +            include64 = pi.current_cpu == 'amd64' or pi.target_cpu == 'amd64'
    +
    +        tools = []
    +        if include32:
    +            tools += [
    +                os.path.join(si.FrameworkDir32, ver) for ver in si.FrameworkVersion32
    +            ]
    +        if include64:
    +            tools += [
    +                os.path.join(si.FrameworkDir64, ver) for ver in si.FrameworkVersion64
    +            ]
    +        return tools
    +
    +    @property
    +    def NetFxSDKLibraries(self):
    +        """
    +        Microsoft .Net Framework SDK Libraries.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        if self.vs_ver < 14.0 or not self.si.NetFxSdkDir:
    +            return []
    +
    +        arch_subdir = self.pi.target_dir(x64=True)
    +        return [os.path.join(self.si.NetFxSdkDir, rf'lib\um{arch_subdir}')]
    +
    +    @property
    +    def NetFxSDKIncludes(self):
    +        """
    +        Microsoft .Net Framework SDK Includes.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        if self.vs_ver < 14.0 or not self.si.NetFxSdkDir:
    +            return []
    +
    +        return [os.path.join(self.si.NetFxSdkDir, r'include\um')]
    +
    +    @property
    +    def VsTDb(self):
    +        """
    +        Microsoft Visual Studio Team System Database.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        return [os.path.join(self.si.VSInstallDir, r'VSTSDB\Deploy')]
    +
    +    @property
    +    def MSBuild(self):
    +        """
    +        Microsoft Build Engine.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        if self.vs_ver < 12.0:
    +            return []
    +        elif self.vs_ver < 15.0:
    +            base_path = self.si.ProgramFilesx86
    +            arch_subdir = self.pi.current_dir(hidex86=True)
    +        else:
    +            base_path = self.si.VSInstallDir
    +            arch_subdir = ''
    +
    +        path = rf'MSBuild\{self.vs_ver:0.1f}\bin{arch_subdir}'
    +        build = [os.path.join(base_path, path)]
    +
    +        if self.vs_ver >= 15.0:
    +            # Add Roslyn C# & Visual Basic Compiler
    +            build += [os.path.join(base_path, path, 'Roslyn')]
    +
    +        return build
    +
    +    @property
    +    def HTMLHelpWorkshop(self):
    +        """
    +        Microsoft HTML Help Workshop.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        if self.vs_ver < 11.0:
    +            return []
    +
    +        return [os.path.join(self.si.ProgramFilesx86, 'HTML Help Workshop')]
    +
    +    @property
    +    def UCRTLibraries(self):
    +        """
    +        Microsoft Universal C Runtime SDK Libraries.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        if self.vs_ver < 14.0:
    +            return []
    +
    +        arch_subdir = self.pi.target_dir(x64=True)
    +        lib = os.path.join(self.si.UniversalCRTSdkDir, 'lib')
    +        ucrtver = self._ucrt_subdir
    +        return [os.path.join(lib, f'{ucrtver}ucrt{arch_subdir}')]
    +
    +    @property
    +    def UCRTIncludes(self):
    +        """
    +        Microsoft Universal C Runtime SDK Include.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        if self.vs_ver < 14.0:
    +            return []
    +
    +        include = os.path.join(self.si.UniversalCRTSdkDir, 'include')
    +        return [os.path.join(include, f'{self._ucrt_subdir}ucrt')]
    +
    +    @property
    +    def _ucrt_subdir(self):
    +        """
    +        Microsoft Universal C Runtime SDK version subdir.
    +
    +        Return
    +        ------
    +        str
    +            subdir
    +        """
    +        ucrtver = self.si.UniversalCRTSdkLastVersion
    +        return (f'{ucrtver}\\') if ucrtver else ''
    +
    +    @property
    +    def FSharp(self):
    +        """
    +        Microsoft Visual F#.
    +
    +        Return
    +        ------
    +        list of str
    +            paths
    +        """
    +        if 11.0 > self.vs_ver > 12.0:
    +            return []
    +
    +        return [self.si.FSharpInstallDir]
    +
    +    @property
    +    def VCRuntimeRedist(self) -> str | None:
    +        """
    +        Microsoft Visual C++ runtime redistributable dll.
    +
    +        Returns the first suitable path found or None.
    +        """
    +        vcruntime = f'vcruntime{self.vc_ver}0.dll'
    +        arch_subdir = self.pi.target_dir(x64=True).strip('\\')
    +
    +        # Installation prefixes candidates
    +        prefixes = []
    +        tools_path = self.si.VCInstallDir
    +        redist_path = os.path.dirname(tools_path.replace(r'\Tools', r'\Redist'))
    +        if os.path.isdir(redist_path):
    +            # Redist version may not be exactly the same as tools
    +            redist_path = os.path.join(redist_path, os.listdir(redist_path)[-1])
    +            prefixes += [redist_path, os.path.join(redist_path, 'onecore')]
    +
    +        prefixes += [os.path.join(tools_path, 'redist')]  # VS14 legacy path
    +
    +        # CRT directory
    +        crt_dirs = (
    +            f'Microsoft.VC{self.vc_ver * 10}.CRT',
    +            # Sometime store in directory with VS version instead of VC
    +            f'Microsoft.VC{int(self.vs_ver) * 10}.CRT',
    +        )
    +
    +        # vcruntime path
    +        candidate_paths = (
    +            os.path.join(prefix, arch_subdir, crt_dir, vcruntime)
    +            for (prefix, crt_dir) in itertools.product(prefixes, crt_dirs)
    +        )
    +        return next(filter(os.path.isfile, candidate_paths), None)  # type: ignore[arg-type] #python/mypy#12682
    +
    +    def return_env(self, exists: bool = True) -> _EnvironmentDict:
    +        """
    +        Return environment dict.
    +
    +        Parameters
    +        ----------
    +        exists: bool
    +            It True, only return existing paths.
    +
    +        Return
    +        ------
    +        dict
    +            environment
    +        """
    +        env = _EnvironmentDict(
    +            include=self._build_paths(
    +                'include',
    +                [
    +                    self.VCIncludes,
    +                    self.OSIncludes,
    +                    self.UCRTIncludes,
    +                    self.NetFxSDKIncludes,
    +                ],
    +                exists,
    +            ),
    +            lib=self._build_paths(
    +                'lib',
    +                [
    +                    self.VCLibraries,
    +                    self.OSLibraries,
    +                    self.FxTools,
    +                    self.UCRTLibraries,
    +                    self.NetFxSDKLibraries,
    +                ],
    +                exists,
    +            ),
    +            libpath=self._build_paths(
    +                'libpath',
    +                [self.VCLibraries, self.FxTools, self.VCStoreRefs, self.OSLibpath],
    +                exists,
    +            ),
    +            path=self._build_paths(
    +                'path',
    +                [
    +                    self.VCTools,
    +                    self.VSTools,
    +                    self.VsTDb,
    +                    self.SdkTools,
    +                    self.SdkSetup,
    +                    self.FxTools,
    +                    self.MSBuild,
    +                    self.HTMLHelpWorkshop,
    +                    self.FSharp,
    +                ],
    +                exists,
    +            ),
    +        )
    +        if self.vs_ver >= 14 and self.VCRuntimeRedist:
    +            env['py_vcruntime_redist'] = self.VCRuntimeRedist
    +        return env
    +
    +    def _build_paths(self, name, spec_path_lists, exists):
    +        """
    +        Given an environment variable name and specified paths,
    +        return a pathsep-separated string of paths containing
    +        unique, extant, directories from those paths and from
    +        the environment variable. Raise an error if no paths
    +        are resolved.
    +
    +        Parameters
    +        ----------
    +        name: str
    +            Environment variable name
    +        spec_path_lists: list of str
    +            Paths
    +        exists: bool
    +            It True, only return existing paths.
    +
    +        Return
    +        ------
    +        str
    +            Pathsep-separated paths
    +        """
    +        # flatten spec_path_lists
    +        spec_paths = itertools.chain.from_iterable(spec_path_lists)
    +        env_paths = environ.get(name, '').split(os.pathsep)
    +        paths = itertools.chain(spec_paths, env_paths)
    +        extant_paths = list(filter(os.path.isdir, paths)) if exists else paths
    +        if not extant_paths:
    +            msg = f"{name.upper()} environment variable is empty"
    +            raise distutils.errors.DistutilsPlatformError(msg)
    +        unique_paths = unique_everseen(extant_paths)
    +        return os.pathsep.join(unique_paths)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/namespaces.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/namespaces.py
    new file mode 100644
    index 000000000..85ea2ebd6
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/namespaces.py
    @@ -0,0 +1,106 @@
    +import itertools
    +import os
    +
    +from .compat import py312
    +
    +from distutils import log
    +
    +flatten = itertools.chain.from_iterable
    +
    +
    +class Installer:
    +    nspkg_ext = '-nspkg.pth'
    +
    +    def install_namespaces(self) -> None:
    +        nsp = self._get_all_ns_packages()
    +        if not nsp:
    +            return
    +        filename = self._get_nspkg_file()
    +        self.outputs.append(filename)
    +        log.info("Installing %s", filename)
    +        lines = map(self._gen_nspkg_line, nsp)
    +
    +        if self.dry_run:
    +            # always generate the lines, even in dry run
    +            list(lines)
    +            return
    +
    +        with open(filename, 'wt', encoding=py312.PTH_ENCODING) as f:
    +            # Python<3.13 requires encoding="locale" instead of "utf-8"
    +            # See: python/cpython#77102
    +            f.writelines(lines)
    +
    +    def uninstall_namespaces(self) -> None:
    +        filename = self._get_nspkg_file()
    +        if not os.path.exists(filename):
    +            return
    +        log.info("Removing %s", filename)
    +        os.remove(filename)
    +
    +    def _get_nspkg_file(self):
    +        filename, _ = os.path.splitext(self._get_target())
    +        return filename + self.nspkg_ext
    +
    +    def _get_target(self):
    +        return self.target
    +
    +    _nspkg_tmpl = (
    +        "import sys, types, os",
    +        "p = os.path.join(%(root)s, *%(pth)r)",
    +        "importlib = __import__('importlib.util')",
    +        "__import__('importlib.machinery')",
    +        (
    +            "m = "
    +            "sys.modules.setdefault(%(pkg)r, "
    +            "importlib.util.module_from_spec("
    +            "importlib.machinery.PathFinder.find_spec(%(pkg)r, "
    +            "[os.path.dirname(p)])))"
    +        ),
    +        ("m = m or sys.modules.setdefault(%(pkg)r, types.ModuleType(%(pkg)r))"),
    +        "mp = (m or []) and m.__dict__.setdefault('__path__',[])",
    +        "(p not in mp) and mp.append(p)",
    +    )
    +    "lines for the namespace installer"
    +
    +    _nspkg_tmpl_multi = ('m and setattr(sys.modules[%(parent)r], %(child)r, m)',)
    +    "additional line(s) when a parent package is indicated"
    +
    +    def _get_root(self):
    +        return "sys._getframe(1).f_locals['sitedir']"
    +
    +    def _gen_nspkg_line(self, pkg):
    +        pth = tuple(pkg.split('.'))
    +        root = self._get_root()
    +        tmpl_lines = self._nspkg_tmpl
    +        parent, sep, child = pkg.rpartition('.')
    +        if parent:
    +            tmpl_lines += self._nspkg_tmpl_multi
    +        return ';'.join(tmpl_lines) % locals() + '\n'
    +
    +    def _get_all_ns_packages(self):
    +        """Return sorted list of all package namespaces"""
    +        pkgs = self.distribution.namespace_packages or []
    +        return sorted(set(flatten(map(self._pkg_names, pkgs))))
    +
    +    @staticmethod
    +    def _pkg_names(pkg):
    +        """
    +        Given a namespace package, yield the components of that
    +        package.
    +
    +        >>> names = Installer._pkg_names('a.b.c')
    +        >>> set(names) == set(['a', 'a.b', 'a.b.c'])
    +        True
    +        """
    +        parts = pkg.split('.')
    +        while parts:
    +            yield '.'.join(parts)
    +            parts.pop()
    +
    +
    +class DevelopInstaller(Installer):
    +    def _get_root(self):
    +        return repr(str(self.egg_path))
    +
    +    def _get_target(self):
    +        return self.egg_link
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/script (dev).tmpl b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/script (dev).tmpl
    new file mode 100644
    index 000000000..39a24b048
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/script (dev).tmpl	
    @@ -0,0 +1,6 @@
    +# EASY-INSTALL-DEV-SCRIPT: %(spec)r,%(script_name)r
    +__requires__ = %(spec)r
    +__import__('pkg_resources').require(%(spec)r)
    +__file__ = %(dev_path)r
    +with open(__file__) as f:
    +    exec(compile(f.read(), __file__, 'exec'))
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/script.tmpl b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/script.tmpl
    new file mode 100644
    index 000000000..ff5efbcab
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/script.tmpl
    @@ -0,0 +1,3 @@
    +# EASY-INSTALL-SCRIPT: %(spec)r,%(script_name)r
    +__requires__ = %(spec)r
    +__import__('pkg_resources').run_script(%(spec)r, %(script_name)r)
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__init__.py
    new file mode 100644
    index 000000000..eb70bfb71
    --- /dev/null
    +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__init__.py
    @@ -0,0 +1,13 @@
    +import locale
    +import sys
    +
    +import pytest
    +
    +__all__ = ['fail_on_ascii']
    +
    +if sys.version_info >= (3, 11):
    +    locale_encoding = locale.getencoding()
    +else:
    +    locale_encoding = locale.getpreferredencoding(False)
    +is_ascii = locale_encoding == 'ANSI_X3.4-1968'
    +fail_on_ascii = pytest.mark.xfail(is_ascii, reason="Test fails in this locale")
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/__init__.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..24b89a2d1235770d3ed15f78f2546ffb22a485b7
    GIT binary patch
    literal 728
    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
    G1pgZqo)gIc
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/fixtures.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/fixtures.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..ac681d5c5867d88825f07b51e26fa6d26b7695ff
    GIT binary patch
    literal 15449
    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
    IYGjxG7bv?~0RR91
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/mod_with_constant.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/mod_with_constant.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..166e4da85892761edc7e6b9d00b1e215a5f67a47
    GIT binary patch
    literal 254
    zcmX@j%ge<81jlwKW{3gl#~=<2FhUuhIe?7m3@Hpz43&(UOjX<^8AYk7Its;^MT&l!
    zjJH_J5_3vZS2BDCssGiipOK%Ns-KvXTA}Y-8Bmm;m6}{qtnV5epzD{Pk_usYy12y$
    z$BjGUAi-^NLFn^GfszDt~d<0EJ6)QtgV^fNlbLq!{GS56p~=
    Oj5jz$8(E83fLs8|PD-)>
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/namespaces.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/namespaces.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..ac72eaccd7857cc40d64771698516b8339ce5b35
    GIT binary patch
    literal 4244
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/script-with-bom.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/script-with-bom.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..0b4210e89bf75c301fdcdd511fae2fe0f1c2e725
    GIT binary patch
    literal 248
    zcmX@j%ge<81jlwKW(Wc4#~=<2FhUuhIe?7m3@Hpz43&(UOt;ty5{rvdQ~Wd;Z?P4n
    z7MJFftYr8MQv0h>KO;XkRX;H&wL;&wGN33wD>b>KSl=}`K-VunB^AQ*ba9Ih%1_EK
    z(Jv`2$uG)G%+c3_vvM+%^b0CWGV=3`^$d;li!)17bqf-cvlG*Sx{FgwN()Nz^K**z
    zOHzx01{Wt6Wfqj^mS>h^=qBao>J?P};;_lhPbtkwwJTx=x(MWjVvr9%Ff%eT-ry8$
    JWGi9?asiE#Nc;c*
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_archive_util.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_archive_util.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..2fb7c6172c797c92368210fa05b38b6391545626
    GIT binary patch
    literal 1916
    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
    CSC0h%
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_bdist_egg.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_bdist_egg.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..6308aa5a9f48efabbe642b64b3e2ef6e12d04cd6
    GIT binary patch
    literal 4197
    zcmb_fO>7&-6`uXy<-cW#lw8TCBgq!)in60PRvTAADgVSyA{&m=wQBB31&-ZgmJ?1ZZw@Wk9XaL*ER!q)pjQ
    zigrl8dGqGY-<$WodHl22>q1ce^!vobZv})N;D%G!3bQo}%py`y94VASr>QtaYC2An
    znu#-{X5%c>Oq$E^ah^g7t8i%{BgRGG`M9LAsYYk&TCE5-(49&%?xxXMq=+|=BHf|O
    z!nkLKj<^b5MV(aBdM<3Kre%JE`vxPF?K!2HmZ6R2EltmULxB{8Vp7jq>a=ARPK+6P
    zCTyx!K4Jc
    z5y>q?b2BzIwZlzlz!m6Yt_W+hdQQ#S+?1hNsx7{Cdg$$o^2K4BPndFYN{P@mZ)I|d
    zX4ur2iM=Hp-nrH@p=Z>dL|UEhd2{BXp{LZOW%itY>tgqyuBc`1+^IA2C4E%4daS&q
    z8(JdW6RmP-ZL}vhV@>GU-srIxdrVlnJC{gaNsPnjnkV%TKO|HhRlo^lb$lEj!b^1I
    ziVGThU|-nl%_SgzNB_KrzH$X_{ix__yDzmDrS|24HK}V8QQW?jpOi#tL6{dl6xYR;
    zZ3aYG^+eIN@4gf+O5x?bYf>jx4Xx~{sNUjk`mko`E6KmmHsAKk0}r9UspMrTO=dHlql^SAR=I-~JG2hF@T9~_i
    z67csZF6I*M@dD<(Tr4QuYao0J7kfdtw;%IKn66rI_~5cN3t_Q{R0QaO;Z-7`|eWwS$op0+n{s)npjs)nH{Dsj;#01w{_2Cc1MksGtBAZJyf4CDPc
    zV7yv*c_dqgERUW8Ab^B68KD15qeGb1ndUXH$_9Ek$1bws=dzIv>ev}{^8Z84L$q5}59%(;X$
    zVY4Y+%NqFBZSK9irdoDGE@7A|0AVJR$SQJL%c{1=$Y&jiX$xss72`K;s5X~LSjmY9
    zW3#539y1Q$nFNBOSro4)~a4L#yfpmoC&D779c
    zwRJ7MS!&u>Y7H;F{7B-wzAZ)wxaQbL0VKH>-1F`aV~b~RpIv<8_8ZHgmCm)sqwC_a
    z4R6!JyYug^dD|W$S_+puf%~5JqNjb`(@FTYqNi=$b6}f;&POiP6k0rg`~1@6TH~R4
    zX)d(k-?K11KfT)g(wF1w{{B_5zv%DZ_JZyvo^8kUz%K8;a4_}?bMF;yfEDb}#o?jX
    zE)1T!FgWzHOXr48$A*Va4_r8P`b?oAHe;#bBs^qcxUj@%T2&z3;SDum>e(kk82bnb
    z;om(sgcW9-u7q$Uv>nI&wh(qgqY_*atXEeY4H8`Lx=v`;`gaA_bHiHUojq293mcG>
    z6n2lg^0cs4_*%eSWvnWcr-F5Zp*hPqt6gQS7N=iU1)lSJZA(&l^d#drX6D)xcO1VGO)018>D>#RR+l
    z6TW~`qh9!Jy#&O`UoV5LNOlUc`tlKlGryY+ESfOq(76L_2
    zJ9uIL^9_S<$^0V_KrP?nsI~h2*lO!Q8MXu#!xm3q%ZGfy?~YA83bibzZl{)mYr(F0
    z_gu?H^S)1nkA+V>AA6R6x-z`hd}7YK;cHsZ=k=w`n(qg5%toLQZeXSNi<6(8TyN}K
    z3-rx#C4Xq?c+nqT6~n9kaLFHBQj7lfRk0oD_MRHB;h6v8;DDF;gO?i!3WE`kEz0C+
    zl4aW^SN?PX?~&#A@`*IICbW3SzHyeqW)j8~+YPzOm^N+Y4RH8wn9=5@#}Zna+^#LC
    z*-6dNvoLuZf#JM2jEne}Df&nx~rJ9CTn4bK4C^sE&UiAY_sM07Nrz8UO$Q
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_bdist_wheel.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_bdist_wheel.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..8d3b9f23807cf3dca5766f8e65aade5a24eaedfa
    GIT binary patch
    literal 33593
    zcmdsg3wTuLdFDAY=geIi-LG5*Ng$2T4GDt`2+$3X0f7M3u#EA*3JgkWJ|W~F59F}jGgYb+dkPDBvGMt`)>vZH}`Se59o(>d6W!)uT|u@
    zOPs_>e3%>I`*@!6mawJI!v0$Otn9DQC$hh`J{$XM@3XVNjy?zb>+Ex~zpg$P`|Iv=
    z=AFDm*vH9&PZ-wt~yp;Up{M7&{u%Jws7G{QD2c-R@_&Nd-ib2
    zNNHc`NLgPQyYC2>kF4oi!}8AX+L3jA>sa0uUO(dN^YPpuC%NC``!?XO2Y)N1EGc`?
    z(pM>Y`>H}!QjU~6#7lWsETN6VhqWa!{)Q?-m2o@ANxAP>l)GQ$EnLVe<-fx#zolHM
    z;EILaE7b25NyX^3M7>|C-_J$uvMW|ryFBe~uC(TgMOur0>!c!@6WXs=Yx>e^Za|$1
    zwdYE`q)OVT-rJ<#%ay978nrL~6{}Qx#nD$Cat*6*+;~bn-{v#hIZpPnnbqk%)JqLg
    z;}vVDT58&b>e7~%xV{>x8L1yN3x-da`%u@T<=R%g{bMh2@2FM!Hm_2Do2gFSDs{G-
    z>eNfE7{5V!9BHGpqpwNYiQE=x7t&^_4QUH{8C*HD;WI1mNxP*z(q5@OR5d)3p|nHl
    z)ZY7P%YaqOOI@bEqIVq&uVoNOwv-eY>P5`r1~R%~Xc*4(cm+$TY$p
    z=`i}+yGlQqo~jpbr#)0U{L;!XhF@NJPkTq&=&QHZYFs<=j#cSLI%=9}m-HlN+ASSJ
    zx=%WebiZ^0=>h2}q&?EpNS}~SB0VTQgY=N}38aS~;mP`>XQfXLShP2>O3N>;d`3Kz
    zZTQP8?`zL4Jx3TI{j+NUt#9dh{S%#TU^NRLlg{Gp#v*M2_b
    z4vvmSV!_x@WHj1~-;U_`*q9uOMk(JP4h2W0NI&xSzM-*wL*WpzLM%8C^;=TzQ_@g0
    z7C1K;3WZbdflw?EJT(+RA?kR#P$UnX8mEr&d(H7sY-JM5{buDdJwZh@<6YX8?C)#(@UbN)uJaY6CJ-z!IMx-TI?~xNdo!t#`
    zG`8e!f9k}6Bgc-j(cFh{yB8%GI%QL8rR-{rlwIv2Wml`Ind99{O2gxjomx~qDxO})qgCn7~YU8P@>)7qHAvuay(N>Ms
    z#4W!op9e&;{28+2kWC@Y$D|e5A}yeqoF94UmnlF#=&}^&gpvaOq4oG
    zYMPb#Hk)BZ6i*Niu@_sROwn9Nn{Gu@!(SXkP
    zUoZbchL)l8F*z6w$e~Y-56PjnPgk6cP}7PXzGo{=g@OYBok%QH@!VAUocw7^;J3(Y
    z0Td~h@(?ua_z(z8TBV=UI`v0rozB!SUE&
    zL~g6-35Un&1x3cAzIJvm!viUm1EG=NP`IsP$Y`=RbUw&HCL#}HXg4mS`d}a!aR6)Q4S9~zCug5j{a
    z!KcQ@&sWs>DxzayAa15cD?n3$E(V%rY*`MQG{4YjOr8jgMTSOW(Y8;g!66mXg-0BX
    zM#7GO0H~!qDS`S(IrTpM%Bzzrsd~1yob}in8=A(~
    z{{y|X@zJ6Fi1d%YL#qo*L{^=`YD76cG!}>kPlqzRp=F@2tm|LrWBuO$>iciK|8D|6
    zy7bi_UAgw--~2LAKqnTa@y7oeb<^m@vm>EckY3DlX}5`+@wNHJW2al|wHj=*POGKD
    zIVx^#PAf2PcPOoRA~HDYd#1tn{x7_LLw^5jq3`^1g>Tm|ZtkTK8nE~6uJe8O^WXi(
    zcfa-BZ}|Sl*I)Mi=u6-5?HUM<1dSSLBP`#-F$&?p4&Slv_O8Q>i%qM~R_Un|`|4YL
    zKYH!8AAkG0@5jG+?MIh?1w5it;Su{!55!$Y>-aCGwSVwBX}slwmIzRt)}z`cK+}$5
    z`n9!hS^NSySSog``+hXbO
    z16gY@5=zsb&!+Tf+;w0iB8}rcwPj{5^v6=974tJ`c||_Z9|BBMG%_ytGd4}X+t81F
    zz&AD#2oH@6#X?dbI5x!SKpIGBU8a)*y1R_yNUspz@T^I;ea^LPnEtVr=J;ck;5vpz
    zL%yREfkQoqdrowB1=^4H_?pf)wKO$1;c``~+lg=2(Ft(CqYZ<*HA+sfx#TuIO*{|6
    zbBlh1K~+C0>6Z;TH^=e!N&rBYxR_ortZMr78^{bpH@f_i_;=8fE;%a(9iehbykxni
    zYl=oaF{fT4NaB#*W{RKWhcW*0OVc#)Tr5i~n>1QkCb?m+cHj7`wd&%Y%j39D;t8g#
    zQ$j3Pt1)Srv`z||&W7h+EfBa#%P`UJWtY|ykMiT3-xfb`Y<$$maCTIp{T>pJFG@6e
    zOpXACq5vk`3&wmy_&@3k1*1bG5=GD^91iuz@E61yQh_4k3B+bXLE(y$Vj*}s7LrqL
    zg@X
    z>7fCIpvev@5COy^(UcvC9gM}~R1RP(7#@m;0ud(WM*U*ScII4A9*CwKv>^r}r-oD3
    z{t+o9umt{(cE7Uwa_yXZ<40D`nRl`FYS9OdrXOaNUT#a&
    z?nspFoXy&`Xy?SNMHiBJVSQ3qKPPOs?JB%DIO|$J-MLV__R{3*lb`?0U5*zkUU6R#
    zE`)A7ycew(Ph5WN1ILC%D{g-%*yn|kq);*^lr6Zkr=PfoNpSsU{2?rZAkW|X=g3^*
    z0KF>CP)+SJ!*@(?Jxq$LW!JEdXGTGc-Z#4@dD^LBI#x|uGz`7QYg#=Ot}VT9^C=q?
    zXQzkG`)w)P$QgjkSjsjWl!N^dxdr{CLGbFL@#*5ag!pr-IQCR6J2UFu{zxn|g7MoKeMR`4E2pCH_UXA(`eDve(ULZ%k%y
    zoRMa;H&5@sEx2Aj_`<_g*i*qC8krvNp4c7cT>V7
    zKWUBQ4NQqKdiU%a*58nJ2NYF*OU6Bo_6+Nk&nN@+QlIfL4zy9HfhHO!YBfyv^k*<=
    z@`I@!Y)tsifRTH5M9v=eh$kq#m96Y
    zFc9ij`Aa;8%N4i@?(5cb{M$T~(((bcg~Hj=(3BESGaihvPKDSd=dOX!Xz2WyygR;*
    zDWe&%M;ms9BmKc}ba#VZejlx(1xS9({mnFYE4O{7@Quogp-Z*N-1eVFX{s+47V~kj
    zw&C1h*zb|Ma7W%x388}AO$kG_>@Fw|87>`uECm*LSpP;*72AFz_l&)A-wxu8&C8z{);!^O_ZF)pGh{FGd
    zf6;FundUys-7ue9lgzETT0EP(W%`K)@A`S~rlfb%%-LCQ!}NjMIVE>FK|H}<5N;Q(
    zPxzXySIrh}zu;adST|FUEZBI#c{?lrwP#;>c0Q{*nN>ZT<)6>mlFZt2ee-PA?mHas
    zJi*`gl)u$~)&J(`x1#U1esgNhb9mnKWYY8Goagv`D^*xz)fVkE%ts#1lZUmvTJu}=
    zZ`a?j&(`jp%Wa=^w2UB2_^WX_q^KZ$Oa;y|xWCk~*rQ@q4Y@@KJluR11ql_+FkOrD4WNP#A?
    zv4!k?n|s?LKaD;Zc1BIaL4F2z;}yiA1V$s8>N5jru;De`BRZ*&2JimM1=q9Rt-95;
    z?+qd8-T%{jv?sji%;#UV=kxJwrsZi=AG5L7FJMn4{HHZbIml2I27ydDG@%iEe-K6L
    zM$NRf>D#V%*%aj{stcG@bT2XlpI%I3rhLx3f7ZQ!y6bjs$>oC2ubt1WPUcq6=K6{6
    z*>*t$#?Op@?K8jrnOok+5{}0b-pB5M^Vzl%m}sI5r~WlEe}7
    zh%9A*BoAJiOxAgM6iIx8)_`_Qrm|xhX3JD;ka893`2{&bZ5RLvGL*`Y9!5z4hY|yH
    zEb-GRn=&-puZ(>mKf~QI(xh6SJ2^J2VsCs)!oD?(is*tu#qgo{=
    z8&&67wO-+GK=Z>Y(KTh0T$45pRVBA6?=kWdoIk5Ko^RNr8$tsE^#uJ(1*V%iPQ)EY
    z5ALt;>D_l^NrX!&vOYk20I5EjM!IO;`NSa$Y{nCu{1h^b5aHQ{XefNz
    z%tJUd%U8VXXP9(@)=Mo>2f_fzcb=S;`vkpgHaj9rm$(7$xM_a!OSoyCoW|fN9C*Cv
    zXPKd<^(DzQT2Ip?VH!+se&K~4Hql>L1Q5~HX&cYPle#`r5qD~^E13*`9&00(+t)j^Ah)Gjy-n;-kA&H=*qie
    z;hjbItXhsuO#T(rOF1+TlJN@s{CMg%PU^1}s(qON+3!e+{evVKh$Cm{kL#QaZA^e<
    zj#L&XTx$Sm6CkuniLuCd|Dd8(asb(y2>{_>gDr*C$D+AMBBN(QFsQ})2U8ABJ&>}a
    zHeseB%27^v5IZzCOx@(r5Q4o5CX{Gm$+`!>YMES|;OfXlZz2O&6TFJv;Nsw%uzn%C
    zC{fyw%x;+8zu+xSlr<&2P16TH6x=T#e&O&-M;1iSg?LgdofkGHg^h2G+!#m*8|Q?5
    zxS#NDOo|)lg}S6rHzzcFBsj#PD`!69@aIke=dGB{u0)@LdtN9=3I!KWUdC|MALf)?
    z-jU4NIPax_Zd50{O|#yP=>rSy#_O#~_s)c{GvVI3;9fUVlXTZ6gxZ9=cERnNIgoVM
    zB`}n`PQep1!6)=!n@9s55}OF0QE|j+#1kq3y|qa-VTk{_3iUyp5_-|M27})MPi8f?
    zf-degq2DqHHP>^%pD96tVl|G*e$Mi$Q-In7YFAx-F=>5}vR0dWEC6se5
    zR>rS6nKHtxj+nr>JpN4y=T`7?6P(V=K~_749+#>JRvV3dfqcK}$0l0pMAGiN(xPLLi25BP9k^vth05I6U9#cM#o1suB`EYiq=xs
    zhdG6dRt|FdW3!&tMJw)H$Xev^2l~~V{EN+(cD}yz^KG-<4R1Yn{ki1Ej$7W2grg(r
    z?YQrzu9Oacde?#$_pQdAB}VUVa?TF7^`_I)VYA&VtVaGln@Fi!>?pAJ>tKxM(2<}+
    zL4wSBIs>%LZPA=A34GEu!NiU5nK-6NGa}Kpz%BzBOqx`kUwM!Q&uqPrY#N{wB1!f^
    z9w?&oLO>DSN}-KwaAR7_7_1t~1!VhJ6j`oq(-Fhb%Z!-u29r%y+ZGAh+6=H7k{fk@
    zKKU~kTmCF1U!i0MNxb#rktTC*Z@W^CVK^4iJ}iHZ`dbaNDSlCPn5H{r<}$Pk`n&kMy#q4=_UR;Zd68k0ifg5&Xb_XGaL
    zrjIy_Xv3~7=BS$sA=3{tA=3{HWU?@1S|~l9C^>N<>$W%VLHHt4?fV#}lfT1KRdrS2
    z?$3P>n~3Z&~GCM$=zrt;^?A>66y7=^W)8=TCY?C(A=4hX?nJ`~`M9jCRV?JarT`zA;RkG_V
    zM%t%km*mh&ryP=V(xFRRE+hYdP1p8-P1oI9sV__Q>>_9*L~T=V)x31pNz?Bj9VPgG-dqRw{p;
    zl7B@Bqc$fgM$dD+p&;ecxn6V+Y{xxXY=>W=kH7A?|b*`
    zY<}+r$Ab5<8zo6^d&1G4@U|~_H(jksdYcoDW~BFXG5#W$hTO$p)Um0?MIdJ9vf+xUJDAZC;Zi
    zXiplifOcdcUUnHYVYqx*5q?Tet-mQd^fPvyVz`a`11QFW*mO^?!cH8;F!5@}shjA8
    za!_LhvkpXMCpl71y>7ft&r&DL&Ua{Knu}L_yLN|ZXjiKZ53feW{Y!6H^`M5DY%Y`j
    zJMKG_M#ENiCjU07`Li>zJ}GfbhGs`@Mvau6WCsZ7OwwRnP|6P1*Kn{uWa5s9g2}%_
    zJv!t8${Xa15iMpA%u+=K)l0;nVT5rS4O7^s>U0vO>#<;k03i#&4Pd+_tA8e
    zXxg76W0pD~X;fvFIt1sd6|dF4QhV{~S=X95VJ#CwcFa0=E^OGp3nMdTVZ=Vi>)`sH^X*&48x>6iqpgB_{gb{9N)w?m~^4FzIny|BGX>Z*ipYd
    z6LnSyu`ZZqmPu1i%}yI#E}7;s(rTWW{0A8E0)ZNlaWfH3WBhJZ&I!Bcg^r}qF(-5}
    zs`>b=a|hHi;$Hs7soMp`mn~m$f5H95tl5H17n}>;rt3W>64!ivDCymkaO^>P-%f4r
    zvzB*Qs)854seOy}<`%Ji$131OhxZ;0yfS&Qne0<0`HlHC>FP&=3o~>tW=+n6fQp@f
    zPxE4mWn*dCHLUYw+8xN2Fi0%F41cCoO~;#cAEtO|LoIAP;Pj)xFnNK(ti;Zwh9sC=
    z#1YbqpMcoSz|yJLjMrp>$+3xMxH_h*DE%%5i}2W+AozjrH%_`nWkRy$DoJ7+m|K9n
    z6*>3`q|?B3FM(19jrxS3P1NQs{|Q>ZPEa|7%nGPN=ERPt=A2IxjoQ!O
    zb`-x=IWzcX{f(`2j=l4auB4-D&asaSzx(+#*UUs&*POdMA#^9*-S?eTOs3!cykh(P
    z`o{KM)|R{&;gzb-MyL}{i*08&eW&h
    z^eLX}tgL8FcxJ=NU!O${Y0le>Ay;?X_rv$z?}~RvM*BlMI+-W5?`#mh$Joey
    z)eW`PgpuPofE;V6t-~^s>%6bMqsND%tP70gn>e~L$p1@z>=t54(e9nes&W4%l*__(x9#}!=y}qQ^H&Zn0t$}4y
    zHQT4Kr1_I%gzPl9)tS#s8XTi0yc3V$vVz%6oIO^J-t
    zg@%DaES17}c#!-?5QZZHHbM@C6#kYNhLmtF7(PQj0oYU&r$T{jG;kNeHk+~^5A@La
    zJOu|B_&b*I74kvWjU0)9J0Tp1!nGO-+$b|@Mpx<>)-ps;7-8CxaJD@tMMlFD0X8*K
    zDEtv&#TSr)r&)IH#hUrN%4A;U%>LQDy4mb{<-ov^7mmEqdD->(BQq!Ggn9$62j+xz
    zFlesd@Rflt49pD7u4}jp`^xU5ql}JnTzqPwunaDa&fOQfZ{x(sfmaT^aqQB`*H2#h
    z8j@NYfe@OK~o%SN!KR-7qo^NEuCwYKcqgXNU;KZ2f36OCzqBCpsmn&4HRffe~J2kO3+M3
    z1JHO+x=B%272GJA6ZXyvT}hz}{wQe{`c^0l9#+Onc=s$67GHYy^=ApjTQ77k`S*zdhmEp2*)$VBLD(DT=N4;Q-Kjhmxfzi9$E|cA+C5W_c^6`C`W!dzyzC
    zl*)>V{`Zg}2S>bPs2DS!zyOR{4Br&yT5icC6lQQYCnrc6YuRNGaA*xI&=l~id5gSy
    zh|Ya1*A~2bQWe~+={~;##%UqT139Cu(W!VQdEGOmcoDtRl00%!@QDbvZ6pAfKZ
    zKyQls`I?h69XIm6UH0n6<&Xr^pTs-kh&q2-MY`J{ucF7vd`D(>)ZGL<6+?tcKPz(1gY^eNN@vj$OEuG!a
    zlJKkps3&~Q$^7Pohf?S|oKWW?xno6#_bu8_MbvzKYkRJEGgoXcbEa`Q^!(rpw9~Pf
    z-LL4ZtFd3BP6n<&&9g*Auk13;%dVo`(Dfi%3&SS_e7Re@YiKFR-UL+}oqJh!sRWp8
    zP8rCvWIOXoywATM0k-$1a*rQ*>R4xY0FkY_1KmfDbRJ0YO({!rP<{{dP|Z5awQj)`
    zYB#@a=vzQ_0$Wc0Yf8v)Y$R}4v_XIijh>pM8>%@!-t_c*b`nNFK^z$HIBfBIk
    z9RW1z8-T3w36f~2`d8_Vm_emCm^R7L{2jG_fVNKW_5Pe6+n;%Mu8*0WJFPbzk+d1%
    z_^fGm26AVZm&fRdIi;s^m_IhyKX_#`C*ppiS0#tdRd>tAsiWSMrGHFu7(RmvjG1Hx
    zxFyG~aB$?56xde}gxEkI?1?rK?mnHB()Opb$yh!)Zdx
    zrxW)g62X?1dW;YVj!4_KYEI+)d6QGN{I_WODD(O$<|Y3f8nFk2kU@i_axl3VA_azV
    z2Dv{nJ{tSj)l%pJTdDNrdgK}Xue2HMgG&`nN&5H&%3&2_%T`F{(cjOqLVue!ADsTA
    z>BMkiN6A3fu$`8Va3kf6PT^bNQ_?_so!-Et->Tau3*ofDqC?JoMIw#)l(xhoSwWx`!)
    z)UhVkHh!b@M)#c1p;S6>%UzWasuJ!hqmt6mlXJo`rB2T+_eOYMC)^v2I@A#;Yg#8s
    zcNGJlw0A`NDfV3c-iyfmzb1Ad0yxb~O4tWO^4o;>h>5u>Aa7oQ@?#T-7y{e7ac)GT
    z4>*rw!Y%p#(CB!jY1axgcT;~Y+v>;0wznwL$OyoXG7m9r9w~K%0F3}{QiopIMUYN#
    zD-xv=CK#J
    zoxQ+%DJX+rKl*zd4V_yFPp-80_z=)6=h7Q}R9Mb9wmWTX6^6Dm7|YjqbHXUP<omm+cT!^}N%g{y;UWez86Yf%iq@&ie;C!gwWD#Ges`bHAQ3{mTcGTn#fHmdnnpwH1~nx7J#l#m9KnIN^n?>yR?3^D}wUOzP*K6g92k#~drx#y9F@@=(@h
    zr#%gMB4fQEs82a29pr}${gp#8AV_Yt#5w6i3B?ytOC}sE6v4lzDuO-nzjKiX>~TG)
    zybn|;a?Ynj(~MF$H)x-HN4t;uwr*{zj`~&(DhRs%fhoHf@g
    z7F6^0GnWTu3pdSqswu2i4J#y@c1^lXdrm0FDWbgX(@)%XXQc&FRFpKZ!@p5|xpp>h
    z<9uF2GOuAauW2@W%k=(5i&$v8%h|-r3l3N}aUg#CEpJ7_QIYUgEN0>MVvbnKDr~;s
    zp$cneP@y*As7-il@1Vlw`<2?X6wA!-mv@$l@0W?4l};GgVUVToQ@}C11?%Lu#PLxH
    zNGPhfl5(+MfuU`!+farR)KnIP%5!krR{H(~eg=Z_$l2}Tlz51K#Wx%wT04ShQy|Cm
    zbqb>K^rpal;PeKnfC0fF?O+scW#)Zb*ExL$?;2b{MxU_N73{|0{7k+t+D?Z9_qqkh
    zZ0fI!XTR9ew=}P0=1&3U4W;ltSlmfT1S1bSTLNb)eJf^xPFeT~xd!h(!bXUx}s}Mg6p+luvS2;q57Oa`>eChB)G5*X6
    z1q=B_%5nJ@4o$aDf9k@f1$XYnXKuOICWN&~_gaO`#Ay1ZTX1CD#Rth8u$c>H+qwZ<
    z@2Ks_bsDx79WeC1IK$O?Shs5!rDpS`#9}QN3?ll|*+Zj6OgAtB_;`&eH6MY?#1c{U1@7z7@>i4wV^nrh5g@G}e=jSrwlU
    zB9O30&Nlqi;Do?^k^7SFR`a4MPF^Nghe>V#(T{(F|GI4m^y4l5S9k;)wDv;XPhLaO
    zcusFb^&Ms(7La@hx|)BOxh3~TV*6k$k-B9$g0POtS9=gwm!j1uKLP>BO7ORP0`$KQZytgvxt(@sfcz0agdds`x`nIHZN5Zj#fqA@u?WGMP2r(Ny4;O}0
    zwB5=F0mbp6<kN|6pvGfvFogq#_XIsP^LIn2O(Ih%$HCBqvQlIq
    z0edhayD?bGuDDJ|6`JE9<{TgGiOTyei~KI&_e$UOk*0RJVD%vh?lOsH)>{`<>X@D&M!Ff=N;uqNBNb`uN?fs
    z!GwPgJnhNBzMWr$a~k3lFdF5Usk`o(6WVUWPk-$zYv+n<6Hpg84^k&p-*Z$_iz;}U
    z>J6-PbR@A6wwrxF6#Vx~S%+-IrTZ?bOAVKzB(S})p<{#fW~10qZ+&lr*imbLuU_of
    zmVRJF7nT1C&-5@l2ZS?ILZFcogL%8ffOKgaBXgHlT&y$D2NJc@0-jkVCE!`6y7u(C
    zhK1L(_39{Xx~HFWGC4bEpp?dpC8y-V0bWyF9La4^Zg}A7+cpIIT;+Mqsn(O$27%I+
    zQ%m8qwzvznYrQ9}jj_>_bL(sNe#-zw?tvo#glJQ6cDSeFP0@ujSp2KGllIpwuOdh~
    zBJJ4a)nX^^QYfYxk;i_HLbJ(J=tF)DNj!%HI&*YBL*_|Y_Z>NsvYracng?GN$v{kA
    zCN4R?Cf#MkBpjfj;@mewV^BaUCbDP&dS0jDKS#+PN)Av$4y()0ZLRR|`!%XW%q8>i
    zOSy?OMFXda*fIekgP$LhTQFU1;s^wG7AO5B`IG481;XS-bgCMxD5&*CauG?3NacCC
    z_k~{K62z>FuB2EtFKkK*n-bNCK#~wP%?XEqq_*sfVp4?D>4v1RVP@m?>V&WX@v!wc
    zB;RVeasHca2pKRh98L;{=Y%64IyNmh{5U3?W1Btz2H%ydMf%}IKl})bN-tM@W%Cy{
    zf3beHsOEy3sDU4Bzo+2hnWTHeTgTsg>XsI#>cb6nf9gGe;H9o_^}k#7&7oUO`#&el
    zdJiOo0}1zmg!jOGH#G)%@c-|-E-t5skCxz}-}9DrR$1S-=XEv-@0SUbR*9YUfIk#!
    zm(J-l;4U~FsLM>7s*Y!-d%9walw$a#r~Qi69GpATW}8V>Hfb^8vmQRkz-PuyWx#2K
    zXJnxaHCzFo;R36!pKr|MU=_>J9v8m4ZjHZUhuvV9RW1!%GX?a}$}rY4tT)tWl1G~n
    z)PsWIFbQ;yITrq??K
    zIr7Yk9-pPpy)~G)8g+=3(^JQ5Aew{;R6N~%jLxmBoMil$SB|2^*jw4H8qYxc4$g|E
    zK3_wF7X5&!&6LMAr>LNQypq&v<`T-MEL)rXR=lVQb>$mkk&!TqTa>b^4*_l!5XZ%}
    zk6@x7cFYmBBe??w^7A03@#>>+Z$Yq2oabt2Y^bH#RQvkbu{L~QV>E`3wNX(u;}_!<
    zxh1J^%EltZ*E6~GqehVbdWM~_i9IvZnFnAX?Z+3-LijGD1hpBVC~fJ$JA5hvOh5Y;D04>p
    zHQFL64kiR_2Uk+FP_*%f>ozS~Y`F#Ztd8~BALVgn70@ivPkUK5gz%CzP=DpS?%0b-
    z2li1DC%TPKMqCWN)p^zN=3(}^h-PMxWt;BcOi8lHKPS{KxLT$=i6vH!uHrw=HrmaodfG<(uY*p2rsu98a{Cxh`a5`Z?=n
    z%5Qn=5{|lrw+=Byl`uNHX7k(T^ShGyUGF|Un}3KxPt;x=OnSE^9NQA!Z3|xiRRp4-
    z(Ar4v7h)tf+p-?*sDic#JKZ(VbpP(0Ok3<_-1U7d3$Dt`eFhJPy)z(BWfQKmc({-X5t4)y6f97R{2Mfr{39n0
    zbRP@!?C(8t3|~}ILNj{R1AhValplS5qMxFx;~Wy=m`0UvG%)lzM4j02l@u25BuJfy
    zC>fw6O39}w`8*|GqU0(i*N~)yk)V7AZY)>|&|n$bHTj!V_`8(+J|*9#1awA^HEX7*5~e}>lW%+S~nB7wt~kc4E?elc;Bak30o6_wv!>VG#9c&I8e^lo_y
    zmGM6p{Ud-FzKg^2-{&fRzcY+MbL+p)t@%Dz{sS%#H^0x7
    z{ea8;bFTCIT+R2nU4Ow<-4(=K%XHRVkGs^8;0hPZ5GV_A`haT1_?^G#u;&ZYUebqG
    zEtFQxoJy4V?}$P^`C7QWuhqX&pD3wMG<7CRI^R7u>pFl>N95b?c(}r~ixy{A&ONKU
    z(1pgurFY7+3v73Mte}VrN>I?um4f}=nJC_M=dtoa+npWD+m)|fC@8wK){C+VR_3Or
    zS!lYBTeEJVYSZ;&$%589qP55c-aV`2a{bl3L}?v#?d7gJ)kW)VcbZr;7d7*sSs7PT
    z`))pD)Z;+>&%|nRT|z3S0lo;kkeho-`)28fP6%_{x-}^d2Xm
    zTbF}xz2`=5k#cv7M9eP7#_zhD=j1ouEwS>ocReh@D&5Vo@>}TV*1Mjq{N_ajSxR4>
    zH49>8V&lGqu>YQjNh|BlRxdxv=PwBP(+6J0*+?8#ybO(yFX2CgNHvy%dmMW}JHL)S
    b-#sU_&8D9P`53>hi0{Ftb!vI#3lIMn7+Eqn
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_build.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_build.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..6501aab977b289b9d2b4b372706225698f4ba23b
    GIT binary patch
    literal 1633
    zcmaJ>yKfse7$;A6k}S*43-KclD$!Iu3(qGqPA5lbcgks#l7`PQ#aiLK#yb#&3({MDm_fVr~p)Ew6Jw%HP
    zAL?6SG)mo)SN;pAhx5{-G>(IWYU(sI9s#MYbEyPxW{Rgth{19=rt}-G>3^?bAF1;_
    zHM|_@(5ThIEkp~{ZefmpbPnyo>BFJ*cUX-QLND-6X|Owq)Ee2U@@W0g8Zc>nj$Yz!
    z(JS>x#nt0cn}yF@)ee*f=1Qirj!M%=x|336!SohA=zAARgguGsxi
    z-2S*azGB*|L1OBoYmwiBMFR1RdW5w2H%yZ8xq-3C<+={Js2};6hFx@4Mb(9OY~@U{#rwBOBQWQh{YAxH0IZN!j&#P
    z?=g~gKu@xFckH-!dHa?=)`v#fMaSi;xS`qq`xf)sL@WR-YMAtXb(<#_eczt&{ol>I
    zaK#;fOHLtKlQ6iM)IG%`rM|?TRqrkDWK!!ebwi^{zHKx)s;kHnssArG>Zy7hcOn+E
    zL@~M{L@F-DUeLz9*@sGfH6KnODAac1buK?oW&2%Rw{T4zncFC!P^A+FOp!U`~Uy|
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_build_clib.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_build_clib.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..94d63176821a64dd9fa6f8760e942292dce1242f
    GIT binary patch
    literal 4206
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_build_py.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_build_py.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..70dc7ef71805bfff75a21b300b01fe7077cfadf2
    GIT binary patch
    literal 17052
    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
    F{|`@`zp(%S
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_core_metadata.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_core_metadata.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..d720c0986832771be8e4510d6b54dc026a6fd21a
    GIT binary patch
    literal 23196
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_depends.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_depends.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..76a4092a527a4035259ebd7550fa626772a870b0
    GIT binary patch
    literal 961
    zcmZuvF>ljA6uz^Q)-^OirG*U{y3|q|3%Ve+VgV8rsZ|AK$#QaYN8`lt1>dERs6_~6
    z=*ZT;P{hKDKw@KIX6853yL<0DfA8J8
    zMpJ|zB{rCXWgjtA#S~Qyiu(xYhHI*s4JKrT$yH7}A-l^XA^k|!Mnuil>P+|s4FFJw
    zcd^XkjiDL{WwwK=@K+&LJd>2j~^1SdOYijj@c9IomkR>*m~i@3HL+Z6(^~
    zP3CMdNm_|gQX5Kjc;xs_dgugE#*lU9NT|(e`?aRO#Y$PEcSA7QX-m#SQPL@*1a$H&
    zkoD|VmEZQm4(nZz^_a1FM+EWpH8&UQKB&v*$WW%}3N@bU5YX71VBr&G>6;_J#gqvb
    z3QdQKPG5L+-eR5~vgh7vcRl6}R+GZJ|7d+-jZ>C-EBDIeA>ZWElO4(9zz@Ar=7qtg
    z*Y3(Xj}}WeZ+Rk+Y++cb@XqSx
    zbQ~UM0v2VT6`#CTN}h($*@dUpa{5qr;wuo)!z``>oR}EnAIScVuKgREz!m%#X-tU!
    E0Z=0Ok^lez
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_develop.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_develop.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..744928a04b316f115dab452405d0c1ded154803c
    GIT binary patch
    literal 5427
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_dist.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_dist.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..d79b5385360f0df95b84f454e93b000822a77677
    GIT binary patch
    literal 10995
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_dist_info.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_dist_info.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..2310731fe5c91fdba03e7dcc06beac7f2df31a1e
    GIT binary patch
    literal 7804
    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
    Cmio#7
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_distutils_adoption.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_distutils_adoption.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..1a708fbe944ad05f01a121bb73616fa7590ebac9
    GIT binary patch
    literal 8259
    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
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_find_packages.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_find_packages.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..e827718a12a524744a5424d48e399a4fb97657fe
    GIT binary patch
    literal 12218
    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
    BjXeMW
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_find_py_modules.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_find_py_modules.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..4a95c34a68e4776f2bba8fba065576458191b9d3
    GIT binary patch
    literal 3834
    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
    OpbXE#{wy4Tr1rnyN-Tc>
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_install_scripts.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_install_scripts.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..140dc80e43dfc0912150430836c34c369533ce8b
    GIT binary patch
    literal 6243
    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
    K-w~Fkk$(YPqn3mK
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_logging.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_logging.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..b8971657a1f019738d71437f2e2ca2ddbdd21ba9
    GIT binary patch
    literal 3220
    zcmai0O>7&-6`oxV$t9N*DOskK$Uhs&PPMj0(UBWFtzw|5b&*^6`D6l`$AvUM7qo_XuXZ|Cq%9&BI-9f1G#KREZG
    zIgKx&2G-cfHG+=+B2Y2J)L(24yf&{r1#8wCp*mL-J$Y~M^n7Z8dgv+h2#rJaP%-Yw
    zdwc(&8{s|v`}S&hay{(()$r07LN@;ndY`K!Ew}s+r7^>{tGYBgnVCE<69)Gz
    z#l*548p_UHy)tukMQ}lyuGCh7RVP1wUgoHvn>kAZh*E5rh66KE+p#K&ns;6J>1g>o2xoT$)@2QeACb@038hAx-j%B3JrsW>Nte<7j$PPpNGJWWqp>xo5oR2)Sm1)C03RATE&&MKEx6K;)R
    z>T-+%xe=i9L{(}%`K?~uy&(!>(2x$Ft*$KWd`0X
    z9dzqX4;Y;lVHBgZHoByZ-3XTKq)wVizYm_)r@kdK7+~
    zdXielnQrQECzWoe(rc+qb8bT%=!nPK;<3kxH8Jy-OP`5TEj-l{r#24^uNK<}#+tKT
    zob2G?HXeR->B-F&9$v@iy5ivd3->N`#L>1m`grz}pR~l$HF3H*-5ol-T6pmD=JYxq
    z>|(*QTgOMb$y6sf)=rMCB~LalZyY?_IViUe%1`9AgJ+xBuK3dG_0PmpEqtmip4x_V
    zP;RGYG1;wwZXJ9J9_|9=IK9>44h6V+JKa6x-@sp@Jg0GY1pjU~xH@+Q$$U1qSD(R%
    zvCKAs?l;^+6hS=>*#k#8r`_R=w2W!r4{Tc}4y?`)Vi6j?d_|eRHh+zV0D=H88oZTP4PYc1DBDmZ
    z@>Mfuvvi~;IROI=Dr{=yF!0z?O|eXuF4I#bE2oz13u$*X4T|>nq5Hatws0si@UK|%
    zgNt8pB#wNAaAe@$iBvcB#)H5{GW9U_>)7MKYPEIzoz{^bttV%@vHqMg1Zy
    zqFJ$1KR-<8s1{k)&Pq2H)qLrK=TC@u!`b>Y|1BF1Y`@}HW~u51sDP8^5sB-
    z2ZG>=J#q!Bowgsf?qaBp{vVl=AJ+NeJ|ucO36#9=%JL4OIz18vy&ie`F(I`38L%IL
    z`ZVd0a}7B?LM;yM?%_-Od+;&s?;+!?%TzK)M!?c7&~lt6lpe<@i%|OLz;4}3v&s#G
    z<<@b}ils#(Im^r&1t3cr)=l+BN!J)1<&6@fqo`pUrtPR^PNxCbfw1&x80OfA7ZnV<
    zY-!b!E(geW{XpE!ZT6m_x_ekU;Z|3dRv-jLvvgZAEl0_zRiL8^vA}KFCKtel;oV+_
    z4$7^7g2T`7k^kVMo4BuoQ*E5;V5yCzbv&{ePIbaZ+u@_@VQDjQ;C|y?qm?-RB=!mZ
    zd;G8Q_Sj5Im}wWkG(6J58&#v^7^dPS?$H@J#WdOLq`0h-B`N~Z
    z0!cf>SkYY;aqo|t;GdA|!#$Yi!j!ko1u_lBtmN7@bXx(A<32~p&rzTIi#|i~&FJ82
    zpfi+d4`o`>Of$R{3de9$*cwE{{tbW^#K3?
    
    literal 0
    HcmV?d00001
    
    diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_manifest.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_manifest.cpython-312.pyc
    new file mode 100644
    index 0000000000000000000000000000000000000000..4aa4c76910b17c4d0149207aa8a30c3bc7e6a26d
    GIT binary patch
    literal 26796
    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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_namespaces.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_namespaces.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..91563761f0adad0de5b3ffe0a62ba9ddcd98747b GIT binary patch literal 5591 zcmcJTPiz~<6^CcJTynJ{B}z&pTdv}jBQ&C2k+L19PE!<>B{@!uvO?n?tjl7>U5k`R zE<3xlOhN)$zy}2mklq~hBp^A|a1QCsK-xpAB9|U&K`JC{j9!`?a&v6~3Uumw`)77Z z(UR4sE9mXa?97{)o!RgGhJQ;YB?8yypQ(k9dI`qF`fn zAsw^3uIr|i3;cPbar|_E<7vdn3mKbMurk#!@iE)OmFMkgUF zQAkCdl&~CK7H&pXVwV4Y$wJKQD0I^VEvCgS9H(@%)WlF})GwWnuf#3r$-Nd5 zek!;x$Njooc)ndh4L`Nayh6?6jgt5KXd0#9mmYJJhxgr~N%Q=QXu-a9FRPEGL_f96 zcA-CpO9Wb!2sWMh;z!a4^}vZdxN z$NwBS4@OLNHD6HYO1eB(XP%1XszI#`%kOuT>lHIoU7Vi?l2;l@9QT+%`9>1Q#BA!n{_~A9Zbvfn{+8TQawV6Rr~s>N56snyB~4*-QoMd` z-mIIpq~F%_H47&K1s1g>vo=?y27m@0<_mg$QOU!K*~zlHs4F;d1ztEsNZ5Q?t)@Hd zsHvB3+A*tKg(tQEvsEVC+ZEfHs^6t)J5vp^aZ9E1x@Fp(-VBv|S+gaJ))jX?CVuGt z=8^Y*lPwr!J*$@V+u5JhXQ;8D=Pffk{qD?I&d_u>_0H5)Bp5qpQZb zX0~PytBeuGOaZ-qO?JCT&#CRyg^kpOPv3a>)@JJMRpD`Ju%%?@#4Bs3H%^SNCPS&- z(`!SIdNZr>-55!xKFGb7+exH$5`#O5mmep(e=FSm3FI-A+)TXkq+1-2Ry%ilNk`wd zIJ6-SeYm(Ko_#F#Zj17UD6b7|iPu&I9Ew9JDpdvN$jIz@evqq8JDu6nO96qaM&Ct!tYnD6*%wEJ8;If6aH*U(v zEUKGEjRN=repB3Rw&;_ZVtBN9U^B(lq^J>c6c?-UlE>dBM;?MHE}|`z7ZIEol_{!mkSfs;{v`;#qY3ke~Xk)Y; zlG@dL9UcD@4Dd)I-6yxZ#y7ggKka{bYO`y4mEY+Z`0(sT&&XMWE|?>5=X<{&otqr z*;6~3JVBc5^?*-IW%u_|kar6AO?A8rnJJOnIjHc!Z4wO*!?IPB#GT~fC2}&GU{;U zfOb@v9#>HQz_=RUZ-500X-~&;Cl5C0^)6#x&9YhfY_&O*)MYPY&?w1Hz;n&!ywGs5mbaeqNB^hXzBdm2^la6y;Yn zwS?PHQRo?X7c`9~i{?C-`{Wr|;w%=$)pHDfnI;O>JLG9(RLDHN&JBXSd`g(+p8a45 zEPcbT3md};R469wRB-0b!0!T9!Tn`{xIxbGe+e5ptx@Xki$8P+`y=`$WKrRm7|ovW e9LIe@dcGjiS7iJva$+ww5#gq}r^LBA4*mnFhSGch literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_scripts.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_scripts.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..097e32dbecc857093c81d5722547212e97348c64 GIT binary patch literal 1036 zcmZ`&O=uHA6rR~lnl&{W+DMBRZHz*;&@3uF2$EA(6b!`*g&-`O%-AGuvT<^x>|MI$Mc5`~hDkAS75?(%8~ygeFmdOd z%A}S+7rYWasrfR3`;&MtU>jBV#!tS%j?s|V`pk-C1MuD>rFsyANC$MMCzPOmdS z!+6S3QcgT2ZrZ)}U}G3hI!e-sCy&*Iy-Ke#ICrRC;2!^IUlU9H?3?V{E5k(EQPNI4 z?IhA8o)F};5MKhLW>&FbxKYEX+Nfa(`K)0)ZJ3sCAz~BW0g~X1EC?cM_K4U%Dn_#l zMp7iK`50l&@kNRL?UwiMzTdKNp2iw0H~p+xa-JK+$WxK;hYTV70xtfVQ=s+}aN_y= E0q0!wVE_OC literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_sdist.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_sdist.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e1c0f0572e96e806398caee7fa471299e3da7799 GIT binary patch literal 46444 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 UQF!+i3vaHwS86x!W!%vJ55fIXR{#J2 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_setopt.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_setopt.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c82720251353ecdac8a734a1a1712df380a312c7 GIT binary patch literal 2910 zcmdT`O>7fK6rTOf#&K{r5I_XzCL{$zVh0kGR1}m52m+}o;-`q9YPH#T6qom~?g zC4eeaC6y}R(pZ8+)b;=(2M(yMT8U#Xz1TQXqAiC?Z4bQ#a)^{e)i=9dJE4J|JC@(P znfEh0?|tv>{!(8bKrnv(NsC<+5c-`i{K1!*<#u3Zkbw*)iH7LRCYcmF#4?CQr;x$j zMh5?w^|Xh$91|A)qKm;Wt(UC4-%RXtuZJk-;UIdoZxYHb=F()W(KF7T7or09f>D#m~$jL zr?nJz#IlJ<#h6$$0E(ilPDW#93P-ghz8?KBcb1q5tlL)fy6s$R+? znVb`JA4~OaHQwmwE3$T*M%Fq3h3y!{SIL18_`lT9uZN@9O_#9N$;)3Se z&zzfWHbKMp+5ikx5KtL!;TFT8iFuKf-pJ47=aKwqKgWeWS%D3 zseu^UIBh$;Ws{VjUm{bJfNP@K__{s5xf0{*<|a_GXstnnA*QW)zEr=9#_aqq_LXlYwyJ{YB;?OdS>FDdb&`ekzu_r1`M)<;zWw{EqagIbsYj3+Af z29olC_?CB}me5AgT~mFPh(c`3`D2h>slNn0@wKs$wO!{cRXKy3|1 zZ7rV0Mx>&#TI-f`L?0Q=?t+V4p`FG0B#@wP&7*~WaYQ?nG2+A#y{>Ni)_zwdZ!r9$4KwV68o z0>~}26hIBzXPWLc<*$_F@RYbH1@DBWLl3z8!2P;H+sS!p;DxklLE2H2c0B0HU%P)~ zj(^(y1D@|XF~5&W7v;tUxuqz#eA_j9?VBSdISNifjd#YU$Mbt@0B$f`Lt0>Vu}$_+j$)g%Qql&b{0gVtI?R*3bQ{_OB4H{Mp@6em@-;j+ zxJacpsKU5uJ&e~0>C;&mAb?)!t?2EUmwNvTz1tS#=AzvEu%{q5m*g%A-Yt1?`es4e zJ#}+2v^D=;F{BhE1t>WHhtl$vRF(DvRdoWYnlg=SlJY@S{SP;2i$7TnGTc1&IYf@DN2(GAJH^C4q`4+YxMKv)mbg3+@5U zEC^r)M4(Ht0E-UEL^dJE6~Qi73`TTJ+esz1lUP(7OD^YQa7cj1REkxStL&;&1q4;0 z%}OPCujkkU10J#?`y(ywLr?eXW2WELuV3@WMMZ83(ht8EIni22QSah|ksNyFM!-f< z7bt=1p#)m6#pxcJ{I&Ji$X}+1fxk@Lo?v@eTElVlIH1fPcP6+VPA_xyxCp*G;py?} zWksZnjk^=R9-m&u_xK53G5PC=7bi-3N=ThEUYaQDDWfSHB|7?>jEQFd3fv{vtF-nk zxSyw9)vJ0c1kdwSPbIW!&0-t5{&pjm{R<;(5WRx;Rd{zyUP>ssCK3FQC-Yv5Pp;McD47KgN%=0c&;{2J?WdZ=5Y zhpybVT3%QWZ*6?h4LN-@2peI(n}sTXjU%>Tb>_Y&ML8`8dQ(y$eL@U0%3^wOAe~CZ z<;K83BziK^C;kFE?GDnavnMuiI2IQ%`*Bf{W2q!&pAerJj7eDPIy9UXlX`jS!I+#L zOvmE#G3@h@B&DP$5kE4RP7TUpRG*+ZeFkzj>;NuMBh*E@`yvI{?sQ^6h)Ln-kRW4& zz^&6QCsGNqB@!2hTOJ#ETuSwe(X`xh=-A`U-6=uTa$N@xho49tPo-O63MnZTiMNEz zTs(HXWnd(IB9&|pwQX;aV`;Hje^2Zk`Ja; z0Y8}qFiu^wyKg{-iXt!)R(are<0=4POFC`TQ2jcwngx&vn`NU^zcaT+%L_Jv>7xyT zr70Jcb{SaxL^v2vIzAhtMyapTe*)}%w<8~;>ZrTN9-@Ysr>G%1=*S#=0@hnf1_W4t zDRvx4Ae9XCN~wfSU0a%(B2u3mY}^(Yioq%jrUT-z7zMm!Um%)FBqB*cRy}$y9!rX< zM~+Idfpi$#sm@qZPDkSLZVA6=(4o3;BtmJbJ(`k4wOCuPu$)c}gd@FaQBvKof`Zr^ z8H}e%UMF&uB`XVrX2-rY5|fIcU)7a}oD`2C=}H^n8GrKc0T`#29n_Yc&v(7heY$(W zUJp;K>xHAIkDhyMx@&sxg1u$g&akal`SpwZrdj;Iak?JBwXH2@TxWfgzPGq7zns}& z=5NXP8h=&RQAS-UtL)gysHJ^kI-E!egK;q&P2tNX)0vv%BWW=T1RjtF2L@77I*?4I z1CdjaSUhr^@T5Z$BXTO4M|TDt-ROidE>I!`YJfr&00Mv!Yyj;dD=;}C!U50roM$II zvpLV)h$HA!Jt#H~iUT4nRURWFp%X@42i$srN}EicHl_l^ZxF6bk5D*?F?y8lN6s%u zW41K*MN+?^*^C1CI|^(d*k9FgPTM|8eVV>w3wS-Fh2S{31y=R$+BtLD+3%qpmu;ub zaD)oFx>dh8oR%Wdw7J50>xQ4L6n;0#0HC~xP}vU{u|XHMZq<$gD#)nxuu5lCdW7(U z#6t^>f^EHRnJqaB6+(Ov(KzhGNLQhK@l-StmmduEw(W#wvKIhIFn`5F$5nsvWC!U? zrJwo5|3H%JvFADjn-Mes2-;QWiHICYrzMpU!~vBH!wU&wI4sp-HKW>PG2SaR!h>q- zjmo%Ifj~f;puccJnX21O7p(w!3cxsZm9Kb7R;oe^e9JX&$%>tEl`Oj{pa1M9CqFr1 zd*4C%OBeaNS-x)izzj3<#5~`s@b@d+{Q#{hFCU)cA5gdl6#fCr>H~B9E`{5r@Vl(4 zwXSFR`^o3ZV+SN!eB~R*3)sO*>ZeT>FqHRBil)-0{O{+Wr-B5`q_Y?pTjW23xuB(9 zLs{yW4>X$XHly8so{Z7*Q}8{;=rP+E15A&iuOPjuKht0Z)KP7eOb^*;>M8gVGlEz@UG?&3k4_#{s49FBvGZFu z?SPHh-M8dQn7|h+4ydINhPE6Yt$M=Y zQ<~Wu4y*Ql(6!P&s8Jbt1gsLhDibIqDxCoMr6ETRY7>PXN51pO9DhXNjwt+*_q_a~w{F&3r_>*Q z(>3pX0)+7jLl;#pGmOi9-3GbUg3z=J4#PX-+67260%K@oVhP||79=5uMyzcGfyu5K zU|3iSSrb_>#aLb&E5kWQ(?hRl7#1W$TnTKpFTo)=aTh%Xf-8+`oFr&pZsfCnjrN9k z9JOWpffmS#1qmot7wnqlvIds9rO>kkKhr! zLQ&rO-ev@I7PlEe!vW6pfeG|c;KB^s7HSQ(XPGJE#^PqJ6sbwt3qV8LlVMv!dqQoh zb1-=_nHoxFdeFEL>ZJ5 z$wvnz3GzWkQ!fk*s)>O-Bg%tvK;MIBDhnlmUhzqoos1^=IQ5>d{9Nx;-}I?@Uuc54 z#+RHOo*bUqHOJQ~T&=>_EJ+{XN)~z8!qi`KUUtrJxqr?ur4V&& za%{S2j&D}DW`%FoOJ00#dfOZyQn--9hcsbxuKmJ8=O3Cct)J%`WhV_Z(b^`xbWcl2d5hsN}Cj}N#UD}lHfw=Hig@!@Y`_K&}xC-q;Q)Q zev{sd`3&!3ABp2F*GPNoCfVoBC`^gU<>iqLu8*k%$6l&bTAtM2R$NJ4l^nqP9LN zYJ0jCX3wPkM*saKMlSo;N@|Uo=G=MPnL0Z)W+&#Hg|r&A8xqEp9v1vxh&2Lpqv1Ek z3{gR6x5^@2%PNbsE@w(kq|*Zrw6uuBk;Fh;41ucvcJLhfg$BT3Mf5cmgu?@o^a)V3 zMH&-3z|ED2q$M=6q$3E>c_uvxKwV`GN*}{wTS`{#*o*1}Uk_pD$FNN|fFP@>=A&3Z zu;~GnMP!-yg3tieExW%EuWumxZMdp6GTL4^w{d=SexM_v_Y`zDE!O>f`OzPXa-t)SJ1c8Lp&Jn#&Kp5Y|Ax3k?c|0P8z{!zeF%!)&(a=bS83{#$ ztV%~ROeAzX!vY9JRrQ^dXuAHv_TH}`+m32)^>o&aa zV$0nV_RqOiYa9G{WG5v+CRf{7FG+UuZna=m)~~V4(WLMQC85TEFAYWq@uw!EqLhRp zX&nI7i_Uw)d3%v2axT|7N_MmaC-vmWfS6gIrCze#$yWU-bSDP@pwnjkRQ)T#mxEvJ z`C9nP;l+lI*@lh<{(!v4?#VEAV+vg<;CG>d=T8C zy3CSJAVv%U(zFyukU)U@9tn?Va=EPpt%pNe7msU)a{69h6IZLNKaV}|pb^HYCC+=+ zHR)R9YG=9H>AD4O^AcZrc4Ts7k*}TQYp0_#?bAJTe2c=hDBw-K6ZZ7S=6J&{H~K+G z>kKnJIG43E^bv5^FjMx8%8Qkk>;JCtn~lnr2TV`vorZd1j&D@BMul%QCww;p&A8_H zHic_b_%?9Xx=LR3EOK?TT;24;aPV>)A@kqxweCg80OMFNbsv2x$0NIjFt8wJz_ei5 zT(VrFFSLOQ(uXm#HO9EJ`23xnFEFvK8&n-KWYD4UtyAY)jX?>kBA4P3B;jXkPVLev zb%tHVsrl7^3H{062LR_T2Jfw(<b~bz}-i>zN_AU%>PD_k`!{SG$h1b`Ov zx)-0Fu%in1PI{;0De-dYW%jj$ZydRD#e_5Oo$NV!wqqSjbb8zli{VHO96u+dj0hE#F&UVl;T*b*I;FCivlA-u*)y zf9>~Yf6MRx;f!zf{tnn^Ie%+!e}~am2d&%9wBx&k#{ShFU&W=*Sg&6)pNqx{V^ z%0F*iK4OG(a^0FEgH}r*c*cmG38w}ys#A*tdk!^12Ei5pL0USAe;iU97Hvm>_Lt^d zBqkEEbPKK8^{6SjlBXi^n2^6i%G4KFNtRgu3S-D`5s!x+IJ2-ZG+)$$ku$rNy#BLY zlURE5~ijjF#im&j`;z=R_0#-?qhyf zQPagSZ=zrH(hLJsq@VWwlm;-vySa-cD~ulcJ6V$xsUB)oj>B(u43np z%Gj=IXLrye{Q*)cjwSsef&m1B2!;`iAs9#SX#{_aU;+VZM`8((xJD_8j|e^kKY1Gf zJcx3!?v)CfeVATx@N979J`cNhWrLmFzT&mB-Smpr!?xepP|Rw3C(=AG)(UM3Vprf) z$aY%Seeh_ed@Eb9WngBO-b>R4L~BE^-yPmD^mD3AZz^@m4WI=Nb|4&{y5)w@V<91i z(!+4zqOysTa3-U&LlQ*R!#S)&i{a1pX!`V{+pwG(l;GsyJiNg*_{n(eM`Gw-c=Yt6 z=gJrCl}oH=B0kG*ShUy9+H0rpTd+4+6?uxsEjBtRdB{imYslp8I&;E=!AvVm+0(I6 z%1|riAHUs<^_RVk50c2x+zG2X>I^U>~&Oj zJC!y!P}zmEg8?(K2x!s z`c|-`hPhHr10=&*3x^*7_Pq%Qt8*C)Gc}IDfdWjAU^Xb!N(`(PB%^e$huKBMia=$1 zUTylDrZmWNlmIFN5&+EOKZm@=?9-Ubmjd8C#I+-ApXWTRLNnQ9_(V*G)B8Si@o>I& zpk5hclt7KT__NiM)h}+kPBH98W94>EH7sxe3n8$?mrdC|`>eukn0)r86I$HFW~8mo z>3cgWm@5@*$0lc{elUsmjsocv+}iu{*U;I#bL8qMnSEfY3FY9=diPXj;&{{T9x~EcaWTs)3QDi*X2Es|P*IjM)km z#BS>tqm|d`q+E39EeTKv9MRqvs)kD*4L#yv6ROuq0>App`WSsgHLI_X6S5i3) za6&b%Iwf%+9s$FLuskD+1EAq^LeRoPCqyx>Iy13>Ubt~7?IO($M;u18B#uKUI=(uJ zBt6P3NQff_o;rwY)w+O4b5Rb1oFZPlNGus9t0es`w1oS-lza*@5ESb2E5)_*uKQ4~ zchb{+OFQ;1?l?HRs&eS_=hQF9sX5>NnavZU zQ>PaAhFRbKUlCjM(>_0a(Ls1ZLc?781_EOE;OUUcM3N&H?b0`~^jip!{H1RLC@^I= z-C=stKS7&voDd${f_3}rk~!!*FAwi=xpTp{f5Ed~vG1St?6;!s8#;A2A$2zp>TY7L zG=P=FTxnuE+W()rwfn-L6<1L=iZw#rosco9djm*g`u4UX(!L?vbq=V?;eZ+lyH5%! zsU_6(sSrj7Hph~^sg}nMJ=t-vB2p}ESLKlQFRwx_qSn4=(#)b#?N=f_Wk1uljt}{@oGfCh+TKXQK zOaF-Tumi|S`i8rjg!BVwRE5J1L*_R{{@2OOA363u&h>rD=5;JnHr4^fUWXMYNO3cKxLxX><=i~f3OX(A$l zU60mwtXFEn`9~0JLJ&njHf^}KCc80W-l`t>R}b{QWC<05$`1F!{cWO*iKrqAR^Uy# z#qHB>ojfSbLK|33O5O?(jA@$w3AN>2%JozH-~A4?@m;Fu9jf77s`wo$@KdVd9cuHt zRM}6d@^`5Ecc@m-(Ki2h#S1m3Yo_cAbTwSnqCF7gY^zzu+zRKRTbHY-l64n0p5LhX z0Di*p=NP5DX`b7v*tafuwl1?&N&O9qDY1?FZhD`j>4xhR!kbCkCuq9uI)!ii{$|`UNY{5=8 rYE21B$t+!>Z1{*mm(0^0*KI7_h-e4sWz4Sl?ev2;d=A<{Tyy^mZSc(3 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_shutil_wrapper.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_shutil_wrapper.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..eb26f8950c40ac6046efd911f6d6538d267db7e7 GIT binary patch literal 1383 zcmZ8hO>7%Q6rT0Y+HMxdMrj&hz}`wAVkxzga!3vc36TOpjnf~AgDEb(mqRBKJ&D9P~0FDx!gfBGb>13+V zfUrxybL1vYrd~&SNB3p)bM(Imx}Q2{6e3G2oj-1lk|tb5*8qD(S^Rm0X54>uh81#k zCQjFV|^#5ot$4nMEZjCaoZ zB|2*OZ_F$TbzpND0Gjv|e5r|^7nOd-RY%EqPdi<@a9H>Z5pS<;;Rq38?PJoUmP0Lc z5TiOnF3;?HtYH)6xHt;hhv_{pKxKBoxW4a2&*cpgIV56ejD6z7lrK7rp)h84y%A#9 z{sNI*Oi{Iz<3`wYJ;KvI_M+Hf4Q?>pstY#W$suJ9==P^k@wD16bVm8c#?#SAjIeDP7v62+=>`adejzKOG$2qIBKG{$SiWE zSs2^nL!=~<=ej^~h-_IOpI7BigQO?5>_s#w5?W(=`BkMM94bzL4l3L28wC5JW3+PZ z_Kho5?4k+U+Wg4Ag?BNluolC_bAn3w3Fv!<^O6S&#C6=2p5}Bbd3jbG$Qvi&OO7=7a0^uMgnmXZbgOT=`*Tm|yGX z*M5C_kl(m}^Rd&d{*_&L_|7oD-p{WOvK!q`Mld^sOMSTXFx9)f@pyRvKYS*#RgbIR zt`FerBXePB7W!u4QTY#ZwFg&w=ISVW>6<%W-x*|!Jy`6S#a^~}Dvk_FDUub8$k)j; zt;iEoMOir%KdABji-9<6&}0^5$v**NNw0!fUZ&p@1K0}C`{XSl%2B2Ay}r;jO?wK= Tr(o`HQ1}-VPLo;98vFeRB5+5< literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_unicode_utils.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_unicode_utils.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..4913cb3e167a4828fa86f2669b999e3a32bc7e5d GIT binary patch literal 837 zcma)4&ubGw7@bMBX^q4m6pY>m6eL1-(Vm2mgIK|Xp=eG;SSGvEWYgK5Wo8z;!Gl8o zhg`i%PoBMd@nS(K1U-53R>-XUriBv4Y!Y0y0pmkmzbX9m}Jy<5> zH5vW=bqrn>y^3K(pqWuYA7R@tu1-lk9lYO z5MkkRZsD#87g>af30(|rsUj{-$6rt{!F3GI>@Cr&*yEK^t=pi!^^MUqwn7J zV~-tq>|OJl*K!uoS^ZB$&YV+n19A{&1M*2#Tu9N;S3w^A89eZ$N-6z8?#ya6de6as E11j6y*Z=?k literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_virtualenv.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_virtualenv.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..14161cc27102d191fd50f77561a6ba2e98c837de GIT binary patch literal 4486 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_warnings.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_warnings.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..95e222ec0bf52416c537aa2dafe95f20cbcf08b7 GIT binary patch literal 4180 zcmd509 zIEh2Dq${Kasp_&X4G*Z|frlVkwT~<9)Ape+eThk`L?bG-+DcvCk_L%3Pd#_WP8`ry zeb}ygEuVYtxp(fId(QdJx%00nn&|$K23TgX#QWh_QXCqaWw)7M2 zfrd(abni>HD9YJV+Q4dFGtiFiiRO)a>-`I{$4;CAY9OE8m{ziJcmoed&R>ykw@aJ@1*s(4vCPP1)Rp?R8g9 zuh+@Y+)d6pd`Cx}(=$11$G+jVV{=C-`AqEO4(T`i#$)b*;9%@LU;+`WL~ZZ*q|-}y zs({lL*1!Y4WHFahNog}MXcC;0^#U#CY)LC(MN=&t74+~CuxNmpwF!uNmqWkySboJ zYip=X>Q=^y2Rn$T)EpRB$*Vb>u4Hit8HBv>XGwJ9D1^*BvY5xa(8nnt8CR8!Xb-gaHnON7H>4GT0PM-(2TXSXx3x-T^^yVQ+KN) zx1Zs4G$TCWe!)S7^|D{h+n_qT?T)9qqZO{oX2hy&{3t?{{~`K_D|rv1Q;2etJcn)| z4t_sBI3?UblU&p{{ecsD1C~rPX3@}OwP=|+sA((+OL7Jhj)5WSG@Q4bN_QLv7A6G~ zVu?jP%ScuRY9EyieH_wK5&jTnZX}T)C`OpZq#lUfo=l8hzdAZHGMH2n!{T}mkZ ziL2KVm-_v3dh{v`#L%$gZRWoM(OzhO@IMpqD zqM)Y7K{r|h%s4v?b*RELVKxM?+F>SF0F>Yc3xot5iM|Ja`YDh(^r{X8_dNJXIdI_d zcglfdbNw$uO%G8x2{6!3}h)rd&X|egcpEWOw zeJ}jsPulLcEjJxm@*iD8oaf}izzeBmMQSfg?T^JpDZb!+F2!F9F!Q%S^F#kq;J}m2 z!qn2??&pE-MX|da=zi^iN$1&3%B=cDr0Jq0{9f{0+~rGG!W_gkunan|<)T#iSl%Ez=gXLHlNlNni&`{sC8^HA^M*9W^lYq|t>ww(8(FCx`1h6BQ zl26eFY>NoozK~u2h63+`a0vdCUCHjE)rPiv(rSYYr18K#|7v6BeLv}fDRP#PeL!r{ zB1KG^fsIN;WMY|-4j{Ids5-@z9ApE5TEzBDs0J)|z%PYb{B7Vc{VB=_C+99WQzgEw`L~g`i&xB2Q!+RZYv{_Zh18-QTy|d}hht#gNhd znY1c3tw^n9sdZV}$Kcey=Bn)F&U_|8ObL{^aOF_tJr`=Yg(8v8x>D zdVPqkWIJq97KESg>gy4{=c0!Atgq?QdFc7GC)d+F`HiP=N0=ycQNfhOWcc7C! zeuix^4CF^p80OIo`T&d%Smd%Gd$VP0OKxRSL#$N(lAGtCugIrKc-yU_SR zoDY5)T#0m)BOQ-B{uJpfhkO6!IQyf6hdB6%6Jc*F$`NKP%1q@(0OE{eTQWJc?4pPr}eJH&}HHxL_YZd%nW?gpz{pEMnoGhJ;FK3c}@ zKtUydD~ssU*cPEaQ76AU;pQsC9O6QO0cle@@8a?T8Gs?voc;>Pn!s_~pHbVFDD-zU zvhGEZ#?{d2)jdrQf4p!668{?S-z~lJg(BYdHq_j@8alEXdFSEqV))%PKFDSw&EE9` zNbY1aZO0b7uav_BYkWPM+AVw6`?xb9e$KyUz_+~gaqG`oSGc`pZtuhPg_hs8KW$%% go?GI2*7*Q;ZbLwP?;7L&(e@5^cB6;m&O7@58@u7W{r~^~ literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_wheel.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/test_wheel.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..967beb7387708bb9453772ed1380a0db45130f46 GIT binary patch literal 18372 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 V2OQlWl>CQ1W2=S#;&5Z@@jsl{kgWg! literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/text.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/__pycache__/text.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..28a2b2443365906e2e843ef574685b21f0aceee5 GIT binary patch literal 555 zcmZ`#Jx{|h5VaFZ`Dnv{kXV>NLK#}CFwg-p0TlyL1uSH-(%R5K5{JY=O<6$d(y1f- z1;pNk5s8J71!d(AAUYs1VJ9tO;fA~S?(RL=_fjm*01?lRR_jXCcS*)EF#^Ly0d9c; zYJh+)An-xSCMJj#U2Tr{WmQLHcqG6rpumI#mH9wFCxnsP4bavHyNSHB=ypo`QS<-eQ@<24CO1oFHwuR6j=^!qy4xZuru1^A=){t zmkc4#(BAegK41;T5sx?vY|BCAU*y;g3-NtKS`DQ05j8%pX mGmBZ-N!#*t-&32}J+=Z((A0ZQfDaWy_@$_D$Q&RIv6cY1N z6mnA2N_2}$iZTl{nQw8Fq*j!a7bO8TF{*==0|2WsZAAb8 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/compat/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/compat/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/compat/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/compat/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e586891d1acf6d71daddc8f28a41295fa6600a2e GIT binary patch literal 226 zcmX@j%ge<81jlwKW`O9&AOanHW&w&!XQ*V*Wb|9fP{ah}eFmxd)u^A5pPQ8XTbOm!FafVR^c^#Rugl<(KG}l$PWdWhUn6>%mz$nMwKul_eSZ zdB%E%M*78>C8@dviOJcC=|J7ZsU@WaCHeU|#rh?w#Xy6T^K%OlOZ4O8GxIV_;^XxS iDt~d<xJh2*kx8#z$sGM#ds$APWFlpg;)# literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/compat/__pycache__/py39.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/compat/__pycache__/py39.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a380379042e9d889bcc1477527beb9124cd0fd7e GIT binary patch literal 393 zcmX|-KT88K7{-&k7VN)41h-BOr9&@hmkR2n76(hwt;><#Meo|AZ%9(;Ar4NiZhi*w z3kdEmPTK7j5hpjHTPJg^^&Ou4^71_7A+ME65!rcprqQiEzp~3}+&`GLEZn0Ig_t9O zdssL<2O|eDCv+b1(lx<)ZL!0lyV~{KBv;RWXNJ0yu3sn+zG2$E!U(KZ8CPV#WqkOgZuXiN}4ie4^=X?+_gu){rz9(o37x z%#5W0;F@G*GzmaRYHXmn>&axkwkIGQb9SIgwoUdmx@zUe#Tb8}{m=5|-PN?b^8XTbOm!FafVR^c^#Rugl<(KG}l$PWdWhUn6>%mz$nMwKul_eSZ zdB%E%M*78>C8@dviOJcC=|J7ZsU@WaCHeU|#rh?w#Xy6T^YhX&)Ai%yGxIV_;^XxS iDt~d<xJh2*kx8#z$sGM#ds$APWFj1wZ=$ literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/__pycache__/test_apply_pyprojecttoml.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/__pycache__/test_apply_pyprojecttoml.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ea954300390c6f2cb9198f21de98f6e1f2b6accc GIT binary patch literal 40273 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/__pycache__/test_pyprojecttoml.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/__pycache__/test_pyprojecttoml.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9254db3768901e85e9eb741e4d9bf860a22c1ad8 GIT binary patch literal 15895 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 MhkLiut;D|jUqyD$lmGw# literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/__pycache__/test_pyprojecttoml_dynamic_deps.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/__pycache__/test_pyprojecttoml_dynamic_deps.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5ddf192f05a3b08ccaa5c0b6fc2d283505e05857 GIT binary patch literal 4291 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/downloads/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/downloads/__init__.py new file mode 100644 index 000000000..00a16423f --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/downloads/__init__.py @@ -0,0 +1,59 @@ +from __future__ import annotations + +import re +import time +from pathlib import Path +from urllib.error import HTTPError +from urllib.request import urlopen + +__all__ = ["DOWNLOAD_DIR", "retrieve_file", "output_file", "urls_from_file"] + + +NAME_REMOVE = ("http://", "https://", "github.com/", "/raw/") +DOWNLOAD_DIR = Path(__file__).parent + + +# ---------------------------------------------------------------------- +# Please update ./preload.py accordingly when modifying this file +# ---------------------------------------------------------------------- + + +def output_file(url: str, download_dir: Path = DOWNLOAD_DIR) -> Path: + file_name = url.strip() + for part in NAME_REMOVE: + file_name = file_name.replace(part, '').strip().strip('/:').strip() + return Path(download_dir, re.sub(r"[^\-_\.\w\d]+", "_", file_name)) + + +def retrieve_file(url: str, download_dir: Path = DOWNLOAD_DIR, wait: float = 5) -> Path: + path = output_file(url, download_dir) + if path.exists(): + print(f"Skipping {url} (already exists: {path})") + else: + download_dir.mkdir(exist_ok=True, parents=True) + print(f"Downloading {url} to {path}") + try: + download(url, path) + except HTTPError: + time.sleep(wait) # wait a few seconds and try again. + download(url, path) + return path + + +def urls_from_file(list_file: Path) -> list[str]: + """``list_file`` should be a text file where each line corresponds to a URL to + download. + """ + print(f"file: {list_file}") + content = list_file.read_text(encoding="utf-8") + return [url for url in content.splitlines() if not url.startswith("#")] + + +def download(url: str, dest: Path): + with urlopen(url) as f: + data = f.read() + + with open(dest, "wb") as f: + f.write(data) + + assert Path(dest).exists() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/downloads/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/downloads/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0d9d2ee8e061ca9d4f7fb7f0ffdd8db11978613b GIT binary patch literal 3154 zcmaJ@UvLx08Q;A>(n%*vvMn43s1aZ$RfsK!OPw%;j)M&t8$&Qn2L*DRbtg;aq*L}* z2rDvmJIoY{XHcdOxRcO&@{|rdIMat_rZ06LI-Ti@RXeqNB`-~1^5zMiq4h(j-=1`m zNtv8<-+p`hec$fw_q*SIe`#s)Be?$bdo{h^i_n*><6eAC!B2h#%6+6E4I3zn6Bsj{ zGq?ojw0wexmN$f~m=K*Y!SH0g39qAzhLrUsd>Bn4&GRu%_%&}r=8!Jxfrq#@!_-c9 z%4VAg>cJG&S~TgFm`n`&==0DG!3oq^u>$khX^qVbi4&(n0Y-H6YRj?xgU*y-710FNtxY7UM~- z`Bq2*9rhJJ*#zZ2Dx<0T9&EEg59^&7jy8M;(Ul({G{cvT%W3Z^X||pC{&&o}^ZMX#9N7 zn5pSCZFumca>1N1X`B|QNiwPt?`>#CW+I-SrfD(nn(%Lk4uTAvNCbe&w0Pb~|lp1@q_D~6zCJvHnBVrg|?`7%J@ zKB5gElu@|>EC3%rwcX2cMGd%;2yH-9!)5d#kVKgW$v+TXh+$Ob$06oa14#8C&}f1t zJQ7`~V6-io$BE`;(H;oRSU%JQA*_^d`m$N}BiaCFHzEfhVv9T5RM6F$Ex@(@-eB1P z_p@;?IqNT?8~i0y#4%~C%e<$!Mu9`d!r^x~fe_^&1&L!O`dzj$Mp#w&e5` z^P24iSn4@yl>&ox;5x2Cl$z0)WQQX=hd1xiGlcy)5lqmHL@a zV19glXd$woExf%Pd}USY+290U^l>0k8K3W74eZ&F9RGiBdQteruMx+_!uQVHIa8sl zf!%ex&jWkbuQm&tO1j1IG}sez~MPi0*MoZW1NAD;+?{91!wzvFyepcy33T`+%G4 z6u@VO8wZIUtq5dTdiUy81EAs@DOayXt+ZJ%wCIE$RijkDL8FY&qQ$gM^r)^T(@`Un z)1yg~5Z%g~In83YQKLV+FbayFF`bK&UZ+>`umDG+C9yzLJ+HypC+WGQsR8J=@P5F} z9(X<5$3UyF`E0+HH!_sXVu4N>hZf;Ti}ALvu}<3y>_!2_4(cqnp)hd`W9*9~OdN#U z8UrzlHYFtbZ=bBZUOBkz?^+f1tOs9M3+}B3_kPm99NfDS?3+EczH8swuAb_yo|Rqk zzsVz&6N}dGZhm_656RE_&;0zvU*(ZyVdOv1STcnCZO1^Xu;dp&K6AP@fbd^1+75&= za?^37ma^x7z)kQB57i9(nq<->qB3rtv-L>NN&b%;U~(#;XJa*q1-omSV(;{g%UzAd zok2gv(?Dj2k%fx@ol6MAZ*HVULI3ysaGjdCF`Fw+#5{y;iY>4V+X5?kY_Uk->~fA% z(glNc_OJyw2C0oxpr};+26yZQL&C)O;I`fa0o>sWSK9CH-hi{JbG~&w6ux);&h@)D zZVON080y^gAb;?-RvBFJy~s>D=HFVEeD}O}ycJ=tg_(4KNg!Mi?jBu}cUR@zt8&+} z&{dVYp0G%DDo`IUOKZhaD7#ho5wL@F?DF^Wr_utp5WF%)T`M literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/downloads/__pycache__/preload.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/downloads/__pycache__/preload.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7c26c89a924d708e596ca2ce7f32b017330fbaef GIT binary patch literal 824 zcmZ`$J#W-N5Z$$XAMp`{AO%UaAPP<)wty}|R3U~M z^duE6C_jOYf`*QWB9@SlC{VhfbVx{yoft&HNb8yL%zHC>^Kp9GC1@Ys@$q{~$hR`7 zt$7+8zr^4b5u`^16;?!h6uli;vE8#N5sqj?PTc4<;%2W&3A99W<0>I)-XhS%X9Hb7 zSCjtr!kNWn52uz^``#2HTznm9z|@}gZ(`@ksM#=#fDL%U`oJ;`f*HwD z1(D>Us%e%02>d^kiW$%*Oh%sTE@K809;b-TWmYjDd~wlr8QMTF4JJ#Cl#%vJnDz%U z8HS^(oaSaM6SfdDA)h4WEbY}pE8Ji>3Qp;@XC}sVajlqd0MnTQX2!tQszwhx*Xm6) z<5;XIapykZ)`&4&m3vpXY8lTxELBMxuhK20B$4Q`= zDWyNGHg%3?2ytfu(3#!6vZG&5b|-J>?$iCb`TfqdXG;f8`}u|K V$2&{=Q^EX__lW=i literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/downloads/preload.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/downloads/preload.py new file mode 100644 index 000000000..8eeb5dd75 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/downloads/preload.py @@ -0,0 +1,18 @@ +"""This file can be used to preload files needed for testing. + +For example you can use:: + + cd setuptools/tests/config + python -m downloads.preload setupcfg_examples.txt + +to make sure the `setup.cfg` examples are downloaded before starting the tests. +""" + +import sys +from pathlib import Path + +from . import retrieve_file, urls_from_file + +if __name__ == "__main__": + urls = urls_from_file(Path(sys.argv[1])) + list(map(retrieve_file, urls)) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/setupcfg_examples.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/setupcfg_examples.txt new file mode 100644 index 000000000..6aab887ff --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/setupcfg_examples.txt @@ -0,0 +1,22 @@ +# ==================================================================== +# Some popular packages that use setup.cfg (and others not so popular) +# Reference: https://hugovk.github.io/top-pypi-packages/ +# ==================================================================== +https://github.com/pypa/setuptools/raw/52c990172fec37766b3566679724aa8bf70ae06d/setup.cfg +https://github.com/pypa/wheel/raw/0acd203cd896afec7f715aa2ff5980a403459a3b/setup.cfg +https://github.com/python/importlib_metadata/raw/2f05392ca980952a6960d82b2f2d2ea10aa53239/setup.cfg +https://github.com/jaraco/skeleton/raw/d9008b5c510cd6969127a6a2ab6f832edddef296/setup.cfg +https://github.com/jaraco/zipp/raw/700d3a96390e970b6b962823bfea78b4f7e1c537/setup.cfg +https://github.com/pallets/jinja/raw/7d72eb7fefb7dce065193967f31f805180508448/setup.cfg +https://github.com/tkem/cachetools/raw/2fd87a94b8d3861d80e9e4236cd480bfdd21c90d/setup.cfg +https://github.com/aio-libs/aiohttp/raw/5e0e6b7080f2408d5f1dd544c0e1cf88378b7b10/setup.cfg +https://github.com/pallets/flask/raw/9486b6cf57bd6a8a261f67091aca8ca78eeec1e3/setup.cfg +https://github.com/pallets/click/raw/6411f425fae545f42795665af4162006b36c5e4a/setup.cfg +https://github.com/sqlalchemy/sqlalchemy/raw/533f5718904b620be8d63f2474229945d6f8ba5d/setup.cfg +https://github.com/pytest-dev/pluggy/raw/461ef63291d13589c4e21aa182cd1529257e9a0a/setup.cfg +https://github.com/pytest-dev/pytest/raw/c7be96dae487edbd2f55b561b31b68afac1dabe6/setup.cfg +https://github.com/platformdirs/platformdirs/raw/7b7852128dd6f07511b618d6edea35046bd0c6ff/setup.cfg +https://github.com/pandas-dev/pandas/raw/bc17343f934a33dc231c8c74be95d8365537c376/setup.cfg +https://github.com/django/django/raw/4e249d11a6e56ca8feb4b055b681cec457ef3a3d/setup.cfg +https://github.com/pyscaffold/pyscaffold/raw/de7aa5dc059fbd04307419c667cc4961bc9df4b8/setup.cfg +https://github.com/pypa/virtualenv/raw/f92eda6e3da26a4d28c2663ffb85c4960bdb990c/setup.cfg diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_apply_pyprojecttoml.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_apply_pyprojecttoml.py new file mode 100644 index 000000000..489fd98e2 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_apply_pyprojecttoml.py @@ -0,0 +1,772 @@ +"""Make sure that applying the configuration from pyproject.toml is equivalent to +applying a similar configuration from setup.cfg + +To run these tests offline, please have a look on ``./downloads/preload.py`` +""" + +from __future__ import annotations + +import io +import re +import tarfile +from inspect import cleandoc +from pathlib import Path +from unittest.mock import Mock + +import pytest +from ini2toml.api import LiteTranslator +from packaging.metadata import Metadata + +import setuptools # noqa: F401 # ensure monkey patch to metadata +from setuptools._static import is_static +from setuptools.command.egg_info import write_requirements +from setuptools.config import expand, pyprojecttoml, setupcfg +from setuptools.config._apply_pyprojecttoml import _MissingDynamic, _some_attrgetter +from setuptools.dist import Distribution +from setuptools.errors import InvalidConfigError, RemovedConfigError +from setuptools.warnings import InformationOnly, SetuptoolsDeprecationWarning + +from .downloads import retrieve_file, urls_from_file + +HERE = Path(__file__).parent +EXAMPLES_FILE = "setupcfg_examples.txt" + + +def makedist(path, **attrs): + return Distribution({"src_root": path, **attrs}) + + +def _mock_expand_patterns(patterns, *_, **__): + """ + Allow comparing the given patterns for 2 dist objects. + We need to strip special chars to avoid errors when validating. + """ + return [re.sub("[^a-z0-9]+", "", p, flags=re.I) or "empty" for p in patterns] + + +@pytest.mark.parametrize("url", urls_from_file(HERE / EXAMPLES_FILE)) +@pytest.mark.filterwarnings("ignore") +@pytest.mark.uses_network +def test_apply_pyproject_equivalent_to_setupcfg(url, monkeypatch, tmp_path): + monkeypatch.setattr(expand, "read_attr", Mock(return_value="0.0.1")) + monkeypatch.setattr( + Distribution, "_expand_patterns", Mock(side_effect=_mock_expand_patterns) + ) + setupcfg_example = retrieve_file(url) + pyproject_example = Path(tmp_path, "pyproject.toml") + setupcfg_text = setupcfg_example.read_text(encoding="utf-8") + toml_config = LiteTranslator().translate(setupcfg_text, "setup.cfg") + pyproject_example.write_text(toml_config, encoding="utf-8") + + dist_toml = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject_example) + dist_cfg = setupcfg.apply_configuration(makedist(tmp_path), setupcfg_example) + + pkg_info_toml = core_metadata(dist_toml) + pkg_info_cfg = core_metadata(dist_cfg) + assert pkg_info_toml == pkg_info_cfg + + if any(getattr(d, "license_files", None) for d in (dist_toml, dist_cfg)): + assert set(dist_toml.license_files) == set(dist_cfg.license_files) + + if any(getattr(d, "entry_points", None) for d in (dist_toml, dist_cfg)): + print(dist_cfg.entry_points) + ep_toml = { + (k, *sorted(i.replace(" ", "") for i in v)) + for k, v in dist_toml.entry_points.items() + } + ep_cfg = { + (k, *sorted(i.replace(" ", "") for i in v)) + for k, v in dist_cfg.entry_points.items() + } + assert ep_toml == ep_cfg + + if any(getattr(d, "package_data", None) for d in (dist_toml, dist_cfg)): + pkg_data_toml = {(k, *sorted(v)) for k, v in dist_toml.package_data.items()} + pkg_data_cfg = {(k, *sorted(v)) for k, v in dist_cfg.package_data.items()} + assert pkg_data_toml == pkg_data_cfg + + if any(getattr(d, "data_files", None) for d in (dist_toml, dist_cfg)): + data_files_toml = {(k, *sorted(v)) for k, v in dist_toml.data_files} + data_files_cfg = {(k, *sorted(v)) for k, v in dist_cfg.data_files} + assert data_files_toml == data_files_cfg + + assert set(dist_toml.install_requires) == set(dist_cfg.install_requires) + if any(getattr(d, "extras_require", None) for d in (dist_toml, dist_cfg)): + extra_req_toml = {(k, *sorted(v)) for k, v in dist_toml.extras_require.items()} + extra_req_cfg = {(k, *sorted(v)) for k, v in dist_cfg.extras_require.items()} + assert extra_req_toml == extra_req_cfg + + +PEP621_EXAMPLE = """\ +[project] +name = "spam" +version = "2020.0.0" +description = "Lovely Spam! Wonderful Spam!" +readme = "README.rst" +requires-python = ">=3.8" +license-files = ["LICENSE.txt"] # Updated to be PEP 639 compliant +keywords = ["egg", "bacon", "sausage", "tomatoes", "Lobster Thermidor"] +authors = [ + {email = "hi@pradyunsg.me"}, + {name = "Tzu-Ping Chung"} +] +maintainers = [ + {name = "Brett Cannon", email = "brett@python.org"}, + {name = "John X. Ãørçeč", email = "john@utf8.org"}, + {name = "Γαμα קּ 東", email = "gama@utf8.org"}, +] +classifiers = [ + "Development Status :: 4 - Beta", + "Programming Language :: Python" +] + +dependencies = [ + "httpx", + "gidgethub[httpx]>4.0.0", + "django>2.1; os_name != 'nt'", + "django>2.0; os_name == 'nt'" +] + +[project.optional-dependencies] +test = [ + "pytest < 5.0.0", + "pytest-cov[all]" +] + +[project.urls] +homepage = "http://example.com" +documentation = "http://readthedocs.org" +repository = "http://github.com" +changelog = "http://github.com/me/spam/blob/master/CHANGELOG.md" + +[project.scripts] +spam-cli = "spam:main_cli" + +[project.gui-scripts] +spam-gui = "spam:main_gui" + +[project.entry-points."spam.magical"] +tomatoes = "spam:main_tomatoes" +""" + +PEP621_INTERNATIONAL_EMAIL_EXAMPLE = """\ +[project] +name = "spam" +version = "2020.0.0" +authors = [ + {email = "hi@pradyunsg.me"}, + {name = "Tzu-Ping Chung"} +] +maintainers = [ + {name = "Степан Бандера", email = "криївка@оун-упа.укр"}, +] +""" + +PEP621_EXAMPLE_SCRIPT = """ +def main_cli(): pass +def main_gui(): pass +def main_tomatoes(): pass +""" + +PEP639_LICENSE_TEXT = """\ +[project] +name = "spam" +version = "2020.0.0" +authors = [ + {email = "hi@pradyunsg.me"}, + {name = "Tzu-Ping Chung"} +] +license = {text = "MIT"} +""" + +PEP639_LICENSE_EXPRESSION = """\ +[project] +name = "spam" +version = "2020.0.0" +authors = [ + {email = "hi@pradyunsg.me"}, + {name = "Tzu-Ping Chung"} +] +license = "mit or apache-2.0" # should be normalized in metadata +classifiers = [ + "Development Status :: 5 - Production/Stable", + "Programming Language :: Python", +] +""" + + +def _pep621_example_project( + tmp_path, + readme="README.rst", + pyproject_text=PEP621_EXAMPLE, +): + pyproject = tmp_path / "pyproject.toml" + text = pyproject_text + replacements = {'readme = "README.rst"': f'readme = "{readme}"'} + for orig, subst in replacements.items(): + text = text.replace(orig, subst) + pyproject.write_text(text, encoding="utf-8") + + (tmp_path / readme).write_text("hello world", encoding="utf-8") + (tmp_path / "LICENSE.txt").write_text("--- LICENSE stub ---", encoding="utf-8") + (tmp_path / "spam.py").write_text(PEP621_EXAMPLE_SCRIPT, encoding="utf-8") + return pyproject + + +def test_pep621_example(tmp_path): + """Make sure the example in PEP 621 works""" + pyproject = _pep621_example_project(tmp_path) + dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + assert set(dist.metadata.license_files) == {"LICENSE.txt"} + + +@pytest.mark.parametrize( + ("readme", "ctype"), + [ + ("Readme.txt", "text/plain"), + ("readme.md", "text/markdown"), + ("text.rst", "text/x-rst"), + ], +) +def test_readme_content_type(tmp_path, readme, ctype): + pyproject = _pep621_example_project(tmp_path, readme) + dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + assert dist.metadata.long_description_content_type == ctype + + +def test_undefined_content_type(tmp_path): + pyproject = _pep621_example_project(tmp_path, "README.tex") + with pytest.raises(ValueError, match="Undefined content type for README.tex"): + pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + + +def test_no_explicit_content_type_for_missing_extension(tmp_path): + pyproject = _pep621_example_project(tmp_path, "README") + dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + assert dist.metadata.long_description_content_type is None + + +@pytest.mark.parametrize( + ("pyproject_text", "expected_maintainers_meta_value"), + ( + pytest.param( + PEP621_EXAMPLE, + ( + 'Brett Cannon , "John X. Ãørçeč" , ' + 'Γαμα קּ 東 ' + ), + id='non-international-emails', + ), + pytest.param( + PEP621_INTERNATIONAL_EMAIL_EXAMPLE, + 'Степан Бандера <криївка@оун-упа.укр>', + marks=pytest.mark.xfail( + reason="CPython's `email.headerregistry.Address` only supports " + 'RFC 5322, as of Nov 10, 2022 and latest Python 3.11.0', + strict=True, + ), + id='international-email', + ), + ), +) +def test_utf8_maintainer_in_metadata( # issue-3663 + expected_maintainers_meta_value, + pyproject_text, + tmp_path, +): + pyproject = _pep621_example_project( + tmp_path, + "README", + pyproject_text=pyproject_text, + ) + dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + assert dist.metadata.maintainer_email == expected_maintainers_meta_value + pkg_file = tmp_path / "PKG-FILE" + with open(pkg_file, "w", encoding="utf-8") as fh: + dist.metadata.write_pkg_file(fh) + content = pkg_file.read_text(encoding="utf-8") + assert f"Maintainer-email: {expected_maintainers_meta_value}" in content + + +@pytest.mark.parametrize( + ( + 'pyproject_text', + 'license', + 'license_expression', + 'content_str', + 'not_content_str', + ), + ( + pytest.param( + PEP639_LICENSE_TEXT, + 'MIT', + None, + 'License: MIT', + 'License-Expression: ', + id='license-text', + marks=[ + pytest.mark.filterwarnings( + "ignore:.project.license. as a TOML table is deprecated", + ) + ], + ), + pytest.param( + PEP639_LICENSE_EXPRESSION, + None, + 'MIT OR Apache-2.0', + 'License-Expression: MIT OR Apache-2.0', + 'License: ', + id='license-expression', + ), + ), +) +def test_license_in_metadata( + license, + license_expression, + content_str, + not_content_str, + pyproject_text, + tmp_path, +): + pyproject = _pep621_example_project( + tmp_path, + "README", + pyproject_text=pyproject_text, + ) + dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + assert dist.metadata.license == license + assert dist.metadata.license_expression == license_expression + pkg_file = tmp_path / "PKG-FILE" + with open(pkg_file, "w", encoding="utf-8") as fh: + dist.metadata.write_pkg_file(fh) + content = pkg_file.read_text(encoding="utf-8") + assert "Metadata-Version: 2.4" in content + assert content_str in content + assert not_content_str not in content + + +def test_license_classifier_with_license_expression(tmp_path): + text = PEP639_LICENSE_EXPRESSION.rsplit("\n", 2)[0] + pyproject = _pep621_example_project( + tmp_path, + "README", + f"{text}\n \"License :: OSI Approved :: MIT License\"\n]", + ) + msg = "License classifiers have been superseded by license expressions" + with pytest.raises(InvalidConfigError, match=msg) as exc: + pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + + assert "License :: OSI Approved :: MIT License" in str(exc.value) + + +def test_license_classifier_without_license_expression(tmp_path): + text = """\ + [project] + name = "spam" + version = "2020.0.0" + license = {text = "mit or apache-2.0"} + classifiers = ["License :: OSI Approved :: MIT License"] + """ + pyproject = _pep621_example_project(tmp_path, "README", text) + + msg1 = "License classifiers are deprecated(?:.|\n)*MIT License" + msg2 = ".project.license. as a TOML table is deprecated" + with ( + pytest.warns(SetuptoolsDeprecationWarning, match=msg1), + pytest.warns(SetuptoolsDeprecationWarning, match=msg2), + ): + dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + + # Check license classifier is still included + assert dist.metadata.get_classifiers() == ["License :: OSI Approved :: MIT License"] + + +class TestLicenseFiles: + def base_pyproject( + self, + tmp_path, + additional_text="", + license_toml='license = {file = "LICENSE.txt"}\n', + ): + text = PEP639_LICENSE_EXPRESSION + + # Sanity-check + assert 'license = "mit or apache-2.0"' in text + assert 'license-files' not in text + assert "[tool.setuptools]" not in text + + text = re.sub( + r"(license = .*)\n", + license_toml, + text, + count=1, + ) + assert license_toml in text # sanity check + text = f"{text}\n{additional_text}\n" + pyproject = _pep621_example_project(tmp_path, "README", pyproject_text=text) + return pyproject + + def base_pyproject_license_pep639(self, tmp_path, additional_text=""): + return self.base_pyproject( + tmp_path, + additional_text=additional_text, + license_toml='license = "licenseref-Proprietary"' + '\nlicense-files = ["_FILE*"]\n', + ) + + def test_both_license_and_license_files_defined(self, tmp_path): + setuptools_config = '[tool.setuptools]\nlicense-files = ["_FILE*"]' + pyproject = self.base_pyproject(tmp_path, setuptools_config) + + (tmp_path / "_FILE.txt").touch() + (tmp_path / "_FILE.rst").touch() + + # Would normally match the `license_files` patterns, but we want to exclude it + # by being explicit. On the other hand, contents should be added to `license` + license = tmp_path / "LICENSE.txt" + license.write_text("LicenseRef-Proprietary\n", encoding="utf-8") + + msg1 = "'tool.setuptools.license-files' is deprecated in favor of 'project.license-files'" + msg2 = ".project.license. as a TOML table is deprecated" + with ( + pytest.warns(SetuptoolsDeprecationWarning, match=msg1), + pytest.warns(SetuptoolsDeprecationWarning, match=msg2), + ): + dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + assert set(dist.metadata.license_files) == {"_FILE.rst", "_FILE.txt"} + assert dist.metadata.license == "LicenseRef-Proprietary\n" + + def test_both_license_and_license_files_defined_pep639(self, tmp_path): + # Set license and license-files + pyproject = self.base_pyproject_license_pep639(tmp_path) + + (tmp_path / "_FILE.txt").touch() + (tmp_path / "_FILE.rst").touch() + + msg = "Normalizing.*LicenseRef" + with pytest.warns(InformationOnly, match=msg): + dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + + assert set(dist.metadata.license_files) == {"_FILE.rst", "_FILE.txt"} + assert dist.metadata.license is None + assert dist.metadata.license_expression == "LicenseRef-Proprietary" + + def test_license_files_defined_twice(self, tmp_path): + # Set project.license-files and tools.setuptools.license-files + setuptools_config = '[tool.setuptools]\nlicense-files = ["_FILE*"]' + pyproject = self.base_pyproject_license_pep639(tmp_path, setuptools_config) + + msg = "'project.license-files' is defined already. Remove 'tool.setuptools.license-files'" + with pytest.raises(InvalidConfigError, match=msg): + pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + + def test_default_patterns(self, tmp_path): + setuptools_config = '[tool.setuptools]\nzip-safe = false' + # ^ used just to trigger section validation + pyproject = self.base_pyproject(tmp_path, setuptools_config, license_toml="") + + license_files = "LICENCE-a.html COPYING-abc.txt AUTHORS-xyz NOTICE,def".split() + + for fname in license_files: + (tmp_path / fname).write_text(f"{fname}\n", encoding="utf-8") + + dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + + assert (tmp_path / "LICENSE.txt").exists() # from base example + assert set(dist.metadata.license_files) == {*license_files, "LICENSE.txt"} + + def test_missing_patterns(self, tmp_path): + pyproject = self.base_pyproject_license_pep639(tmp_path) + assert list(tmp_path.glob("_FILE*")) == [] # sanity check + + msg1 = "Cannot find any files for the given pattern.*" + msg2 = "Normalizing 'licenseref-Proprietary' to 'LicenseRef-Proprietary'" + with ( + pytest.warns(SetuptoolsDeprecationWarning, match=msg1), + pytest.warns(InformationOnly, match=msg2), + ): + pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + + def test_deprecated_file_expands_to_text(self, tmp_path): + """Make sure the old example with ``license = {text = ...}`` works""" + + assert 'license-files = ["LICENSE.txt"]' in PEP621_EXAMPLE # sanity check + text = PEP621_EXAMPLE.replace( + 'license-files = ["LICENSE.txt"]', + 'license = {file = "LICENSE.txt"}', + ) + pyproject = _pep621_example_project(tmp_path, pyproject_text=text) + + msg = ".project.license. as a TOML table is deprecated" + with pytest.warns(SetuptoolsDeprecationWarning, match=msg): + dist = pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + + assert dist.metadata.license == "--- LICENSE stub ---" + assert set(dist.metadata.license_files) == {"LICENSE.txt"} # auto-filled + + +class TestPyModules: + # https://github.com/pypa/setuptools/issues/4316 + + def dist(self, name): + toml_config = f""" + [project] + name = "test" + version = "42.0" + [tool.setuptools] + py-modules = [{name!r}] + """ + pyproject = Path("pyproject.toml") + pyproject.write_text(cleandoc(toml_config), encoding="utf-8") + return pyprojecttoml.apply_configuration(Distribution({}), pyproject) + + @pytest.mark.parametrize("module", ["pip-run", "abc-d.λ-xyz-e"]) + def test_valid_module_name(self, tmp_path, monkeypatch, module): + monkeypatch.chdir(tmp_path) + assert module in self.dist(module).py_modules + + @pytest.mark.parametrize("module", ["pip run", "-pip-run", "pip-run-stubs"]) + def test_invalid_module_name(self, tmp_path, monkeypatch, module): + monkeypatch.chdir(tmp_path) + with pytest.raises(ValueError, match="py-modules"): + self.dist(module).py_modules + + +class TestExtModules: + def test_pyproject_sets_attribute(self, tmp_path, monkeypatch): + monkeypatch.chdir(tmp_path) + pyproject = Path("pyproject.toml") + toml_config = """ + [project] + name = "test" + version = "42.0" + [tool.setuptools] + ext-modules = [ + {name = "my.ext", sources = ["hello.c", "world.c"]} + ] + """ + pyproject.write_text(cleandoc(toml_config), encoding="utf-8") + with pytest.warns(pyprojecttoml._ExperimentalConfiguration): + dist = pyprojecttoml.apply_configuration(Distribution({}), pyproject) + assert len(dist.ext_modules) == 1 + assert dist.ext_modules[0].name == "my.ext" + assert set(dist.ext_modules[0].sources) == {"hello.c", "world.c"} + + +class TestDeprecatedFields: + def test_namespace_packages(self, tmp_path): + pyproject = tmp_path / "pyproject.toml" + config = """ + [project] + name = "myproj" + version = "42" + [tool.setuptools] + namespace-packages = ["myproj.pkg"] + """ + pyproject.write_text(cleandoc(config), encoding="utf-8") + with pytest.raises(RemovedConfigError, match="namespace-packages"): + pyprojecttoml.apply_configuration(makedist(tmp_path), pyproject) + + +class TestPresetField: + def pyproject(self, tmp_path, dynamic, extra_content=""): + content = f"[project]\nname = 'proj'\ndynamic = {dynamic!r}\n" + if "version" not in dynamic: + content += "version = '42'\n" + file = tmp_path / "pyproject.toml" + file.write_text(content + extra_content, encoding="utf-8") + return file + + @pytest.mark.parametrize( + ("attr", "field", "value"), + [ + ("license_expression", "license", "MIT"), + pytest.param( + *("license", "license", "Not SPDX"), + marks=[pytest.mark.filterwarnings("ignore:.*license. overwritten")], + ), + ("classifiers", "classifiers", ["Private :: Classifier"]), + ("entry_points", "scripts", {"console_scripts": ["foobar=foobar:main"]}), + ("entry_points", "gui-scripts", {"gui_scripts": ["bazquux=bazquux:main"]}), + pytest.param( + *("install_requires", "dependencies", ["six"]), + marks=[ + pytest.mark.filterwarnings("ignore:.*install_requires. overwritten") + ], + ), + ], + ) + def test_not_listed_in_dynamic(self, tmp_path, attr, field, value): + """Setuptools cannot set a field if not listed in ``dynamic``""" + pyproject = self.pyproject(tmp_path, []) + dist = makedist(tmp_path, **{attr: value}) + msg = re.compile(f"defined outside of `pyproject.toml`:.*{field}", re.S) + with pytest.warns(_MissingDynamic, match=msg): + dist = pyprojecttoml.apply_configuration(dist, pyproject) + + dist_value = _some_attrgetter(f"metadata.{attr}", attr)(dist) + assert not dist_value + + @pytest.mark.parametrize( + ("attr", "field", "value"), + [ + ("license_expression", "license", "MIT"), + ("install_requires", "dependencies", []), + ("extras_require", "optional-dependencies", {}), + ("install_requires", "dependencies", ["six"]), + ("classifiers", "classifiers", ["Private :: Classifier"]), + ], + ) + def test_listed_in_dynamic(self, tmp_path, attr, field, value): + pyproject = self.pyproject(tmp_path, [field]) + dist = makedist(tmp_path, **{attr: value}) + dist = pyprojecttoml.apply_configuration(dist, pyproject) + dist_value = _some_attrgetter(f"metadata.{attr}", attr)(dist) + assert dist_value == value + + def test_license_files_exempt_from_dynamic(self, monkeypatch, tmp_path): + """ + license-file is currently not considered in the context of dynamic. + As per 2025-02-19, https://packaging.python.org/en/latest/specifications/pyproject-toml/#license-files + allows setuptools to fill-in `license-files` the way it sees fit: + + > If the license-files key is not defined, tools can decide how to handle license files. + > For example they can choose not to include any files or use their own + > logic to discover the appropriate files in the distribution. + + Using license_files from setup.py to fill-in the value is in accordance + with this rule. + """ + monkeypatch.chdir(tmp_path) + pyproject = self.pyproject(tmp_path, []) + dist = makedist(tmp_path, license_files=["LIC*"]) + (tmp_path / "LIC1").write_text("42", encoding="utf-8") + dist = pyprojecttoml.apply_configuration(dist, pyproject) + assert dist.metadata.license_files == ["LIC1"] + + def test_warning_overwritten_dependencies(self, tmp_path): + src = "[project]\nname='pkg'\nversion='0.1'\ndependencies=['click']\n" + pyproject = tmp_path / "pyproject.toml" + pyproject.write_text(src, encoding="utf-8") + dist = makedist(tmp_path, install_requires=["wheel"]) + with pytest.warns(match="`install_requires` overwritten"): + dist = pyprojecttoml.apply_configuration(dist, pyproject) + assert "wheel" not in dist.install_requires + + def test_optional_dependencies_dont_remove_env_markers(self, tmp_path): + """ + Internally setuptools converts dependencies with markers to "extras". + If ``install_requires`` is given by ``setup.py``, we have to ensure that + applying ``optional-dependencies`` does not overwrite the mandatory + dependencies with markers (see #3204). + """ + # If setuptools replace its internal mechanism that uses `requires.txt` + # this test has to be rewritten to adapt accordingly + extra = "\n[project.optional-dependencies]\nfoo = ['bar>1']\n" + pyproject = self.pyproject(tmp_path, ["dependencies"], extra) + install_req = ['importlib-resources (>=3.0.0) ; python_version < "3.7"'] + dist = makedist(tmp_path, install_requires=install_req) + dist = pyprojecttoml.apply_configuration(dist, pyproject) + assert "foo" in dist.extras_require + egg_info = dist.get_command_obj("egg_info") + write_requirements(egg_info, tmp_path, tmp_path / "requires.txt") + reqs = (tmp_path / "requires.txt").read_text(encoding="utf-8") + assert "importlib-resources" in reqs + assert "bar" in reqs + assert ':python_version < "3.7"' in reqs + + @pytest.mark.parametrize( + ("field", "group"), + [("scripts", "console_scripts"), ("gui-scripts", "gui_scripts")], + ) + @pytest.mark.filterwarnings("error") + def test_scripts_dont_require_dynamic_entry_points(self, tmp_path, field, group): + # Issue 3862 + pyproject = self.pyproject(tmp_path, [field]) + dist = makedist(tmp_path, entry_points={group: ["foobar=foobar:main"]}) + dist = pyprojecttoml.apply_configuration(dist, pyproject) + assert group in dist.entry_points + + +class TestMeta: + def test_example_file_in_sdist(self, setuptools_sdist): + """Meta test to ensure tests can run from sdist""" + with tarfile.open(setuptools_sdist) as tar: + assert any(name.endswith(EXAMPLES_FILE) for name in tar.getnames()) + + +class TestInteropCommandLineParsing: + def test_version(self, tmp_path, monkeypatch, capsys): + # See pypa/setuptools#4047 + # This test can be removed once the CLI interface of setup.py is removed + monkeypatch.chdir(tmp_path) + toml_config = """ + [project] + name = "test" + version = "42.0" + """ + pyproject = Path(tmp_path, "pyproject.toml") + pyproject.write_text(cleandoc(toml_config), encoding="utf-8") + opts = {"script_args": ["--version"]} + dist = pyprojecttoml.apply_configuration(Distribution(opts), pyproject) + dist.parse_command_line() # <-- there should be no exception here. + captured = capsys.readouterr() + assert "42.0" in captured.out + + +class TestStaticConfig: + def test_mark_static_fields(self, tmp_path, monkeypatch): + monkeypatch.chdir(tmp_path) + toml_config = """ + [project] + name = "test" + version = "42.0" + dependencies = ["hello"] + keywords = ["world"] + classifiers = ["private :: hello world"] + [tool.setuptools] + obsoletes = ["abcd"] + provides = ["abcd"] + platforms = ["abcd"] + """ + pyproject = Path(tmp_path, "pyproject.toml") + pyproject.write_text(cleandoc(toml_config), encoding="utf-8") + dist = pyprojecttoml.apply_configuration(Distribution({}), pyproject) + assert is_static(dist.install_requires) + assert is_static(dist.metadata.keywords) + assert is_static(dist.metadata.classifiers) + assert is_static(dist.metadata.obsoletes) + assert is_static(dist.metadata.provides) + assert is_static(dist.metadata.platforms) + + +# --- Auxiliary Functions --- + + +def core_metadata(dist) -> str: + with io.StringIO() as buffer: + dist.metadata.write_pkg_file(buffer) + pkg_file_txt = buffer.getvalue() + + # Make sure core metadata is valid + Metadata.from_email(pkg_file_txt, validate=True) # can raise exceptions + + skip_prefixes: tuple[str, ...] = () + skip_lines = set() + # ---- DIFF NORMALISATION ---- + # PEP 621 is very particular about author/maintainer metadata conversion, so skip + skip_prefixes += ("Author:", "Author-email:", "Maintainer:", "Maintainer-email:") + # May be redundant with Home-page + skip_prefixes += ("Project-URL: Homepage,", "Home-page:") + # May be missing in original (relying on default) but backfilled in the TOML + skip_prefixes += ("Description-Content-Type:",) + # Remove empty lines + skip_lines.add("") + + result = [] + for line in pkg_file_txt.splitlines(): + if line.startswith(skip_prefixes) or line in skip_lines: + continue + result.append(line + "\n") + + return "".join(result) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_expand.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_expand.py new file mode 100644 index 000000000..c5710ec63 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_expand.py @@ -0,0 +1,247 @@ +import os +import sys +from pathlib import Path + +import pytest + +from setuptools._static import is_static +from setuptools.config import expand +from setuptools.discovery import find_package_path + +from distutils.errors import DistutilsOptionError + + +def write_files(files, root_dir): + for file, content in files.items(): + path = root_dir / file + path.parent.mkdir(exist_ok=True, parents=True) + path.write_text(content, encoding="utf-8") + + +def test_glob_relative(tmp_path, monkeypatch): + files = { + "dir1/dir2/dir3/file1.txt", + "dir1/dir2/file2.txt", + "dir1/file3.txt", + "a.ini", + "b.ini", + "dir1/c.ini", + "dir1/dir2/a.ini", + } + + write_files({k: "" for k in files}, tmp_path) + patterns = ["**/*.txt", "[ab].*", "**/[ac].ini"] + monkeypatch.chdir(tmp_path) + assert set(expand.glob_relative(patterns)) == files + # Make sure the same APIs work outside cwd + assert set(expand.glob_relative(patterns, tmp_path)) == files + + +def test_read_files(tmp_path, monkeypatch): + dir_ = tmp_path / "dir_" + (tmp_path / "_dir").mkdir(exist_ok=True) + (tmp_path / "a.txt").touch() + files = {"a.txt": "a", "dir1/b.txt": "b", "dir1/dir2/c.txt": "c"} + write_files(files, dir_) + + secrets = Path(str(dir_) + "secrets") + secrets.mkdir(exist_ok=True) + write_files({"secrets.txt": "secret keys"}, secrets) + + with monkeypatch.context() as m: + m.chdir(dir_) + assert expand.read_files(list(files)) == "a\nb\nc" + + cannot_access_msg = r"Cannot access '.*\.\..a\.txt'" + with pytest.raises(DistutilsOptionError, match=cannot_access_msg): + expand.read_files(["../a.txt"]) + + cannot_access_secrets_msg = r"Cannot access '.*secrets\.txt'" + with pytest.raises(DistutilsOptionError, match=cannot_access_secrets_msg): + expand.read_files(["../dir_secrets/secrets.txt"]) + + # Make sure the same APIs work outside cwd + assert expand.read_files(list(files), dir_) == "a\nb\nc" + with pytest.raises(DistutilsOptionError, match=cannot_access_msg): + expand.read_files(["../a.txt"], dir_) + + +class TestReadAttr: + @pytest.mark.parametrize( + "example", + [ + # No cookie means UTF-8: + b"__version__ = '\xc3\xa9'\nraise SystemExit(1)\n", + # If a cookie is present, honor it: + b"# -*- coding: utf-8 -*-\n__version__ = '\xc3\xa9'\nraise SystemExit(1)\n", + b"# -*- coding: latin1 -*-\n__version__ = '\xe9'\nraise SystemExit(1)\n", + ], + ) + def test_read_attr_encoding_cookie(self, example, tmp_path): + (tmp_path / "mod.py").write_bytes(example) + assert expand.read_attr('mod.__version__', root_dir=tmp_path) == 'é' + + def test_read_attr(self, tmp_path, monkeypatch): + files = { + "pkg/__init__.py": "", + "pkg/sub/__init__.py": "VERSION = '0.1.1'", + "pkg/sub/mod.py": ( + "VALUES = {'a': 0, 'b': {42}, 'c': (0, 1, 1)}\nraise SystemExit(1)" + ), + } + write_files(files, tmp_path) + + with monkeypatch.context() as m: + m.chdir(tmp_path) + # Make sure it can read the attr statically without evaluating the module + version = expand.read_attr('pkg.sub.VERSION') + values = expand.read_attr('lib.mod.VALUES', {'lib': 'pkg/sub'}) + + assert version == '0.1.1' + assert is_static(values) + + assert values['a'] == 0 + assert values['b'] == {42} + assert is_static(values) + + # Make sure the same APIs work outside cwd + assert expand.read_attr('pkg.sub.VERSION', root_dir=tmp_path) == '0.1.1' + values = expand.read_attr('lib.mod.VALUES', {'lib': 'pkg/sub'}, tmp_path) + assert values['c'] == (0, 1, 1) + + @pytest.mark.parametrize( + "example", + [ + "VERSION: str\nVERSION = '0.1.1'\nraise SystemExit(1)\n", + "VERSION: str = '0.1.1'\nraise SystemExit(1)\n", + ], + ) + def test_read_annotated_attr(self, tmp_path, example): + files = { + "pkg/__init__.py": "", + "pkg/sub/__init__.py": example, + } + write_files(files, tmp_path) + # Make sure this attribute can be read statically + version = expand.read_attr('pkg.sub.VERSION', root_dir=tmp_path) + assert version == '0.1.1' + assert is_static(version) + + @pytest.mark.parametrize( + "example", + [ + "VERSION = (lambda: '0.1.1')()\n", + "def fn(): return '0.1.1'\nVERSION = fn()\n", + "VERSION: str = (lambda: '0.1.1')()\n", + ], + ) + def test_read_dynamic_attr(self, tmp_path, monkeypatch, example): + files = { + "pkg/__init__.py": "", + "pkg/sub/__init__.py": example, + } + write_files(files, tmp_path) + monkeypatch.chdir(tmp_path) + version = expand.read_attr('pkg.sub.VERSION') + assert version == '0.1.1' + assert not is_static(version) + + def test_import_order(self, tmp_path): + """ + Sometimes the import machinery will import the parent package of a nested + module, which triggers side-effects and might create problems (see issue #3176) + + ``read_attr`` should bypass these limitations by resolving modules statically + (via ast.literal_eval). + """ + files = { + "src/pkg/__init__.py": "from .main import func\nfrom .about import version", + "src/pkg/main.py": "import super_complicated_dep\ndef func(): return 42", + "src/pkg/about.py": "version = '42'", + } + write_files(files, tmp_path) + attr_desc = "pkg.about.version" + package_dir = {"": "src"} + # `import super_complicated_dep` should not run, otherwise the build fails + assert expand.read_attr(attr_desc, package_dir, tmp_path) == "42" + + +@pytest.mark.parametrize( + ("package_dir", "file", "module", "return_value"), + [ + ({"": "src"}, "src/pkg/main.py", "pkg.main", 42), + ({"pkg": "lib"}, "lib/main.py", "pkg.main", 13), + ({}, "single_module.py", "single_module", 70), + ({}, "flat_layout/pkg.py", "flat_layout.pkg", 836), + ], +) +def test_resolve_class(monkeypatch, tmp_path, package_dir, file, module, return_value): + monkeypatch.setattr(sys, "modules", {}) # reproducibility + files = {file: f"class Custom:\n def testing(self): return {return_value}"} + write_files(files, tmp_path) + cls = expand.resolve_class(f"{module}.Custom", package_dir, tmp_path) + assert cls().testing() == return_value + + +@pytest.mark.parametrize( + ("args", "pkgs"), + [ + ({"where": ["."], "namespaces": False}, {"pkg", "other"}), + ({"where": [".", "dir1"], "namespaces": False}, {"pkg", "other", "dir2"}), + ({"namespaces": True}, {"pkg", "other", "dir1", "dir1.dir2"}), + ({}, {"pkg", "other", "dir1", "dir1.dir2"}), # default value for `namespaces` + ], +) +def test_find_packages(tmp_path, args, pkgs): + files = { + "pkg/__init__.py", + "other/__init__.py", + "dir1/dir2/__init__.py", + } + write_files({k: "" for k in files}, tmp_path) + + package_dir = {} + kwargs = {"root_dir": tmp_path, "fill_package_dir": package_dir, **args} + where = kwargs.get("where", ["."]) + assert set(expand.find_packages(**kwargs)) == pkgs + for pkg in pkgs: + pkg_path = find_package_path(pkg, package_dir, tmp_path) + assert os.path.exists(pkg_path) + + # Make sure the same APIs work outside cwd + where = [ + str((tmp_path / p).resolve()).replace(os.sep, "/") # ensure posix-style paths + for p in args.pop("where", ["."]) + ] + + assert set(expand.find_packages(where=where, **args)) == pkgs + + +@pytest.mark.parametrize( + ("files", "where", "expected_package_dir"), + [ + (["pkg1/__init__.py", "pkg1/other.py"], ["."], {}), + (["pkg1/__init__.py", "pkg2/__init__.py"], ["."], {}), + (["src/pkg1/__init__.py", "src/pkg1/other.py"], ["src"], {"": "src"}), + (["src/pkg1/__init__.py", "src/pkg2/__init__.py"], ["src"], {"": "src"}), + ( + ["src1/pkg1/__init__.py", "src2/pkg2/__init__.py"], + ["src1", "src2"], + {"pkg1": "src1/pkg1", "pkg2": "src2/pkg2"}, + ), + ( + ["src/pkg1/__init__.py", "pkg2/__init__.py"], + ["src", "."], + {"pkg1": "src/pkg1"}, + ), + ], +) +def test_fill_package_dir(tmp_path, files, where, expected_package_dir): + write_files({k: "" for k in files}, tmp_path) + pkg_dir = {} + kwargs = {"root_dir": tmp_path, "fill_package_dir": pkg_dir, "namespaces": False} + pkgs = expand.find_packages(where=where, **kwargs) + assert set(pkg_dir.items()) == set(expected_package_dir.items()) + for pkg in pkgs: + pkg_path = find_package_path(pkg, pkg_dir, tmp_path) + assert os.path.exists(pkg_path) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_pyprojecttoml.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_pyprojecttoml.py new file mode 100644 index 000000000..db40fcd23 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_pyprojecttoml.py @@ -0,0 +1,396 @@ +import re +from configparser import ConfigParser +from inspect import cleandoc + +import jaraco.path +import pytest +import tomli_w +from path import Path + +import setuptools # noqa: F401 # force distutils.core to be patched +from setuptools.config.pyprojecttoml import ( + _ToolsTypoInMetadata, + apply_configuration, + expand_configuration, + read_configuration, + validate, +) +from setuptools.dist import Distribution +from setuptools.errors import OptionError + +import distutils.core + +EXAMPLE = """ +[project] +name = "myproj" +keywords = ["some", "key", "words"] +dynamic = ["version", "readme"] +requires-python = ">=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*" +dependencies = [ + 'importlib-metadata>=0.12;python_version<"3.8"', + 'importlib-resources>=1.0;python_version<"3.7"', + 'pathlib2>=2.3.3,<3;python_version < "3.4" and sys.platform != "win32"', +] + +[project.optional-dependencies] +docs = [ + "sphinx>=3", + "sphinx-argparse>=0.2.5", + "sphinx-rtd-theme>=0.4.3", +] +testing = [ + "pytest>=1", + "coverage>=3,<5", +] + +[project.scripts] +exec = "pkg.__main__:exec" + +[build-system] +requires = ["setuptools", "wheel"] +build-backend = "setuptools.build_meta" + +[tool.setuptools] +package-dir = {"" = "src"} +zip-safe = true +platforms = ["any"] + +[tool.setuptools.packages.find] +where = ["src"] + +[tool.setuptools.cmdclass] +sdist = "pkg.mod.CustomSdist" + +[tool.setuptools.dynamic.version] +attr = "pkg.__version__.VERSION" + +[tool.setuptools.dynamic.readme] +file = ["README.md"] +content-type = "text/markdown" + +[tool.setuptools.package-data] +"*" = ["*.txt"] + +[tool.setuptools.data-files] +"data" = ["_files/*.txt"] + +[tool.distutils.sdist] +formats = "gztar" + +[tool.distutils.bdist_wheel] +universal = true +""" + + +def create_example(path, pkg_root): + files = { + "pyproject.toml": EXAMPLE, + "README.md": "hello world", + "_files": { + "file.txt": "", + }, + } + packages = { + "pkg": { + "__init__.py": "", + "mod.py": "class CustomSdist: pass", + "__version__.py": "VERSION = (3, 10)", + "__main__.py": "def exec(): print('hello')", + }, + } + + assert pkg_root # Meta-test: cannot be empty string. + + if pkg_root == ".": + files = {**files, **packages} + # skip other files: flat-layout will raise error for multi-package dist + else: + # Use this opportunity to ensure namespaces are discovered + files[pkg_root] = {**packages, "other": {"nested": {"__init__.py": ""}}} + + jaraco.path.build(files, prefix=path) + + +def verify_example(config, path, pkg_root): + pyproject = path / "pyproject.toml" + pyproject.write_text(tomli_w.dumps(config), encoding="utf-8") + expanded = expand_configuration(config, path) + expanded_project = expanded["project"] + assert read_configuration(pyproject, expand=True) == expanded + assert expanded_project["version"] == "3.10" + assert expanded_project["readme"]["text"] == "hello world" + assert "packages" in expanded["tool"]["setuptools"] + if pkg_root == ".": + # Auto-discovery will raise error for multi-package dist + assert set(expanded["tool"]["setuptools"]["packages"]) == {"pkg"} + else: + assert set(expanded["tool"]["setuptools"]["packages"]) == { + "pkg", + "other", + "other.nested", + } + assert expanded["tool"]["setuptools"]["include-package-data"] is True + assert "" in expanded["tool"]["setuptools"]["package-data"] + assert "*" not in expanded["tool"]["setuptools"]["package-data"] + assert expanded["tool"]["setuptools"]["data-files"] == [ + ("data", ["_files/file.txt"]) + ] + + +def test_read_configuration(tmp_path): + create_example(tmp_path, "src") + pyproject = tmp_path / "pyproject.toml" + + config = read_configuration(pyproject, expand=False) + assert config["project"].get("version") is None + assert config["project"].get("readme") is None + + verify_example(config, tmp_path, "src") + + +@pytest.mark.parametrize( + ("pkg_root", "opts"), + [ + (".", {}), + ("src", {}), + ("lib", {"packages": {"find": {"where": ["lib"]}}}), + ], +) +def test_discovered_package_dir_with_attr_directive_in_config(tmp_path, pkg_root, opts): + create_example(tmp_path, pkg_root) + + pyproject = tmp_path / "pyproject.toml" + + config = read_configuration(pyproject, expand=False) + assert config["project"].get("version") is None + assert config["project"].get("readme") is None + config["tool"]["setuptools"].pop("packages", None) + config["tool"]["setuptools"].pop("package-dir", None) + + config["tool"]["setuptools"].update(opts) + verify_example(config, tmp_path, pkg_root) + + +ENTRY_POINTS = { + "console_scripts": {"a": "mod.a:func"}, + "gui_scripts": {"b": "mod.b:func"}, + "other": {"c": "mod.c:func [extra]"}, +} + + +class TestEntryPoints: + def write_entry_points(self, tmp_path): + entry_points = ConfigParser() + entry_points.read_dict(ENTRY_POINTS) + with open(tmp_path / "entry-points.txt", "w", encoding="utf-8") as f: + entry_points.write(f) + + def pyproject(self, dynamic=None): + project = {"dynamic": dynamic or ["scripts", "gui-scripts", "entry-points"]} + tool = {"dynamic": {"entry-points": {"file": "entry-points.txt"}}} + return {"project": project, "tool": {"setuptools": tool}} + + def test_all_listed_in_dynamic(self, tmp_path): + self.write_entry_points(tmp_path) + expanded = expand_configuration(self.pyproject(), tmp_path) + expanded_project = expanded["project"] + assert len(expanded_project["scripts"]) == 1 + assert expanded_project["scripts"]["a"] == "mod.a:func" + assert len(expanded_project["gui-scripts"]) == 1 + assert expanded_project["gui-scripts"]["b"] == "mod.b:func" + assert len(expanded_project["entry-points"]) == 1 + assert expanded_project["entry-points"]["other"]["c"] == "mod.c:func [extra]" + + @pytest.mark.parametrize("missing_dynamic", ("scripts", "gui-scripts")) + def test_scripts_not_listed_in_dynamic(self, tmp_path, missing_dynamic): + self.write_entry_points(tmp_path) + dynamic = {"scripts", "gui-scripts", "entry-points"} - {missing_dynamic} + + msg = f"defined outside of `pyproject.toml`:.*{missing_dynamic}" + with pytest.raises(OptionError, match=re.compile(msg, re.S)): + expand_configuration(self.pyproject(dynamic), tmp_path) + + +class TestClassifiers: + def test_dynamic(self, tmp_path): + # Let's create a project example that has dynamic classifiers + # coming from a txt file. + create_example(tmp_path, "src") + classifiers = cleandoc( + """ + Framework :: Flask + Programming Language :: Haskell + """ + ) + (tmp_path / "classifiers.txt").write_text(classifiers, encoding="utf-8") + + pyproject = tmp_path / "pyproject.toml" + config = read_configuration(pyproject, expand=False) + dynamic = config["project"]["dynamic"] + config["project"]["dynamic"] = list({*dynamic, "classifiers"}) + dynamic_config = config["tool"]["setuptools"]["dynamic"] + dynamic_config["classifiers"] = {"file": "classifiers.txt"} + + # When the configuration is expanded, + # each line of the file should be an different classifier. + validate(config, pyproject) + expanded = expand_configuration(config, tmp_path) + + assert set(expanded["project"]["classifiers"]) == { + "Framework :: Flask", + "Programming Language :: Haskell", + } + + def test_dynamic_without_config(self, tmp_path): + config = """ + [project] + name = "myproj" + version = '42' + dynamic = ["classifiers"] + """ + + pyproject = tmp_path / "pyproject.toml" + pyproject.write_text(cleandoc(config), encoding="utf-8") + with pytest.raises(OptionError, match="No configuration .* .classifiers."): + read_configuration(pyproject) + + def test_dynamic_readme_from_setup_script_args(self, tmp_path): + config = """ + [project] + name = "myproj" + version = '42' + dynamic = ["readme"] + """ + pyproject = tmp_path / "pyproject.toml" + pyproject.write_text(cleandoc(config), encoding="utf-8") + dist = Distribution(attrs={"long_description": "42"}) + # No error should occur because of missing `readme` + dist = apply_configuration(dist, pyproject) + assert dist.metadata.long_description == "42" + + def test_dynamic_without_file(self, tmp_path): + config = """ + [project] + name = "myproj" + version = '42' + dynamic = ["classifiers"] + + [tool.setuptools.dynamic] + classifiers = {file = ["classifiers.txt"]} + """ + + pyproject = tmp_path / "pyproject.toml" + pyproject.write_text(cleandoc(config), encoding="utf-8") + with pytest.warns(UserWarning, match="File .*classifiers.txt. cannot be found"): + expanded = read_configuration(pyproject) + assert "classifiers" not in expanded["project"] + + +@pytest.mark.parametrize( + "example", + ( + """ + [project] + name = "myproj" + version = "1.2" + + [my-tool.that-disrespect.pep518] + value = 42 + """, + ), +) +def test_ignore_unrelated_config(tmp_path, example): + pyproject = tmp_path / "pyproject.toml" + pyproject.write_text(cleandoc(example), encoding="utf-8") + + # Make sure no error is raised due to 3rd party configs in pyproject.toml + assert read_configuration(pyproject) is not None + + +@pytest.mark.parametrize( + ("example", "error_msg"), + [ + ( + """ + [project] + name = "myproj" + version = "1.2" + requires = ['pywin32; platform_system=="Windows"' ] + """, + "configuration error: .project. must not contain ..requires.. properties", + ), + ], +) +def test_invalid_example(tmp_path, example, error_msg): + pyproject = tmp_path / "pyproject.toml" + pyproject.write_text(cleandoc(example), encoding="utf-8") + + pattern = re.compile(f"invalid pyproject.toml.*{error_msg}.*", re.M | re.S) + with pytest.raises(ValueError, match=pattern): + read_configuration(pyproject) + + +@pytest.mark.parametrize("config", ("", "[tool.something]\nvalue = 42")) +def test_empty(tmp_path, config): + pyproject = tmp_path / "pyproject.toml" + pyproject.write_text(config, encoding="utf-8") + + # Make sure no error is raised + assert read_configuration(pyproject) == {} + + +@pytest.mark.parametrize("config", ("[project]\nname = 'myproj'\nversion='42'\n",)) +def test_include_package_data_by_default(tmp_path, config): + """Builds with ``pyproject.toml`` should consider ``include-package-data=True`` as + default. + """ + pyproject = tmp_path / "pyproject.toml" + pyproject.write_text(config, encoding="utf-8") + + config = read_configuration(pyproject) + assert config["tool"]["setuptools"]["include-package-data"] is True + + +def test_include_package_data_in_setuppy(tmp_path): + """Builds with ``pyproject.toml`` should consider ``include_package_data`` set in + ``setup.py``. + + See https://github.com/pypa/setuptools/issues/3197#issuecomment-1079023889 + """ + files = { + "pyproject.toml": "[project]\nname = 'myproj'\nversion='42'\n", + "setup.py": "__import__('setuptools').setup(include_package_data=False)", + } + jaraco.path.build(files, prefix=tmp_path) + + with Path(tmp_path): + dist = distutils.core.run_setup("setup.py", {}, stop_after="config") + + assert dist.get_name() == "myproj" + assert dist.get_version() == "42" + assert dist.include_package_data is False + + +def test_warn_tools_typo(tmp_path): + """Test that the common ``tools.setuptools`` typo in ``pyproject.toml`` issues a warning + + See https://github.com/pypa/setuptools/issues/4150 + """ + config = """ + [build-system] + requires = ["setuptools"] + build-backend = "setuptools.build_meta" + + [project] + name = "myproj" + version = '42' + + [tools.setuptools] + packages = ["package"] + """ + + pyproject = tmp_path / "pyproject.toml" + pyproject.write_text(cleandoc(config), encoding="utf-8") + + with pytest.warns(_ToolsTypoInMetadata): + read_configuration(pyproject) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_pyprojecttoml_dynamic_deps.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_pyprojecttoml_dynamic_deps.py new file mode 100644 index 000000000..e42f28ffa --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_pyprojecttoml_dynamic_deps.py @@ -0,0 +1,109 @@ +from inspect import cleandoc + +import pytest +from jaraco import path + +from setuptools.config.pyprojecttoml import apply_configuration +from setuptools.dist import Distribution +from setuptools.warnings import SetuptoolsWarning + + +def test_dynamic_dependencies(tmp_path): + files = { + "requirements.txt": "six\n # comment\n", + "pyproject.toml": cleandoc( + """ + [project] + name = "myproj" + version = "1.0" + dynamic = ["dependencies"] + + [build-system] + requires = ["setuptools", "wheel"] + build-backend = "setuptools.build_meta" + + [tool.setuptools.dynamic.dependencies] + file = ["requirements.txt"] + """ + ), + } + path.build(files, prefix=tmp_path) + dist = Distribution() + dist = apply_configuration(dist, tmp_path / "pyproject.toml") + assert dist.install_requires == ["six"] + + +def test_dynamic_optional_dependencies(tmp_path): + files = { + "requirements-docs.txt": "sphinx\n # comment\n", + "pyproject.toml": cleandoc( + """ + [project] + name = "myproj" + version = "1.0" + dynamic = ["optional-dependencies"] + + [tool.setuptools.dynamic.optional-dependencies.docs] + file = ["requirements-docs.txt"] + + [build-system] + requires = ["setuptools", "wheel"] + build-backend = "setuptools.build_meta" + """ + ), + } + path.build(files, prefix=tmp_path) + dist = Distribution() + dist = apply_configuration(dist, tmp_path / "pyproject.toml") + assert dist.extras_require == {"docs": ["sphinx"]} + + +def test_mixed_dynamic_optional_dependencies(tmp_path): + """ + Test that if PEP 621 was loosened to allow mixing of dynamic and static + configurations in the case of fields containing sub-fields (groups), + things would work out. + """ + files = { + "requirements-images.txt": "pillow~=42.0\n # comment\n", + "pyproject.toml": cleandoc( + """ + [project] + name = "myproj" + version = "1.0" + dynamic = ["optional-dependencies"] + + [project.optional-dependencies] + docs = ["sphinx"] + + [tool.setuptools.dynamic.optional-dependencies.images] + file = ["requirements-images.txt"] + """ + ), + } + + path.build(files, prefix=tmp_path) + pyproject = tmp_path / "pyproject.toml" + with pytest.raises(ValueError, match="project.optional-dependencies"): + apply_configuration(Distribution(), pyproject) + + +def test_mixed_extras_require_optional_dependencies(tmp_path): + files = { + "pyproject.toml": cleandoc( + """ + [project] + name = "myproj" + version = "1.0" + optional-dependencies.docs = ["sphinx"] + """ + ), + } + + path.build(files, prefix=tmp_path) + pyproject = tmp_path / "pyproject.toml" + + with pytest.warns(SetuptoolsWarning, match=".extras_require. overwritten"): + dist = Distribution({"extras_require": {"hello": ["world"]}}) + dist = apply_configuration(dist, pyproject) + assert dist.extras_require == {"docs": ["sphinx"]} diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_setupcfg.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_setupcfg.py new file mode 100644 index 000000000..61af99044 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/config/test_setupcfg.py @@ -0,0 +1,980 @@ +import configparser +import contextlib +import inspect +import re +from pathlib import Path +from unittest.mock import Mock, patch + +import pytest +from packaging.requirements import InvalidRequirement + +from setuptools.config.setupcfg import ConfigHandler, Target, read_configuration +from setuptools.dist import Distribution, _Distribution +from setuptools.warnings import SetuptoolsDeprecationWarning + +from ..textwrap import DALS + +from distutils.errors import DistutilsFileError, DistutilsOptionError + + +class ErrConfigHandler(ConfigHandler[Target]): + """Erroneous handler. Fails to implement required methods.""" + + section_prefix = "**err**" + + +def make_package_dir(name, base_dir, ns=False): + dir_package = base_dir + for dir_name in name.split('/'): + dir_package = dir_package.mkdir(dir_name) + init_file = None + if not ns: + init_file = dir_package.join('__init__.py') + init_file.write('') + return dir_package, init_file + + +def fake_env( + tmpdir, setup_cfg, setup_py=None, encoding='ascii', package_path='fake_package' +): + if setup_py is None: + setup_py = 'from setuptools import setup\nsetup()\n' + + tmpdir.join('setup.py').write(setup_py) + config = tmpdir.join('setup.cfg') + config.write(setup_cfg.encode(encoding), mode='wb') + + package_dir, init_file = make_package_dir(package_path, tmpdir) + + init_file.write( + 'VERSION = (1, 2, 3)\n' + '\n' + 'VERSION_MAJOR = 1' + '\n' + 'def get_version():\n' + ' return [3, 4, 5, "dev"]\n' + '\n' + ) + + return package_dir, config + + +@contextlib.contextmanager +def get_dist(tmpdir, kwargs_initial=None, parse=True): + kwargs_initial = kwargs_initial or {} + + with tmpdir.as_cwd(): + dist = Distribution(kwargs_initial) + dist.script_name = 'setup.py' + parse and dist.parse_config_files() + + yield dist + + +def test_parsers_implemented(): + with pytest.raises(NotImplementedError): + handler = ErrConfigHandler(None, {}, False, Mock()) + handler.parsers + + +class TestConfigurationReader: + def test_basic(self, tmpdir): + _, config = fake_env( + tmpdir, + '[metadata]\n' + 'version = 10.1.1\n' + 'keywords = one, two\n' + '\n' + '[options]\n' + 'scripts = bin/a.py, bin/b.py\n', + ) + config_dict = read_configuration(str(config)) + assert config_dict['metadata']['version'] == '10.1.1' + assert config_dict['metadata']['keywords'] == ['one', 'two'] + assert config_dict['options']['scripts'] == ['bin/a.py', 'bin/b.py'] + + def test_no_config(self, tmpdir): + with pytest.raises(DistutilsFileError): + read_configuration(str(tmpdir.join('setup.cfg'))) + + def test_ignore_errors(self, tmpdir): + _, config = fake_env( + tmpdir, + '[metadata]\nversion = attr: none.VERSION\nkeywords = one, two\n', + ) + with pytest.raises(ImportError): + read_configuration(str(config)) + + config_dict = read_configuration(str(config), ignore_option_errors=True) + + assert config_dict['metadata']['keywords'] == ['one', 'two'] + assert 'version' not in config_dict['metadata'] + + config.remove() + + +class TestMetadata: + def test_basic(self, tmpdir): + fake_env( + tmpdir, + '[metadata]\n' + 'version = 10.1.1\n' + 'description = Some description\n' + 'long_description_content_type = text/something\n' + 'long_description = file: README\n' + 'name = fake_name\n' + 'keywords = one, two\n' + 'provides = package, package.sub\n' + 'license = otherlic\n' + 'download_url = http://test.test.com/test/\n' + 'maintainer_email = test@test.com\n', + ) + + tmpdir.join('README').write('readme contents\nline2') + + meta_initial = { + # This will be used so `otherlic` won't replace it. + 'license': 'BSD 3-Clause License', + } + + with get_dist(tmpdir, meta_initial) as dist: + metadata = dist.metadata + + assert metadata.version == '10.1.1' + assert metadata.description == 'Some description' + assert metadata.long_description_content_type == 'text/something' + assert metadata.long_description == 'readme contents\nline2' + assert metadata.provides == ['package', 'package.sub'] + assert metadata.license == 'BSD 3-Clause License' + assert metadata.name == 'fake_name' + assert metadata.keywords == ['one', 'two'] + assert metadata.download_url == 'http://test.test.com/test/' + assert metadata.maintainer_email == 'test@test.com' + + def test_license_cfg(self, tmpdir): + fake_env( + tmpdir, + DALS( + """ + [metadata] + name=foo + version=0.0.1 + license=Apache 2.0 + """ + ), + ) + + with get_dist(tmpdir) as dist: + metadata = dist.metadata + + assert metadata.name == "foo" + assert metadata.version == "0.0.1" + assert metadata.license == "Apache 2.0" + + def test_file_mixed(self, tmpdir): + fake_env( + tmpdir, + '[metadata]\nlong_description = file: README.rst, CHANGES.rst\n\n', + ) + + tmpdir.join('README.rst').write('readme contents\nline2') + tmpdir.join('CHANGES.rst').write('changelog contents\nand stuff') + + with get_dist(tmpdir) as dist: + assert dist.metadata.long_description == ( + 'readme contents\nline2\nchangelog contents\nand stuff' + ) + + def test_file_sandboxed(self, tmpdir): + tmpdir.ensure("README") + project = tmpdir.join('depth1', 'depth2') + project.ensure(dir=True) + fake_env(project, '[metadata]\nlong_description = file: ../../README\n') + + with get_dist(project, parse=False) as dist: + with pytest.raises(DistutilsOptionError): + dist.parse_config_files() # file: out of sandbox + + def test_aliases(self, tmpdir): + fake_env( + tmpdir, + '[metadata]\n' + 'author_email = test@test.com\n' + 'home_page = http://test.test.com/test/\n' + 'summary = Short summary\n' + 'platform = a, b\n' + 'classifier =\n' + ' Framework :: Django\n' + ' Programming Language :: Python :: 3.5\n', + ) + + with get_dist(tmpdir) as dist: + metadata = dist.metadata + assert metadata.author_email == 'test@test.com' + assert metadata.url == 'http://test.test.com/test/' + assert metadata.description == 'Short summary' + assert metadata.platforms == ['a', 'b'] + assert metadata.classifiers == [ + 'Framework :: Django', + 'Programming Language :: Python :: 3.5', + ] + + def test_multiline(self, tmpdir): + fake_env( + tmpdir, + '[metadata]\n' + 'name = fake_name\n' + 'keywords =\n' + ' one\n' + ' two\n' + 'classifiers =\n' + ' Framework :: Django\n' + ' Programming Language :: Python :: 3.5\n', + ) + with get_dist(tmpdir) as dist: + metadata = dist.metadata + assert metadata.keywords == ['one', 'two'] + assert metadata.classifiers == [ + 'Framework :: Django', + 'Programming Language :: Python :: 3.5', + ] + + def test_dict(self, tmpdir): + fake_env( + tmpdir, + '[metadata]\n' + 'project_urls =\n' + ' Link One = https://example.com/one/\n' + ' Link Two = https://example.com/two/\n', + ) + with get_dist(tmpdir) as dist: + metadata = dist.metadata + assert metadata.project_urls == { + 'Link One': 'https://example.com/one/', + 'Link Two': 'https://example.com/two/', + } + + def test_version(self, tmpdir): + package_dir, config = fake_env( + tmpdir, '[metadata]\nversion = attr: fake_package.VERSION\n' + ) + + sub_a = package_dir.mkdir('subpkg_a') + sub_a.join('__init__.py').write('') + sub_a.join('mod.py').write('VERSION = (2016, 11, 26)') + + sub_b = package_dir.mkdir('subpkg_b') + sub_b.join('__init__.py').write('') + sub_b.join('mod.py').write( + 'import third_party_module\nVERSION = (2016, 11, 26)' + ) + + with get_dist(tmpdir) as dist: + assert dist.metadata.version == '1.2.3' + + config.write('[metadata]\nversion = attr: fake_package.get_version\n') + with get_dist(tmpdir) as dist: + assert dist.metadata.version == '3.4.5.dev' + + config.write('[metadata]\nversion = attr: fake_package.VERSION_MAJOR\n') + with get_dist(tmpdir) as dist: + assert dist.metadata.version == '1' + + config.write('[metadata]\nversion = attr: fake_package.subpkg_a.mod.VERSION\n') + with get_dist(tmpdir) as dist: + assert dist.metadata.version == '2016.11.26' + + config.write('[metadata]\nversion = attr: fake_package.subpkg_b.mod.VERSION\n') + with get_dist(tmpdir) as dist: + assert dist.metadata.version == '2016.11.26' + + def test_version_file(self, tmpdir): + fake_env(tmpdir, '[metadata]\nversion = file: fake_package/version.txt\n') + tmpdir.join('fake_package', 'version.txt').write('1.2.3\n') + + with get_dist(tmpdir) as dist: + assert dist.metadata.version == '1.2.3' + + tmpdir.join('fake_package', 'version.txt').write('1.2.3\n4.5.6\n') + with pytest.raises(DistutilsOptionError): + with get_dist(tmpdir) as dist: + dist.metadata.version + + def test_version_with_package_dir_simple(self, tmpdir): + fake_env( + tmpdir, + '[metadata]\n' + 'version = attr: fake_package_simple.VERSION\n' + '[options]\n' + 'package_dir =\n' + ' = src\n', + package_path='src/fake_package_simple', + ) + + with get_dist(tmpdir) as dist: + assert dist.metadata.version == '1.2.3' + + def test_version_with_package_dir_rename(self, tmpdir): + fake_env( + tmpdir, + '[metadata]\n' + 'version = attr: fake_package_rename.VERSION\n' + '[options]\n' + 'package_dir =\n' + ' fake_package_rename = fake_dir\n', + package_path='fake_dir', + ) + + with get_dist(tmpdir) as dist: + assert dist.metadata.version == '1.2.3' + + def test_version_with_package_dir_complex(self, tmpdir): + fake_env( + tmpdir, + '[metadata]\n' + 'version = attr: fake_package_complex.VERSION\n' + '[options]\n' + 'package_dir =\n' + ' fake_package_complex = src/fake_dir\n', + package_path='src/fake_dir', + ) + + with get_dist(tmpdir) as dist: + assert dist.metadata.version == '1.2.3' + + def test_unknown_meta_item(self, tmpdir): + fake_env(tmpdir, '[metadata]\nname = fake_name\nunknown = some\n') + with get_dist(tmpdir, parse=False) as dist: + dist.parse_config_files() # Skip unknown. + + def test_usupported_section(self, tmpdir): + fake_env(tmpdir, '[metadata.some]\nkey = val\n') + with get_dist(tmpdir, parse=False) as dist: + with pytest.raises(DistutilsOptionError): + dist.parse_config_files() + + def test_classifiers(self, tmpdir): + expected = set([ + 'Framework :: Django', + 'Programming Language :: Python :: 3', + 'Programming Language :: Python :: 3.5', + ]) + + # From file. + _, config = fake_env(tmpdir, '[metadata]\nclassifiers = file: classifiers\n') + + tmpdir.join('classifiers').write( + 'Framework :: Django\n' + 'Programming Language :: Python :: 3\n' + 'Programming Language :: Python :: 3.5\n' + ) + + with get_dist(tmpdir) as dist: + assert set(dist.metadata.classifiers) == expected + + # From list notation + config.write( + '[metadata]\n' + 'classifiers =\n' + ' Framework :: Django\n' + ' Programming Language :: Python :: 3\n' + ' Programming Language :: Python :: 3.5\n' + ) + with get_dist(tmpdir) as dist: + assert set(dist.metadata.classifiers) == expected + + def test_interpolation(self, tmpdir): + fake_env(tmpdir, '[metadata]\ndescription = %(message)s\n') + with pytest.raises(configparser.InterpolationMissingOptionError): + with get_dist(tmpdir): + pass + + def test_non_ascii_1(self, tmpdir): + fake_env(tmpdir, '[metadata]\ndescription = éàïôñ\n', encoding='utf-8') + with get_dist(tmpdir): + pass + + def test_non_ascii_3(self, tmpdir): + fake_env(tmpdir, '\n# -*- coding: invalid\n') + with get_dist(tmpdir): + pass + + def test_non_ascii_4(self, tmpdir): + fake_env( + tmpdir, + '# -*- coding: utf-8\n[metadata]\ndescription = éàïôñ\n', + encoding='utf-8', + ) + with get_dist(tmpdir) as dist: + assert dist.metadata.description == 'éàïôñ' + + def test_not_utf8(self, tmpdir): + """ + Config files encoded not in UTF-8 will fail + """ + fake_env( + tmpdir, + '# vim: set fileencoding=iso-8859-15 :\n[metadata]\ndescription = éàïôñ\n', + encoding='iso-8859-15', + ) + with pytest.raises(UnicodeDecodeError): + with get_dist(tmpdir): + pass + + @pytest.mark.parametrize( + ("error_msg", "config", "invalid"), + [ + ( + "Invalid dash-separated key 'author-email' in 'metadata' (setup.cfg)", + DALS( + """ + [metadata] + author-email = test@test.com + maintainer_email = foo@foo.com + """ + ), + {"author-email": "test@test.com"}, + ), + ( + "Invalid uppercase key 'Name' in 'metadata' (setup.cfg)", + DALS( + """ + [metadata] + Name = foo + description = Some description + """ + ), + {"Name": "foo"}, + ), + ], + ) + def test_invalid_options_previously_deprecated( + self, tmpdir, error_msg, config, invalid + ): + # This test and related methods can be removed when no longer needed. + # Deprecation postponed due to push-back from the community in + # https://github.com/pypa/setuptools/issues/4910 + fake_env(tmpdir, config) + with pytest.warns(SetuptoolsDeprecationWarning, match=re.escape(error_msg)): + dist = get_dist(tmpdir).__enter__() + + tmpdir.join('setup.cfg').remove() + + for field, value in invalid.items(): + attr = field.replace("-", "_").lower() + assert getattr(dist.metadata, attr) == value + + +class TestOptions: + def test_basic(self, tmpdir): + fake_env( + tmpdir, + '[options]\n' + 'zip_safe = True\n' + 'include_package_data = yes\n' + 'package_dir = b=c, =src\n' + 'packages = pack_a, pack_b.subpack\n' + 'namespace_packages = pack1, pack2\n' + 'scripts = bin/one.py, bin/two.py\n' + 'eager_resources = bin/one.py, bin/two.py\n' + 'install_requires = docutils>=0.3; pack ==1.1, ==1.3; hey\n' + 'setup_requires = docutils>=0.3; spack ==1.1, ==1.3; there\n' + 'dependency_links = http://some.com/here/1, ' + 'http://some.com/there/2\n' + 'python_requires = >=1.0, !=2.8\n' + 'py_modules = module1, module2\n', + ) + deprec = pytest.warns(SetuptoolsDeprecationWarning, match="namespace_packages") + with deprec, get_dist(tmpdir) as dist: + assert dist.zip_safe + assert dist.include_package_data + assert dist.package_dir == {'': 'src', 'b': 'c'} + assert dist.packages == ['pack_a', 'pack_b.subpack'] + assert dist.namespace_packages == ['pack1', 'pack2'] + assert dist.scripts == ['bin/one.py', 'bin/two.py'] + assert dist.dependency_links == ([ + 'http://some.com/here/1', + 'http://some.com/there/2', + ]) + assert dist.install_requires == ([ + 'docutils>=0.3', + 'pack==1.1,==1.3', + 'hey', + ]) + assert dist.setup_requires == ([ + 'docutils>=0.3', + 'spack ==1.1, ==1.3', + 'there', + ]) + assert dist.python_requires == '>=1.0, !=2.8' + assert dist.py_modules == ['module1', 'module2'] + + def test_multiline(self, tmpdir): + fake_env( + tmpdir, + '[options]\n' + 'package_dir = \n' + ' b=c\n' + ' =src\n' + 'packages = \n' + ' pack_a\n' + ' pack_b.subpack\n' + 'namespace_packages = \n' + ' pack1\n' + ' pack2\n' + 'scripts = \n' + ' bin/one.py\n' + ' bin/two.py\n' + 'eager_resources = \n' + ' bin/one.py\n' + ' bin/two.py\n' + 'install_requires = \n' + ' docutils>=0.3\n' + ' pack ==1.1, ==1.3\n' + ' hey\n' + 'setup_requires = \n' + ' docutils>=0.3\n' + ' spack ==1.1, ==1.3\n' + ' there\n' + 'dependency_links = \n' + ' http://some.com/here/1\n' + ' http://some.com/there/2\n', + ) + deprec = pytest.warns(SetuptoolsDeprecationWarning, match="namespace_packages") + with deprec, get_dist(tmpdir) as dist: + assert dist.package_dir == {'': 'src', 'b': 'c'} + assert dist.packages == ['pack_a', 'pack_b.subpack'] + assert dist.namespace_packages == ['pack1', 'pack2'] + assert dist.scripts == ['bin/one.py', 'bin/two.py'] + assert dist.dependency_links == ([ + 'http://some.com/here/1', + 'http://some.com/there/2', + ]) + assert dist.install_requires == ([ + 'docutils>=0.3', + 'pack==1.1,==1.3', + 'hey', + ]) + assert dist.setup_requires == ([ + 'docutils>=0.3', + 'spack ==1.1, ==1.3', + 'there', + ]) + + def test_package_dir_fail(self, tmpdir): + fake_env(tmpdir, '[options]\npackage_dir = a b\n') + with get_dist(tmpdir, parse=False) as dist: + with pytest.raises(DistutilsOptionError): + dist.parse_config_files() + + def test_package_data(self, tmpdir): + fake_env( + tmpdir, + '[options.package_data]\n' + '* = *.txt, *.rst\n' + 'hello = *.msg\n' + '\n' + '[options.exclude_package_data]\n' + '* = fake1.txt, fake2.txt\n' + 'hello = *.dat\n', + ) + + with get_dist(tmpdir) as dist: + assert dist.package_data == { + '': ['*.txt', '*.rst'], + 'hello': ['*.msg'], + } + assert dist.exclude_package_data == { + '': ['fake1.txt', 'fake2.txt'], + 'hello': ['*.dat'], + } + + def test_packages(self, tmpdir): + fake_env(tmpdir, '[options]\npackages = find:\n') + + with get_dist(tmpdir) as dist: + assert dist.packages == ['fake_package'] + + def test_find_directive(self, tmpdir): + dir_package, config = fake_env(tmpdir, '[options]\npackages = find:\n') + + make_package_dir('sub_one', dir_package) + make_package_dir('sub_two', dir_package) + + with get_dist(tmpdir) as dist: + assert set(dist.packages) == set([ + 'fake_package', + 'fake_package.sub_two', + 'fake_package.sub_one', + ]) + + config.write( + '[options]\n' + 'packages = find:\n' + '\n' + '[options.packages.find]\n' + 'where = .\n' + 'include =\n' + ' fake_package.sub_one\n' + ' two\n' + ) + with get_dist(tmpdir) as dist: + assert dist.packages == ['fake_package.sub_one'] + + config.write( + '[options]\n' + 'packages = find:\n' + '\n' + '[options.packages.find]\n' + 'exclude =\n' + ' fake_package.sub_one\n' + ) + with get_dist(tmpdir) as dist: + assert set(dist.packages) == set(['fake_package', 'fake_package.sub_two']) + + def test_find_namespace_directive(self, tmpdir): + dir_package, config = fake_env( + tmpdir, '[options]\npackages = find_namespace:\n' + ) + + make_package_dir('sub_one', dir_package) + make_package_dir('sub_two', dir_package, ns=True) + + with get_dist(tmpdir) as dist: + assert set(dist.packages) == { + 'fake_package', + 'fake_package.sub_two', + 'fake_package.sub_one', + } + + config.write( + '[options]\n' + 'packages = find_namespace:\n' + '\n' + '[options.packages.find]\n' + 'where = .\n' + 'include =\n' + ' fake_package.sub_one\n' + ' two\n' + ) + with get_dist(tmpdir) as dist: + assert dist.packages == ['fake_package.sub_one'] + + config.write( + '[options]\n' + 'packages = find_namespace:\n' + '\n' + '[options.packages.find]\n' + 'exclude =\n' + ' fake_package.sub_one\n' + ) + with get_dist(tmpdir) as dist: + assert set(dist.packages) == {'fake_package', 'fake_package.sub_two'} + + def test_extras_require(self, tmpdir): + fake_env( + tmpdir, + '[options.extras_require]\n' + 'pdf = ReportLab>=1.2; RXP\n' + 'rest = \n' + ' docutils>=0.3\n' + ' pack ==1.1, ==1.3\n', + ) + + with get_dist(tmpdir) as dist: + assert dist.extras_require == { + 'pdf': ['ReportLab>=1.2', 'RXP'], + 'rest': ['docutils>=0.3', 'pack==1.1,==1.3'], + } + assert set(dist.metadata.provides_extras) == {'pdf', 'rest'} + + @pytest.mark.parametrize( + "config", + [ + "[options.extras_require]\nfoo = bar;python_version<'3'", + "[options.extras_require]\nfoo = bar;os_name=='linux'", + "[options.extras_require]\nfoo = bar;python_version<'3'\n", + "[options.extras_require]\nfoo = bar;os_name=='linux'\n", + "[options]\ninstall_requires = bar;python_version<'3'", + "[options]\ninstall_requires = bar;os_name=='linux'", + "[options]\ninstall_requires = bar;python_version<'3'\n", + "[options]\ninstall_requires = bar;os_name=='linux'\n", + ], + ) + def test_raises_accidental_env_marker_misconfig(self, config, tmpdir): + fake_env(tmpdir, config) + match = ( + r"One of the parsed requirements in `(install_requires|extras_require.+)` " + "looks like a valid environment marker.*" + ) + with pytest.raises(InvalidRequirement, match=match): + with get_dist(tmpdir) as _: + pass + + @pytest.mark.parametrize( + "config", + [ + "[options.extras_require]\nfoo = bar;python_version<3", + "[options.extras_require]\nfoo = bar;python_version<3\n", + "[options]\ninstall_requires = bar;python_version<3", + "[options]\ninstall_requires = bar;python_version<3\n", + ], + ) + def test_warn_accidental_env_marker_misconfig(self, config, tmpdir): + fake_env(tmpdir, config) + match = ( + r"One of the parsed requirements in `(install_requires|extras_require.+)` " + "looks like a valid environment marker.*" + ) + with pytest.warns(SetuptoolsDeprecationWarning, match=match): + with get_dist(tmpdir) as _: + pass + + @pytest.mark.parametrize( + "config", + [ + "[options.extras_require]\nfoo =\n bar;python_version<'3'", + "[options.extras_require]\nfoo = bar;baz\nboo = xxx;yyy", + "[options.extras_require]\nfoo =\n bar;python_version<'3'\n", + "[options.extras_require]\nfoo = bar;baz\nboo = xxx;yyy\n", + "[options.extras_require]\nfoo =\n bar\n python_version<3\n", + "[options]\ninstall_requires =\n bar;python_version<'3'", + "[options]\ninstall_requires = bar;baz\nboo = xxx;yyy", + "[options]\ninstall_requires =\n bar;python_version<'3'\n", + "[options]\ninstall_requires = bar;baz\nboo = xxx;yyy\n", + "[options]\ninstall_requires =\n bar\n python_version<3\n", + ], + ) + @pytest.mark.filterwarnings("error::setuptools.SetuptoolsDeprecationWarning") + def test_nowarn_accidental_env_marker_misconfig(self, config, tmpdir, recwarn): + fake_env(tmpdir, config) + num_warnings = len(recwarn) + with get_dist(tmpdir) as _: + pass + # The examples are valid, no warnings shown + assert len(recwarn) == num_warnings + + def test_dash_preserved_extras_require(self, tmpdir): + fake_env(tmpdir, '[options.extras_require]\nfoo-a = foo\nfoo_b = test\n') + + with get_dist(tmpdir) as dist: + assert dist.extras_require == {'foo-a': ['foo'], 'foo_b': ['test']} + + def test_entry_points(self, tmpdir): + _, config = fake_env( + tmpdir, + '[options.entry_points]\n' + 'group1 = point1 = pack.module:func, ' + '.point2 = pack.module2:func_rest [rest]\n' + 'group2 = point3 = pack.module:func2\n', + ) + + with get_dist(tmpdir) as dist: + assert dist.entry_points == { + 'group1': [ + 'point1 = pack.module:func', + '.point2 = pack.module2:func_rest [rest]', + ], + 'group2': ['point3 = pack.module:func2'], + } + + expected = ( + '[blogtool.parsers]\n' + '.rst = some.nested.module:SomeClass.some_classmethod[reST]\n' + ) + + tmpdir.join('entry_points').write(expected) + + # From file. + config.write('[options]\nentry_points = file: entry_points\n') + + with get_dist(tmpdir) as dist: + assert dist.entry_points == expected + + def test_case_sensitive_entry_points(self, tmpdir): + fake_env( + tmpdir, + '[options.entry_points]\n' + 'GROUP1 = point1 = pack.module:func, ' + '.point2 = pack.module2:func_rest [rest]\n' + 'group2 = point3 = pack.module:func2\n', + ) + + with get_dist(tmpdir) as dist: + assert dist.entry_points == { + 'GROUP1': [ + 'point1 = pack.module:func', + '.point2 = pack.module2:func_rest [rest]', + ], + 'group2': ['point3 = pack.module:func2'], + } + + def test_data_files(self, tmpdir): + fake_env( + tmpdir, + '[options.data_files]\n' + 'cfg =\n' + ' a/b.conf\n' + ' c/d.conf\n' + 'data = e/f.dat, g/h.dat\n', + ) + + with get_dist(tmpdir) as dist: + expected = [ + ('cfg', ['a/b.conf', 'c/d.conf']), + ('data', ['e/f.dat', 'g/h.dat']), + ] + assert sorted(dist.data_files) == sorted(expected) + + def test_data_files_globby(self, tmpdir): + fake_env( + tmpdir, + '[options.data_files]\n' + 'cfg =\n' + ' a/b.conf\n' + ' c/d.conf\n' + 'data = *.dat\n' + 'icons = \n' + ' *.ico\n' + 'audio = \n' + ' *.wav\n' + ' sounds.db\n', + ) + + # Create dummy files for glob()'s sake: + tmpdir.join('a.dat').write('') + tmpdir.join('b.dat').write('') + tmpdir.join('c.dat').write('') + tmpdir.join('a.ico').write('') + tmpdir.join('b.ico').write('') + tmpdir.join('c.ico').write('') + tmpdir.join('beep.wav').write('') + tmpdir.join('boop.wav').write('') + tmpdir.join('sounds.db').write('') + + with get_dist(tmpdir) as dist: + expected = [ + ('cfg', ['a/b.conf', 'c/d.conf']), + ('data', ['a.dat', 'b.dat', 'c.dat']), + ('icons', ['a.ico', 'b.ico', 'c.ico']), + ('audio', ['beep.wav', 'boop.wav', 'sounds.db']), + ] + assert sorted(dist.data_files) == sorted(expected) + + def test_python_requires_simple(self, tmpdir): + fake_env( + tmpdir, + DALS( + """ + [options] + python_requires=>=2.7 + """ + ), + ) + with get_dist(tmpdir) as dist: + dist.parse_config_files() + + def test_python_requires_compound(self, tmpdir): + fake_env( + tmpdir, + DALS( + """ + [options] + python_requires=>=2.7,!=3.0.* + """ + ), + ) + with get_dist(tmpdir) as dist: + dist.parse_config_files() + + def test_python_requires_invalid(self, tmpdir): + fake_env( + tmpdir, + DALS( + """ + [options] + python_requires=invalid + """ + ), + ) + with pytest.raises(Exception): + with get_dist(tmpdir) as dist: + dist.parse_config_files() + + def test_cmdclass(self, tmpdir): + module_path = Path(tmpdir, "src/custom_build.py") # auto discovery for src + module_path.parent.mkdir(parents=True, exist_ok=True) + module_path.write_text( + "from distutils.core import Command\nclass CustomCmd(Command): pass\n", + encoding="utf-8", + ) + + setup_cfg = """ + [options] + cmdclass = + customcmd = custom_build.CustomCmd + """ + fake_env(tmpdir, inspect.cleandoc(setup_cfg)) + + with get_dist(tmpdir) as dist: + cmdclass = dist.cmdclass['customcmd'] + assert cmdclass.__name__ == "CustomCmd" + assert cmdclass.__module__ == "custom_build" + assert module_path.samefile(inspect.getfile(cmdclass)) + + def test_requirements_file(self, tmpdir): + fake_env( + tmpdir, + DALS( + """ + [options] + install_requires = file:requirements.txt + [options.extras_require] + colors = file:requirements-extra.txt + """ + ), + ) + + tmpdir.join('requirements.txt').write('\ndocutils>=0.3\n\n') + tmpdir.join('requirements-extra.txt').write('colorama') + + with get_dist(tmpdir) as dist: + assert dist.install_requires == ['docutils>=0.3'] + assert dist.extras_require == {'colors': ['colorama']} + + +saved_dist_init = _Distribution.__init__ + + +class TestExternalSetters: + # During creation of the setuptools Distribution() object, we call + # the init of the parent distutils Distribution object via + # _Distribution.__init__ (). + # + # It's possible distutils calls out to various keyword + # implementations (i.e. distutils.setup_keywords entry points) + # that may set a range of variables. + # + # This wraps distutil's Distribution.__init__ and simulates + # pbr or something else setting these values. + def _fake_distribution_init(self, dist, attrs): + saved_dist_init(dist, attrs) + # see self._DISTUTILS_UNSUPPORTED_METADATA + dist.metadata.long_description_content_type = 'text/something' + # Test overwrite setup() args + dist.metadata.project_urls = { + 'Link One': 'https://example.com/one/', + 'Link Two': 'https://example.com/two/', + } + + @patch.object(_Distribution, '__init__', autospec=True) + def test_external_setters(self, mock_parent_init, tmpdir): + mock_parent_init.side_effect = self._fake_distribution_init + + dist = Distribution(attrs={'project_urls': {'will_be': 'ignored'}}) + + assert dist.metadata.long_description_content_type == 'text/something' + assert dist.metadata.project_urls == { + 'Link One': 'https://example.com/one/', + 'Link Two': 'https://example.com/two/', + } diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/contexts.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/contexts.py new file mode 100644 index 000000000..3c931bbd4 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/contexts.py @@ -0,0 +1,131 @@ +import contextlib +import io +import os +import shutil +import site +import sys +import tempfile + +from filelock import FileLock + + +@contextlib.contextmanager +def tempdir(cd=lambda dir: None, **kwargs): + temp_dir = tempfile.mkdtemp(**kwargs) + orig_dir = os.getcwd() + try: + cd(temp_dir) + yield temp_dir + finally: + cd(orig_dir) + shutil.rmtree(temp_dir) + + +@contextlib.contextmanager +def environment(**replacements): + """ + In a context, patch the environment with replacements. Pass None values + to clear the values. + """ + saved = dict((key, os.environ[key]) for key in replacements if key in os.environ) + + # remove values that are null + remove = (key for (key, value) in replacements.items() if value is None) + for key in list(remove): + os.environ.pop(key, None) + replacements.pop(key) + + os.environ.update(replacements) + + try: + yield saved + finally: + for key in replacements: + os.environ.pop(key, None) + os.environ.update(saved) + + +@contextlib.contextmanager +def quiet(): + """ + Redirect stdout/stderr to StringIO objects to prevent console output from + distutils commands. + """ + + old_stdout = sys.stdout + old_stderr = sys.stderr + new_stdout = sys.stdout = io.StringIO() + new_stderr = sys.stderr = io.StringIO() + try: + yield new_stdout, new_stderr + finally: + new_stdout.seek(0) + new_stderr.seek(0) + sys.stdout = old_stdout + sys.stderr = old_stderr + + +@contextlib.contextmanager +def save_user_site_setting(): + saved = site.ENABLE_USER_SITE + try: + yield saved + finally: + site.ENABLE_USER_SITE = saved + + +@contextlib.contextmanager +def suppress_exceptions(*excs): + try: + yield + except excs: + pass + + +def multiproc(request): + """ + Return True if running under xdist and multiple + workers are used. + """ + try: + worker_id = request.getfixturevalue('worker_id') + except Exception: + return False + return worker_id != 'master' + + +@contextlib.contextmanager +def session_locked_tmp_dir(request, tmp_path_factory, name): + """Uses a file lock to guarantee only one worker can access a temp dir""" + # get the temp directory shared by all workers + base = tmp_path_factory.getbasetemp() + shared_dir = base.parent if multiproc(request) else base + + locked_dir = shared_dir / name + with FileLock(locked_dir.with_suffix(".lock")): + # ^-- prevent multiple workers to access the directory at once + locked_dir.mkdir(exist_ok=True, parents=True) + yield locked_dir + + +@contextlib.contextmanager +def save_paths(): + """Make sure ``sys.path``, ``sys.meta_path`` and ``sys.path_hooks`` are preserved""" + prev = sys.path[:], sys.meta_path[:], sys.path_hooks[:] + + try: + yield + finally: + sys.path, sys.meta_path, sys.path_hooks = prev + + +@contextlib.contextmanager +def save_sys_modules(): + """Make sure initial ``sys.modules`` is preserved""" + prev_modules = sys.modules + + try: + sys.modules = sys.modules.copy() + yield + finally: + sys.modules = prev_modules diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/environment.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/environment.py new file mode 100644 index 000000000..ed5499ef7 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/environment.py @@ -0,0 +1,95 @@ +import os +import subprocess +import sys +import unicodedata +from subprocess import PIPE as _PIPE, Popen as _Popen + +import jaraco.envs + + +class VirtualEnv(jaraco.envs.VirtualEnv): + name = '.env' + # Some version of PyPy will import distutils on startup, implicitly + # importing setuptools, and thus leading to BackendInvalid errors + # when upgrading Setuptools. Bypass this behavior by avoiding the + # early availability and need to upgrade. + create_opts = ['--no-setuptools'] + + def run(self, cmd, *args, **kwargs): + cmd = [self.exe(cmd[0])] + cmd[1:] + kwargs = {"cwd": self.root, "encoding": "utf-8", **kwargs} # Allow overriding + # In some environments (eg. downstream distro packaging), where: + # - tox isn't used to run tests and + # - PYTHONPATH is set to point to a specific setuptools codebase and + # - no custom env is explicitly set by a test + # PYTHONPATH will leak into the spawned processes. + # In that case tests look for module in the wrong place (on PYTHONPATH). + # Unless the test sets its own special env, pass a copy of the existing + # environment with removed PYTHONPATH to the subprocesses. + if "env" not in kwargs: + env = dict(os.environ) + if "PYTHONPATH" in env: + del env["PYTHONPATH"] + kwargs["env"] = env + return subprocess.check_output(cmd, *args, **kwargs) + + +def _which_dirs(cmd): + result = set() + for path in os.environ.get('PATH', '').split(os.pathsep): + filename = os.path.join(path, cmd) + if os.access(filename, os.X_OK): + result.add(path) + return result + + +def run_setup_py(cmd, pypath=None, path=None, data_stream=0, env=None): + """ + Execution command for tests, separate from those used by the + code directly to prevent accidental behavior issues + """ + if env is None: + env = dict() + for envname in os.environ: + env[envname] = os.environ[envname] + + # override the python path if needed + if pypath is not None: + env["PYTHONPATH"] = pypath + + # override the execution path if needed + if path is not None: + env["PATH"] = path + if not env.get("PATH", ""): + env["PATH"] = _which_dirs("tar").union(_which_dirs("gzip")) + env["PATH"] = os.pathsep.join(env["PATH"]) + + cmd = [sys.executable, "setup.py"] + list(cmd) + + # https://bugs.python.org/issue8557 + shell = sys.platform == 'win32' + + try: + proc = _Popen( + cmd, + stdout=_PIPE, + stderr=_PIPE, + shell=shell, + env=env, + encoding="utf-8", + ) + + if isinstance(data_stream, tuple): + data_stream = slice(*data_stream) + data = proc.communicate()[data_stream] + except OSError: + return 1, '' + + # decode the console string if needed + if hasattr(data, "decode"): + # use the default encoding + data = data.decode() + data = unicodedata.normalize('NFC', data) + + # communicate calls wait() + return proc.returncode, data diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/fixtures.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/fixtures.py new file mode 100644 index 000000000..27a169896 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/fixtures.py @@ -0,0 +1,392 @@ +import contextlib +import io +import os +import subprocess +import sys +import tarfile +import time +from pathlib import Path + +import jaraco.path +import path +import pytest + +from setuptools._normalization import safer_name + +from . import contexts, environment +from .textwrap import DALS + + +@pytest.fixture +def user_override(monkeypatch): + """ + Override site.USER_BASE and site.USER_SITE with temporary directories in + a context. + """ + with contexts.tempdir() as user_base: + monkeypatch.setattr('site.USER_BASE', user_base) + with contexts.tempdir() as user_site: + monkeypatch.setattr('site.USER_SITE', user_site) + with contexts.save_user_site_setting(): + yield + + +@pytest.fixture +def tmpdir_cwd(tmpdir): + with tmpdir.as_cwd() as orig: + yield orig + + +@pytest.fixture(autouse=True, scope="session") +def workaround_xdist_376(request): + """ + Workaround pytest-dev/pytest-xdist#376 + + ``pytest-xdist`` tends to inject '' into ``sys.path``, + which may break certain isolation expectations. + Remove the entry so the import + machinery behaves the same irrespective of xdist. + """ + if not request.config.pluginmanager.has_plugin('xdist'): + return + + with contextlib.suppress(ValueError): + sys.path.remove('') + + +@pytest.fixture +def sample_project(tmp_path): + """ + Clone the 'sampleproject' and return a path to it. + """ + cmd = ['git', 'clone', 'https://github.com/pypa/sampleproject'] + try: + subprocess.check_call(cmd, cwd=str(tmp_path)) + except Exception: + pytest.skip("Unable to clone sampleproject") + return tmp_path / 'sampleproject' + + +@pytest.fixture +def sample_project_cwd(sample_project): + with path.Path(sample_project): + yield + + +# sdist and wheel artifacts should be stable across a round of tests +# so we can build them once per session and use the files as "readonly" + +# In the case of setuptools, building the wheel without sdist may cause +# it to contain the `build` directory, and therefore create situations with +# `setuptools/build/lib/build/lib/...`. To avoid that, build both artifacts at once. + + +def _build_distributions(tmp_path_factory, request): + with contexts.session_locked_tmp_dir( + request, tmp_path_factory, "dist_build" + ) as tmp: # pragma: no cover + sdist = next(tmp.glob("*.tar.gz"), None) + wheel = next(tmp.glob("*.whl"), None) + if sdist and wheel: + return (sdist, wheel) + + # Sanity check: should not create recursive setuptools/build/lib/build/lib/... + assert not Path(request.config.rootdir, "build/lib/build").exists() + + subprocess.check_output([ + sys.executable, + "-m", + "build", + "--outdir", + str(tmp), + str(request.config.rootdir), + ]) + + # Sanity check: should not create recursive setuptools/build/lib/build/lib/... + assert not Path(request.config.rootdir, "build/lib/build").exists() + + return next(tmp.glob("*.tar.gz")), next(tmp.glob("*.whl")) + + +@pytest.fixture(scope="session") +def setuptools_sdist(tmp_path_factory, request): + prebuilt = os.getenv("PRE_BUILT_SETUPTOOLS_SDIST") + if prebuilt and os.path.exists(prebuilt): # pragma: no cover + return Path(prebuilt).resolve() + + sdist, _ = _build_distributions(tmp_path_factory, request) + return sdist + + +@pytest.fixture(scope="session") +def setuptools_wheel(tmp_path_factory, request): + prebuilt = os.getenv("PRE_BUILT_SETUPTOOLS_WHEEL") + if prebuilt and os.path.exists(prebuilt): # pragma: no cover + return Path(prebuilt).resolve() + + _, wheel = _build_distributions(tmp_path_factory, request) + return wheel + + +@pytest.fixture +def venv(tmp_path, setuptools_wheel): + """Virtual env with the version of setuptools under test installed""" + env = environment.VirtualEnv() + env.root = path.Path(tmp_path / 'venv') + env.create_opts = ['--no-setuptools', '--wheel=bundle'] + # TODO: Use `--no-wheel` when setuptools implements its own bdist_wheel + env.req = str(setuptools_wheel) + # In some environments (eg. downstream distro packaging), + # where tox isn't used to run tests and PYTHONPATH is set to point to + # a specific setuptools codebase, PYTHONPATH will leak into the spawned + # processes. + # env.create() should install the just created setuptools + # wheel, but it doesn't if it finds another existing matching setuptools + # installation present on PYTHONPATH: + # `setuptools is already installed with the same version as the provided + # wheel. Use --force-reinstall to force an installation of the wheel.` + # This prevents leaking PYTHONPATH to the created environment. + with contexts.environment(PYTHONPATH=None): + return env.create() + + +@pytest.fixture +def venv_without_setuptools(tmp_path): + """Virtual env without any version of setuptools installed""" + env = environment.VirtualEnv() + env.root = path.Path(tmp_path / 'venv_without_setuptools') + env.create_opts = ['--no-setuptools', '--no-wheel'] + env.ensure_env() + return env + + +@pytest.fixture +def bare_venv(tmp_path): + """Virtual env without any common packages installed""" + env = environment.VirtualEnv() + env.root = path.Path(tmp_path / 'bare_venv') + env.create_opts = ['--no-setuptools', '--no-pip', '--no-wheel', '--no-seed'] + env.ensure_env() + return env + + +def make_sdist(dist_path, files): + """ + Create a simple sdist tarball at dist_path, containing the files + listed in ``files`` as ``(filename, content)`` tuples. + """ + + # Distributions with only one file don't play well with pip. + assert len(files) > 1 + with tarfile.open(dist_path, 'w:gz') as dist: + for filename, content in files: + file_bytes = io.BytesIO(content.encode('utf-8')) + file_info = tarfile.TarInfo(name=filename) + file_info.size = len(file_bytes.getvalue()) + file_info.mtime = int(time.time()) + dist.addfile(file_info, fileobj=file_bytes) + + +def make_trivial_sdist(dist_path, distname, version): + """ + Create a simple sdist tarball at dist_path, containing just a simple + setup.py. + """ + + make_sdist( + dist_path, + [ + ( + 'setup.py', + DALS( + f"""\ + import setuptools + setuptools.setup( + name={distname!r}, + version={version!r} + ) + """ + ), + ), + ('setup.cfg', ''), + ], + ) + + +def make_nspkg_sdist(dist_path, distname, version): + """ + Make an sdist tarball with distname and version which also contains one + package with the same name as distname. The top-level package is + designated a namespace package). + """ + # Assert that the distname contains at least one period + assert '.' in distname + + parts = distname.split('.') + nspackage = parts[0] + + packages = ['.'.join(parts[:idx]) for idx in range(1, len(parts) + 1)] + + setup_py = DALS( + f"""\ + import setuptools + setuptools.setup( + name={distname!r}, + version={version!r}, + packages={packages!r}, + namespace_packages=[{nspackage!r}] + ) + """ + ) + + init = "__import__('pkg_resources').declare_namespace(__name__)" + + files = [('setup.py', setup_py), (os.path.join(nspackage, '__init__.py'), init)] + for package in packages[1:]: + filename = os.path.join(*(package.split('.') + ['__init__.py'])) + files.append((filename, '')) + + make_sdist(dist_path, files) + + +def make_python_requires_sdist(dist_path, distname, version, python_requires): + make_sdist( + dist_path, + [ + ( + 'setup.py', + DALS( + """\ + import setuptools + setuptools.setup( + name={name!r}, + version={version!r}, + python_requires={python_requires!r}, + ) + """ + ).format( + name=distname, version=version, python_requires=python_requires + ), + ), + ('setup.cfg', ''), + ], + ) + + +def create_setup_requires_package( + path, + distname='foobar', + version='0.1', + make_package=make_trivial_sdist, + setup_py_template=None, + setup_attrs=None, + use_setup_cfg=(), +): + """Creates a source tree under path for a trivial test package that has a + single requirement in setup_requires--a tarball for that requirement is + also created and added to the dependency_links argument. + + ``distname`` and ``version`` refer to the name/version of the package that + the test package requires via ``setup_requires``. The name of the test + package itself is just 'test_pkg'. + """ + + normalized_distname = safer_name(distname) + test_setup_attrs = { + 'name': 'test_pkg', + 'version': '0.0', + 'setup_requires': [f'{normalized_distname}=={version}'], + 'dependency_links': [os.path.abspath(path)], + } + if setup_attrs: + test_setup_attrs.update(setup_attrs) + + test_pkg = os.path.join(path, 'test_pkg') + os.mkdir(test_pkg) + + # setup.cfg + if use_setup_cfg: + options = [] + metadata = [] + for name in use_setup_cfg: + value = test_setup_attrs.pop(name) + if name in 'name version'.split(): + section = metadata + else: + section = options + if isinstance(value, (tuple, list)): + value = ';'.join(value) + section.append(f'{name}: {value}') + test_setup_cfg_contents = DALS( + """ + [metadata] + {metadata} + [options] + {options} + """ + ).format( + options='\n'.join(options), + metadata='\n'.join(metadata), + ) + else: + test_setup_cfg_contents = '' + with open(os.path.join(test_pkg, 'setup.cfg'), 'w', encoding="utf-8") as f: + f.write(test_setup_cfg_contents) + + # setup.py + if setup_py_template is None: + setup_py_template = DALS( + """\ + import setuptools + setuptools.setup(**%r) + """ + ) + with open(os.path.join(test_pkg, 'setup.py'), 'w', encoding="utf-8") as f: + f.write(setup_py_template % test_setup_attrs) + + foobar_path = os.path.join(path, f'{normalized_distname}-{version}.tar.gz') + make_package(foobar_path, distname, version) + + return test_pkg + + +@pytest.fixture +def pbr_package(tmp_path, monkeypatch, venv): + files = { + "pyproject.toml": DALS( + """ + [build-system] + requires = ["setuptools"] + build-backend = "setuptools.build_meta" + """ + ), + "setup.py": DALS( + """ + __import__('setuptools').setup( + pbr=True, + setup_requires=["pbr"], + ) + """ + ), + "setup.cfg": DALS( + """ + [metadata] + name = mypkg + + [files] + packages = + mypkg + """ + ), + "mypkg": { + "__init__.py": "", + "hello.py": "print('Hello world!')", + }, + "other": {"test.txt": "Another file in here."}, + } + venv.run(["python", "-m", "pip", "install", "pbr"]) + prefix = tmp_path / 'mypkg' + prefix.mkdir() + jaraco.path.build(files, prefix=prefix) + monkeypatch.setenv('PBR_VERSION', "0.42") + return prefix diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/indexes/test_links_priority/external.html b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/indexes/test_links_priority/external.html new file mode 100644 index 000000000..92e4702f6 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/indexes/test_links_priority/external.html @@ -0,0 +1,3 @@ + +bad old link + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/indexes/test_links_priority/simple/foobar/index.html b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/indexes/test_links_priority/simple/foobar/index.html new file mode 100644 index 000000000..fefb028bd --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/indexes/test_links_priority/simple/foobar/index.html @@ -0,0 +1,4 @@ + +foobar-0.1.tar.gz
    +external homepage
    + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..980dbfc29142fad3992cad683622f04e949210bd GIT binary patch literal 231 zcmX@j%ge<81jlwKW`O9&AOanHW&w&!XQ*V*Wb|9fP{ah}eFmxd)ux}3pPQ8XTbOm!FafVR^c^#Rugl<(KG}l$PWdWhUn6>%mz$nMwKul_eSZ zdB%E%M*78>C8@dviOJcC=|J7ZsU@WaCHeU|#rh?w#Xy5I^GZ_FixNvR^YirM<1_Oz nOXB183Mzkb*yQG?l;)(`6|n-H#R$a3AjU^#Mn=XWW*`dy&ptvf literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/__pycache__/helpers.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/__pycache__/helpers.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cff340fc2b0fa820034f727179b40742c9e4f4e8 GIT binary patch literal 4674 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 B;hX>f literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/__pycache__/test_pip_install_sdist.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/integration/__pycache__/test_pip_install_sdist.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b6eb2cecd008e6a598d4dd7911b2b92c52a03556 GIT binary patch literal 9162 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.4.1",), # no pyproject.toml available +} + +EXTRA_ENV_VARS = { + "pyyaml": {"PYYAML_FORCE_CYTHON": "1"}, + "charset-normalizer": {"CHARSET_NORMALIZER_USE_MYPYC": "1"}, +} + +IMPORT_NAME = { + "pyyaml": "yaml", + "protobuf": "google.protobuf", +} + + +VIRTUALENV = (sys.executable, "-m", "virtualenv") + + +# By default, pip will try to build packages in isolation (PEP 517), which +# means it will download the previous stable version of setuptools. +# `pip` flags can avoid that (the version of setuptools under test +# should be the one to be used) +INSTALL_OPTIONS = ( + "--ignore-installed", + "--no-build-isolation", + # Omit "--no-binary :all:" the sdist is supplied directly. + # Allows dependencies as wheels. +) +# The downside of `--no-build-isolation` is that pip will not download build +# dependencies. The test script will have to also handle that. + + +@pytest.fixture +def venv_python(tmp_path): + run([*VIRTUALENV, str(tmp_path / ".venv")]) + possible_path = (str(p.parent) for p in tmp_path.glob(".venv/*/python*")) + return shutil.which("python", path=os.pathsep.join(possible_path)) + + +@pytest.fixture(autouse=True) +def _prepare(tmp_path, venv_python, monkeypatch): + download_path = os.getenv("DOWNLOAD_PATH", str(tmp_path)) + os.makedirs(download_path, exist_ok=True) + + # Environment vars used for building some of the packages + monkeypatch.setenv("USE_MYPYC", "1") + + yield + + # Let's provide the maximum amount of information possible in the case + # it is necessary to debug the tests directly from the CI logs. + print("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~") + print("Temporary directory:") + map(print, tmp_path.glob("*")) + print("Virtual environment:") + run([venv_python, "-m", "pip", "freeze"]) + + +@pytest.mark.parametrize(("package", "version"), EXAMPLES) +@pytest.mark.uses_network +def test_install_sdist(package, version, tmp_path, venv_python, setuptools_wheel): + venv_pip = (venv_python, "-m", "pip") + sdist = retrieve_sdist(package, version, tmp_path) + deps = build_deps(package, sdist) + if deps: + print("~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~") + print("Dependencies:", deps) + run([*venv_pip, "install", *deps]) + + # Use a virtualenv to simulate PEP 517 isolation + # but install fresh setuptools wheel to ensure the version under development + env = EXTRA_ENV_VARS.get(package, {}) + run([*venv_pip, "install", "--force-reinstall", setuptools_wheel]) + run([*venv_pip, "install", *INSTALL_OPTIONS, sdist], env) + + # Execute a simple script to make sure the package was installed correctly + pkg = IMPORT_NAME.get(package, package).replace("-", "_") + script = f"import {pkg}; print(getattr({pkg}, '__version__', 0))" + run([venv_python, "-c", script]) + + +# ---- Helper Functions ---- + + +def retrieve_sdist(package, version, tmp_path): + """Either use cached sdist file or download it from PyPI""" + # `pip download` cannot be used due to + # https://github.com/pypa/pip/issues/1884 + # https://discuss.python.org/t/pep-625-file-name-of-a-source-distribution/4686 + # We have to find the correct distribution file and download it + download_path = os.getenv("DOWNLOAD_PATH", str(tmp_path)) + dist = retrieve_pypi_sdist_metadata(package, version) + + # Remove old files to prevent cache to grow indefinitely + for file in glob(os.path.join(download_path, f"{package}*")): + if dist["filename"] != file: + os.unlink(file) + + dist_file = os.path.join(download_path, dist["filename"]) + if not os.path.exists(dist_file): + download(dist["url"], dist_file, dist["md5_digest"]) + return dist_file + + +def retrieve_pypi_sdist_metadata(package, version): + # https://warehouse.pypa.io/api-reference/json.html + id_ = package if version is LATEST else f"{package}/{version}" + with urlopen(f"https://pypi.org/pypi/{id_}/json") as f: + metadata = json.load(f) + + if metadata["info"]["yanked"]: + raise ValueError(f"Release for {package} {version} was yanked") + + version = metadata["info"]["version"] + release = metadata["releases"][version] if version is LATEST else metadata["urls"] + (sdist,) = filter(lambda d: d["packagetype"] == "sdist", release) + return sdist + + +def download(url, dest, md5_digest): + with urlopen(url) as f: + data = f.read() + + assert md5(data).hexdigest() == md5_digest + + with open(dest, "wb") as f: + f.write(data) + + assert os.path.exists(dest) + + +def build_deps(package, sdist_file): + """Find out what are the build dependencies for a package. + + "Manually" install them, since pip will not install build + deps with `--no-build-isolation`. + """ + # delay importing, since pytest discovery phase may hit this file from a + # testenv without tomli + from setuptools.compat.py310 import tomllib + + archive = Archive(sdist_file) + info = tomllib.loads(_read_pyproject(archive)) + deps = info.get("build-system", {}).get("requires", []) + deps += EXTRA_BUILD_DEPS.get(package, []) + # Remove setuptools from requirements (and deduplicate) + requirements = {Requirement(d).name: d for d in deps} + return [v for k, v in requirements.items() if k != "setuptools"] + + +def _read_pyproject(archive): + contents = ( + archive.get_content(member) + for member in archive + if os.path.basename(archive.get_name(member)) == "pyproject.toml" + ) + return next(contents, "") diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/mod_with_constant.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/mod_with_constant.py new file mode 100644 index 000000000..ef755dd1c --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/mod_with_constant.py @@ -0,0 +1 @@ +value = 'three, sir!' diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/namespaces.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/namespaces.py new file mode 100644 index 000000000..248db98f9 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/namespaces.py @@ -0,0 +1,90 @@ +import ast +import json +import textwrap +from pathlib import Path + + +def iter_namespace_pkgs(namespace): + parts = namespace.split(".") + for i in range(len(parts)): + yield ".".join(parts[: i + 1]) + + +def build_namespace_package(tmpdir, name, version="1.0", impl="pkg_resources"): + src_dir = tmpdir / name + src_dir.mkdir() + setup_py = src_dir / 'setup.py' + namespace, _, rest = name.rpartition('.') + namespaces = list(iter_namespace_pkgs(namespace)) + setup_args = { + "name": name, + "version": version, + "packages": namespaces, + } + + if impl == "pkg_resources": + tmpl = '__import__("pkg_resources").declare_namespace(__name__)' + setup_args["namespace_packages"] = namespaces + elif impl == "pkgutil": + tmpl = '__path__ = __import__("pkgutil").extend_path(__path__, __name__)' + else: + raise ValueError(f"Cannot recognise {impl=} when creating namespaces") + + args = json.dumps(setup_args, indent=4) + assert ast.literal_eval(args) # ensure it is valid Python + + script = textwrap.dedent( + """\ + import setuptools + args = {args} + setuptools.setup(**args) + """ + ).format(args=args) + setup_py.write_text(script, encoding='utf-8') + + ns_pkg_dir = Path(src_dir, namespace.replace(".", "/")) + ns_pkg_dir.mkdir(parents=True) + + for ns in namespaces: + pkg_init = src_dir / ns.replace(".", "/") / '__init__.py' + pkg_init.write_text(tmpl, encoding='utf-8') + + pkg_mod = ns_pkg_dir / (rest + '.py') + some_functionality = 'name = {rest!r}'.format(**locals()) + pkg_mod.write_text(some_functionality, encoding='utf-8') + return src_dir + + +def build_pep420_namespace_package(tmpdir, name): + src_dir = tmpdir / name + src_dir.mkdir() + pyproject = src_dir / "pyproject.toml" + namespace, _, rest = name.rpartition(".") + script = f"""\ + [build-system] + requires = ["setuptools"] + build-backend = "setuptools.build_meta" + + [project] + name = "{name}" + version = "3.14159" + """ + pyproject.write_text(textwrap.dedent(script), encoding='utf-8') + ns_pkg_dir = Path(src_dir, namespace.replace(".", "/")) + ns_pkg_dir.mkdir(parents=True) + pkg_mod = ns_pkg_dir / (rest + ".py") + some_functionality = f"name = {rest!r}" + pkg_mod.write_text(some_functionality, encoding='utf-8') + return src_dir + + +def make_site_dir(target): + """ + Add a sitecustomize.py module in target to cause + target to be added to site dirs such that .pth files + are processed there. + """ + sc = target / 'sitecustomize.py' + target_str = str(target) + tmpl = '__import__("site").addsitedir({target_str!r})' + sc.write_text(tmpl.format(**locals()), encoding='utf-8') diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/script-with-bom.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/script-with-bom.py new file mode 100644 index 000000000..c074d263c --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/script-with-bom.py @@ -0,0 +1 @@ +result = 'passed' diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_archive_util.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_archive_util.py new file mode 100644 index 000000000..e3efc6288 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_archive_util.py @@ -0,0 +1,36 @@ +import io +import tarfile + +import pytest + +from setuptools import archive_util + + +@pytest.fixture +def tarfile_with_unicode(tmpdir): + """ + Create a tarfile containing only a file whose name is + a zero byte file called testimäge.png. + """ + tarobj = io.BytesIO() + + with tarfile.open(fileobj=tarobj, mode="w:gz") as tgz: + data = b"" + + filename = "testimäge.png" + + t = tarfile.TarInfo(filename) + t.size = len(data) + + tgz.addfile(t, io.BytesIO(data)) + + target = tmpdir / 'unicode-pkg-1.0.tar.gz' + with open(str(target), mode='wb') as tf: + tf.write(tarobj.getvalue()) + return str(target) + + +@pytest.mark.xfail(reason="#710 and #712") +def test_unicode_files(tarfile_with_unicode, tmpdir): + target = tmpdir / 'out' + archive_util.unpack_archive(tarfile_with_unicode, str(target)) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_bdist_deprecations.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_bdist_deprecations.py new file mode 100644 index 000000000..d9d67b061 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_bdist_deprecations.py @@ -0,0 +1,28 @@ +"""develop tests""" + +import sys +from unittest import mock + +import pytest + +from setuptools import SetuptoolsDeprecationWarning +from setuptools.dist import Distribution + + +@pytest.mark.skipif(sys.platform == 'win32', reason='non-Windows only') +@pytest.mark.xfail(reason="bdist_rpm is long deprecated, should we remove it? #1988") +@mock.patch('distutils.command.bdist_rpm.bdist_rpm') +def test_bdist_rpm_warning(distutils_cmd, tmpdir_cwd): + dist = Distribution( + dict( + script_name='setup.py', + script_args=['bdist_rpm'], + name='foo', + py_modules=['hi'], + ) + ) + dist.parse_command_line() + with pytest.warns(SetuptoolsDeprecationWarning): + dist.run_commands() + + distutils_cmd.run.assert_called_once() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_bdist_egg.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_bdist_egg.py new file mode 100644 index 000000000..036167dd9 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_bdist_egg.py @@ -0,0 +1,73 @@ +"""develop tests""" + +import os +import re +import zipfile + +import pytest + +from setuptools.dist import Distribution + +from . import contexts + +SETUP_PY = """\ +from setuptools import setup + +setup(py_modules=['hi']) +""" + + +@pytest.fixture +def setup_context(tmpdir): + with (tmpdir / 'setup.py').open('w') as f: + f.write(SETUP_PY) + with (tmpdir / 'hi.py').open('w') as f: + f.write('1\n') + with tmpdir.as_cwd(): + yield tmpdir + + +class Test: + @pytest.mark.usefixtures("user_override") + @pytest.mark.usefixtures("setup_context") + def test_bdist_egg(self): + dist = Distribution( + dict( + script_name='setup.py', + script_args=['bdist_egg'], + name='foo', + py_modules=['hi'], + ) + ) + os.makedirs(os.path.join('build', 'src')) + with contexts.quiet(): + dist.parse_command_line() + dist.run_commands() + + # let's see if we got our egg link at the right place + [content] = os.listdir('dist') + assert re.match(r'foo-0.0.0-py[23].\d+.egg$', content) + + @pytest.mark.xfail( + os.environ.get('PYTHONDONTWRITEBYTECODE', False), + reason="Byte code disabled", + ) + @pytest.mark.usefixtures("user_override") + @pytest.mark.usefixtures("setup_context") + def test_exclude_source_files(self): + dist = Distribution( + dict( + script_name='setup.py', + script_args=['bdist_egg', '--exclude-source-files'], + py_modules=['hi'], + ) + ) + with contexts.quiet(): + dist.parse_command_line() + dist.run_commands() + [dist_name] = os.listdir('dist') + dist_filename = os.path.join('dist', dist_name) + zip = zipfile.ZipFile(dist_filename) + names = list(zi.filename for zi in zip.filelist) + assert 'hi.pyc' in names + assert 'hi.py' not in names diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_bdist_wheel.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_bdist_wheel.py new file mode 100644 index 000000000..2ab4e9cfc --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_bdist_wheel.py @@ -0,0 +1,708 @@ +from __future__ import annotations + +import builtins +import importlib +import os.path +import platform +import shutil +import stat +import struct +import sys +import sysconfig +from contextlib import suppress +from inspect import cleandoc +from zipfile import ZipFile + +import jaraco.path +import pytest +from packaging import tags + +import setuptools +from setuptools.command.bdist_wheel import bdist_wheel, get_abi_tag +from setuptools.dist import Distribution +from setuptools.warnings import SetuptoolsDeprecationWarning + +from distutils.core import run_setup + +DEFAULT_FILES = { + "dummy_dist-1.0.dist-info/top_level.txt", + "dummy_dist-1.0.dist-info/METADATA", + "dummy_dist-1.0.dist-info/WHEEL", + "dummy_dist-1.0.dist-info/RECORD", +} +DEFAULT_LICENSE_FILES = { + "LICENSE", + "LICENSE.txt", + "LICENCE", + "LICENCE.txt", + "COPYING", + "COPYING.md", + "NOTICE", + "NOTICE.rst", + "AUTHORS", + "AUTHORS.txt", +} +OTHER_IGNORED_FILES = { + "LICENSE~", + "AUTHORS~", +} +SETUPPY_EXAMPLE = """\ +from setuptools import setup + +setup( + name='dummy_dist', + version='1.0', +) +""" + + +EXAMPLES = { + "dummy-dist": { + "setup.py": SETUPPY_EXAMPLE, + "licenses_dir": {"DUMMYFILE": ""}, + **dict.fromkeys(DEFAULT_LICENSE_FILES | OTHER_IGNORED_FILES, ""), + }, + "simple-dist": { + "setup.py": cleandoc( + """ + from setuptools import setup + + setup( + name="simple.dist", + version="0.1", + description="A testing distribution \N{SNOWMAN}", + extras_require={"voting": ["beaglevote"]}, + ) + """ + ), + "simpledist": "", + }, + "complex-dist": { + "setup.py": cleandoc( + """ + from setuptools import setup + + setup( + name="complex-dist", + version="0.1", + description="Another testing distribution \N{SNOWMAN}", + long_description="Another testing distribution \N{SNOWMAN}", + author="Illustrious Author", + author_email="illustrious@example.org", + url="http://example.org/exemplary", + packages=["complexdist"], + setup_requires=["setuptools"], + install_requires=["quux", "splort"], + extras_require={"simple": ["simple.dist"]}, + entry_points={ + "console_scripts": [ + "complex-dist=complexdist:main", + "complex-dist2=complexdist:main", + ], + }, + ) + """ + ), + "complexdist": {"__init__.py": "def main(): return"}, + }, + "headers-dist": { + "setup.py": cleandoc( + """ + from setuptools import setup + + setup( + name="headers.dist", + version="0.1", + description="A distribution with headers", + headers=["header.h"], + ) + """ + ), + "headersdist.py": "", + "header.h": "", + }, + "commasinfilenames-dist": { + "setup.py": cleandoc( + """ + from setuptools import setup + + setup( + name="testrepo", + version="0.1", + packages=["mypackage"], + description="A test package with commas in file names", + include_package_data=True, + package_data={"mypackage.data": ["*"]}, + ) + """ + ), + "mypackage": { + "__init__.py": "", + "data": {"__init__.py": "", "1,2,3.txt": ""}, + }, + "testrepo-0.1.0": { + "mypackage": {"__init__.py": ""}, + }, + }, + "unicode-dist": { + "setup.py": cleandoc( + """ + from setuptools import setup + + setup( + name="unicode.dist", + version="0.1", + description="A testing distribution \N{SNOWMAN}", + packages=["unicodedist"], + zip_safe=True, + ) + """ + ), + "unicodedist": {"__init__.py": "", "åäö_日本語.py": ""}, + }, + "utf8-metadata-dist": { + "setup.cfg": cleandoc( + """ + [metadata] + name = utf8-metadata-dist + version = 42 + author_email = "John X. Ãørçeč" , Γαμα קּ 東 + long_description = file: README.rst + """ + ), + "README.rst": "UTF-8 描述 説明", + }, + "licenses-dist": { + "setup.cfg": cleandoc( + """ + [metadata] + name = licenses-dist + version = 1.0 + license_files = **/LICENSE + """ + ), + "LICENSE": "", + "src": { + "vendor": {"LICENSE": ""}, + }, + }, +} + + +if sys.platform != "win32": + # ABI3 extensions don't really work on Windows + EXAMPLES["abi3extension-dist"] = { + "setup.py": cleandoc( + """ + from setuptools import Extension, setup + + setup( + name="extension.dist", + version="0.1", + description="A testing distribution \N{SNOWMAN}", + ext_modules=[ + Extension( + name="extension", sources=["extension.c"], py_limited_api=True + ) + ], + ) + """ + ), + "setup.cfg": "[bdist_wheel]\npy_limited_api=cp32", + "extension.c": "#define Py_LIMITED_API 0x03020000\n#include ", + } + + +def bdist_wheel_cmd(**kwargs): + """Run command in the same process so that it is easier to collect coverage""" + dist_obj = ( + run_setup("setup.py", stop_after="init") + if os.path.exists("setup.py") + else Distribution({"script_name": "%%build_meta%%"}) + ) + dist_obj.parse_config_files() + cmd = bdist_wheel(dist_obj) + for attr, value in kwargs.items(): + setattr(cmd, attr, value) + cmd.finalize_options() + return cmd + + +def mkexample(tmp_path_factory, name): + basedir = tmp_path_factory.mktemp(name) + jaraco.path.build(EXAMPLES[name], prefix=str(basedir)) + return basedir + + +@pytest.fixture(scope="session") +def wheel_paths(tmp_path_factory): + build_base = tmp_path_factory.mktemp("build") + dist_dir = tmp_path_factory.mktemp("dist") + for name in EXAMPLES: + example_dir = mkexample(tmp_path_factory, name) + build_dir = build_base / name + with jaraco.path.DirectoryStack().context(example_dir): + bdist_wheel_cmd(bdist_dir=str(build_dir), dist_dir=str(dist_dir)).run() + + return sorted(str(fname) for fname in dist_dir.glob("*.whl")) + + +@pytest.fixture +def dummy_dist(tmp_path_factory): + return mkexample(tmp_path_factory, "dummy-dist") + + +@pytest.fixture +def licenses_dist(tmp_path_factory): + return mkexample(tmp_path_factory, "licenses-dist") + + +def test_no_scripts(wheel_paths): + """Make sure entry point scripts are not generated.""" + path = next(path for path in wheel_paths if "complex_dist" in path) + for entry in ZipFile(path).infolist(): + assert ".data/scripts/" not in entry.filename + + +def test_unicode_record(wheel_paths): + path = next(path for path in wheel_paths if "unicode_dist" in path) + with ZipFile(path) as zf: + record = zf.read("unicode_dist-0.1.dist-info/RECORD") + + assert "åäö_日本語.py".encode() in record + + +UTF8_PKG_INFO = """\ +Metadata-Version: 2.1 +Name: helloworld +Version: 42 +Author-email: "John X. Ãørçeč" , Γαμα קּ 東 + + +UTF-8 描述 説明 +""" + + +def test_preserve_unicode_metadata(monkeypatch, tmp_path): + monkeypatch.chdir(tmp_path) + egginfo = tmp_path / "dummy_dist.egg-info" + distinfo = tmp_path / "dummy_dist.dist-info" + + egginfo.mkdir() + (egginfo / "PKG-INFO").write_text(UTF8_PKG_INFO, encoding="utf-8") + (egginfo / "dependency_links.txt").touch() + + class simpler_bdist_wheel(bdist_wheel): + """Avoid messing with setuptools/distutils internals""" + + def __init__(self): + pass + + @property + def license_paths(self): + return [] + + cmd_obj = simpler_bdist_wheel() + cmd_obj.egg2dist(egginfo, distinfo) + + metadata = (distinfo / "METADATA").read_text(encoding="utf-8") + assert 'Author-email: "John X. Ãørçeč"' in metadata + assert "Γαμα קּ 東 " in metadata + assert "UTF-8 描述 説明" in metadata + + +def test_licenses_default(dummy_dist, monkeypatch, tmp_path): + monkeypatch.chdir(dummy_dist) + bdist_wheel_cmd(bdist_dir=str(tmp_path)).run() + with ZipFile("dist/dummy_dist-1.0-py3-none-any.whl") as wf: + license_files = { + "dummy_dist-1.0.dist-info/licenses/" + fname + for fname in DEFAULT_LICENSE_FILES + } + assert set(wf.namelist()) == DEFAULT_FILES | license_files + + +def test_licenses_deprecated(dummy_dist, monkeypatch, tmp_path): + dummy_dist.joinpath("setup.cfg").write_text( + "[metadata]\nlicense_file=licenses_dir/DUMMYFILE", encoding="utf-8" + ) + monkeypatch.chdir(dummy_dist) + + bdist_wheel_cmd(bdist_dir=str(tmp_path)).run() + + with ZipFile("dist/dummy_dist-1.0-py3-none-any.whl") as wf: + license_files = {"dummy_dist-1.0.dist-info/licenses/licenses_dir/DUMMYFILE"} + assert set(wf.namelist()) == DEFAULT_FILES | license_files + + +@pytest.mark.parametrize( + ("config_file", "config"), + [ + ("setup.cfg", "[metadata]\nlicense_files=licenses_dir/*\n LICENSE"), + ("setup.cfg", "[metadata]\nlicense_files=licenses_dir/*, LICENSE"), + ( + "setup.py", + SETUPPY_EXAMPLE.replace( + ")", " license_files=['licenses_dir/DUMMYFILE', 'LICENSE'])" + ), + ), + ], +) +def test_licenses_override(dummy_dist, monkeypatch, tmp_path, config_file, config): + dummy_dist.joinpath(config_file).write_text(config, encoding="utf-8") + monkeypatch.chdir(dummy_dist) + bdist_wheel_cmd(bdist_dir=str(tmp_path)).run() + with ZipFile("dist/dummy_dist-1.0-py3-none-any.whl") as wf: + license_files = { + "dummy_dist-1.0.dist-info/licenses/" + fname + for fname in {"licenses_dir/DUMMYFILE", "LICENSE"} + } + assert set(wf.namelist()) == DEFAULT_FILES | license_files + metadata = wf.read("dummy_dist-1.0.dist-info/METADATA").decode("utf8") + assert "License-File: licenses_dir/DUMMYFILE" in metadata + assert "License-File: LICENSE" in metadata + + +def test_licenses_preserve_folder_structure(licenses_dist, monkeypatch, tmp_path): + monkeypatch.chdir(licenses_dist) + bdist_wheel_cmd(bdist_dir=str(tmp_path)).run() + print(os.listdir("dist")) + with ZipFile("dist/licenses_dist-1.0-py3-none-any.whl") as wf: + default_files = {name.replace("dummy_", "licenses_") for name in DEFAULT_FILES} + license_files = { + "licenses_dist-1.0.dist-info/licenses/LICENSE", + "licenses_dist-1.0.dist-info/licenses/src/vendor/LICENSE", + } + assert set(wf.namelist()) == default_files | license_files + metadata = wf.read("licenses_dist-1.0.dist-info/METADATA").decode("utf8") + assert "License-File: src/vendor/LICENSE" in metadata + assert "License-File: LICENSE" in metadata + + +def test_licenses_disabled(dummy_dist, monkeypatch, tmp_path): + dummy_dist.joinpath("setup.cfg").write_text( + "[metadata]\nlicense_files=\n", encoding="utf-8" + ) + monkeypatch.chdir(dummy_dist) + bdist_wheel_cmd(bdist_dir=str(tmp_path)).run() + with ZipFile("dist/dummy_dist-1.0-py3-none-any.whl") as wf: + assert set(wf.namelist()) == DEFAULT_FILES + + +def test_build_number(dummy_dist, monkeypatch, tmp_path): + monkeypatch.chdir(dummy_dist) + bdist_wheel_cmd(bdist_dir=str(tmp_path), build_number="2").run() + with ZipFile("dist/dummy_dist-1.0-2-py3-none-any.whl") as wf: + filenames = set(wf.namelist()) + assert "dummy_dist-1.0.dist-info/RECORD" in filenames + assert "dummy_dist-1.0.dist-info/METADATA" in filenames + + +def test_universal_deprecated(dummy_dist, monkeypatch, tmp_path): + monkeypatch.chdir(dummy_dist) + with pytest.warns(SetuptoolsDeprecationWarning, match=".*universal is deprecated"): + bdist_wheel_cmd(bdist_dir=str(tmp_path), universal=True).run() + + # For now we still respect the option + assert os.path.exists("dist/dummy_dist-1.0-py2.py3-none-any.whl") + + +EXTENSION_EXAMPLE = """\ +#include + +static PyMethodDef methods[] = { + { NULL, NULL, 0, NULL } +}; + +static struct PyModuleDef module_def = { + PyModuleDef_HEAD_INIT, + "extension", + "Dummy extension module", + -1, + methods +}; + +PyMODINIT_FUNC PyInit_extension(void) { + return PyModule_Create(&module_def); +} +""" +EXTENSION_SETUPPY = """\ +from __future__ import annotations + +from setuptools import Extension, setup + +setup( + name="extension.dist", + version="0.1", + description="A testing distribution \N{SNOWMAN}", + ext_modules=[Extension(name="extension", sources=["extension.c"])], +) +""" + + +@pytest.mark.filterwarnings( + "once:Config variable '.*' is unset.*, Python ABI tag may be incorrect" +) +def test_limited_abi(monkeypatch, tmp_path, tmp_path_factory): + """Test that building a binary wheel with the limited ABI works.""" + source_dir = tmp_path_factory.mktemp("extension_dist") + (source_dir / "setup.py").write_text(EXTENSION_SETUPPY, encoding="utf-8") + (source_dir / "extension.c").write_text(EXTENSION_EXAMPLE, encoding="utf-8") + build_dir = tmp_path.joinpath("build") + dist_dir = tmp_path.joinpath("dist") + monkeypatch.chdir(source_dir) + bdist_wheel_cmd(bdist_dir=str(build_dir), dist_dir=str(dist_dir)).run() + + +def test_build_from_readonly_tree(dummy_dist, monkeypatch, tmp_path): + basedir = str(tmp_path.joinpath("dummy")) + shutil.copytree(str(dummy_dist), basedir) + monkeypatch.chdir(basedir) + + # Make the tree read-only + for root, _dirs, files in os.walk(basedir): + for fname in files: + os.chmod(os.path.join(root, fname), stat.S_IREAD) + + bdist_wheel_cmd().run() + + +@pytest.mark.parametrize( + ("option", "compress_type"), + list(bdist_wheel.supported_compressions.items()), + ids=list(bdist_wheel.supported_compressions), +) +def test_compression(dummy_dist, monkeypatch, tmp_path, option, compress_type): + monkeypatch.chdir(dummy_dist) + bdist_wheel_cmd(bdist_dir=str(tmp_path), compression=option).run() + with ZipFile("dist/dummy_dist-1.0-py3-none-any.whl") as wf: + filenames = set(wf.namelist()) + assert "dummy_dist-1.0.dist-info/RECORD" in filenames + assert "dummy_dist-1.0.dist-info/METADATA" in filenames + for zinfo in wf.filelist: + assert zinfo.compress_type == compress_type + + +def test_wheelfile_line_endings(wheel_paths): + for path in wheel_paths: + with ZipFile(path) as wf: + wheelfile = next(fn for fn in wf.filelist if fn.filename.endswith("WHEEL")) + wheelfile_contents = wf.read(wheelfile) + assert b"\r" not in wheelfile_contents + + +def test_unix_epoch_timestamps(dummy_dist, monkeypatch, tmp_path): + monkeypatch.setenv("SOURCE_DATE_EPOCH", "0") + monkeypatch.chdir(dummy_dist) + bdist_wheel_cmd(bdist_dir=str(tmp_path), build_number="2a").run() + with ZipFile("dist/dummy_dist-1.0-2a-py3-none-any.whl") as wf: + for zinfo in wf.filelist: + assert zinfo.date_time >= (1980, 1, 1, 0, 0, 0) # min epoch is used + + +def test_get_abi_tag_windows(monkeypatch): + monkeypatch.setattr(tags, "interpreter_name", lambda: "cp") + monkeypatch.setattr(sysconfig, "get_config_var", lambda x: "cp313-win_amd64") + assert get_abi_tag() == "cp313" + monkeypatch.setattr(sys, "gettotalrefcount", lambda: 1, False) + assert get_abi_tag() == "cp313d" + monkeypatch.setattr(sysconfig, "get_config_var", lambda x: "cp313t-win_amd64") + assert get_abi_tag() == "cp313td" + monkeypatch.delattr(sys, "gettotalrefcount") + assert get_abi_tag() == "cp313t" + + +def test_get_abi_tag_pypy_old(monkeypatch): + monkeypatch.setattr(tags, "interpreter_name", lambda: "pp") + monkeypatch.setattr(sysconfig, "get_config_var", lambda x: "pypy36-pp73") + assert get_abi_tag() == "pypy36_pp73" + + +def test_get_abi_tag_pypy_new(monkeypatch): + monkeypatch.setattr(sysconfig, "get_config_var", lambda x: "pypy37-pp73-darwin") + monkeypatch.setattr(tags, "interpreter_name", lambda: "pp") + assert get_abi_tag() == "pypy37_pp73" + + +def test_get_abi_tag_graalpy(monkeypatch): + monkeypatch.setattr( + sysconfig, "get_config_var", lambda x: "graalpy231-310-native-x86_64-linux" + ) + monkeypatch.setattr(tags, "interpreter_name", lambda: "graalpy") + assert get_abi_tag() == "graalpy231_310_native" + + +def test_get_abi_tag_fallback(monkeypatch): + monkeypatch.setattr(sysconfig, "get_config_var", lambda x: "unknown-python-310") + monkeypatch.setattr(tags, "interpreter_name", lambda: "unknown-python") + assert get_abi_tag() == "unknown_python_310" + + +def test_platform_with_space(dummy_dist, monkeypatch): + """Ensure building on platforms with a space in the name succeed.""" + monkeypatch.chdir(dummy_dist) + bdist_wheel_cmd(plat_name="isilon onefs").run() + + +def test_data_dir_with_tag_build(monkeypatch, tmp_path): + """ + Setuptools allow authors to set PEP 440's local version segments + using ``egg_info.tag_build``. This should be reflected not only in the + ``.whl`` file name, but also in the ``.dist-info`` and ``.data`` dirs. + See pypa/setuptools#3997. + """ + monkeypatch.chdir(tmp_path) + files = { + "setup.py": """ + from setuptools import setup + setup(headers=["hello.h"]) + """, + "setup.cfg": """ + [metadata] + name = test + version = 1.0 + + [options.data_files] + hello/world = file.txt + + [egg_info] + tag_build = +what + tag_date = 0 + """, + "file.txt": "", + "hello.h": "", + } + for file, content in files.items(): + with open(file, "w", encoding="utf-8") as fh: + fh.write(cleandoc(content)) + + bdist_wheel_cmd().run() + + # Ensure .whl, .dist-info and .data contain the local segment + wheel_path = "dist/test-1.0+what-py3-none-any.whl" + assert os.path.exists(wheel_path) + entries = set(ZipFile(wheel_path).namelist()) + for expected in ( + "test-1.0+what.data/headers/hello.h", + "test-1.0+what.data/data/hello/world/file.txt", + "test-1.0+what.dist-info/METADATA", + "test-1.0+what.dist-info/WHEEL", + ): + assert expected in entries + + for not_expected in ( + "test.data/headers/hello.h", + "test-1.0.data/data/hello/world/file.txt", + "test.dist-info/METADATA", + "test-1.0.dist-info/WHEEL", + ): + assert not_expected not in entries + + +@pytest.mark.parametrize( + ("reported", "expected"), + [("linux-x86_64", "linux_i686"), ("linux-aarch64", "linux_armv7l")], +) +@pytest.mark.skipif( + platform.system() != "Linux", reason="Only makes sense to test on Linux" +) +def test_platform_linux32(reported, expected, monkeypatch): + monkeypatch.setattr(struct, "calcsize", lambda x: 4) + dist = setuptools.Distribution() + cmd = bdist_wheel(dist) + cmd.plat_name = reported + cmd.root_is_pure = False + _, _, actual = cmd.get_tag() + assert actual == expected + + +def test_no_ctypes(monkeypatch) -> None: + def _fake_import(name: str, *args, **kwargs): + if name == "ctypes": + raise ModuleNotFoundError(f"No module named {name}") + + return importlib.__import__(name, *args, **kwargs) + + with suppress(KeyError): + monkeypatch.delitem(sys.modules, "wheel.macosx_libfile") + + # Install an importer shim that refuses to load ctypes + monkeypatch.setattr(builtins, "__import__", _fake_import) + with pytest.raises(ModuleNotFoundError, match="No module named ctypes"): + import wheel.macosx_libfile # noqa: F401 + + # Unload and reimport the bdist_wheel command module to make sure it won't try to + # import ctypes + monkeypatch.delitem(sys.modules, "setuptools.command.bdist_wheel") + + import setuptools.command.bdist_wheel # noqa: F401 + + +def test_dist_info_provided(dummy_dist, monkeypatch, tmp_path): + monkeypatch.chdir(dummy_dist) + distinfo = tmp_path / "dummy_dist.dist-info" + + distinfo.mkdir() + (distinfo / "METADATA").write_text("name: helloworld", encoding="utf-8") + + # We don't control the metadata. According to PEP-517, "The hook MAY also + # create other files inside this directory, and a build frontend MUST + # preserve". + (distinfo / "FOO").write_text("bar", encoding="utf-8") + + bdist_wheel_cmd(bdist_dir=str(tmp_path), dist_info_dir=str(distinfo)).run() + expected = { + "dummy_dist-1.0.dist-info/FOO", + "dummy_dist-1.0.dist-info/RECORD", + } + with ZipFile("dist/dummy_dist-1.0-py3-none-any.whl") as wf: + files_found = set(wf.namelist()) + # Check that all expected files are there. + assert expected - files_found == set() + # Make sure there is no accidental egg-info bleeding into the wheel. + assert not [path for path in files_found if 'egg-info' in str(path)] + + +def test_allow_grace_period_parent_directory_license(monkeypatch, tmp_path): + # Motivation: https://github.com/pypa/setuptools/issues/4892 + # TODO: Remove this test after deprecation period is over + files = { + "LICENSE.txt": "parent license", # <---- the license files are outside + "NOTICE.txt": "parent notice", + "python": { + "pyproject.toml": cleandoc( + """ + [project] + name = "test-proj" + dynamic = ["version"] # <---- testing dynamic will not break + [tool.setuptools.dynamic] + version.file = "VERSION" + """ + ), + "setup.cfg": cleandoc( + """ + [metadata] + license_files = + ../LICENSE.txt + ../NOTICE.txt + """ + ), + "VERSION": "42", + }, + } + jaraco.path.build(files, prefix=str(tmp_path)) + monkeypatch.chdir(tmp_path / "python") + msg = "Pattern '../.*.txt' cannot contain '..'" + with pytest.warns(SetuptoolsDeprecationWarning, match=msg): + bdist_wheel_cmd().run() + with ZipFile("dist/test_proj-42-py3-none-any.whl") as wf: + files_found = set(wf.namelist()) + expected_files = { + "test_proj-42.dist-info/licenses/LICENSE.txt", + "test_proj-42.dist-info/licenses/NOTICE.txt", + } + assert expected_files <= files_found + + metadata = wf.read("test_proj-42.dist-info/METADATA").decode("utf8") + assert "License-File: LICENSE.txt" in metadata + assert "License-File: NOTICE.txt" in metadata diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build.py new file mode 100644 index 000000000..f0f1d9dcf --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build.py @@ -0,0 +1,33 @@ +from setuptools import Command +from setuptools.command.build import build +from setuptools.dist import Distribution + + +def test_distribution_gives_setuptools_build_obj(tmpdir_cwd): + """ + Check that the setuptools Distribution uses the + setuptools specific build object. + """ + + dist = Distribution( + dict( + script_name='setup.py', + script_args=['build'], + packages=[], + package_data={'': ['path/*']}, + ) + ) + assert isinstance(dist.get_command_obj("build"), build) + + +class Subcommand(Command): + """Dummy command to be used in tests""" + + def initialize_options(self): + pass + + def finalize_options(self): + pass + + def run(self): + raise NotImplementedError("just to check if the command runs") diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_clib.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_clib.py new file mode 100644 index 000000000..b5315df4f --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_clib.py @@ -0,0 +1,84 @@ +import random +from unittest import mock + +import pytest + +from setuptools.command.build_clib import build_clib +from setuptools.dist import Distribution + +from distutils.errors import DistutilsSetupError + + +class TestBuildCLib: + @mock.patch('setuptools.command.build_clib.newer_pairwise_group') + def test_build_libraries(self, mock_newer): + dist = Distribution() + cmd = build_clib(dist) + + # this will be a long section, just making sure all + # exceptions are properly raised + libs = [('example', {'sources': 'broken.c'})] + with pytest.raises(DistutilsSetupError): + cmd.build_libraries(libs) + + obj_deps = 'some_string' + libs = [('example', {'sources': ['source.c'], 'obj_deps': obj_deps})] + with pytest.raises(DistutilsSetupError): + cmd.build_libraries(libs) + + obj_deps = {'': ''} + libs = [('example', {'sources': ['source.c'], 'obj_deps': obj_deps})] + with pytest.raises(DistutilsSetupError): + cmd.build_libraries(libs) + + obj_deps = {'source.c': ''} + libs = [('example', {'sources': ['source.c'], 'obj_deps': obj_deps})] + with pytest.raises(DistutilsSetupError): + cmd.build_libraries(libs) + + # with that out of the way, let's see if the crude dependency + # system works + cmd.compiler = mock.MagicMock(spec=cmd.compiler) + mock_newer.return_value = ([], []) + + obj_deps = {'': ('global.h',), 'example.c': ('example.h',)} + libs = [('example', {'sources': ['example.c'], 'obj_deps': obj_deps})] + + cmd.build_libraries(libs) + assert [['example.c', 'global.h', 'example.h']] in mock_newer.call_args[0] + assert not cmd.compiler.compile.called + assert cmd.compiler.create_static_lib.call_count == 1 + + # reset the call numbers so we can test again + cmd.compiler.reset_mock() + + mock_newer.return_value = '' # anything as long as it's not ([],[]) + cmd.build_libraries(libs) + assert cmd.compiler.compile.call_count == 1 + assert cmd.compiler.create_static_lib.call_count == 1 + + @mock.patch('setuptools.command.build_clib.newer_pairwise_group') + def test_build_libraries_reproducible(self, mock_newer): + dist = Distribution() + cmd = build_clib(dist) + + # with that out of the way, let's see if the crude dependency + # system works + cmd.compiler = mock.MagicMock(spec=cmd.compiler) + mock_newer.return_value = ([], []) + + original_sources = ['a-example.c', 'example.c'] + sources = original_sources + + obj_deps = {'': ('global.h',), 'example.c': ('example.h',)} + libs = [('example', {'sources': sources, 'obj_deps': obj_deps})] + + cmd.build_libraries(libs) + computed_call_args = mock_newer.call_args[0] + + while sources == original_sources: + sources = random.sample(original_sources, len(original_sources)) + libs = [('example', {'sources': sources, 'obj_deps': obj_deps})] + + cmd.build_libraries(libs) + assert computed_call_args == mock_newer.call_args[0] diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_ext.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_ext.py new file mode 100644 index 000000000..c7b60ac32 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_ext.py @@ -0,0 +1,293 @@ +from __future__ import annotations + +import os +import sys +from importlib.util import cache_from_source as _compiled_file_name + +import pytest +from jaraco import path + +from setuptools.command.build_ext import build_ext, get_abi3_suffix +from setuptools.dist import Distribution +from setuptools.errors import CompileError +from setuptools.extension import Extension + +from . import environment +from .textwrap import DALS + +import distutils.command.build_ext as orig +from distutils.sysconfig import get_config_var + +IS_PYPY = '__pypy__' in sys.builtin_module_names + + +class TestBuildExt: + def test_get_ext_filename(self): + """ + Setuptools needs to give back the same + result as distutils, even if the fullname + is not in ext_map. + """ + dist = Distribution() + cmd = build_ext(dist) + cmd.ext_map['foo/bar'] = '' + res = cmd.get_ext_filename('foo') + wanted = orig.build_ext.get_ext_filename(cmd, 'foo') + assert res == wanted + + def test_abi3_filename(self): + """ + Filename needs to be loadable by several versions + of Python 3 if 'is_abi3' is truthy on Extension() + """ + print(get_abi3_suffix()) + + extension = Extension('spam.eggs', ['eggs.c'], py_limited_api=True) + dist = Distribution(dict(ext_modules=[extension])) + cmd = build_ext(dist) + cmd.finalize_options() + assert 'spam.eggs' in cmd.ext_map + res = cmd.get_ext_filename('spam.eggs') + + if not get_abi3_suffix(): + assert res.endswith(get_config_var('EXT_SUFFIX')) + elif sys.platform == 'win32': + assert res.endswith('eggs.pyd') + else: + assert 'abi3' in res + + def test_ext_suffix_override(self): + """ + SETUPTOOLS_EXT_SUFFIX variable always overrides + default extension options. + """ + dist = Distribution() + cmd = build_ext(dist) + cmd.ext_map['for_abi3'] = ext = Extension( + 'for_abi3', + ['s.c'], + # Override shouldn't affect abi3 modules + py_limited_api=True, + ) + # Mock value needed to pass tests + ext._links_to_dynamic = False + + if not IS_PYPY: + expect = cmd.get_ext_filename('for_abi3') + else: + # PyPy builds do not use ABI3 tag, so they will + # also get the overridden suffix. + expect = 'for_abi3.test-suffix' + + try: + os.environ['SETUPTOOLS_EXT_SUFFIX'] = '.test-suffix' + res = cmd.get_ext_filename('normal') + assert 'normal.test-suffix' == res + res = cmd.get_ext_filename('for_abi3') + assert expect == res + finally: + del os.environ['SETUPTOOLS_EXT_SUFFIX'] + + def dist_with_example(self): + files = { + "src": {"mypkg": {"subpkg": {"ext2.c": ""}}}, + "c-extensions": {"ext1": {"main.c": ""}}, + } + + ext1 = Extension("mypkg.ext1", ["c-extensions/ext1/main.c"]) + ext2 = Extension("mypkg.subpkg.ext2", ["src/mypkg/subpkg/ext2.c"]) + ext3 = Extension("ext3", ["c-extension/ext3.c"]) + + path.build(files) + return Distribution({ + "script_name": "%test%", + "ext_modules": [ext1, ext2, ext3], + "package_dir": {"": "src"}, + }) + + def test_get_outputs(self, tmpdir_cwd, monkeypatch): + monkeypatch.setenv('SETUPTOOLS_EXT_SUFFIX', '.mp3') # make test OS-independent + monkeypatch.setattr('setuptools.command.build_ext.use_stubs', False) + dist = self.dist_with_example() + + # Regular build: get_outputs not empty, but get_output_mappings is empty + build_ext = dist.get_command_obj("build_ext") + build_ext.editable_mode = False + build_ext.ensure_finalized() + build_lib = build_ext.build_lib.replace(os.sep, "/") + outputs = [x.replace(os.sep, "/") for x in build_ext.get_outputs()] + assert outputs == [ + f"{build_lib}/ext3.mp3", + f"{build_lib}/mypkg/ext1.mp3", + f"{build_lib}/mypkg/subpkg/ext2.mp3", + ] + assert build_ext.get_output_mapping() == {} + + # Editable build: get_output_mappings should contain everything in get_outputs + dist.reinitialize_command("build_ext") + build_ext.editable_mode = True + build_ext.ensure_finalized() + mapping = { + k.replace(os.sep, "/"): v.replace(os.sep, "/") + for k, v in build_ext.get_output_mapping().items() + } + assert mapping == { + f"{build_lib}/ext3.mp3": "src/ext3.mp3", + f"{build_lib}/mypkg/ext1.mp3": "src/mypkg/ext1.mp3", + f"{build_lib}/mypkg/subpkg/ext2.mp3": "src/mypkg/subpkg/ext2.mp3", + } + + def test_get_output_mapping_with_stub(self, tmpdir_cwd, monkeypatch): + monkeypatch.setenv('SETUPTOOLS_EXT_SUFFIX', '.mp3') # make test OS-independent + monkeypatch.setattr('setuptools.command.build_ext.use_stubs', True) + dist = self.dist_with_example() + + # Editable build should create compiled stubs (.pyc files only, no .py) + build_ext = dist.get_command_obj("build_ext") + build_ext.editable_mode = True + build_ext.ensure_finalized() + for ext in build_ext.extensions: + monkeypatch.setattr(ext, "_needs_stub", True) + + build_lib = build_ext.build_lib.replace(os.sep, "/") + mapping = { + k.replace(os.sep, "/"): v.replace(os.sep, "/") + for k, v in build_ext.get_output_mapping().items() + } + + def C(file): + """Make it possible to do comparisons and tests in a OS-independent way""" + return _compiled_file_name(file).replace(os.sep, "/") + + assert mapping == { + C(f"{build_lib}/ext3.py"): C("src/ext3.py"), + f"{build_lib}/ext3.mp3": "src/ext3.mp3", + C(f"{build_lib}/mypkg/ext1.py"): C("src/mypkg/ext1.py"), + f"{build_lib}/mypkg/ext1.mp3": "src/mypkg/ext1.mp3", + C(f"{build_lib}/mypkg/subpkg/ext2.py"): C("src/mypkg/subpkg/ext2.py"), + f"{build_lib}/mypkg/subpkg/ext2.mp3": "src/mypkg/subpkg/ext2.mp3", + } + + # Ensure only the compiled stubs are present not the raw .py stub + assert f"{build_lib}/mypkg/ext1.py" not in mapping + assert f"{build_lib}/mypkg/subpkg/ext2.py" not in mapping + + # Visualize what the cached stub files look like + example_stub = C(f"{build_lib}/mypkg/ext1.py") + assert example_stub in mapping + assert example_stub.startswith(f"{build_lib}/mypkg/__pycache__/ext1") + assert example_stub.endswith(".pyc") + + +class TestBuildExtInplace: + def get_build_ext_cmd(self, optional: bool, **opts) -> build_ext: + files: dict[str, str | dict[str, dict[str, str]]] = { + "eggs.c": "#include missingheader.h\n", + ".build": {"lib": {}, "tmp": {}}, + } + path.build(files) + extension = Extension('spam.eggs', ['eggs.c'], optional=optional) + dist = Distribution(dict(ext_modules=[extension])) + dist.script_name = 'setup.py' + cmd = build_ext(dist) + vars(cmd).update(build_lib=".build/lib", build_temp=".build/tmp", **opts) + cmd.ensure_finalized() + return cmd + + def get_log_messages(self, caplog, capsys): + """ + Historically, distutils "logged" by printing to sys.std*. + Later versions adopted the logging framework. Grab + messages regardless of how they were captured. + """ + std = capsys.readouterr() + return std.out.splitlines() + std.err.splitlines() + caplog.messages + + def test_optional(self, tmpdir_cwd, caplog, capsys): + """ + If optional extensions fail to build, setuptools should show the error + in the logs but not fail to build + """ + cmd = self.get_build_ext_cmd(optional=True, inplace=True) + cmd.run() + assert any( + 'build_ext: building extension "spam.eggs" failed' + for msg in self.get_log_messages(caplog, capsys) + ) + # No compile error exception should be raised + + def test_non_optional(self, tmpdir_cwd): + # Non-optional extensions should raise an exception + cmd = self.get_build_ext_cmd(optional=False, inplace=True) + with pytest.raises(CompileError): + cmd.run() + + +def test_build_ext_config_handling(tmpdir_cwd): + files = { + 'setup.py': DALS( + """ + from setuptools import Extension, setup + setup( + name='foo', + version='0.0.0', + ext_modules=[Extension('foo', ['foo.c'])], + ) + """ + ), + 'foo.c': DALS( + """ + #include "Python.h" + + #if PY_MAJOR_VERSION >= 3 + + static struct PyModuleDef moduledef = { + PyModuleDef_HEAD_INIT, + "foo", + NULL, + 0, + NULL, + NULL, + NULL, + NULL, + NULL + }; + + #define INITERROR return NULL + + PyMODINIT_FUNC PyInit_foo(void) + + #else + + #define INITERROR return + + void initfoo(void) + + #endif + { + #if PY_MAJOR_VERSION >= 3 + PyObject *module = PyModule_Create(&moduledef); + #else + PyObject *module = Py_InitModule("extension", NULL); + #endif + if (module == NULL) + INITERROR; + #if PY_MAJOR_VERSION >= 3 + return module; + #endif + } + """ + ), + 'setup.cfg': DALS( + """ + [build] + build_base = foo_build + """ + ), + } + path.build(files) + code, (stdout, stderr) = environment.run_setup_py( + cmd=['build'], + data_stream=(0, 2), + ) + assert code == 0, f'\nSTDOUT:\n{stdout}\nSTDERR:\n{stderr}' diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_meta.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_meta.py new file mode 100644 index 000000000..57162fd6a --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_meta.py @@ -0,0 +1,959 @@ +import contextlib +import importlib +import os +import re +import shutil +import signal +import sys +import tarfile +import warnings +from concurrent import futures +from pathlib import Path +from typing import Any, Callable +from zipfile import ZipFile + +import pytest +from jaraco import path +from packaging.requirements import Requirement + +from setuptools.warnings import SetuptoolsDeprecationWarning + +from .textwrap import DALS + +SETUP_SCRIPT_STUB = "__import__('setuptools').setup()" + + +TIMEOUT = int(os.getenv("TIMEOUT_BACKEND_TEST", "180")) # in seconds +IS_PYPY = '__pypy__' in sys.builtin_module_names + + +pytestmark = pytest.mark.skipif( + sys.platform == "win32" and IS_PYPY, + reason="The combination of PyPy + Windows + pytest-xdist + ProcessPoolExecutor " + "is flaky and problematic", +) + + +class BuildBackendBase: + def __init__(self, cwd='.', env=None, backend_name='setuptools.build_meta'): + self.cwd = cwd + self.env = env or {} + self.backend_name = backend_name + + +class BuildBackend(BuildBackendBase): + """PEP 517 Build Backend""" + + def __init__(self, *args, **kwargs): + super().__init__(*args, **kwargs) + self.pool = futures.ProcessPoolExecutor(max_workers=1) + + def __getattr__(self, name: str) -> Callable[..., Any]: + """Handles arbitrary function invocations on the build backend.""" + + def method(*args, **kw): + root = os.path.abspath(self.cwd) + caller = BuildBackendCaller(root, self.env, self.backend_name) + pid = None + try: + pid = self.pool.submit(os.getpid).result(TIMEOUT) + return self.pool.submit(caller, name, *args, **kw).result(TIMEOUT) + except futures.TimeoutError: + self.pool.shutdown(wait=False) # doesn't stop already running processes + self._kill(pid) + pytest.xfail(f"Backend did not respond before timeout ({TIMEOUT} s)") + except (futures.process.BrokenProcessPool, MemoryError, OSError): + if IS_PYPY: + pytest.xfail("PyPy frequently fails tests with ProcessPoolExector") + raise + + return method + + def _kill(self, pid): + if pid is None: + return + with contextlib.suppress(ProcessLookupError, OSError): + os.kill(pid, signal.SIGTERM if os.name == "nt" else signal.SIGKILL) + + +class BuildBackendCaller(BuildBackendBase): + def __init__(self, *args, **kwargs): + super().__init__(*args, **kwargs) + + (self.backend_name, _, self.backend_obj) = self.backend_name.partition(':') + + def __call__(self, name, *args, **kw): + """Handles arbitrary function invocations on the build backend.""" + os.chdir(self.cwd) + os.environ.update(self.env) + mod = importlib.import_module(self.backend_name) + + if self.backend_obj: + backend = getattr(mod, self.backend_obj) + else: + backend = mod + + return getattr(backend, name)(*args, **kw) + + +defns = [ + { # simple setup.py script + 'setup.py': DALS( + """ + __import__('setuptools').setup( + name='foo', + version='0.0.0', + py_modules=['hello'], + setup_requires=['six'], + ) + """ + ), + 'hello.py': DALS( + """ + def run(): + print('hello') + """ + ), + }, + { # setup.py that relies on __name__ + 'setup.py': DALS( + """ + assert __name__ == '__main__' + __import__('setuptools').setup( + name='foo', + version='0.0.0', + py_modules=['hello'], + setup_requires=['six'], + ) + """ + ), + 'hello.py': DALS( + """ + def run(): + print('hello') + """ + ), + }, + { # setup.py script that runs arbitrary code + 'setup.py': DALS( + """ + variable = True + def function(): + return variable + assert variable + __import__('setuptools').setup( + name='foo', + version='0.0.0', + py_modules=['hello'], + setup_requires=['six'], + ) + """ + ), + 'hello.py': DALS( + """ + def run(): + print('hello') + """ + ), + }, + { # setup.py script that constructs temp files to be included in the distribution + 'setup.py': DALS( + """ + # Some packages construct files on the fly, include them in the package, + # and immediately remove them after `setup()` (e.g. pybind11==2.9.1). + # Therefore, we cannot use `distutils.core.run_setup(..., stop_after=...)` + # to obtain a distribution object first, and then run the distutils + # commands later, because these files will be removed in the meantime. + + with open('world.py', 'w', encoding="utf-8") as f: + f.write('x = 42') + + try: + __import__('setuptools').setup( + name='foo', + version='0.0.0', + py_modules=['world'], + setup_requires=['six'], + ) + finally: + # Some packages will clean temporary files + __import__('os').unlink('world.py') + """ + ), + }, + { # setup.cfg only + 'setup.cfg': DALS( + """ + [metadata] + name = foo + version = 0.0.0 + + [options] + py_modules=hello + setup_requires=six + """ + ), + 'hello.py': DALS( + """ + def run(): + print('hello') + """ + ), + }, + { # setup.cfg and setup.py + 'setup.cfg': DALS( + """ + [metadata] + name = foo + version = 0.0.0 + + [options] + py_modules=hello + setup_requires=six + """ + ), + 'setup.py': "__import__('setuptools').setup()", + 'hello.py': DALS( + """ + def run(): + print('hello') + """ + ), + }, +] + + +class TestBuildMetaBackend: + backend_name = 'setuptools.build_meta' + + def get_build_backend(self): + return BuildBackend(backend_name=self.backend_name) + + @pytest.fixture(params=defns) + def build_backend(self, tmpdir, request): + path.build(request.param, prefix=str(tmpdir)) + with tmpdir.as_cwd(): + yield self.get_build_backend() + + def test_get_requires_for_build_wheel(self, build_backend): + actual = build_backend.get_requires_for_build_wheel() + expected = ['six'] + assert sorted(actual) == sorted(expected) + + def test_get_requires_for_build_sdist(self, build_backend): + actual = build_backend.get_requires_for_build_sdist() + expected = ['six'] + assert sorted(actual) == sorted(expected) + + def test_build_wheel(self, build_backend): + dist_dir = os.path.abspath('pip-wheel') + os.makedirs(dist_dir) + wheel_name = build_backend.build_wheel(dist_dir) + + wheel_file = os.path.join(dist_dir, wheel_name) + assert os.path.isfile(wheel_file) + + # Temporary files should be removed + assert not os.path.isfile('world.py') + + with ZipFile(wheel_file) as zipfile: + wheel_contents = set(zipfile.namelist()) + + # Each one of the examples have a single module + # that should be included in the distribution + python_scripts = (f for f in wheel_contents if f.endswith('.py')) + modules = [f for f in python_scripts if not f.endswith('setup.py')] + assert len(modules) == 1 + + @pytest.mark.parametrize('build_type', ('wheel', 'sdist')) + def test_build_with_existing_file_present(self, build_type, tmpdir_cwd): + # Building a sdist/wheel should still succeed if there's + # already a sdist/wheel in the destination directory. + files = { + 'setup.py': "from setuptools import setup\nsetup()", + 'VERSION': "0.0.1", + 'setup.cfg': DALS( + """ + [metadata] + name = foo + version = file: VERSION + """ + ), + 'pyproject.toml': DALS( + """ + [build-system] + requires = ["setuptools", "wheel"] + build-backend = "setuptools.build_meta" + """ + ), + } + + path.build(files) + + dist_dir = os.path.abspath('preexisting-' + build_type) + + build_backend = self.get_build_backend() + build_method = getattr(build_backend, 'build_' + build_type) + + # Build a first sdist/wheel. + # Note: this also check the destination directory is + # successfully created if it does not exist already. + first_result = build_method(dist_dir) + + # Change version. + with open("VERSION", "wt", encoding="utf-8") as version_file: + version_file.write("0.0.2") + + # Build a *second* sdist/wheel. + second_result = build_method(dist_dir) + + assert os.path.isfile(os.path.join(dist_dir, first_result)) + assert first_result != second_result + + # And if rebuilding the exact same sdist/wheel? + open(os.path.join(dist_dir, second_result), 'wb').close() + third_result = build_method(dist_dir) + assert third_result == second_result + assert os.path.getsize(os.path.join(dist_dir, third_result)) > 0 + + @pytest.mark.parametrize("setup_script", [None, SETUP_SCRIPT_STUB]) + def test_build_with_pyproject_config(self, tmpdir, setup_script): + files = { + 'pyproject.toml': DALS( + """ + [build-system] + requires = ["setuptools", "wheel"] + build-backend = "setuptools.build_meta" + + [project] + name = "foo" + license = {text = "MIT"} + description = "This is a Python package" + dynamic = ["version", "readme"] + classifiers = [ + "Development Status :: 5 - Production/Stable", + "Intended Audience :: Developers" + ] + urls = {Homepage = "http://github.com"} + dependencies = [ + "appdirs", + ] + + [project.optional-dependencies] + all = [ + "tomli>=1", + "pyscaffold>=4,<5", + 'importlib; python_version == "2.6"', + ] + + [project.scripts] + foo = "foo.cli:main" + + [tool.setuptools] + zip-safe = false + package-dir = {"" = "src"} + packages = {find = {where = ["src"]}} + license-files = ["LICENSE*"] + + [tool.setuptools.dynamic] + version = {attr = "foo.__version__"} + readme = {file = "README.rst"} + + [tool.distutils.sdist] + formats = "gztar" + """ + ), + "MANIFEST.in": DALS( + """ + global-include *.py *.txt + global-exclude *.py[cod] + """ + ), + "README.rst": "This is a ``README``", + "LICENSE.txt": "---- placeholder MIT license ----", + "src": { + "foo": { + "__init__.py": "__version__ = '0.1'", + "__init__.pyi": "__version__: str", + "cli.py": "def main(): print('hello world')", + "data.txt": "def main(): print('hello world')", + "py.typed": "", + } + }, + } + if setup_script: + files["setup.py"] = setup_script + + build_backend = self.get_build_backend() + with tmpdir.as_cwd(): + path.build(files) + msgs = [ + "'tool.setuptools.license-files' is deprecated in favor of 'project.license-files'", + "`project.license` as a TOML table is deprecated", + ] + with warnings.catch_warnings(): + for msg in msgs: + warnings.filterwarnings("ignore", msg, SetuptoolsDeprecationWarning) + sdist_path = build_backend.build_sdist("temp") + wheel_file = build_backend.build_wheel("temp") + + with tarfile.open(os.path.join(tmpdir, "temp", sdist_path)) as tar: + sdist_contents = set(tar.getnames()) + + with ZipFile(os.path.join(tmpdir, "temp", wheel_file)) as zipfile: + wheel_contents = set(zipfile.namelist()) + metadata = str(zipfile.read("foo-0.1.dist-info/METADATA"), "utf-8") + license = str( + zipfile.read("foo-0.1.dist-info/licenses/LICENSE.txt"), "utf-8" + ) + epoints = str(zipfile.read("foo-0.1.dist-info/entry_points.txt"), "utf-8") + + assert sdist_contents - {"foo-0.1/setup.py"} == { + 'foo-0.1', + 'foo-0.1/LICENSE.txt', + 'foo-0.1/MANIFEST.in', + 'foo-0.1/PKG-INFO', + 'foo-0.1/README.rst', + 'foo-0.1/pyproject.toml', + 'foo-0.1/setup.cfg', + 'foo-0.1/src', + 'foo-0.1/src/foo', + 'foo-0.1/src/foo/__init__.py', + 'foo-0.1/src/foo/__init__.pyi', + 'foo-0.1/src/foo/cli.py', + 'foo-0.1/src/foo/data.txt', + 'foo-0.1/src/foo/py.typed', + 'foo-0.1/src/foo.egg-info', + 'foo-0.1/src/foo.egg-info/PKG-INFO', + 'foo-0.1/src/foo.egg-info/SOURCES.txt', + 'foo-0.1/src/foo.egg-info/dependency_links.txt', + 'foo-0.1/src/foo.egg-info/entry_points.txt', + 'foo-0.1/src/foo.egg-info/requires.txt', + 'foo-0.1/src/foo.egg-info/top_level.txt', + 'foo-0.1/src/foo.egg-info/not-zip-safe', + } + assert wheel_contents == { + "foo/__init__.py", + "foo/__init__.pyi", # include type information by default + "foo/cli.py", + "foo/data.txt", # include_package_data defaults to True + "foo/py.typed", # include type information by default + "foo-0.1.dist-info/licenses/LICENSE.txt", + "foo-0.1.dist-info/METADATA", + "foo-0.1.dist-info/WHEEL", + "foo-0.1.dist-info/entry_points.txt", + "foo-0.1.dist-info/top_level.txt", + "foo-0.1.dist-info/RECORD", + } + assert license == "---- placeholder MIT license ----" + + for line in ( + "Summary: This is a Python package", + "License: MIT", + "License-File: LICENSE.txt", + "Classifier: Intended Audience :: Developers", + "Requires-Dist: appdirs", + "Requires-Dist: " + str(Requirement('tomli>=1 ; extra == "all"')), + "Requires-Dist: " + + str(Requirement('importlib; python_version=="2.6" and extra =="all"')), + ): + assert line in metadata, (line, metadata) + + assert metadata.strip().endswith("This is a ``README``") + assert epoints.strip() == "[console_scripts]\nfoo = foo.cli:main" + + def test_static_metadata_in_pyproject_config(self, tmpdir): + # Make sure static metadata in pyproject.toml is not overwritten by setup.py + # as required by PEP 621 + files = { + 'pyproject.toml': DALS( + """ + [build-system] + requires = ["setuptools", "wheel"] + build-backend = "setuptools.build_meta" + + [project] + name = "foo" + description = "This is a Python package" + version = "42" + dependencies = ["six"] + """ + ), + 'hello.py': DALS( + """ + def run(): + print('hello') + """ + ), + 'setup.py': DALS( + """ + __import__('setuptools').setup( + name='bar', + version='13', + ) + """ + ), + } + build_backend = self.get_build_backend() + with tmpdir.as_cwd(): + path.build(files) + sdist_path = build_backend.build_sdist("temp") + wheel_file = build_backend.build_wheel("temp") + + assert (tmpdir / "temp/foo-42.tar.gz").exists() + assert (tmpdir / "temp/foo-42-py3-none-any.whl").exists() + assert not (tmpdir / "temp/bar-13.tar.gz").exists() + assert not (tmpdir / "temp/bar-42.tar.gz").exists() + assert not (tmpdir / "temp/foo-13.tar.gz").exists() + assert not (tmpdir / "temp/bar-13-py3-none-any.whl").exists() + assert not (tmpdir / "temp/bar-42-py3-none-any.whl").exists() + assert not (tmpdir / "temp/foo-13-py3-none-any.whl").exists() + + with tarfile.open(os.path.join(tmpdir, "temp", sdist_path)) as tar: + pkg_info = str(tar.extractfile('foo-42/PKG-INFO').read(), "utf-8") + members = tar.getnames() + assert "bar-13/PKG-INFO" not in members + + with ZipFile(os.path.join(tmpdir, "temp", wheel_file)) as zipfile: + metadata = str(zipfile.read("foo-42.dist-info/METADATA"), "utf-8") + members = zipfile.namelist() + assert "bar-13.dist-info/METADATA" not in members + + for file in pkg_info, metadata: + for line in ("Name: foo", "Version: 42"): + assert line in file + for line in ("Name: bar", "Version: 13"): + assert line not in file + + def test_build_sdist(self, build_backend): + dist_dir = os.path.abspath('pip-sdist') + os.makedirs(dist_dir) + sdist_name = build_backend.build_sdist(dist_dir) + + assert os.path.isfile(os.path.join(dist_dir, sdist_name)) + + def test_prepare_metadata_for_build_wheel(self, build_backend): + dist_dir = os.path.abspath('pip-dist-info') + os.makedirs(dist_dir) + + dist_info = build_backend.prepare_metadata_for_build_wheel(dist_dir) + + assert os.path.isfile(os.path.join(dist_dir, dist_info, 'METADATA')) + + def test_prepare_metadata_inplace(self, build_backend): + """ + Some users might pass metadata_directory pre-populated with `.tox` or `.venv`. + See issue #3523. + """ + for pre_existing in [ + ".tox/python/lib/python3.10/site-packages/attrs-22.1.0.dist-info", + ".tox/python/lib/python3.10/site-packages/autocommand-2.2.1.dist-info", + ".nox/python/lib/python3.10/site-packages/build-0.8.0.dist-info", + ".venv/python3.10/site-packages/click-8.1.3.dist-info", + "venv/python3.10/site-packages/distlib-0.3.5.dist-info", + "env/python3.10/site-packages/docutils-0.19.dist-info", + ]: + os.makedirs(pre_existing, exist_ok=True) + dist_info = build_backend.prepare_metadata_for_build_wheel(".") + assert os.path.isfile(os.path.join(dist_info, 'METADATA')) + + def test_build_sdist_explicit_dist(self, build_backend): + # explicitly specifying the dist folder should work + # the folder sdist_directory and the ``--dist-dir`` can be the same + dist_dir = os.path.abspath('dist') + sdist_name = build_backend.build_sdist(dist_dir) + assert os.path.isfile(os.path.join(dist_dir, sdist_name)) + + def test_build_sdist_version_change(self, build_backend): + sdist_into_directory = os.path.abspath("out_sdist") + os.makedirs(sdist_into_directory) + + sdist_name = build_backend.build_sdist(sdist_into_directory) + assert os.path.isfile(os.path.join(sdist_into_directory, sdist_name)) + + # if the setup.py changes subsequent call of the build meta + # should still succeed, given the + # sdist_directory the frontend specifies is empty + setup_loc = os.path.abspath("setup.py") + if not os.path.exists(setup_loc): + setup_loc = os.path.abspath("setup.cfg") + + with open(setup_loc, 'rt', encoding="utf-8") as file_handler: + content = file_handler.read() + with open(setup_loc, 'wt', encoding="utf-8") as file_handler: + file_handler.write(content.replace("version='0.0.0'", "version='0.0.1'")) + + shutil.rmtree(sdist_into_directory) + os.makedirs(sdist_into_directory) + + sdist_name = build_backend.build_sdist("out_sdist") + assert os.path.isfile(os.path.join(os.path.abspath("out_sdist"), sdist_name)) + + def test_build_sdist_pyproject_toml_exists(self, tmpdir_cwd): + files = { + 'setup.py': DALS( + """ + __import__('setuptools').setup( + name='foo', + version='0.0.0', + py_modules=['hello'] + )""" + ), + 'hello.py': '', + 'pyproject.toml': DALS( + """ + [build-system] + requires = ["setuptools", "wheel"] + build-backend = "setuptools.build_meta" + """ + ), + } + path.build(files) + build_backend = self.get_build_backend() + targz_path = build_backend.build_sdist("temp") + with tarfile.open(os.path.join("temp", targz_path)) as tar: + assert any('pyproject.toml' in name for name in tar.getnames()) + + def test_build_sdist_setup_py_exists(self, tmpdir_cwd): + # If build_sdist is called from a script other than setup.py, + # ensure setup.py is included + path.build(defns[0]) + + build_backend = self.get_build_backend() + targz_path = build_backend.build_sdist("temp") + with tarfile.open(os.path.join("temp", targz_path)) as tar: + assert any('setup.py' in name for name in tar.getnames()) + + def test_build_sdist_setup_py_manifest_excluded(self, tmpdir_cwd): + # Ensure that MANIFEST.in can exclude setup.py + files = { + 'setup.py': DALS( + """ + __import__('setuptools').setup( + name='foo', + version='0.0.0', + py_modules=['hello'] + )""" + ), + 'hello.py': '', + 'MANIFEST.in': DALS( + """ + exclude setup.py + """ + ), + } + + path.build(files) + + build_backend = self.get_build_backend() + targz_path = build_backend.build_sdist("temp") + with tarfile.open(os.path.join("temp", targz_path)) as tar: + assert not any('setup.py' in name for name in tar.getnames()) + + def test_build_sdist_builds_targz_even_if_zip_indicated(self, tmpdir_cwd): + files = { + 'setup.py': DALS( + """ + __import__('setuptools').setup( + name='foo', + version='0.0.0', + py_modules=['hello'] + )""" + ), + 'hello.py': '', + 'setup.cfg': DALS( + """ + [sdist] + formats=zip + """ + ), + } + + path.build(files) + + build_backend = self.get_build_backend() + build_backend.build_sdist("temp") + + _relative_path_import_files = { + 'setup.py': DALS( + """ + __import__('setuptools').setup( + name='foo', + version=__import__('hello').__version__, + py_modules=['hello'] + )""" + ), + 'hello.py': '__version__ = "0.0.0"', + 'setup.cfg': DALS( + """ + [sdist] + formats=zip + """ + ), + } + + def test_build_sdist_relative_path_import(self, tmpdir_cwd): + path.build(self._relative_path_import_files) + build_backend = self.get_build_backend() + with pytest.raises(ImportError, match="^No module named 'hello'$"): + build_backend.build_sdist("temp") + + _simple_pyproject_example = { + "pyproject.toml": DALS( + """ + [project] + name = "proj" + version = "42" + """ + ), + "src": {"proj": {"__init__.py": ""}}, + } + + def _assert_link_tree(self, parent_dir): + """All files in the directory should be either links or hard links""" + files = list(Path(parent_dir).glob("**/*")) + assert files # Should not be empty + for file in files: + assert file.is_symlink() or os.stat(file).st_nlink > 0 + + def test_editable_without_config_settings(self, tmpdir_cwd): + """ + Sanity check to ensure tests with --mode=strict are different from the ones + without --mode. + + --mode=strict should create a local directory with a package tree. + The directory should not get created otherwise. + """ + path.build(self._simple_pyproject_example) + build_backend = self.get_build_backend() + assert not Path("build").exists() + build_backend.build_editable("temp") + assert not Path("build").exists() + + def test_build_wheel_inplace(self, tmpdir_cwd): + config_settings = {"--build-option": ["build_ext", "--inplace"]} + path.build(self._simple_pyproject_example) + build_backend = self.get_build_backend() + assert not Path("build").exists() + Path("build").mkdir() + build_backend.prepare_metadata_for_build_wheel("build", config_settings) + build_backend.build_wheel("build", config_settings) + assert Path("build/proj-42-py3-none-any.whl").exists() + + @pytest.mark.parametrize("config_settings", [{"editable-mode": "strict"}]) + def test_editable_with_config_settings(self, tmpdir_cwd, config_settings): + path.build({**self._simple_pyproject_example, '_meta': {}}) + assert not Path("build").exists() + build_backend = self.get_build_backend() + build_backend.prepare_metadata_for_build_editable("_meta", config_settings) + build_backend.build_editable("temp", config_settings, "_meta") + self._assert_link_tree(next(Path("build").glob("__editable__.*"))) + + @pytest.mark.parametrize( + ("setup_literal", "requirements"), + [ + ("'foo'", ['foo']), + ("['foo']", ['foo']), + (r"'foo\n'", ['foo']), + (r"'foo\n\n'", ['foo']), + ("['foo', 'bar']", ['foo', 'bar']), + (r"'# Has a comment line\nfoo'", ['foo']), + (r"'foo # Has an inline comment'", ['foo']), + (r"'foo \\\n >=3.0'", ['foo>=3.0']), + (r"'foo\nbar'", ['foo', 'bar']), + (r"'foo\nbar\n'", ['foo', 'bar']), + (r"['foo\n', 'bar\n']", ['foo', 'bar']), + ], + ) + @pytest.mark.parametrize('use_wheel', [True, False]) + def test_setup_requires(self, setup_literal, requirements, use_wheel, tmpdir_cwd): + files = { + 'setup.py': DALS( + """ + from setuptools import setup + + setup( + name="qux", + version="0.0.0", + py_modules=["hello"], + setup_requires={setup_literal}, + ) + """ + ).format(setup_literal=setup_literal), + 'hello.py': DALS( + """ + def run(): + print('hello') + """ + ), + } + + path.build(files) + + build_backend = self.get_build_backend() + + if use_wheel: + get_requires = build_backend.get_requires_for_build_wheel + else: + get_requires = build_backend.get_requires_for_build_sdist + + # Ensure that the build requirements are properly parsed + expected = sorted(requirements) + actual = get_requires() + + assert expected == sorted(actual) + + def test_setup_requires_with_auto_discovery(self, tmpdir_cwd): + # Make sure patches introduced to retrieve setup_requires don't accidentally + # activate auto-discovery and cause problems due to the incomplete set of + # attributes passed to MinimalDistribution + files = { + 'pyproject.toml': DALS( + """ + [project] + name = "proj" + version = "42" + """ + ), + "setup.py": DALS( + """ + __import__('setuptools').setup( + setup_requires=["foo"], + py_modules = ["hello", "world"] + ) + """ + ), + 'hello.py': "'hello'", + 'world.py': "'world'", + } + path.build(files) + build_backend = self.get_build_backend() + setup_requires = build_backend.get_requires_for_build_wheel() + assert setup_requires == ["foo"] + + def test_dont_install_setup_requires(self, tmpdir_cwd): + files = { + 'setup.py': DALS( + """ + from setuptools import setup + + setup( + name="qux", + version="0.0.0", + py_modules=["hello"], + setup_requires=["does-not-exist >99"], + ) + """ + ), + 'hello.py': DALS( + """ + def run(): + print('hello') + """ + ), + } + + path.build(files) + + build_backend = self.get_build_backend() + + dist_dir = os.path.abspath('pip-dist-info') + os.makedirs(dist_dir) + + # does-not-exist can't be satisfied, so if it attempts to install + # setup_requires, it will fail. + build_backend.prepare_metadata_for_build_wheel(dist_dir) + + _sys_argv_0_passthrough = { + 'setup.py': DALS( + """ + import os + import sys + + __import__('setuptools').setup( + name='foo', + version='0.0.0', + ) + + sys_argv = os.path.abspath(sys.argv[0]) + file_path = os.path.abspath('setup.py') + assert sys_argv == file_path + """ + ) + } + + def test_sys_argv_passthrough(self, tmpdir_cwd): + path.build(self._sys_argv_0_passthrough) + build_backend = self.get_build_backend() + with pytest.raises(AssertionError): + build_backend.build_sdist("temp") + + _setup_py_file_abspath = { + 'setup.py': DALS( + """ + import os + assert os.path.isabs(__file__) + __import__('setuptools').setup( + name='foo', + version='0.0.0', + py_modules=['hello'], + setup_requires=['six'], + ) + """ + ) + } + + def test_setup_py_file_abspath(self, tmpdir_cwd): + path.build(self._setup_py_file_abspath) + build_backend = self.get_build_backend() + build_backend.build_sdist("temp") + + @pytest.mark.parametrize('build_hook', ('build_sdist', 'build_wheel')) + def test_build_with_empty_setuppy(self, build_backend, build_hook): + files = {'setup.py': ''} + path.build(files) + + msg = re.escape('No distribution was found.') + with pytest.raises(ValueError, match=msg): + getattr(build_backend, build_hook)("temp") + + +class TestBuildMetaLegacyBackend(TestBuildMetaBackend): + backend_name = 'setuptools.build_meta:__legacy__' + + # build_meta_legacy-specific tests + def test_build_sdist_relative_path_import(self, tmpdir_cwd): + # This must fail in build_meta, but must pass in build_meta_legacy + path.build(self._relative_path_import_files) + + build_backend = self.get_build_backend() + build_backend.build_sdist("temp") + + def test_sys_argv_passthrough(self, tmpdir_cwd): + path.build(self._sys_argv_0_passthrough) + + build_backend = self.get_build_backend() + build_backend.build_sdist("temp") + + +@pytest.mark.filterwarnings("ignore::setuptools.SetuptoolsDeprecationWarning") +def test_sys_exit_0_in_setuppy(monkeypatch, tmp_path): + """Setuptools should be resilient to setup.py with ``sys.exit(0)`` (#3973).""" + monkeypatch.chdir(tmp_path) + setuppy = """ + import sys, setuptools + setuptools.setup(name='foo', version='0.0.0') + sys.exit(0) + """ + (tmp_path / "setup.py").write_text(DALS(setuppy), encoding="utf-8") + backend = BuildBackend(backend_name="setuptools.build_meta") + assert backend.get_requires_for_build_wheel() == [] + + +def test_system_exit_in_setuppy(monkeypatch, tmp_path): + monkeypatch.chdir(tmp_path) + setuppy = "import sys; sys.exit('some error')" + (tmp_path / "setup.py").write_text(setuppy, encoding="utf-8") + with pytest.raises(SystemExit, match="some error"): + backend = BuildBackend(backend_name="setuptools.build_meta") + backend.get_requires_for_build_wheel() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_py.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_py.py new file mode 100644 index 000000000..1e3a66083 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_build_py.py @@ -0,0 +1,480 @@ +import os +import shutil +import stat +import warnings +from pathlib import Path +from unittest.mock import Mock + +import jaraco.path +import pytest + +from setuptools import SetuptoolsDeprecationWarning +from setuptools.dist import Distribution + +from .textwrap import DALS + + +def test_directories_in_package_data_glob(tmpdir_cwd): + """ + Directories matching the glob in package_data should + not be included in the package data. + + Regression test for #261. + """ + dist = Distribution( + dict( + script_name='setup.py', + script_args=['build_py'], + packages=[''], + package_data={'': ['path/*']}, + ) + ) + os.makedirs('path/subpath') + dist.parse_command_line() + dist.run_commands() + + +def test_recursive_in_package_data_glob(tmpdir_cwd): + """ + Files matching recursive globs (**) in package_data should + be included in the package data. + + #1806 + """ + dist = Distribution( + dict( + script_name='setup.py', + script_args=['build_py'], + packages=[''], + package_data={'': ['path/**/data']}, + ) + ) + os.makedirs('path/subpath/subsubpath') + open('path/subpath/subsubpath/data', 'wb').close() + + dist.parse_command_line() + dist.run_commands() + + assert stat.S_ISREG(os.stat('build/lib/path/subpath/subsubpath/data').st_mode), ( + "File is not included" + ) + + +def test_read_only(tmpdir_cwd): + """ + Ensure read-only flag is not preserved in copy + for package modules and package data, as that + causes problems with deleting read-only files on + Windows. + + #1451 + """ + dist = Distribution( + dict( + script_name='setup.py', + script_args=['build_py'], + packages=['pkg'], + package_data={'pkg': ['data.dat']}, + ) + ) + os.makedirs('pkg') + open('pkg/__init__.py', 'wb').close() + open('pkg/data.dat', 'wb').close() + os.chmod('pkg/__init__.py', stat.S_IREAD) + os.chmod('pkg/data.dat', stat.S_IREAD) + dist.parse_command_line() + dist.run_commands() + shutil.rmtree('build') + + +@pytest.mark.xfail( + 'platform.system() == "Windows"', + reason="On Windows, files do not have executable bits", + raises=AssertionError, + strict=True, +) +def test_executable_data(tmpdir_cwd): + """ + Ensure executable bit is preserved in copy for + package data, as users rely on it for scripts. + + #2041 + """ + dist = Distribution( + dict( + script_name='setup.py', + script_args=['build_py'], + packages=['pkg'], + package_data={'pkg': ['run-me']}, + ) + ) + os.makedirs('pkg') + open('pkg/__init__.py', 'wb').close() + open('pkg/run-me', 'wb').close() + os.chmod('pkg/run-me', 0o700) + + dist.parse_command_line() + dist.run_commands() + + assert os.stat('build/lib/pkg/run-me').st_mode & stat.S_IEXEC, ( + "Script is not executable" + ) + + +EXAMPLE_WITH_MANIFEST = { + "setup.cfg": DALS( + """ + [metadata] + name = mypkg + version = 42 + + [options] + include_package_data = True + packages = find: + + [options.packages.find] + exclude = *.tests* + """ + ), + "mypkg": { + "__init__.py": "", + "resource_file.txt": "", + "tests": { + "__init__.py": "", + "test_mypkg.py": "", + "test_file.txt": "", + }, + }, + "MANIFEST.in": DALS( + """ + global-include *.py *.txt + global-exclude *.py[cod] + prune dist + prune build + prune *.egg-info + """ + ), +} + + +def test_excluded_subpackages(tmpdir_cwd): + jaraco.path.build(EXAMPLE_WITH_MANIFEST) + dist = Distribution({"script_name": "%PEP 517%"}) + dist.parse_config_files() + + build_py = dist.get_command_obj("build_py") + + msg = r"Python recognizes 'mypkg\.tests' as an importable package" + with pytest.warns(SetuptoolsDeprecationWarning, match=msg): + # TODO: To fix #3260 we need some transition period to deprecate the + # existing behavior of `include_package_data`. After the transition, we + # should remove the warning and fix the behavior. + + if os.getenv("SETUPTOOLS_USE_DISTUTILS") == "stdlib": + # pytest.warns reset the warning filter temporarily + # https://github.com/pytest-dev/pytest/issues/4011#issuecomment-423494810 + warnings.filterwarnings( + "ignore", + "'encoding' argument not specified", + module="distutils.text_file", + # This warning is already fixed in pypa/distutils but not in stdlib + ) + + build_py.finalize_options() + build_py.run() + + build_dir = Path(dist.get_command_obj("build_py").build_lib) + assert (build_dir / "mypkg/__init__.py").exists() + assert (build_dir / "mypkg/resource_file.txt").exists() + + # Setuptools is configured to ignore `mypkg.tests`, therefore the following + # files/dirs should not be included in the distribution. + for f in [ + "mypkg/tests/__init__.py", + "mypkg/tests/test_mypkg.py", + "mypkg/tests/test_file.txt", + "mypkg/tests", + ]: + with pytest.raises(AssertionError): + # TODO: Enforce the following assertion once #3260 is fixed + # (remove context manager and the following xfail). + assert not (build_dir / f).exists() + + pytest.xfail("#3260") + + +@pytest.mark.filterwarnings("ignore::setuptools.SetuptoolsDeprecationWarning") +def test_existing_egg_info(tmpdir_cwd, monkeypatch): + """When provided with the ``existing_egg_info_dir`` attribute, build_py should not + attempt to run egg_info again. + """ + # == Pre-condition == + # Generate an egg-info dir + jaraco.path.build(EXAMPLE_WITH_MANIFEST) + dist = Distribution({"script_name": "%PEP 517%"}) + dist.parse_config_files() + assert dist.include_package_data + + egg_info = dist.get_command_obj("egg_info") + dist.run_command("egg_info") + egg_info_dir = next(Path(egg_info.egg_base).glob("*.egg-info")) + assert egg_info_dir.is_dir() + + # == Setup == + build_py = dist.get_command_obj("build_py") + build_py.finalize_options() + egg_info = dist.get_command_obj("egg_info") + egg_info_run = Mock(side_effect=egg_info.run) + monkeypatch.setattr(egg_info, "run", egg_info_run) + + # == Remove caches == + # egg_info is called when build_py looks for data_files, which gets cached. + # We need to ensure it is not cached yet, otherwise it may impact on the tests + build_py.__dict__.pop('data_files', None) + dist.reinitialize_command(egg_info) + + # == Sanity check == + # Ensure that if existing_egg_info is not given, build_py attempts to run egg_info + build_py.existing_egg_info_dir = None + build_py.run() + egg_info_run.assert_called() + + # == Remove caches == + egg_info_run.reset_mock() + build_py.__dict__.pop('data_files', None) + dist.reinitialize_command(egg_info) + + # == Actual test == + # Ensure that if existing_egg_info_dir is given, egg_info doesn't run + build_py.existing_egg_info_dir = egg_info_dir + build_py.run() + egg_info_run.assert_not_called() + assert build_py.data_files + + # Make sure the list of outputs is actually OK + outputs = map(lambda x: x.replace(os.sep, "/"), build_py.get_outputs()) + assert outputs + example = str(Path(build_py.build_lib, "mypkg/__init__.py")).replace(os.sep, "/") + assert example in outputs + + +EXAMPLE_ARBITRARY_MAPPING = { + "pyproject.toml": DALS( + """ + [project] + name = "mypkg" + version = "42" + + [tool.setuptools] + packages = ["mypkg", "mypkg.sub1", "mypkg.sub2", "mypkg.sub2.nested"] + + [tool.setuptools.package-dir] + "" = "src" + "mypkg.sub2" = "src/mypkg/_sub2" + "mypkg.sub2.nested" = "other" + """ + ), + "src": { + "mypkg": { + "__init__.py": "", + "resource_file.txt": "", + "sub1": { + "__init__.py": "", + "mod1.py": "", + }, + "_sub2": { + "mod2.py": "", + }, + }, + }, + "other": { + "__init__.py": "", + "mod3.py": "", + }, + "MANIFEST.in": DALS( + """ + global-include *.py *.txt + global-exclude *.py[cod] + """ + ), +} + + +def test_get_outputs(tmpdir_cwd): + jaraco.path.build(EXAMPLE_ARBITRARY_MAPPING) + dist = Distribution({"script_name": "%test%"}) + dist.parse_config_files() + + build_py = dist.get_command_obj("build_py") + build_py.editable_mode = True + build_py.ensure_finalized() + build_lib = build_py.build_lib.replace(os.sep, "/") + outputs = {x.replace(os.sep, "/") for x in build_py.get_outputs()} + assert outputs == { + f"{build_lib}/mypkg/__init__.py", + f"{build_lib}/mypkg/resource_file.txt", + f"{build_lib}/mypkg/sub1/__init__.py", + f"{build_lib}/mypkg/sub1/mod1.py", + f"{build_lib}/mypkg/sub2/mod2.py", + f"{build_lib}/mypkg/sub2/nested/__init__.py", + f"{build_lib}/mypkg/sub2/nested/mod3.py", + } + mapping = { + k.replace(os.sep, "/"): v.replace(os.sep, "/") + for k, v in build_py.get_output_mapping().items() + } + assert mapping == { + f"{build_lib}/mypkg/__init__.py": "src/mypkg/__init__.py", + f"{build_lib}/mypkg/resource_file.txt": "src/mypkg/resource_file.txt", + f"{build_lib}/mypkg/sub1/__init__.py": "src/mypkg/sub1/__init__.py", + f"{build_lib}/mypkg/sub1/mod1.py": "src/mypkg/sub1/mod1.py", + f"{build_lib}/mypkg/sub2/mod2.py": "src/mypkg/_sub2/mod2.py", + f"{build_lib}/mypkg/sub2/nested/__init__.py": "other/__init__.py", + f"{build_lib}/mypkg/sub2/nested/mod3.py": "other/mod3.py", + } + + +class TestTypeInfoFiles: + PYPROJECTS = { + "default_pyproject": DALS( + """ + [project] + name = "foo" + version = "1" + """ + ), + "dont_include_package_data": DALS( + """ + [project] + name = "foo" + version = "1" + + [tool.setuptools] + include-package-data = false + """ + ), + "exclude_type_info": DALS( + """ + [project] + name = "foo" + version = "1" + + [tool.setuptools] + include-package-data = false + + [tool.setuptools.exclude-package-data] + "*" = ["py.typed", "*.pyi"] + """ + ), + } + + EXAMPLES = { + "simple_namespace": { + "directory_structure": { + "foo": { + "bar.pyi": "", + "py.typed": "", + "__init__.py": "", + } + }, + "expected_type_files": {"foo/bar.pyi", "foo/py.typed"}, + }, + "nested_inside_namespace": { + "directory_structure": { + "foo": { + "bar": { + "py.typed": "", + "mod.pyi": "", + } + } + }, + "expected_type_files": {"foo/bar/mod.pyi", "foo/bar/py.typed"}, + }, + "namespace_nested_inside_regular": { + "directory_structure": { + "foo": { + "namespace": { + "foo.pyi": "", + }, + "__init__.pyi": "", + "py.typed": "", + } + }, + "expected_type_files": { + "foo/namespace/foo.pyi", + "foo/__init__.pyi", + "foo/py.typed", + }, + }, + } + + @pytest.mark.parametrize( + "pyproject", + [ + "default_pyproject", + pytest.param( + "dont_include_package_data", + marks=pytest.mark.xfail(reason="pypa/setuptools#4350"), + ), + ], + ) + @pytest.mark.parametrize("example", EXAMPLES.keys()) + def test_type_files_included_by_default(self, tmpdir_cwd, pyproject, example): + structure = { + **self.EXAMPLES[example]["directory_structure"], + "pyproject.toml": self.PYPROJECTS[pyproject], + } + expected_type_files = self.EXAMPLES[example]["expected_type_files"] + jaraco.path.build(structure) + + build_py = get_finalized_build_py() + outputs = get_outputs(build_py) + assert expected_type_files <= outputs + + @pytest.mark.parametrize("pyproject", ["exclude_type_info"]) + @pytest.mark.parametrize("example", EXAMPLES.keys()) + def test_type_files_can_be_excluded(self, tmpdir_cwd, pyproject, example): + structure = { + **self.EXAMPLES[example]["directory_structure"], + "pyproject.toml": self.PYPROJECTS[pyproject], + } + expected_type_files = self.EXAMPLES[example]["expected_type_files"] + jaraco.path.build(structure) + + build_py = get_finalized_build_py() + outputs = get_outputs(build_py) + assert expected_type_files.isdisjoint(outputs) + + def test_stub_only_package(self, tmpdir_cwd): + structure = { + "pyproject.toml": DALS( + """ + [project] + name = "foo-stubs" + version = "1" + """ + ), + "foo-stubs": {"__init__.pyi": "", "bar.pyi": ""}, + } + expected_type_files = {"foo-stubs/__init__.pyi", "foo-stubs/bar.pyi"} + jaraco.path.build(structure) + + build_py = get_finalized_build_py() + outputs = get_outputs(build_py) + assert expected_type_files <= outputs + + +def get_finalized_build_py(script_name="%build_py-test%"): + dist = Distribution({"script_name": script_name}) + dist.parse_config_files() + build_py = dist.get_command_obj("build_py") + build_py.finalize_options() + return build_py + + +def get_outputs(build_py): + build_dir = Path(build_py.build_lib) + return { + os.path.relpath(x, build_dir).replace(os.sep, "/") + for x in build_py.get_outputs() + } diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_config_discovery.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_config_discovery.py new file mode 100644 index 000000000..b5df8203c --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_config_discovery.py @@ -0,0 +1,647 @@ +import os +import sys +from configparser import ConfigParser +from itertools import product +from typing import cast + +import jaraco.path +import pytest +from path import Path + +import setuptools # noqa: F401 # force distutils.core to be patched +from setuptools.command.sdist import sdist +from setuptools.discovery import find_package_path, find_parent_package +from setuptools.dist import Distribution +from setuptools.errors import PackageDiscoveryError + +from .contexts import quiet +from .integration.helpers import get_sdist_members, get_wheel_members, run +from .textwrap import DALS + +import distutils.core + + +class TestFindParentPackage: + def test_single_package(self, tmp_path): + # find_parent_package should find a non-namespace parent package + (tmp_path / "src/namespace/pkg/nested").mkdir(exist_ok=True, parents=True) + (tmp_path / "src/namespace/pkg/nested/__init__.py").touch() + (tmp_path / "src/namespace/pkg/__init__.py").touch() + packages = ["namespace", "namespace.pkg", "namespace.pkg.nested"] + assert find_parent_package(packages, {"": "src"}, tmp_path) == "namespace.pkg" + + def test_multiple_toplevel(self, tmp_path): + # find_parent_package should return null if the given list of packages does not + # have a single parent package + multiple = ["pkg", "pkg1", "pkg2"] + for name in multiple: + (tmp_path / f"src/{name}").mkdir(exist_ok=True, parents=True) + (tmp_path / f"src/{name}/__init__.py").touch() + assert find_parent_package(multiple, {"": "src"}, tmp_path) is None + + +class TestDiscoverPackagesAndPyModules: + """Make sure discovered values for ``packages`` and ``py_modules`` work + similarly to explicit configuration for the simple scenarios. + """ + + OPTIONS = { + # Different options according to the circumstance being tested + "explicit-src": {"package_dir": {"": "src"}, "packages": ["pkg"]}, + "variation-lib": { + "package_dir": {"": "lib"}, # variation of the source-layout + }, + "explicit-flat": {"packages": ["pkg"]}, + "explicit-single_module": {"py_modules": ["pkg"]}, + "explicit-namespace": {"packages": ["ns", "ns.pkg"]}, + "automatic-src": {}, + "automatic-flat": {}, + "automatic-single_module": {}, + "automatic-namespace": {}, + } + FILES = { + "src": ["src/pkg/__init__.py", "src/pkg/main.py"], + "lib": ["lib/pkg/__init__.py", "lib/pkg/main.py"], + "flat": ["pkg/__init__.py", "pkg/main.py"], + "single_module": ["pkg.py"], + "namespace": ["ns/pkg/__init__.py"], + } + + def _get_info(self, circumstance): + _, _, layout = circumstance.partition("-") + files = self.FILES[layout] + options = self.OPTIONS[circumstance] + return files, options + + @pytest.mark.parametrize("circumstance", OPTIONS.keys()) + def test_sdist_filelist(self, tmp_path, circumstance): + files, options = self._get_info(circumstance) + _populate_project_dir(tmp_path, files, options) + + _, cmd = _run_sdist_programatically(tmp_path, options) + + manifest = [f.replace(os.sep, "/") for f in cmd.filelist.files] + for file in files: + assert any(f.endswith(file) for f in manifest) + + @pytest.mark.parametrize("circumstance", OPTIONS.keys()) + def test_project(self, tmp_path, circumstance): + files, options = self._get_info(circumstance) + _populate_project_dir(tmp_path, files, options) + + # Simulate a pre-existing `build` directory + (tmp_path / "build").mkdir() + (tmp_path / "build/lib").mkdir() + (tmp_path / "build/bdist.linux-x86_64").mkdir() + (tmp_path / "build/bdist.linux-x86_64/file.py").touch() + (tmp_path / "build/lib/__init__.py").touch() + (tmp_path / "build/lib/file.py").touch() + (tmp_path / "dist").mkdir() + (tmp_path / "dist/file.py").touch() + + _run_build(tmp_path) + + sdist_files = get_sdist_members(next(tmp_path.glob("dist/*.tar.gz"))) + print("~~~~~ sdist_members ~~~~~") + print('\n'.join(sdist_files)) + assert sdist_files >= set(files) + + wheel_files = get_wheel_members(next(tmp_path.glob("dist/*.whl"))) + print("~~~~~ wheel_members ~~~~~") + print('\n'.join(wheel_files)) + orig_files = {f.replace("src/", "").replace("lib/", "") for f in files} + assert wheel_files >= orig_files + + # Make sure build files are not included by mistake + for file in wheel_files: + assert "build" not in files + assert "dist" not in files + + PURPOSEFULLY_EMPY = { + "setup.cfg": DALS( + """ + [metadata] + name = myproj + version = 0.0.0 + + [options] + {param} = + """ + ), + "setup.py": DALS( + """ + __import__('setuptools').setup( + name="myproj", + version="0.0.0", + {param}=[] + ) + """ + ), + "pyproject.toml": DALS( + """ + [build-system] + requires = [] + build-backend = 'setuptools.build_meta' + + [project] + name = "myproj" + version = "0.0.0" + + [tool.setuptools] + {param} = [] + """ + ), + "template-pyproject.toml": DALS( + """ + [build-system] + requires = [] + build-backend = 'setuptools.build_meta' + """ + ), + } + + @pytest.mark.parametrize( + ("config_file", "param", "circumstance"), + product( + ["setup.cfg", "setup.py", "pyproject.toml"], + ["packages", "py_modules"], + FILES.keys(), + ), + ) + def test_purposefully_empty(self, tmp_path, config_file, param, circumstance): + files = self.FILES[circumstance] + ["mod.py", "other.py", "src/pkg/__init__.py"] + _populate_project_dir(tmp_path, files, {}) + + if config_file == "pyproject.toml": + template_param = param.replace("_", "-") + else: + # Make sure build works with or without setup.cfg + pyproject = self.PURPOSEFULLY_EMPY["template-pyproject.toml"] + (tmp_path / "pyproject.toml").write_text(pyproject, encoding="utf-8") + template_param = param + + config = self.PURPOSEFULLY_EMPY[config_file].format(param=template_param) + (tmp_path / config_file).write_text(config, encoding="utf-8") + + dist = _get_dist(tmp_path, {}) + # When either parameter package or py_modules is an empty list, + # then there should be no discovery + assert getattr(dist, param) == [] + other = {"py_modules": "packages", "packages": "py_modules"}[param] + assert getattr(dist, other) is None + + @pytest.mark.parametrize( + ("extra_files", "pkgs"), + [ + (["venv/bin/simulate_venv"], {"pkg"}), + (["pkg-stubs/__init__.pyi"], {"pkg", "pkg-stubs"}), + (["other-stubs/__init__.pyi"], {"pkg", "other-stubs"}), + ( + # Type stubs can also be namespaced + ["namespace-stubs/pkg/__init__.pyi"], + {"pkg", "namespace-stubs", "namespace-stubs.pkg"}, + ), + ( + # Just the top-level package can have `-stubs`, ignore nested ones + ["namespace-stubs/pkg-stubs/__init__.pyi"], + {"pkg", "namespace-stubs"}, + ), + (["_hidden/file.py"], {"pkg"}), + (["news/finalize.py"], {"pkg"}), + ], + ) + def test_flat_layout_with_extra_files(self, tmp_path, extra_files, pkgs): + files = self.FILES["flat"] + extra_files + _populate_project_dir(tmp_path, files, {}) + dist = _get_dist(tmp_path, {}) + assert set(dist.packages) == pkgs + + @pytest.mark.parametrize( + "extra_files", + [ + ["other/__init__.py"], + ["other/finalize.py"], + ], + ) + def test_flat_layout_with_dangerous_extra_files(self, tmp_path, extra_files): + files = self.FILES["flat"] + extra_files + _populate_project_dir(tmp_path, files, {}) + with pytest.raises(PackageDiscoveryError, match="multiple (packages|modules)"): + _get_dist(tmp_path, {}) + + def test_flat_layout_with_single_module(self, tmp_path): + files = self.FILES["single_module"] + ["invalid-module-name.py"] + _populate_project_dir(tmp_path, files, {}) + dist = _get_dist(tmp_path, {}) + assert set(dist.py_modules) == {"pkg"} + + def test_flat_layout_with_multiple_modules(self, tmp_path): + files = self.FILES["single_module"] + ["valid_module_name.py"] + _populate_project_dir(tmp_path, files, {}) + with pytest.raises(PackageDiscoveryError, match="multiple (packages|modules)"): + _get_dist(tmp_path, {}) + + def test_py_modules_when_wheel_dir_is_cwd(self, tmp_path): + """Regression for issue 3692""" + from setuptools import build_meta + + pyproject = '[project]\nname = "test"\nversion = "1"' + (tmp_path / "pyproject.toml").write_text(DALS(pyproject), encoding="utf-8") + (tmp_path / "foo.py").touch() + with jaraco.path.DirectoryStack().context(tmp_path): + build_meta.build_wheel(".") + # Ensure py_modules are found + wheel_files = get_wheel_members(next(tmp_path.glob("*.whl"))) + assert "foo.py" in wheel_files + + +class TestNoConfig: + DEFAULT_VERSION = "0.0.0" # Default version given by setuptools + + EXAMPLES = { + "pkg1": ["src/pkg1.py"], + "pkg2": ["src/pkg2/__init__.py"], + "pkg3": ["src/pkg3/__init__.py", "src/pkg3-stubs/__init__.py"], + "pkg4": ["pkg4/__init__.py", "pkg4-stubs/__init__.py"], + "ns.nested.pkg1": ["src/ns/nested/pkg1/__init__.py"], + "ns.nested.pkg2": ["ns/nested/pkg2/__init__.py"], + } + + @pytest.mark.parametrize("example", EXAMPLES.keys()) + def test_discover_name(self, tmp_path, example): + _populate_project_dir(tmp_path, self.EXAMPLES[example], {}) + dist = _get_dist(tmp_path, {}) + assert dist.get_name() == example + + def test_build_with_discovered_name(self, tmp_path): + files = ["src/ns/nested/pkg/__init__.py"] + _populate_project_dir(tmp_path, files, {}) + _run_build(tmp_path, "--sdist") + # Expected distribution file + dist_file = tmp_path / f"dist/ns_nested_pkg-{self.DEFAULT_VERSION}.tar.gz" + assert dist_file.is_file() + + +class TestWithAttrDirective: + @pytest.mark.parametrize( + ("folder", "opts"), + [ + ("src", {}), + ("lib", {"packages": "find:", "packages.find": {"where": "lib"}}), + ], + ) + def test_setupcfg_metadata(self, tmp_path, folder, opts): + files = [f"{folder}/pkg/__init__.py", "setup.cfg"] + _populate_project_dir(tmp_path, files, opts) + + config = (tmp_path / "setup.cfg").read_text(encoding="utf-8") + overwrite = { + folder: {"pkg": {"__init__.py": "version = 42"}}, + "setup.cfg": "[metadata]\nversion = attr: pkg.version\n" + config, + } + jaraco.path.build(overwrite, prefix=tmp_path) + + dist = _get_dist(tmp_path, {}) + assert dist.get_name() == "pkg" + assert dist.get_version() == "42" + assert dist.package_dir + package_path = find_package_path("pkg", dist.package_dir, tmp_path) + assert os.path.exists(package_path) + assert folder in Path(package_path).parts() + + _run_build(tmp_path, "--sdist") + dist_file = tmp_path / "dist/pkg-42.tar.gz" + assert dist_file.is_file() + + def test_pyproject_metadata(self, tmp_path): + _populate_project_dir(tmp_path, ["src/pkg/__init__.py"], {}) + + overwrite = { + "src": {"pkg": {"__init__.py": "version = 42"}}, + "pyproject.toml": ( + "[project]\nname = 'pkg'\ndynamic = ['version']\n" + "[tool.setuptools.dynamic]\nversion = {attr = 'pkg.version'}\n" + ), + } + jaraco.path.build(overwrite, prefix=tmp_path) + + dist = _get_dist(tmp_path, {}) + assert dist.get_version() == "42" + assert dist.package_dir == {"": "src"} + + +class TestWithCExtension: + def _simulate_package_with_extension(self, tmp_path): + # This example is based on: https://github.com/nucleic/kiwi/tree/1.4.0 + files = [ + "benchmarks/file.py", + "docs/Makefile", + "docs/requirements.txt", + "docs/source/conf.py", + "proj/header.h", + "proj/file.py", + "py/proj.cpp", + "py/other.cpp", + "py/file.py", + "py/py.typed", + "py/tests/test_proj.py", + "README.rst", + ] + _populate_project_dir(tmp_path, files, {}) + + setup_script = """ + from setuptools import Extension, setup + + ext_modules = [ + Extension( + "proj", + ["py/proj.cpp", "py/other.cpp"], + include_dirs=["."], + language="c++", + ), + ] + setup(ext_modules=ext_modules) + """ + (tmp_path / "setup.py").write_text(DALS(setup_script), encoding="utf-8") + + def test_skip_discovery_with_setupcfg_metadata(self, tmp_path): + """Ensure that auto-discovery is not triggered when the project is based on + C-extensions only, for backward compatibility. + """ + self._simulate_package_with_extension(tmp_path) + + pyproject = """ + [build-system] + requires = [] + build-backend = 'setuptools.build_meta' + """ + (tmp_path / "pyproject.toml").write_text(DALS(pyproject), encoding="utf-8") + + setupcfg = """ + [metadata] + name = proj + version = 42 + """ + (tmp_path / "setup.cfg").write_text(DALS(setupcfg), encoding="utf-8") + + dist = _get_dist(tmp_path, {}) + assert dist.get_name() == "proj" + assert dist.get_version() == "42" + assert dist.py_modules is None + assert dist.packages is None + assert len(dist.ext_modules) == 1 + assert dist.ext_modules[0].name == "proj" + + def test_dont_skip_discovery_with_pyproject_metadata(self, tmp_path): + """When opting-in to pyproject.toml metadata, auto-discovery will be active if + the package lists C-extensions, but does not configure py-modules or packages. + + This way we ensure users with complex package layouts that would lead to the + discovery of multiple top-level modules/packages see errors and are forced to + explicitly set ``packages`` or ``py-modules``. + """ + self._simulate_package_with_extension(tmp_path) + + pyproject = """ + [project] + name = 'proj' + version = '42' + """ + (tmp_path / "pyproject.toml").write_text(DALS(pyproject), encoding="utf-8") + with pytest.raises(PackageDiscoveryError, match="multiple (packages|modules)"): + _get_dist(tmp_path, {}) + + +class TestWithPackageData: + def _simulate_package_with_data_files(self, tmp_path, src_root): + files = [ + f"{src_root}/proj/__init__.py", + f"{src_root}/proj/file1.txt", + f"{src_root}/proj/nested/file2.txt", + ] + _populate_project_dir(tmp_path, files, {}) + + manifest = """ + global-include *.py *.txt + """ + (tmp_path / "MANIFEST.in").write_text(DALS(manifest), encoding="utf-8") + + EXAMPLE_SETUPCFG = """ + [metadata] + name = proj + version = 42 + + [options] + include_package_data = True + """ + EXAMPLE_PYPROJECT = """ + [project] + name = "proj" + version = "42" + """ + + PYPROJECT_PACKAGE_DIR = """ + [tool.setuptools] + package-dir = {"" = "src"} + """ + + @pytest.mark.parametrize( + ("src_root", "files"), + [ + (".", {"setup.cfg": DALS(EXAMPLE_SETUPCFG)}), + (".", {"pyproject.toml": DALS(EXAMPLE_PYPROJECT)}), + ("src", {"setup.cfg": DALS(EXAMPLE_SETUPCFG)}), + ("src", {"pyproject.toml": DALS(EXAMPLE_PYPROJECT)}), + ( + "src", + { + "setup.cfg": DALS(EXAMPLE_SETUPCFG) + + DALS( + """ + packages = find: + package_dir = + =src + + [options.packages.find] + where = src + """ + ) + }, + ), + ( + "src", + { + "pyproject.toml": DALS(EXAMPLE_PYPROJECT) + + DALS( + """ + [tool.setuptools] + package-dir = {"" = "src"} + """ + ) + }, + ), + ], + ) + def test_include_package_data(self, tmp_path, src_root, files): + """ + Make sure auto-discovery does not affect package include_package_data. + See issue #3196. + """ + jaraco.path.build(files, prefix=str(tmp_path)) + self._simulate_package_with_data_files(tmp_path, src_root) + + expected = { + os.path.normpath(f"{src_root}/proj/file1.txt").replace(os.sep, "/"), + os.path.normpath(f"{src_root}/proj/nested/file2.txt").replace(os.sep, "/"), + } + + _run_build(tmp_path) + + sdist_files = get_sdist_members(next(tmp_path.glob("dist/*.tar.gz"))) + print("~~~~~ sdist_members ~~~~~") + print('\n'.join(sdist_files)) + assert sdist_files >= expected + + wheel_files = get_wheel_members(next(tmp_path.glob("dist/*.whl"))) + print("~~~~~ wheel_members ~~~~~") + print('\n'.join(wheel_files)) + orig_files = {f.replace("src/", "").replace("lib/", "") for f in expected} + assert wheel_files >= orig_files + + +def test_compatible_with_numpy_configuration(tmp_path): + files = [ + "dir1/__init__.py", + "dir2/__init__.py", + "file.py", + ] + _populate_project_dir(tmp_path, files, {}) + dist = Distribution({}) + dist.configuration = object() + dist.set_defaults() + assert dist.py_modules is None + assert dist.packages is None + + +def test_name_discovery_doesnt_break_cli(tmpdir_cwd): + jaraco.path.build({"pkg.py": ""}) + dist = Distribution({}) + dist.script_args = ["--name"] + dist.set_defaults() + dist.parse_command_line() # <-- no exception should be raised here. + assert dist.get_name() == "pkg" + + +def test_preserve_explicit_name_with_dynamic_version(tmpdir_cwd, monkeypatch): + """According to #3545 it seems that ``name`` discovery is running, + even when the project already explicitly sets it. + This seems to be related to parsing of dynamic versions (via ``attr`` directive), + which requires the auto-discovery of ``package_dir``. + """ + files = { + "src": { + "pkg": {"__init__.py": "__version__ = 42\n"}, + }, + "pyproject.toml": DALS( + """ + [project] + name = "myproj" # purposefully different from package name + dynamic = ["version"] + [tool.setuptools.dynamic] + version = {"attr" = "pkg.__version__"} + """ + ), + } + jaraco.path.build(files) + dist = Distribution({}) + orig_analyse_name = dist.set_defaults.analyse_name + + def spy_analyse_name(): + # We can check if name discovery was triggered by ensuring the original + # name remains instead of the package name. + orig_analyse_name() + assert dist.get_name() == "myproj" + + monkeypatch.setattr(dist.set_defaults, "analyse_name", spy_analyse_name) + dist.parse_config_files() + assert dist.get_version() == "42" + assert set(dist.packages) == {"pkg"} + + +def _populate_project_dir(root, files, options): + # NOTE: Currently pypa/build will refuse to build the project if no + # `pyproject.toml` or `setup.py` is found. So it is impossible to do + # completely "config-less" projects. + basic = { + "setup.py": "import setuptools\nsetuptools.setup()", + "README.md": "# Example Package", + "LICENSE": "Copyright (c) 2018", + } + jaraco.path.build(basic, prefix=root) + _write_setupcfg(root, options) + paths = (root / f for f in files) + for path in paths: + path.parent.mkdir(exist_ok=True, parents=True) + path.touch() + + +def _write_setupcfg(root, options): + if not options: + print("~~~~~ **NO** setup.cfg ~~~~~") + return + setupcfg = ConfigParser() + setupcfg.add_section("options") + for key, value in options.items(): + if key == "packages.find": + setupcfg.add_section(f"options.{key}") + setupcfg[f"options.{key}"].update(value) + elif isinstance(value, list): + setupcfg["options"][key] = ", ".join(value) + elif isinstance(value, dict): + str_value = "\n".join(f"\t{k} = {v}" for k, v in value.items()) + setupcfg["options"][key] = "\n" + str_value + else: + setupcfg["options"][key] = str(value) + with open(root / "setup.cfg", "w", encoding="utf-8") as f: + setupcfg.write(f) + print("~~~~~ setup.cfg ~~~~~") + print((root / "setup.cfg").read_text(encoding="utf-8")) + + +def _run_build(path, *flags): + cmd = [sys.executable, "-m", "build", "--no-isolation", *flags, str(path)] + return run(cmd, env={'DISTUTILS_DEBUG': ''}) + + +def _get_dist(dist_path, attrs): + root = "/".join(os.path.split(dist_path)) # POSIX-style + + script = dist_path / 'setup.py' + if script.exists(): + with Path(dist_path): + dist = cast( + Distribution, + distutils.core.run_setup("setup.py", {}, stop_after="init"), + ) + else: + dist = Distribution(attrs) + + dist.src_root = root + dist.script_name = "setup.py" + with Path(dist_path): + dist.parse_config_files() + + dist.set_defaults() + return dist + + +def _run_sdist_programatically(dist_path, attrs): + dist = _get_dist(dist_path, attrs) + cmd = sdist(dist) + cmd.ensure_finalized() + assert cmd.distribution.packages or cmd.distribution.py_modules + + with quiet(), Path(dist_path): + cmd.run() + + return dist, cmd diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_core_metadata.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_core_metadata.py new file mode 100644 index 000000000..0d925111f --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_core_metadata.py @@ -0,0 +1,622 @@ +from __future__ import annotations + +import functools +import importlib +import io +from email import message_from_string +from email.generator import Generator +from email.message import EmailMessage, Message +from email.parser import Parser +from email.policy import EmailPolicy +from inspect import cleandoc +from pathlib import Path +from unittest.mock import Mock + +import jaraco.path +import pytest +from packaging.metadata import Metadata +from packaging.requirements import Requirement + +from setuptools import _reqs, sic +from setuptools._core_metadata import rfc822_escape, rfc822_unescape +from setuptools.command.egg_info import egg_info, write_requirements +from setuptools.config import expand, setupcfg +from setuptools.dist import Distribution + +from .config.downloads import retrieve_file, urls_from_file + +EXAMPLE_BASE_INFO = dict( + name="package", + version="0.0.1", + author="Foo Bar", + author_email="foo@bar.net", + long_description="Long\ndescription", + description="Short description", + keywords=["one", "two"], +) + + +@pytest.mark.parametrize( + ("content", "result"), + ( + pytest.param( + "Just a single line", + None, + id="single_line", + ), + pytest.param( + "Multiline\nText\nwithout\nextra indents\n", + None, + id="multiline", + ), + pytest.param( + "Multiline\n With\n\nadditional\n indentation", + None, + id="multiline_with_indentation", + ), + pytest.param( + " Leading whitespace", + "Leading whitespace", + id="remove_leading_whitespace", + ), + pytest.param( + " Leading whitespace\nIn\n Multiline comment", + "Leading whitespace\nIn\n Multiline comment", + id="remove_leading_whitespace_multiline", + ), + ), +) +def test_rfc822_unescape(content, result): + assert (result or content) == rfc822_unescape(rfc822_escape(content)) + + +def __read_test_cases(): + base = EXAMPLE_BASE_INFO + + params = functools.partial(dict, base) + + return [ + ('Metadata version 1.0', params()), + ( + 'Metadata Version 1.0: Short long description', + params( + long_description='Short long description', + ), + ), + ( + 'Metadata version 1.1: Classifiers', + params( + classifiers=[ + 'Programming Language :: Python :: 3', + 'Programming Language :: Python :: 3.7', + 'License :: OSI Approved :: MIT License', + ], + ), + ), + ( + 'Metadata version 1.1: Download URL', + params( + download_url='https://example.com', + ), + ), + ( + 'Metadata Version 1.2: Requires-Python', + params( + python_requires='>=3.7', + ), + ), + pytest.param( + 'Metadata Version 1.2: Project-Url', + params(project_urls=dict(Foo='https://example.bar')), + marks=pytest.mark.xfail( + reason="Issue #1578: project_urls not read", + ), + ), + ( + 'Metadata Version 2.1: Long Description Content Type', + params( + long_description_content_type='text/x-rst; charset=UTF-8', + ), + ), + ( + 'License', + params( + license='MIT', + ), + ), + ( + 'License multiline', + params( + license='This is a long license \nover multiple lines', + ), + ), + pytest.param( + 'Metadata Version 2.1: Provides Extra', + params(provides_extras=['foo', 'bar']), + marks=pytest.mark.xfail(reason="provides_extras not read"), + ), + ( + 'Missing author', + dict( + name='foo', + version='1.0.0', + author_email='snorri@sturluson.name', + ), + ), + ( + 'Missing author e-mail', + dict( + name='foo', + version='1.0.0', + author='Snorri Sturluson', + ), + ), + ( + 'Missing author and e-mail', + dict( + name='foo', + version='1.0.0', + ), + ), + ( + 'Bypass normalized version', + dict( + name='foo', + version=sic('1.0.0a'), + ), + ), + ] + + +@pytest.mark.parametrize(("name", "attrs"), __read_test_cases()) +def test_read_metadata(name, attrs): + dist = Distribution(attrs) + metadata_out = dist.metadata + dist_class = metadata_out.__class__ + + # Write to PKG_INFO and then load into a new metadata object + PKG_INFO = io.StringIO() + + metadata_out.write_pkg_file(PKG_INFO) + PKG_INFO.seek(0) + pkg_info = PKG_INFO.read() + assert _valid_metadata(pkg_info) + + PKG_INFO.seek(0) + metadata_in = dist_class() + metadata_in.read_pkg_file(PKG_INFO) + + tested_attrs = [ + ('name', dist_class.get_name), + ('version', dist_class.get_version), + ('author', dist_class.get_contact), + ('author_email', dist_class.get_contact_email), + ('metadata_version', dist_class.get_metadata_version), + ('provides', dist_class.get_provides), + ('description', dist_class.get_description), + ('long_description', dist_class.get_long_description), + ('download_url', dist_class.get_download_url), + ('keywords', dist_class.get_keywords), + ('platforms', dist_class.get_platforms), + ('obsoletes', dist_class.get_obsoletes), + ('requires', dist_class.get_requires), + ('classifiers', dist_class.get_classifiers), + ('project_urls', lambda s: getattr(s, 'project_urls', {})), + ('provides_extras', lambda s: getattr(s, 'provides_extras', {})), + ] + + for attr, getter in tested_attrs: + assert getter(metadata_in) == getter(metadata_out) + + +def __maintainer_test_cases(): + attrs = {"name": "package", "version": "1.0", "description": "xxx"} + + def merge_dicts(d1, d2): + d1 = d1.copy() + d1.update(d2) + + return d1 + + return [ + ('No author, no maintainer', attrs.copy()), + ( + 'Author (no e-mail), no maintainer', + merge_dicts(attrs, {'author': 'Author Name'}), + ), + ( + 'Author (e-mail), no maintainer', + merge_dicts( + attrs, {'author': 'Author Name', 'author_email': 'author@name.com'} + ), + ), + ( + 'No author, maintainer (no e-mail)', + merge_dicts(attrs, {'maintainer': 'Maintainer Name'}), + ), + ( + 'No author, maintainer (e-mail)', + merge_dicts( + attrs, + { + 'maintainer': 'Maintainer Name', + 'maintainer_email': 'maintainer@name.com', + }, + ), + ), + ( + 'Author (no e-mail), Maintainer (no-email)', + merge_dicts( + attrs, {'author': 'Author Name', 'maintainer': 'Maintainer Name'} + ), + ), + ( + 'Author (e-mail), Maintainer (e-mail)', + merge_dicts( + attrs, + { + 'author': 'Author Name', + 'author_email': 'author@name.com', + 'maintainer': 'Maintainer Name', + 'maintainer_email': 'maintainer@name.com', + }, + ), + ), + ( + 'No author (e-mail), no maintainer (e-mail)', + merge_dicts( + attrs, + { + 'author_email': 'author@name.com', + 'maintainer_email': 'maintainer@name.com', + }, + ), + ), + ('Author unicode', merge_dicts(attrs, {'author': '鉄沢寛'})), + ('Maintainer unicode', merge_dicts(attrs, {'maintainer': 'Jan Łukasiewicz'})), + ] + + +@pytest.mark.parametrize(("name", "attrs"), __maintainer_test_cases()) +def test_maintainer_author(name, attrs, tmpdir): + tested_keys = { + 'author': 'Author', + 'author_email': 'Author-email', + 'maintainer': 'Maintainer', + 'maintainer_email': 'Maintainer-email', + } + + # Generate a PKG-INFO file + dist = Distribution(attrs) + fn = tmpdir.mkdir('pkg_info') + fn_s = str(fn) + + dist.metadata.write_pkg_info(fn_s) + + with open(str(fn.join('PKG-INFO')), 'r', encoding='utf-8') as f: + pkg_info = f.read() + + assert _valid_metadata(pkg_info) + + # Drop blank lines and strip lines from default description + raw_pkg_lines = pkg_info.splitlines() + pkg_lines = list(filter(None, raw_pkg_lines[:-2])) + + pkg_lines_set = set(pkg_lines) + + # Duplicate lines should not be generated + assert len(pkg_lines) == len(pkg_lines_set) + + for fkey, dkey in tested_keys.items(): + val = attrs.get(dkey, None) + if val is None: + for line in pkg_lines: + assert not line.startswith(fkey + ':') + else: + line = f'{fkey}: {val}' + assert line in pkg_lines_set + + +class TestParityWithMetadataFromPyPaWheel: + def base_example(self): + attrs = dict( + **EXAMPLE_BASE_INFO, + # Example with complex requirement definition + python_requires=">=3.8", + install_requires=""" + packaging==23.2 + more-itertools==8.8.0; extra == "other" + jaraco.text==3.7.0 + importlib-resources==5.10.2; python_version<"3.8" + importlib-metadata==6.0.0 ; python_version<"3.8" + colorama>=0.4.4; sys_platform == "win32" + """, + extras_require={ + "testing": """ + pytest >= 6 + pytest-checkdocs >= 2.4 + tomli ; \\ + # Using stdlib when possible + python_version < "3.11" + ini2toml[lite]>=0.9 + """, + "other": [], + }, + ) + # Generate a PKG-INFO file using setuptools + return Distribution(attrs) + + def test_requires_dist(self, tmp_path): + dist = self.base_example() + pkg_info = _get_pkginfo(dist) + assert _valid_metadata(pkg_info) + + # Ensure Requires-Dist is present + expected = [ + 'Metadata-Version:', + 'Requires-Python: >=3.8', + 'Provides-Extra: other', + 'Provides-Extra: testing', + 'Requires-Dist: tomli; python_version < "3.11" and extra == "testing"', + 'Requires-Dist: more-itertools==8.8.0; extra == "other"', + 'Requires-Dist: ini2toml[lite]>=0.9; extra == "testing"', + ] + for line in expected: + assert line in pkg_info + + HERE = Path(__file__).parent + EXAMPLES_FILE = HERE / "config/setupcfg_examples.txt" + + @pytest.fixture(params=[None, *urls_from_file(EXAMPLES_FILE)]) + def dist(self, request, monkeypatch, tmp_path): + """Example of distribution with arbitrary configuration""" + monkeypatch.chdir(tmp_path) + monkeypatch.setattr(expand, "read_attr", Mock(return_value="0.42")) + monkeypatch.setattr(expand, "read_files", Mock(return_value="hello world")) + monkeypatch.setattr( + Distribution, "_finalize_license_files", Mock(return_value=None) + ) + if request.param is None: + yield self.base_example() + else: + # Real-world usage + config = retrieve_file(request.param) + yield setupcfg.apply_configuration(Distribution({}), config) + + @pytest.mark.uses_network + def test_equivalent_output(self, tmp_path, dist): + """Ensure output from setuptools is equivalent to the one from `pypa/wheel`""" + # Generate a METADATA file using pypa/wheel for comparison + wheel_metadata = importlib.import_module("wheel.metadata") + pkginfo_to_metadata = getattr(wheel_metadata, "pkginfo_to_metadata", None) + + if pkginfo_to_metadata is None: # pragma: nocover + pytest.xfail( + "wheel.metadata.pkginfo_to_metadata is undefined, " + "(this is likely to be caused by API changes in pypa/wheel" + ) + + # Generate an simplified "egg-info" dir for pypa/wheel to convert + pkg_info = _get_pkginfo(dist) + egg_info_dir = tmp_path / "pkg.egg-info" + egg_info_dir.mkdir(parents=True) + (egg_info_dir / "PKG-INFO").write_text(pkg_info, encoding="utf-8") + write_requirements(egg_info(dist), egg_info_dir, egg_info_dir / "requires.txt") + + # Get pypa/wheel generated METADATA but normalize requirements formatting + metadata_msg = pkginfo_to_metadata(egg_info_dir, egg_info_dir / "PKG-INFO") + metadata_str = _normalize_metadata(metadata_msg) + pkg_info_msg = message_from_string(pkg_info) + pkg_info_str = _normalize_metadata(pkg_info_msg) + + # Compare setuptools PKG-INFO x pypa/wheel METADATA + assert metadata_str == pkg_info_str + + # Make sure it parses/serializes well in pypa/wheel + _assert_roundtrip_message(pkg_info) + + +class TestPEP643: + STATIC_CONFIG = { + "setup.cfg": cleandoc( + """ + [metadata] + name = package + version = 0.0.1 + author = Foo Bar + author_email = foo@bar.net + long_description = Long + description + description = Short description + keywords = one, two + platforms = abcd + [options] + install_requires = requests + """ + ), + "pyproject.toml": cleandoc( + """ + [project] + name = "package" + version = "0.0.1" + authors = [ + {name = "Foo Bar", email = "foo@bar.net"} + ] + description = "Short description" + readme = {text = "Long\\ndescription", content-type = "text/plain"} + keywords = ["one", "two"] + dependencies = ["requests"] + license = "AGPL-3.0-or-later" + [tool.setuptools] + provides = ["abcd"] + obsoletes = ["abcd"] + """ + ), + } + + @pytest.mark.parametrize("file", STATIC_CONFIG.keys()) + def test_static_config_has_no_dynamic(self, file, tmpdir_cwd): + Path(file).write_text(self.STATIC_CONFIG[file], encoding="utf-8") + metadata = _get_metadata() + assert metadata.get_all("Dynamic") is None + assert metadata.get_all("dynamic") is None + + @pytest.mark.parametrize("file", STATIC_CONFIG.keys()) + @pytest.mark.parametrize( + "fields", + [ + # Single dynamic field + {"requires-python": ("python_requires", ">=3.12")}, + {"author-email": ("author_email", "snoopy@peanuts.com")}, + {"keywords": ("keywords", ["hello", "world"])}, + {"platform": ("platforms", ["abcd"])}, + # Multiple dynamic fields + { + "summary": ("description", "hello world"), + "description": ("long_description", "bla bla bla bla"), + "requires-dist": ("install_requires", ["hello-world"]), + }, + ], + ) + def test_modified_fields_marked_as_dynamic(self, file, fields, tmpdir_cwd): + # We start with a static config + Path(file).write_text(self.STATIC_CONFIG[file], encoding="utf-8") + dist = _makedist() + + # ... but then we simulate the effects of a plugin modifying the distribution + for attr, value in fields.values(): + # `dist` and `dist.metadata` are complicated... + # Some attributes work when set on `dist`, others on `dist.metadata`... + # Here we set in both just in case (this also avoids calling `_finalize_*`) + setattr(dist, attr, value) + setattr(dist.metadata, attr, value) + + # Then we should be able to list the modified fields as Dynamic + metadata = _get_metadata(dist) + assert set(metadata.get_all("Dynamic")) == set(fields) + + @pytest.mark.parametrize( + "extra_toml", + [ + "# Let setuptools autofill license-files", + "license-files = ['LICENSE*', 'AUTHORS*', 'NOTICE']", + ], + ) + def test_license_files_dynamic(self, extra_toml, tmpdir_cwd): + # For simplicity (and for the time being) setuptools is not making + # any special handling to guarantee `License-File` is considered static. + # Instead we rely in the fact that, although suboptimal, it is OK to have + # it as dynamics, as per: + # https://github.com/pypa/setuptools/issues/4629#issuecomment-2331233677 + files = { + "pyproject.toml": self.STATIC_CONFIG["pyproject.toml"].replace( + 'license = "AGPL-3.0-or-later"', + f"dynamic = ['license']\n{extra_toml}", + ), + "LICENSE.md": "--- mock license ---", + "NOTICE": "--- mock notice ---", + "AUTHORS.txt": "--- me ---", + } + # Sanity checks: + assert extra_toml in files["pyproject.toml"] + assert 'license = "AGPL-3.0-or-later"' not in extra_toml + + jaraco.path.build(files) + dist = _makedist(license_expression="AGPL-3.0-or-later") + metadata = _get_metadata(dist) + assert set(metadata.get_all("Dynamic")) == { + 'license-file', + 'license-expression', + } + assert metadata.get("License-Expression") == "AGPL-3.0-or-later" + assert set(metadata.get_all("License-File")) == { + "NOTICE", + "AUTHORS.txt", + "LICENSE.md", + } + + +def _makedist(**attrs): + dist = Distribution(attrs) + dist.parse_config_files() + return dist + + +def _assert_roundtrip_message(metadata: str) -> None: + """Emulate the way wheel.bdist_wheel parses and regenerates the message, + then ensures the metadata generated by setuptools is compatible. + """ + with io.StringIO(metadata) as buffer: + msg = Parser(EmailMessage).parse(buffer) + + serialization_policy = EmailPolicy( + utf8=True, + mangle_from_=False, + max_line_length=0, + ) + with io.BytesIO() as buffer: + out = io.TextIOWrapper(buffer, encoding="utf-8") + Generator(out, policy=serialization_policy).flatten(msg) + out.flush() + regenerated = buffer.getvalue() + + raw_metadata = bytes(metadata, "utf-8") + # Normalise newlines to avoid test errors on Windows: + raw_metadata = b"\n".join(raw_metadata.splitlines()) + regenerated = b"\n".join(regenerated.splitlines()) + assert regenerated == raw_metadata + + +def _normalize_metadata(msg: Message) -> str: + """Allow equivalent metadata to be compared directly""" + # The main challenge regards the requirements and extras. + # Both setuptools and wheel already apply some level of normalization + # but they differ regarding which character is chosen, according to the + # following spec it should be "-": + # https://packaging.python.org/en/latest/specifications/name-normalization/ + + # Related issues: + # https://github.com/pypa/packaging/issues/845 + # https://github.com/pypa/packaging/issues/644#issuecomment-2429813968 + + extras = {x.replace("_", "-"): x for x in msg.get_all("Provides-Extra", [])} + reqs = [ + _normalize_req(req, extras) + for req in _reqs.parse(msg.get_all("Requires-Dist", [])) + ] + del msg["Requires-Dist"] + del msg["Provides-Extra"] + + # Ensure consistent ord + for req in sorted(reqs): + msg["Requires-Dist"] = req + for extra in sorted(extras): + msg["Provides-Extra"] = extra + + # TODO: Handle lack of PEP 643 implementation in pypa/wheel? + del msg["Metadata-Version"] + + return msg.as_string() + + +def _normalize_req(req: Requirement, extras: dict[str, str]) -> str: + """Allow equivalent requirement objects to be compared directly""" + as_str = str(req).replace(req.name, req.name.replace("_", "-")) + for norm, orig in extras.items(): + as_str = as_str.replace(orig, norm) + return as_str + + +def _get_pkginfo(dist: Distribution): + with io.StringIO() as fp: + dist.metadata.write_pkg_file(fp) + return fp.getvalue() + + +def _get_metadata(dist: Distribution | None = None): + return message_from_string(_get_pkginfo(dist or _makedist())) + + +def _valid_metadata(text: str) -> bool: + metadata = Metadata.from_email(text, validate=True) # can raise exceptions + return metadata is not None diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_depends.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_depends.py new file mode 100644 index 000000000..1714c041f --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_depends.py @@ -0,0 +1,15 @@ +import sys + +from setuptools import depends + + +class TestGetModuleConstant: + def test_basic(self): + """ + Invoke get_module_constant on a module in + the test package. + """ + mod_name = 'setuptools.tests.mod_with_constant' + val = depends.get_module_constant(mod_name, 'value') + assert val == 'three, sir!' + assert 'setuptools.tests.mod_with_constant' not in sys.modules diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_develop.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_develop.py new file mode 100644 index 000000000..354c51fc3 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_develop.py @@ -0,0 +1,112 @@ +"""develop tests""" + +import os +import platform +import subprocess +import sys + +import pytest + +from setuptools._path import paths_on_pythonpath + +from . import contexts, namespaces + +SETUP_PY = """\ +from setuptools import setup + +setup(name='foo', + packages=['foo'], +) +""" + +INIT_PY = """print "foo" +""" + + +@pytest.fixture +def temp_user(monkeypatch): + with contexts.tempdir() as user_base: + with contexts.tempdir() as user_site: + monkeypatch.setattr('site.USER_BASE', user_base) + monkeypatch.setattr('site.USER_SITE', user_site) + yield + + +@pytest.fixture +def test_env(tmpdir, temp_user): + target = tmpdir + foo = target.mkdir('foo') + setup = target / 'setup.py' + if setup.isfile(): + raise ValueError(dir(target)) + with setup.open('w') as f: + f.write(SETUP_PY) + init = foo / '__init__.py' + with init.open('w') as f: + f.write(INIT_PY) + with target.as_cwd(): + yield target + + +class TestNamespaces: + @staticmethod + def install_develop(src_dir, target): + develop_cmd = [ + sys.executable, + 'setup.py', + 'develop', + '--install-dir', + str(target), + ] + with src_dir.as_cwd(): + with paths_on_pythonpath([str(target)]): + subprocess.check_call(develop_cmd) + + @pytest.mark.skipif( + bool(os.environ.get("APPVEYOR")), + reason="https://github.com/pypa/setuptools/issues/851", + ) + @pytest.mark.skipif( + platform.python_implementation() == 'PyPy', + reason="https://github.com/pypa/setuptools/issues/1202", + ) + @pytest.mark.uses_network + def test_namespace_package_importable(self, tmpdir): + """ + Installing two packages sharing the same namespace, one installed + naturally using pip or `--single-version-externally-managed` + and the other installed using `develop` should leave the namespace + in tact and both packages reachable by import. + """ + pkg_A = namespaces.build_namespace_package(tmpdir, 'myns.pkgA') + pkg_B = namespaces.build_namespace_package(tmpdir, 'myns.pkgB') + target = tmpdir / 'packages' + # use pip to install to the target directory + install_cmd = [ + sys.executable, + '-m', + 'pip', + 'install', + str(pkg_A), + '-t', + str(target), + ] + subprocess.check_call(install_cmd) + self.install_develop(pkg_B, target) + namespaces.make_site_dir(target) + try_import = [ + sys.executable, + '-c', + 'import myns.pkgA; import myns.pkgB', + ] + with paths_on_pythonpath([str(target)]): + subprocess.check_call(try_import) + + # additionally ensure that pkg_resources import works + pkg_resources_imp = [ + sys.executable, + '-c', + 'import pkg_resources', + ] + with paths_on_pythonpath([str(target)]): + subprocess.check_call(pkg_resources_imp) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_dist.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_dist.py new file mode 100644 index 000000000..552ee2d2e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_dist.py @@ -0,0 +1,278 @@ +import os +import re +import urllib.parse +import urllib.request + +import pytest + +from setuptools import Distribution +from setuptools.dist import check_package_data, check_specifier + +from .fixtures import make_trivial_sdist +from .test_find_packages import ensure_files +from .textwrap import DALS + +from distutils.errors import DistutilsSetupError + + +def test_dist_fetch_build_egg(tmpdir): + """ + Check multiple calls to `Distribution.fetch_build_egg` work as expected. + """ + index = tmpdir.mkdir('index') + index_url = urllib.parse.urljoin('file://', urllib.request.pathname2url(str(index))) + + def sdist_with_index(distname, version): + dist_dir = index.mkdir(distname) + dist_sdist = f'{distname}-{version}.tar.gz' + make_trivial_sdist(str(dist_dir.join(dist_sdist)), distname, version) + with dist_dir.join('index.html').open('w') as fp: + fp.write( + DALS( + """ + + {dist_sdist}
    + + """ + ).format(dist_sdist=dist_sdist) + ) + + sdist_with_index('barbazquux', '3.2.0') + sdist_with_index('barbazquux-runner', '2.11.1') + with tmpdir.join('setup.cfg').open('w') as fp: + fp.write( + DALS( + """ + [easy_install] + index_url = {index_url} + """ + ).format(index_url=index_url) + ) + reqs = """ + barbazquux-runner + barbazquux + """.split() + with tmpdir.as_cwd(): + dist = Distribution() + dist.parse_config_files() + resolved_dists = [dist.fetch_build_egg(r) for r in reqs] + assert [dist.name for dist in resolved_dists if dist] == reqs + + +EXAMPLE_BASE_INFO = dict( + name="package", + version="0.0.1", + author="Foo Bar", + author_email="foo@bar.net", + long_description="Long\ndescription", + description="Short description", + keywords=["one", "two"], +) + + +def test_provides_extras_deterministic_order(): + attrs = dict(extras_require=dict(a=['foo'], b=['bar'])) + dist = Distribution(attrs) + assert list(dist.metadata.provides_extras) == ['a', 'b'] + attrs['extras_require'] = dict(reversed(attrs['extras_require'].items())) + dist = Distribution(attrs) + assert list(dist.metadata.provides_extras) == ['b', 'a'] + + +CHECK_PACKAGE_DATA_TESTS = ( + # Valid. + ( + { + '': ['*.txt', '*.rst'], + 'hello': ['*.msg'], + }, + None, + ), + # Not a dictionary. + ( + ( + ('', ['*.txt', '*.rst']), + ('hello', ['*.msg']), + ), + ( + "'package_data' must be a dictionary mapping package" + " names to lists of string wildcard patterns" + ), + ), + # Invalid key type. + ( + { + 400: ['*.txt', '*.rst'], + }, + ("keys of 'package_data' dict must be strings (got 400)"), + ), + # Invalid value type. + ( + { + 'hello': '*.msg', + }, + ( + "\"values of 'package_data' dict\" must be of type " + " (got '*.msg')" + ), + ), + # Invalid value type (generators are single use) + ( + { + 'hello': (x for x in "generator"), + }, + ( + "\"values of 'package_data' dict\" must be of type " + " (got =3.0, !=3.1'} + dist = Distribution(attrs) + check_specifier(dist, attrs, attrs['python_requires']) + + attrs = {'name': 'foo', 'python_requires': ['>=3.0', '!=3.1']} + dist = Distribution(attrs) + check_specifier(dist, attrs, attrs['python_requires']) + + # invalid specifier value + attrs = {'name': 'foo', 'python_requires': '>=invalid-version'} + with pytest.raises(DistutilsSetupError): + dist = Distribution(attrs) + + +def test_metadata_name(): + with pytest.raises(DistutilsSetupError, match='missing.*name'): + Distribution()._validate_metadata() + + +@pytest.mark.parametrize( + ('dist_name', 'py_module'), + [ + ("my.pkg", "my_pkg"), + ("my-pkg", "my_pkg"), + ("my_pkg", "my_pkg"), + ("pkg", "pkg"), + ], +) +def test_dist_default_py_modules(tmp_path, dist_name, py_module): + (tmp_path / f"{py_module}.py").touch() + + (tmp_path / "setup.py").touch() + (tmp_path / "noxfile.py").touch() + # ^-- make sure common tool files are ignored + + attrs = {**EXAMPLE_BASE_INFO, "name": dist_name, "src_root": str(tmp_path)} + # Find `py_modules` corresponding to dist_name if not given + dist = Distribution(attrs) + dist.set_defaults() + assert dist.py_modules == [py_module] + # When `py_modules` is given, don't do anything + dist = Distribution({**attrs, "py_modules": ["explicity_py_module"]}) + dist.set_defaults() + assert dist.py_modules == ["explicity_py_module"] + # When `packages` is given, don't do anything + dist = Distribution({**attrs, "packages": ["explicity_package"]}) + dist.set_defaults() + assert not dist.py_modules + + +@pytest.mark.parametrize( + ('dist_name', 'package_dir', 'package_files', 'packages'), + [ + ("my.pkg", None, ["my_pkg/__init__.py", "my_pkg/mod.py"], ["my_pkg"]), + ("my-pkg", None, ["my_pkg/__init__.py", "my_pkg/mod.py"], ["my_pkg"]), + ("my_pkg", None, ["my_pkg/__init__.py", "my_pkg/mod.py"], ["my_pkg"]), + ("my.pkg", None, ["my/pkg/__init__.py"], ["my", "my.pkg"]), + ( + "my_pkg", + None, + ["src/my_pkg/__init__.py", "src/my_pkg2/__init__.py"], + ["my_pkg", "my_pkg2"], + ), + ( + "my_pkg", + {"pkg": "lib", "pkg2": "lib2"}, + ["lib/__init__.py", "lib/nested/__init__.pyt", "lib2/__init__.py"], + ["pkg", "pkg.nested", "pkg2"], + ), + ], +) +def test_dist_default_packages( + tmp_path, dist_name, package_dir, package_files, packages +): + ensure_files(tmp_path, package_files) + + (tmp_path / "setup.py").touch() + (tmp_path / "noxfile.py").touch() + # ^-- should not be included by default + + attrs = { + **EXAMPLE_BASE_INFO, + "name": dist_name, + "src_root": str(tmp_path), + "package_dir": package_dir, + } + # Find `packages` either corresponding to dist_name or inside src + dist = Distribution(attrs) + dist.set_defaults() + assert not dist.py_modules + assert not dist.py_modules + assert set(dist.packages) == set(packages) + # When `py_modules` is given, don't do anything + dist = Distribution({**attrs, "py_modules": ["explicit_py_module"]}) + dist.set_defaults() + assert not dist.packages + assert set(dist.py_modules) == {"explicit_py_module"} + # When `packages` is given, don't do anything + dist = Distribution({**attrs, "packages": ["explicit_package"]}) + dist.set_defaults() + assert not dist.py_modules + assert set(dist.packages) == {"explicit_package"} + + +@pytest.mark.parametrize( + ('dist_name', 'package_dir', 'package_files'), + [ + ("my.pkg.nested", None, ["my/pkg/nested/__init__.py"]), + ("my.pkg", None, ["my/pkg/__init__.py", "my/pkg/file.py"]), + ("my_pkg", None, ["my_pkg.py"]), + ("my_pkg", None, ["my_pkg/__init__.py", "my_pkg/nested/__init__.py"]), + ("my_pkg", None, ["src/my_pkg/__init__.py", "src/my_pkg/nested/__init__.py"]), + ( + "my_pkg", + {"my_pkg": "lib", "my_pkg.lib2": "lib2"}, + ["lib/__init__.py", "lib/nested/__init__.pyt", "lib2/__init__.py"], + ), + # Should not try to guess a name from multiple py_modules/packages + ("UNKNOWN", None, ["src/mod1.py", "src/mod2.py"]), + ("UNKNOWN", None, ["src/pkg1/__ini__.py", "src/pkg2/__init__.py"]), + ], +) +def test_dist_default_name(tmp_path, dist_name, package_dir, package_files): + """Make sure dist.name is discovered from packages/py_modules""" + ensure_files(tmp_path, package_files) + attrs = { + **EXAMPLE_BASE_INFO, + "src_root": "/".join(os.path.split(tmp_path)), # POSIX-style + "package_dir": package_dir, + } + del attrs["name"] + + dist = Distribution(attrs) + dist.set_defaults() + assert dist.py_modules or dist.packages + assert dist.get_name() == dist_name diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_dist_info.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_dist_info.py new file mode 100644 index 000000000..010018d1e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_dist_info.py @@ -0,0 +1,147 @@ +"""Test .dist-info style distributions.""" + +import pathlib +import re +import shutil +import subprocess +import sys +from functools import partial + +import pytest + +from setuptools.archive_util import unpack_archive + +from .textwrap import DALS + +read = partial(pathlib.Path.read_text, encoding="utf-8") + + +class TestDistInfo: + def test_invalid_version(self, tmp_path): + """ + Supplying an invalid version crashes dist_info. + """ + config = "[metadata]\nname=proj\nversion=42\n[egg_info]\ntag_build=invalid!!!\n" + (tmp_path / "setup.cfg").write_text(config, encoding="utf-8") + msg = re.compile("invalid version", re.M | re.I) + proc = run_command_inner("dist_info", cwd=tmp_path, check=False) + assert proc.returncode + assert msg.search(proc.stdout) + assert not list(tmp_path.glob("*.dist-info")) + + def test_tag_arguments(self, tmp_path): + config = """ + [metadata] + name=proj + version=42 + [egg_info] + tag_date=1 + tag_build=.post + """ + (tmp_path / "setup.cfg").write_text(config, encoding="utf-8") + + print(run_command("dist_info", "--no-date", cwd=tmp_path)) + dist_info = next(tmp_path.glob("*.dist-info")) + assert dist_info.name.startswith("proj-42") + shutil.rmtree(dist_info) + + print(run_command("dist_info", "--tag-build", ".a", cwd=tmp_path)) + dist_info = next(tmp_path.glob("*.dist-info")) + assert dist_info.name.startswith("proj-42a") + + @pytest.mark.parametrize("keep_egg_info", (False, True)) + def test_output_dir(self, tmp_path, keep_egg_info): + config = "[metadata]\nname=proj\nversion=42\n" + (tmp_path / "setup.cfg").write_text(config, encoding="utf-8") + out = tmp_path / "__out" + out.mkdir() + opts = ["--keep-egg-info"] if keep_egg_info else [] + run_command("dist_info", "--output-dir", out, *opts, cwd=tmp_path) + assert len(list(out.glob("*.dist-info"))) == 1 + assert len(list(tmp_path.glob("*.dist-info"))) == 0 + expected_egg_info = int(keep_egg_info) + assert len(list(out.glob("*.egg-info"))) == expected_egg_info + assert len(list(tmp_path.glob("*.egg-info"))) == 0 + assert len(list(out.glob("*.__bkp__"))) == 0 + assert len(list(tmp_path.glob("*.__bkp__"))) == 0 + + +class TestWheelCompatibility: + """Make sure the .dist-info directory produced with the ``dist_info`` command + is the same as the one produced by ``bdist_wheel``. + """ + + SETUPCFG = DALS( + """ + [metadata] + name = {name} + version = {version} + + [options] + install_requires = + foo>=12; sys_platform != "linux" + + [options.extras_require] + test = pytest + + [options.entry_points] + console_scripts = + executable-name = my_package.module:function + discover = + myproj = my_package.other_module:function + """ + ) + + EGG_INFO_OPTS = [ + # Related: #3088 #2872 + ("", ""), + (".post", "[egg_info]\ntag_build = post\n"), + (".post", "[egg_info]\ntag_build = .post\n"), + (".post", "[egg_info]\ntag_build = post\ntag_date = 1\n"), + (".dev", "[egg_info]\ntag_build = .dev\n"), + (".dev", "[egg_info]\ntag_build = .dev\ntag_date = 1\n"), + ("a1", "[egg_info]\ntag_build = .a1\n"), + ("+local", "[egg_info]\ntag_build = +local\n"), + ] + + @pytest.mark.parametrize("name", "my-proj my_proj my.proj My.Proj".split()) + @pytest.mark.parametrize("version", ["0.42.13"]) + @pytest.mark.parametrize(("suffix", "cfg"), EGG_INFO_OPTS) + def test_dist_info_is_the_same_as_in_wheel( + self, name, version, tmp_path, suffix, cfg + ): + config = self.SETUPCFG.format(name=name, version=version) + cfg + + for i in "dir_wheel", "dir_dist": + (tmp_path / i).mkdir() + (tmp_path / i / "setup.cfg").write_text(config, encoding="utf-8") + + run_command("bdist_wheel", cwd=tmp_path / "dir_wheel") + wheel = next(tmp_path.glob("dir_wheel/dist/*.whl")) + unpack_archive(wheel, tmp_path / "unpack") + wheel_dist_info = next(tmp_path.glob("unpack/*.dist-info")) + + run_command("dist_info", cwd=tmp_path / "dir_dist") + dist_info = next(tmp_path.glob("dir_dist/*.dist-info")) + + assert dist_info.name == wheel_dist_info.name + assert dist_info.name.startswith(f"my_proj-{version}{suffix}") + for file in "METADATA", "entry_points.txt": + assert read(dist_info / file) == read(wheel_dist_info / file) + + +def run_command_inner(*cmd, **kwargs): + opts = { + "stderr": subprocess.STDOUT, + "stdout": subprocess.PIPE, + "text": True, + "encoding": "utf-8", + "check": True, + **kwargs, + } + cmd = [sys.executable, "-c", "__import__('setuptools').setup()", *map(str, cmd)] + return subprocess.run(cmd, **opts) + + +def run_command(*args, **kwargs): + return run_command_inner(*args, **kwargs).stdout diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_distutils_adoption.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_distutils_adoption.py new file mode 100644 index 000000000..f99a58849 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_distutils_adoption.py @@ -0,0 +1,198 @@ +import os +import platform +import sys +import textwrap + +import pytest + +IS_PYPY = '__pypy__' in sys.builtin_module_names + +_TEXT_KWARGS = {"text": True, "encoding": "utf-8"} # For subprocess.run + + +def win_sr(env): + """ + On Windows, SYSTEMROOT must be present to avoid + + > Fatal Python error: _Py_HashRandomization_Init: failed to + > get random numbers to initialize Python + """ + if env and platform.system() == 'Windows': + env['SYSTEMROOT'] = os.environ['SYSTEMROOT'] + return env + + +def find_distutils(venv, imports='distutils', env=None, **kwargs): + py_cmd = 'import {imports}; print(distutils.__file__)'.format(**locals()) + cmd = ['python', '-c', py_cmd] + return venv.run(cmd, env=win_sr(env), **_TEXT_KWARGS, **kwargs) + + +def count_meta_path(venv, env=None): + py_cmd = textwrap.dedent( + """ + import sys + is_distutils = lambda finder: finder.__class__.__name__ == "DistutilsMetaFinder" + print(len(list(filter(is_distutils, sys.meta_path)))) + """ + ) + cmd = ['python', '-c', py_cmd] + return int(venv.run(cmd, env=win_sr(env), **_TEXT_KWARGS)) + + +skip_without_stdlib_distutils = pytest.mark.skipif( + sys.version_info >= (3, 12), + reason='stdlib distutils is removed from Python 3.12+', +) + + +@skip_without_stdlib_distutils +def test_distutils_stdlib(venv): + """ + Ensure stdlib distutils is used when appropriate. + """ + env = dict(SETUPTOOLS_USE_DISTUTILS='stdlib') + assert venv.name not in find_distutils(venv, env=env).split(os.sep) + assert count_meta_path(venv, env=env) == 0 + + +def test_distutils_local_with_setuptools(venv): + """ + Ensure local distutils is used when appropriate. + """ + env = dict(SETUPTOOLS_USE_DISTUTILS='local') + loc = find_distutils(venv, imports='setuptools, distutils', env=env) + assert venv.name in loc.split(os.sep) + assert count_meta_path(venv, env=env) <= 1 + + +@pytest.mark.xfail('IS_PYPY', reason='pypy imports distutils on startup') +def test_distutils_local(venv): + """ + Even without importing, the setuptools-local copy of distutils is + preferred. + """ + env = dict(SETUPTOOLS_USE_DISTUTILS='local') + assert venv.name in find_distutils(venv, env=env).split(os.sep) + assert count_meta_path(venv, env=env) <= 1 + + +def test_pip_import(venv): + """ + Ensure pip can be imported. + Regression test for #3002. + """ + cmd = ['python', '-c', 'import pip'] + venv.run(cmd, **_TEXT_KWARGS) + + +def test_distutils_has_origin(): + """ + Distutils module spec should have an origin. #2990. + """ + assert __import__('distutils').__spec__.origin + + +ENSURE_IMPORTS_ARE_NOT_DUPLICATED = r""" +# Depending on the importlib machinery and _distutils_hack, some imports are +# duplicated resulting in different module objects being loaded, which prevents +# patches as shown in #3042. +# This script provides a way of verifying if this duplication is happening. + +from distutils import cmd +import distutils.command.sdist as sdist + +# import last to prevent caching +from distutils import {imported_module} + +for mod in (cmd, sdist): + assert mod.{imported_module} == {imported_module}, ( + f"\n{{mod.dir_util}}\n!=\n{{{imported_module}}}" + ) + +print("success") +""" + + +@pytest.mark.usefixtures("tmpdir_cwd") +@pytest.mark.parametrize( + ('distutils_version', 'imported_module'), + [ + pytest.param("stdlib", "dir_util", marks=skip_without_stdlib_distutils), + pytest.param("stdlib", "file_util", marks=skip_without_stdlib_distutils), + pytest.param("stdlib", "archive_util", marks=skip_without_stdlib_distutils), + ("local", "dir_util"), + ("local", "file_util"), + ("local", "archive_util"), + ], +) +def test_modules_are_not_duplicated_on_import(distutils_version, imported_module, venv): + env = dict(SETUPTOOLS_USE_DISTUTILS=distutils_version) + script = ENSURE_IMPORTS_ARE_NOT_DUPLICATED.format(imported_module=imported_module) + cmd = ['python', '-c', script] + output = venv.run(cmd, env=win_sr(env), **_TEXT_KWARGS).strip() + assert output == "success" + + +ENSURE_LOG_IMPORT_IS_NOT_DUPLICATED = r""" +import types +import distutils.dist as dist +from distutils import log +if isinstance(dist.log, types.ModuleType): + assert dist.log == log, f"\n{dist.log}\n!=\n{log}" +print("success") +""" + + +@pytest.mark.usefixtures("tmpdir_cwd") +@pytest.mark.parametrize( + "distutils_version", + [ + "local", + pytest.param("stdlib", marks=skip_without_stdlib_distutils), + ], +) +def test_log_module_is_not_duplicated_on_import(distutils_version, venv): + env = dict(SETUPTOOLS_USE_DISTUTILS=distutils_version) + cmd = ['python', '-c', ENSURE_LOG_IMPORT_IS_NOT_DUPLICATED] + output = venv.run(cmd, env=win_sr(env), **_TEXT_KWARGS).strip() + assert output == "success" + + +ENSURE_CONSISTENT_ERROR_FROM_MODIFIED_PY = r""" +from setuptools.modified import newer +from {imported_module}.errors import DistutilsError + +# Can't use pytest.raises in this context +try: + newer("", "") +except DistutilsError: + print("success") +else: + raise AssertionError("Expected to raise") +""" + + +@pytest.mark.usefixtures("tmpdir_cwd") +@pytest.mark.parametrize( + ('distutils_version', 'imported_module'), + [ + ("local", "distutils"), + # Unfortunately we still get ._distutils.errors.DistutilsError with SETUPTOOLS_USE_DISTUTILS=stdlib + # But that's a deprecated use-case we don't mind not fully supporting in newer code + pytest.param( + "stdlib", "setuptools._distutils", marks=skip_without_stdlib_distutils + ), + ], +) +def test_consistent_error_from_modified_py(distutils_version, imported_module, venv): + env = dict(SETUPTOOLS_USE_DISTUTILS=distutils_version) + cmd = [ + 'python', + '-c', + ENSURE_CONSISTENT_ERROR_FROM_MODIFIED_PY.format( + imported_module=imported_module + ), + ] + output = venv.run(cmd, env=win_sr(env), **_TEXT_KWARGS).strip() + assert output == "success" diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_editable_install.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_editable_install.py new file mode 100644 index 000000000..225fc6a2f --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_editable_install.py @@ -0,0 +1,1263 @@ +from __future__ import annotations + +import os +import platform +import stat +import subprocess +import sys +from copy import deepcopy +from importlib import import_module +from importlib.machinery import EXTENSION_SUFFIXES +from pathlib import Path +from textwrap import dedent +from typing import Any +from unittest.mock import Mock +from uuid import uuid4 + +import jaraco.envs +import jaraco.path +import pytest +from path import Path as _Path + +from setuptools._importlib import resources as importlib_resources +from setuptools.command.editable_wheel import ( + _encode_pth, + _find_namespaces, + _find_package_roots, + _find_virtual_namespaces, + _finder_template, + _LinkTree, + _TopLevelFinder, + editable_wheel, +) +from setuptools.dist import Distribution +from setuptools.extension import Extension +from setuptools.warnings import SetuptoolsDeprecationWarning + +from . import contexts, namespaces + +from distutils.core import run_setup + + +@pytest.fixture(params=["strict", "lenient"]) +def editable_opts(request): + if request.param == "strict": + return ["--config-settings", "editable-mode=strict"] + return [] + + +EXAMPLE = { + 'pyproject.toml': dedent( + """\ + [build-system] + requires = ["setuptools"] + build-backend = "setuptools.build_meta" + + [project] + name = "mypkg" + version = "3.14159" + license = {text = "MIT"} + description = "This is a Python package" + dynamic = ["readme"] + classifiers = [ + "Development Status :: 5 - Production/Stable", + "Intended Audience :: Developers" + ] + urls = {Homepage = "https://github.com"} + + [tool.setuptools] + package-dir = {"" = "src"} + packages = {find = {where = ["src"]}} + license-files = ["LICENSE*"] + + [tool.setuptools.dynamic] + readme = {file = "README.rst"} + + [tool.distutils.egg_info] + tag-build = ".post0" + """ + ), + "MANIFEST.in": dedent( + """\ + global-include *.py *.txt + global-exclude *.py[cod] + prune dist + prune build + """ + ).strip(), + "README.rst": "This is a ``README``", + "LICENSE.txt": "---- placeholder MIT license ----", + "src": { + "mypkg": { + "__init__.py": dedent( + """\ + import sys + from importlib.metadata import PackageNotFoundError, version + + try: + __version__ = version(__name__) + except PackageNotFoundError: + __version__ = "unknown" + """ + ), + "__main__.py": dedent( + """\ + from importlib.resources import read_text + from . import __version__, __name__ as parent + from .mod import x + + data = read_text(parent, "data.txt") + print(__version__, data, x) + """ + ), + "mod.py": "x = ''", + "data.txt": "Hello World", + } + }, +} + + +SETUP_SCRIPT_STUB = "__import__('setuptools').setup()" + + +@pytest.mark.xfail(sys.platform == "darwin", reason="pypa/setuptools#4328") +@pytest.mark.parametrize( + "files", + [ + {**EXAMPLE, "setup.py": SETUP_SCRIPT_STUB}, + EXAMPLE, # No setup.py script + ], +) +def test_editable_with_pyproject(tmp_path, venv, files, editable_opts): + project = tmp_path / "mypkg" + project.mkdir() + jaraco.path.build(files, prefix=project) + + cmd = [ + "python", + "-m", + "pip", + "install", + "--no-build-isolation", # required to force current version of setuptools + "-e", + str(project), + *editable_opts, + ] + print(venv.run(cmd)) + + cmd = ["python", "-m", "mypkg"] + assert venv.run(cmd).strip() == "3.14159.post0 Hello World" + + (project / "src/mypkg/data.txt").write_text("foobar", encoding="utf-8") + (project / "src/mypkg/mod.py").write_text("x = 42", encoding="utf-8") + assert venv.run(cmd).strip() == "3.14159.post0 foobar 42" + + +def test_editable_with_flat_layout(tmp_path, venv, editable_opts): + files = { + "mypkg": { + "pyproject.toml": dedent( + """\ + [build-system] + requires = ["setuptools", "wheel"] + build-backend = "setuptools.build_meta" + + [project] + name = "mypkg" + version = "3.14159" + + [tool.setuptools] + packages = ["pkg"] + py-modules = ["mod"] + """ + ), + "pkg": {"__init__.py": "a = 4"}, + "mod.py": "b = 2", + }, + } + jaraco.path.build(files, prefix=tmp_path) + project = tmp_path / "mypkg" + + cmd = [ + "python", + "-m", + "pip", + "install", + "--no-build-isolation", # required to force current version of setuptools + "-e", + str(project), + *editable_opts, + ] + print(venv.run(cmd)) + cmd = ["python", "-c", "import pkg, mod; print(pkg.a, mod.b)"] + assert venv.run(cmd).strip() == "4 2" + + +def test_editable_with_single_module(tmp_path, venv, editable_opts): + files = { + "mypkg": { + "pyproject.toml": dedent( + """\ + [build-system] + requires = ["setuptools", "wheel"] + build-backend = "setuptools.build_meta" + + [project] + name = "mod" + version = "3.14159" + + [tool.setuptools] + py-modules = ["mod"] + """ + ), + "mod.py": "b = 2", + }, + } + jaraco.path.build(files, prefix=tmp_path) + project = tmp_path / "mypkg" + + cmd = [ + "python", + "-m", + "pip", + "install", + "--no-build-isolation", # required to force current version of setuptools + "-e", + str(project), + *editable_opts, + ] + print(venv.run(cmd)) + cmd = ["python", "-c", "import mod; print(mod.b)"] + assert venv.run(cmd).strip() == "2" + + +class TestLegacyNamespaces: + # legacy => pkg_resources.declare_namespace(...) + setup(namespace_packages=...) + + def test_nspkg_file_is_unique(self, tmp_path, monkeypatch): + deprecation = pytest.warns( + SetuptoolsDeprecationWarning, match=".*namespace_packages parameter.*" + ) + installation_dir = tmp_path / ".installation_dir" + installation_dir.mkdir() + examples = ( + "myns.pkgA", + "myns.pkgB", + "myns.n.pkgA", + "myns.n.pkgB", + ) + + for name in examples: + pkg = namespaces.build_namespace_package(tmp_path, name, version="42") + with deprecation, monkeypatch.context() as ctx: + ctx.chdir(pkg) + dist = run_setup("setup.py", stop_after="config") + cmd = editable_wheel(dist) + cmd.finalize_options() + editable_name = cmd.get_finalized_command("dist_info").name + cmd._install_namespaces(installation_dir, editable_name) + + files = list(installation_dir.glob("*-nspkg.pth")) + assert len(files) == len(examples) + + @pytest.mark.parametrize( + "impl", + ( + "pkg_resources", + # "pkgutil", => does not work + ), + ) + @pytest.mark.parametrize("ns", ("myns.n",)) + def test_namespace_package_importable( + self, venv, tmp_path, ns, impl, editable_opts + ): + """ + Installing two packages sharing the same namespace, one installed + naturally using pip or `--single-version-externally-managed` + and the other installed in editable mode should leave the namespace + intact and both packages reachable by import. + (Ported from test_develop). + """ + build_system = """\ + [build-system] + requires = ["setuptools"] + build-backend = "setuptools.build_meta" + """ + pkg_A = namespaces.build_namespace_package(tmp_path, f"{ns}.pkgA", impl=impl) + pkg_B = namespaces.build_namespace_package(tmp_path, f"{ns}.pkgB", impl=impl) + (pkg_A / "pyproject.toml").write_text(build_system, encoding="utf-8") + (pkg_B / "pyproject.toml").write_text(build_system, encoding="utf-8") + # use pip to install to the target directory + opts = editable_opts[:] + opts.append("--no-build-isolation") # force current version of setuptools + venv.run(["python", "-m", "pip", "install", str(pkg_A), *opts]) + venv.run(["python", "-m", "pip", "install", "-e", str(pkg_B), *opts]) + venv.run(["python", "-c", f"import {ns}.pkgA; import {ns}.pkgB"]) + # additionally ensure that pkg_resources import works + venv.run(["python", "-c", "import pkg_resources"]) + + +class TestPep420Namespaces: + def test_namespace_package_importable(self, venv, tmp_path, editable_opts): + """ + Installing two packages sharing the same namespace, one installed + normally using pip and the other installed in editable mode + should allow importing both packages. + """ + pkg_A = namespaces.build_pep420_namespace_package(tmp_path, 'myns.n.pkgA') + pkg_B = namespaces.build_pep420_namespace_package(tmp_path, 'myns.n.pkgB') + # use pip to install to the target directory + opts = editable_opts[:] + opts.append("--no-build-isolation") # force current version of setuptools + venv.run(["python", "-m", "pip", "install", str(pkg_A), *opts]) + venv.run(["python", "-m", "pip", "install", "-e", str(pkg_B), *opts]) + venv.run(["python", "-c", "import myns.n.pkgA; import myns.n.pkgB"]) + + def test_namespace_created_via_package_dir(self, venv, tmp_path, editable_opts): + """Currently users can create a namespace by tweaking `package_dir`""" + files = { + "pkgA": { + "pyproject.toml": dedent( + """\ + [build-system] + requires = ["setuptools", "wheel"] + build-backend = "setuptools.build_meta" + + [project] + name = "pkgA" + version = "3.14159" + + [tool.setuptools] + package-dir = {"myns.n.pkgA" = "src"} + """ + ), + "src": {"__init__.py": "a = 1"}, + }, + } + jaraco.path.build(files, prefix=tmp_path) + pkg_A = tmp_path / "pkgA" + pkg_B = namespaces.build_pep420_namespace_package(tmp_path, 'myns.n.pkgB') + pkg_C = namespaces.build_pep420_namespace_package(tmp_path, 'myns.n.pkgC') + + # use pip to install to the target directory + opts = editable_opts[:] + opts.append("--no-build-isolation") # force current version of setuptools + venv.run(["python", "-m", "pip", "install", str(pkg_A), *opts]) + venv.run(["python", "-m", "pip", "install", "-e", str(pkg_B), *opts]) + venv.run(["python", "-m", "pip", "install", "-e", str(pkg_C), *opts]) + venv.run(["python", "-c", "from myns.n import pkgA, pkgB, pkgC"]) + + def test_namespace_accidental_config_in_lenient_mode(self, venv, tmp_path): + """Sometimes users might specify an ``include`` pattern that ignores parent + packages. In a normal installation this would ignore all modules inside the + parent packages, and make them namespaces (reported in issue #3504), + so the editable mode should preserve this behaviour. + """ + files = { + "pkgA": { + "pyproject.toml": dedent( + """\ + [build-system] + requires = ["setuptools", "wheel"] + build-backend = "setuptools.build_meta" + + [project] + name = "pkgA" + version = "3.14159" + + [tool.setuptools] + packages.find.include = ["mypkg.*"] + """ + ), + "mypkg": { + "__init__.py": "", + "other.py": "b = 1", + "n": { + "__init__.py": "", + "pkgA.py": "a = 1", + }, + }, + "MANIFEST.in": EXAMPLE["MANIFEST.in"], + }, + } + jaraco.path.build(files, prefix=tmp_path) + pkg_A = tmp_path / "pkgA" + + # use pip to install to the target directory + opts = ["--no-build-isolation"] # force current version of setuptools + venv.run(["python", "-m", "pip", "-v", "install", "-e", str(pkg_A), *opts]) + out = venv.run(["python", "-c", "from mypkg.n import pkgA; print(pkgA.a)"]) + assert out.strip() == "1" + cmd = """\ + try: + import mypkg.other + except ImportError: + print("mypkg.other not defined") + """ + out = venv.run(["python", "-c", dedent(cmd)]) + assert "mypkg.other not defined" in out + + +def test_editable_with_prefix(tmp_path, sample_project, editable_opts): + """ + Editable install to a prefix should be discoverable. + """ + prefix = tmp_path / 'prefix' + + # figure out where pip will likely install the package + site_packages_all = [ + prefix / Path(path).relative_to(sys.prefix) + for path in sys.path + if 'site-packages' in path and path.startswith(sys.prefix) + ] + + for sp in site_packages_all: + sp.mkdir(parents=True) + + # install workaround + _addsitedirs(site_packages_all) + + env = dict(os.environ, PYTHONPATH=os.pathsep.join(map(str, site_packages_all))) + cmd = [ + sys.executable, + '-m', + 'pip', + 'install', + '--editable', + str(sample_project), + '--prefix', + str(prefix), + '--no-build-isolation', + *editable_opts, + ] + subprocess.check_call(cmd, env=env) + + # now run 'sample' with the prefix on the PYTHONPATH + bin = 'Scripts' if platform.system() == 'Windows' else 'bin' + exe = prefix / bin / 'sample' + subprocess.check_call([exe], env=env) + + +class TestFinderTemplate: + """This test focus in getting a particular implementation detail right. + If at some point in time the implementation is changed for something different, + this test can be modified or even excluded. + """ + + def install_finder(self, finder): + loc = {} + exec(finder, loc, loc) + loc["install"]() + + def test_packages(self, tmp_path): + files = { + "src1": { + "pkg1": { + "__init__.py": "", + "subpkg": {"mod1.py": "a = 42"}, + }, + }, + "src2": {"mod2.py": "a = 43"}, + } + jaraco.path.build(files, prefix=tmp_path) + + mapping = { + "pkg1": str(tmp_path / "src1/pkg1"), + "mod2": str(tmp_path / "src2/mod2"), + } + template = _finder_template(str(uuid4()), mapping, {}) + + with contexts.save_paths(), contexts.save_sys_modules(): + for mod in ("pkg1", "pkg1.subpkg", "pkg1.subpkg.mod1", "mod2"): + sys.modules.pop(mod, None) + + self.install_finder(template) + mod1 = import_module("pkg1.subpkg.mod1") + mod2 = import_module("mod2") + subpkg = import_module("pkg1.subpkg") + + assert mod1.a == 42 + assert mod2.a == 43 + expected = str((tmp_path / "src1/pkg1/subpkg").resolve()) + assert_path(subpkg, expected) + + def test_namespace(self, tmp_path): + files = {"pkg": {"__init__.py": "a = 13", "text.txt": "abc"}} + jaraco.path.build(files, prefix=tmp_path) + + mapping = {"ns.othername": str(tmp_path / "pkg")} + namespaces = {"ns": []} + + template = _finder_template(str(uuid4()), mapping, namespaces) + with contexts.save_paths(), contexts.save_sys_modules(): + for mod in ("ns", "ns.othername"): + sys.modules.pop(mod, None) + + self.install_finder(template) + pkg = import_module("ns.othername") + text = importlib_resources.files(pkg) / "text.txt" + + expected = str((tmp_path / "pkg").resolve()) + assert_path(pkg, expected) + assert pkg.a == 13 + + # Make sure resources can also be found + assert text.read_text(encoding="utf-8") == "abc" + + def test_combine_namespaces(self, tmp_path): + files = { + "src1": {"ns": {"pkg1": {"__init__.py": "a = 13"}}}, + "src2": {"ns": {"mod2.py": "b = 37"}}, + } + jaraco.path.build(files, prefix=tmp_path) + + mapping = { + "ns.pkgA": str(tmp_path / "src1/ns/pkg1"), + "ns": str(tmp_path / "src2/ns"), + } + namespaces_ = {"ns": [str(tmp_path / "src1"), str(tmp_path / "src2")]} + template = _finder_template(str(uuid4()), mapping, namespaces_) + + with contexts.save_paths(), contexts.save_sys_modules(): + for mod in ("ns", "ns.pkgA", "ns.mod2"): + sys.modules.pop(mod, None) + + self.install_finder(template) + pkgA = import_module("ns.pkgA") + mod2 = import_module("ns.mod2") + + expected = str((tmp_path / "src1/ns/pkg1").resolve()) + assert_path(pkgA, expected) + assert pkgA.a == 13 + assert mod2.b == 37 + + def test_combine_namespaces_nested(self, tmp_path): + """ + Users may attempt to combine namespace packages in a nested way via + ``package_dir`` as shown in pypa/setuptools#4248. + """ + + files = { + "src": {"my_package": {"my_module.py": "a = 13"}}, + "src2": {"my_package2": {"my_module2.py": "b = 37"}}, + } + + stack = jaraco.path.DirectoryStack() + with stack.context(tmp_path): + jaraco.path.build(files) + attrs = { + "script_name": "%PEP 517%", + "package_dir": { + "different_name": "src/my_package", + "different_name.subpkg": "src2/my_package2", + }, + "packages": ["different_name", "different_name.subpkg"], + } + dist = Distribution(attrs) + finder = _TopLevelFinder(dist, str(uuid4())) + code = next(v for k, v in finder.get_implementation() if k.endswith(".py")) + + with contexts.save_paths(), contexts.save_sys_modules(): + for mod in attrs["packages"]: + sys.modules.pop(mod, None) + + self.install_finder(code) + mod1 = import_module("different_name.my_module") + mod2 = import_module("different_name.subpkg.my_module2") + + expected = str((tmp_path / "src/my_package/my_module.py").resolve()) + assert str(Path(mod1.__file__).resolve()) == expected + + expected = str((tmp_path / "src2/my_package2/my_module2.py").resolve()) + assert str(Path(mod2.__file__).resolve()) == expected + + assert mod1.a == 13 + assert mod2.b == 37 + + def test_dynamic_path_computation(self, tmp_path): + # Follows the example in PEP 420 + files = { + "project1": {"parent": {"child": {"one.py": "x = 1"}}}, + "project2": {"parent": {"child": {"two.py": "x = 2"}}}, + "project3": {"parent": {"child": {"three.py": "x = 3"}}}, + } + jaraco.path.build(files, prefix=tmp_path) + mapping = {} + namespaces_ = {"parent": [str(tmp_path / "project1/parent")]} + template = _finder_template(str(uuid4()), mapping, namespaces_) + + mods = (f"parent.child.{name}" for name in ("one", "two", "three")) + with contexts.save_paths(), contexts.save_sys_modules(): + for mod in ("parent", "parent.child", "parent.child", *mods): + sys.modules.pop(mod, None) + + self.install_finder(template) + + one = import_module("parent.child.one") + assert one.x == 1 + + with pytest.raises(ImportError): + import_module("parent.child.two") + + sys.path.append(str(tmp_path / "project2")) + two = import_module("parent.child.two") + assert two.x == 2 + + with pytest.raises(ImportError): + import_module("parent.child.three") + + sys.path.append(str(tmp_path / "project3")) + three = import_module("parent.child.three") + assert three.x == 3 + + def test_no_recursion(self, tmp_path): + # See issue #3550 + files = { + "pkg": { + "__init__.py": "from . import pkg", + }, + } + jaraco.path.build(files, prefix=tmp_path) + + mapping = { + "pkg": str(tmp_path / "pkg"), + } + template = _finder_template(str(uuid4()), mapping, {}) + + with contexts.save_paths(), contexts.save_sys_modules(): + sys.modules.pop("pkg", None) + + self.install_finder(template) + with pytest.raises(ImportError, match="pkg"): + import_module("pkg") + + def test_similar_name(self, tmp_path): + files = { + "foo": { + "__init__.py": "", + "bar": { + "__init__.py": "", + }, + }, + } + jaraco.path.build(files, prefix=tmp_path) + + mapping = { + "foo": str(tmp_path / "foo"), + } + template = _finder_template(str(uuid4()), mapping, {}) + + with contexts.save_paths(), contexts.save_sys_modules(): + sys.modules.pop("foo", None) + sys.modules.pop("foo.bar", None) + + self.install_finder(template) + with pytest.raises(ImportError, match="foobar"): + import_module("foobar") + + def test_case_sensitivity(self, tmp_path): + files = { + "foo": { + "__init__.py": "", + "lowercase.py": "x = 1", + "bar": { + "__init__.py": "", + "lowercase.py": "x = 2", + }, + }, + } + jaraco.path.build(files, prefix=tmp_path) + mapping = { + "foo": str(tmp_path / "foo"), + } + template = _finder_template(str(uuid4()), mapping, {}) + with contexts.save_paths(), contexts.save_sys_modules(): + sys.modules.pop("foo", None) + + self.install_finder(template) + with pytest.raises(ImportError, match="'FOO'"): + import_module("FOO") + + with pytest.raises(ImportError, match="'foo\\.LOWERCASE'"): + import_module("foo.LOWERCASE") + + with pytest.raises(ImportError, match="'foo\\.bar\\.Lowercase'"): + import_module("foo.bar.Lowercase") + + with pytest.raises(ImportError, match="'foo\\.BAR'"): + import_module("foo.BAR.lowercase") + + with pytest.raises(ImportError, match="'FOO'"): + import_module("FOO.bar.lowercase") + + mod = import_module("foo.lowercase") + assert mod.x == 1 + + mod = import_module("foo.bar.lowercase") + assert mod.x == 2 + + def test_namespace_case_sensitivity(self, tmp_path): + files = { + "pkg": { + "__init__.py": "a = 13", + "foo": { + "__init__.py": "b = 37", + "bar.py": "c = 42", + }, + }, + } + jaraco.path.build(files, prefix=tmp_path) + + mapping = {"ns.othername": str(tmp_path / "pkg")} + namespaces = {"ns": []} + + template = _finder_template(str(uuid4()), mapping, namespaces) + with contexts.save_paths(), contexts.save_sys_modules(): + for mod in ("ns", "ns.othername"): + sys.modules.pop(mod, None) + + self.install_finder(template) + pkg = import_module("ns.othername") + expected = str((tmp_path / "pkg").resolve()) + assert_path(pkg, expected) + assert pkg.a == 13 + + foo = import_module("ns.othername.foo") + assert foo.b == 37 + + bar = import_module("ns.othername.foo.bar") + assert bar.c == 42 + + with pytest.raises(ImportError, match="'NS'"): + import_module("NS.othername.foo") + + with pytest.raises(ImportError, match="'ns\\.othername\\.FOO\\'"): + import_module("ns.othername.FOO") + + with pytest.raises(ImportError, match="'ns\\.othername\\.foo\\.BAR\\'"): + import_module("ns.othername.foo.BAR") + + def test_intermediate_packages(self, tmp_path): + """ + The finder should not import ``fullname`` if the intermediate segments + don't exist (see pypa/setuptools#4019). + """ + files = { + "src": { + "mypkg": { + "__init__.py": "", + "config.py": "a = 13", + "helloworld.py": "b = 13", + "components": { + "config.py": "a = 37", + }, + }, + } + } + jaraco.path.build(files, prefix=tmp_path) + + mapping = {"mypkg": str(tmp_path / "src/mypkg")} + template = _finder_template(str(uuid4()), mapping, {}) + + with contexts.save_paths(), contexts.save_sys_modules(): + for mod in ( + "mypkg", + "mypkg.config", + "mypkg.helloworld", + "mypkg.components", + "mypkg.components.config", + "mypkg.components.helloworld", + ): + sys.modules.pop(mod, None) + + self.install_finder(template) + + config = import_module("mypkg.components.config") + assert config.a == 37 + + helloworld = import_module("mypkg.helloworld") + assert helloworld.b == 13 + + with pytest.raises(ImportError): + import_module("mypkg.components.helloworld") + + +def test_pkg_roots(tmp_path): + """This test focus in getting a particular implementation detail right. + If at some point in time the implementation is changed for something different, + this test can be modified or even excluded. + """ + files = { + "a": {"b": {"__init__.py": "ab = 1"}, "__init__.py": "a = 1"}, + "d": {"__init__.py": "d = 1", "e": {"__init__.py": "de = 1"}}, + "f": {"g": {"h": {"__init__.py": "fgh = 1"}}}, + "other": {"__init__.py": "abc = 1"}, + "another": {"__init__.py": "abcxyz = 1"}, + "yet_another": {"__init__.py": "mnopq = 1"}, + } + jaraco.path.build(files, prefix=tmp_path) + package_dir = { + "a.b.c": "other", + "a.b.c.x.y.z": "another", + "m.n.o.p.q": "yet_another", + } + packages = [ + "a", + "a.b", + "a.b.c", + "a.b.c.x.y", + "a.b.c.x.y.z", + "d", + "d.e", + "f", + "f.g", + "f.g.h", + "m.n.o.p.q", + ] + roots = _find_package_roots(packages, package_dir, tmp_path) + assert roots == { + "a": str(tmp_path / "a"), + "a.b.c": str(tmp_path / "other"), + "a.b.c.x.y.z": str(tmp_path / "another"), + "d": str(tmp_path / "d"), + "f": str(tmp_path / "f"), + "m.n.o.p.q": str(tmp_path / "yet_another"), + } + + ns = set(dict(_find_namespaces(packages, roots))) + assert ns == {"f", "f.g"} + + ns = set(_find_virtual_namespaces(roots)) + assert ns == {"a.b", "a.b.c.x", "a.b.c.x.y", "m", "m.n", "m.n.o", "m.n.o.p"} + + +class TestOverallBehaviour: + PYPROJECT = """\ + [build-system] + requires = ["setuptools"] + build-backend = "setuptools.build_meta" + + [project] + name = "mypkg" + version = "3.14159" + """ + + # Any: Would need a TypedDict. Keep it simple for tests + FLAT_LAYOUT: dict[str, Any] = { + "pyproject.toml": dedent(PYPROJECT), + "MANIFEST.in": EXAMPLE["MANIFEST.in"], + "otherfile.py": "", + "mypkg": { + "__init__.py": "", + "mod1.py": "var = 42", + "subpackage": { + "__init__.py": "", + "mod2.py": "var = 13", + "resource_file.txt": "resource 39", + }, + }, + } + + EXAMPLES = { + "flat-layout": FLAT_LAYOUT, + "src-layout": { + "pyproject.toml": dedent(PYPROJECT), + "MANIFEST.in": EXAMPLE["MANIFEST.in"], + "otherfile.py": "", + "src": {"mypkg": FLAT_LAYOUT["mypkg"]}, + }, + "custom-layout": { + "pyproject.toml": dedent(PYPROJECT) + + dedent( + """\ + [tool.setuptools] + packages = ["mypkg", "mypkg.subpackage"] + + [tool.setuptools.package-dir] + "mypkg.subpackage" = "other" + """ + ), + "MANIFEST.in": EXAMPLE["MANIFEST.in"], + "otherfile.py": "", + "mypkg": { + "__init__.py": "", + "mod1.py": FLAT_LAYOUT["mypkg"]["mod1.py"], + }, + "other": FLAT_LAYOUT["mypkg"]["subpackage"], + }, + "namespace": { + "pyproject.toml": dedent(PYPROJECT), + "MANIFEST.in": EXAMPLE["MANIFEST.in"], + "otherfile.py": "", + "src": { + "mypkg": { + "mod1.py": FLAT_LAYOUT["mypkg"]["mod1.py"], + "subpackage": FLAT_LAYOUT["mypkg"]["subpackage"], + }, + }, + }, + } + + @pytest.mark.xfail(sys.platform == "darwin", reason="pypa/setuptools#4328") + @pytest.mark.parametrize("layout", EXAMPLES.keys()) + def test_editable_install(self, tmp_path, venv, layout, editable_opts): + project, _ = install_project( + "mypkg", venv, tmp_path, self.EXAMPLES[layout], *editable_opts + ) + + # Ensure stray files are not importable + cmd_import_error = """\ + try: + import otherfile + except ImportError as ex: + print(ex) + """ + out = venv.run(["python", "-c", dedent(cmd_import_error)]) + assert "No module named 'otherfile'" in out + + # Ensure the modules are importable + cmd_get_vars = """\ + import mypkg, mypkg.mod1, mypkg.subpackage.mod2 + print(mypkg.mod1.var, mypkg.subpackage.mod2.var) + """ + out = venv.run(["python", "-c", dedent(cmd_get_vars)]) + assert "42 13" in out + + # Ensure resources are reachable + cmd_get_resource = """\ + import mypkg.subpackage + from setuptools._importlib import resources as importlib_resources + text = importlib_resources.files(mypkg.subpackage) / "resource_file.txt" + print(text.read_text(encoding="utf-8")) + """ + out = venv.run(["python", "-c", dedent(cmd_get_resource)]) + assert "resource 39" in out + + # Ensure files are editable + mod1 = next(project.glob("**/mod1.py")) + mod2 = next(project.glob("**/mod2.py")) + resource_file = next(project.glob("**/resource_file.txt")) + + mod1.write_text("var = 17", encoding="utf-8") + mod2.write_text("var = 781", encoding="utf-8") + resource_file.write_text("resource 374", encoding="utf-8") + + out = venv.run(["python", "-c", dedent(cmd_get_vars)]) + assert "42 13" not in out + assert "17 781" in out + + out = venv.run(["python", "-c", dedent(cmd_get_resource)]) + assert "resource 39" not in out + assert "resource 374" in out + + +class TestLinkTree: + FILES = deepcopy(TestOverallBehaviour.EXAMPLES["src-layout"]) + FILES["pyproject.toml"] += dedent( + """\ + [tool.setuptools] + # Temporary workaround: both `include-package-data` and `package-data` configs + # can be removed after #3260 is fixed. + include-package-data = false + package-data = {"*" = ["*.txt"]} + + [tool.setuptools.packages.find] + where = ["src"] + exclude = ["*.subpackage*"] + """ + ) + FILES["src"]["mypkg"]["resource.not_in_manifest"] = "abc" + + def test_generated_tree(self, tmp_path): + jaraco.path.build(self.FILES, prefix=tmp_path) + + with _Path(tmp_path): + name = "mypkg-3.14159" + dist = Distribution({"script_name": "%PEP 517%"}) + dist.parse_config_files() + + wheel = Mock() + aux = tmp_path / ".aux" + build = tmp_path / ".build" + aux.mkdir() + build.mkdir() + + build_py = dist.get_command_obj("build_py") + build_py.editable_mode = True + build_py.build_lib = str(build) + build_py.ensure_finalized() + outputs = build_py.get_outputs() + output_mapping = build_py.get_output_mapping() + + make_tree = _LinkTree(dist, name, aux, build) + make_tree(wheel, outputs, output_mapping) + + mod1 = next(aux.glob("**/mod1.py")) + expected = tmp_path / "src/mypkg/mod1.py" + assert_link_to(mod1, expected) + + assert next(aux.glob("**/subpackage"), None) is None + assert next(aux.glob("**/mod2.py"), None) is None + assert next(aux.glob("**/resource_file.txt"), None) is None + + assert next(aux.glob("**/resource.not_in_manifest"), None) is None + + def test_strict_install(self, tmp_path, venv): + opts = ["--config-settings", "editable-mode=strict"] + install_project("mypkg", venv, tmp_path, self.FILES, *opts) + + out = venv.run(["python", "-c", "import mypkg.mod1; print(mypkg.mod1.var)"]) + assert "42" in out + + # Ensure packages excluded from distribution are not importable + cmd_import_error = """\ + try: + from mypkg import subpackage + except ImportError as ex: + print(ex) + """ + out = venv.run(["python", "-c", dedent(cmd_import_error)]) + assert "cannot import name 'subpackage'" in out + + # Ensure resource files excluded from distribution are not reachable + cmd_get_resource = """\ + import mypkg + from setuptools._importlib import resources as importlib_resources + try: + text = importlib_resources.files(mypkg) / "resource.not_in_manifest" + print(text.read_text(encoding="utf-8")) + except FileNotFoundError as ex: + print(ex) + """ + out = venv.run(["python", "-c", dedent(cmd_get_resource)]) + assert "No such file or directory" in out + assert "resource.not_in_manifest" in out + + +@pytest.mark.filterwarnings("ignore:.*compat.*:setuptools.SetuptoolsDeprecationWarning") +def test_compat_install(tmp_path, venv): + # TODO: Remove `compat` after Dec/2022. + opts = ["--config-settings", "editable-mode=compat"] + files = TestOverallBehaviour.EXAMPLES["custom-layout"] + install_project("mypkg", venv, tmp_path, files, *opts) + + out = venv.run(["python", "-c", "import mypkg.mod1; print(mypkg.mod1.var)"]) + assert "42" in out + + expected_path = comparable_path(str(tmp_path)) + + # Compatible behaviour will make spurious modules and excluded + # files importable directly from the original path + for cmd in ( + "import otherfile; print(otherfile)", + "import other; print(other)", + "import mypkg; print(mypkg)", + ): + out = comparable_path(venv.run(["python", "-c", cmd])) + assert expected_path in out + + # Compatible behaviour will not consider custom mappings + cmd = """\ + try: + from mypkg import subpackage; + except ImportError as ex: + print(ex) + """ + out = venv.run(["python", "-c", dedent(cmd)]) + assert "cannot import name 'subpackage'" in out + + +@pytest.mark.uses_network +def test_pbr_integration(pbr_package, venv, editable_opts): + """Ensure editable installs work with pbr, issue #3500""" + cmd = [ + 'python', + '-m', + 'pip', + '-v', + 'install', + '--editable', + pbr_package, + *editable_opts, + ] + venv.run(cmd, stderr=subprocess.STDOUT) + out = venv.run(["python", "-c", "import mypkg.hello"]) + assert "Hello world!" in out + + +class TestCustomBuildPy: + """ + Issue #3501 indicates that some plugins/customizations might rely on: + + 1. ``build_py`` not running + 2. ``build_py`` always copying files to ``build_lib`` + + During the transition period setuptools should prevent potential errors from + happening due to those assumptions. + """ + + # TODO: Remove tests after _run_build_steps is removed. + + FILES = { + **TestOverallBehaviour.EXAMPLES["flat-layout"], + "setup.py": dedent( + """\ + import pathlib + from setuptools import setup + from setuptools.command.build_py import build_py as orig + + class my_build_py(orig): + def run(self): + super().run() + raise ValueError("TEST_RAISE") + + setup(cmdclass={"build_py": my_build_py}) + """ + ), + } + + def test_safeguarded_from_errors(self, tmp_path, venv): + """Ensure that errors in custom build_py are reported as warnings""" + # Warnings should show up + _, out = install_project("mypkg", venv, tmp_path, self.FILES) + assert "SetuptoolsDeprecationWarning" in out + assert "ValueError: TEST_RAISE" in out + # but installation should be successful + out = venv.run(["python", "-c", "import mypkg.mod1; print(mypkg.mod1.var)"]) + assert "42" in out + + +class TestCustomBuildWheel: + def install_custom_build_wheel(self, dist): + bdist_wheel_cls = dist.get_command_class("bdist_wheel") + + class MyBdistWheel(bdist_wheel_cls): + def get_tag(self): + # In issue #3513, we can see that some extensions may try to access + # the `plat_name` property in bdist_wheel + if self.plat_name.startswith("macosx-"): + _ = "macOS platform" + return super().get_tag() + + dist.cmdclass["bdist_wheel"] = MyBdistWheel + + def test_access_plat_name(self, tmpdir_cwd): + # Even when a custom bdist_wheel tries to access plat_name the build should + # be successful + jaraco.path.build({"module.py": "x = 42"}) + dist = Distribution() + dist.script_name = "setup.py" + dist.set_defaults() + self.install_custom_build_wheel(dist) + cmd = editable_wheel(dist) + cmd.ensure_finalized() + cmd.run() + wheel_file = str(next(Path().glob('dist/*.whl'))) + assert "editable" in wheel_file + + +class TestCustomBuildExt: + def install_custom_build_ext_distutils(self, dist): + from distutils.command.build_ext import build_ext as build_ext_cls + + class MyBuildExt(build_ext_cls): + pass + + dist.cmdclass["build_ext"] = MyBuildExt + + @pytest.mark.skipif( + sys.platform != "linux", reason="compilers may fail without correct setup" + ) + def test_distutils_leave_inplace_files(self, tmpdir_cwd): + jaraco.path.build({"module.c": ""}) + attrs = { + "ext_modules": [Extension("module", ["module.c"])], + } + dist = Distribution(attrs) + dist.script_name = "setup.py" + dist.set_defaults() + self.install_custom_build_ext_distutils(dist) + cmd = editable_wheel(dist) + cmd.ensure_finalized() + cmd.run() + wheel_file = str(next(Path().glob('dist/*.whl'))) + assert "editable" in wheel_file + files = [p for p in Path().glob("module.*") if p.suffix != ".c"] + assert len(files) == 1 + name = files[0].name + assert any(name.endswith(ext) for ext in EXTENSION_SUFFIXES) + + +def test_debugging_tips(tmpdir_cwd, monkeypatch): + """Make sure to display useful debugging tips to the user.""" + jaraco.path.build({"module.py": "x = 42"}) + dist = Distribution() + dist.script_name = "setup.py" + dist.set_defaults() + cmd = editable_wheel(dist) + cmd.ensure_finalized() + + SimulatedErr = type("SimulatedErr", (Exception,), {}) + simulated_failure = Mock(side_effect=SimulatedErr()) + monkeypatch.setattr(cmd, "get_finalized_command", simulated_failure) + + with pytest.raises(SimulatedErr) as ctx: + cmd.run() + assert any('debugging-tips' in note for note in ctx.value.__notes__) + + +@pytest.mark.filterwarnings("error") +def test_encode_pth(): + """Ensure _encode_pth function does not produce encoding warnings""" + content = _encode_pth("tkmilan_ç_utf8") # no warnings (would be turned into errors) + assert isinstance(content, bytes) + + +def install_project(name, venv, tmp_path, files, *opts): + project = tmp_path / name + project.mkdir() + jaraco.path.build(files, prefix=project) + opts = [*opts, "--no-build-isolation"] # force current version of setuptools + out = venv.run( + ["python", "-m", "pip", "-v", "install", "-e", str(project), *opts], + stderr=subprocess.STDOUT, + ) + return project, out + + +def _addsitedirs(new_dirs): + """To use this function, it is necessary to insert new_dir in front of sys.path. + The Python process will try to import a ``sitecustomize`` module on startup. + If we manipulate sys.path/PYTHONPATH, we can force it to run our code, + which invokes ``addsitedir`` and ensure ``.pth`` files are loaded. + """ + content = '\n'.join( + ("import site",) + + tuple(f"site.addsitedir({os.fspath(new_dir)!r})" for new_dir in new_dirs) + ) + (new_dirs[0] / "sitecustomize.py").write_text(content, encoding="utf-8") + + +# ---- Assertion Helpers ---- + + +def assert_path(pkg, expected): + # __path__ is not guaranteed to exist, so we have to account for that + if pkg.__path__: + path = next(iter(pkg.__path__), None) + if path: + assert str(Path(path).resolve()) == expected + + +def assert_link_to(file: Path, other: Path) -> None: + if file.is_symlink(): + assert str(file.resolve()) == str(other.resolve()) + else: + file_stat = file.stat() + other_stat = other.stat() + assert file_stat[stat.ST_INO] == other_stat[stat.ST_INO] + assert file_stat[stat.ST_DEV] == other_stat[stat.ST_DEV] + + +def comparable_path(str_with_path: str) -> str: + return str_with_path.lower().replace(os.sep, "/").replace("//", "/") diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_egg_info.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_egg_info.py new file mode 100644 index 000000000..3653be096 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_egg_info.py @@ -0,0 +1,1306 @@ +from __future__ import annotations + +import ast +import glob +import os +import re +import stat +import sys +import time +from pathlib import Path +from unittest import mock + +import pytest +from jaraco import path + +from setuptools import errors +from setuptools.command.egg_info import egg_info, manifest_maker, write_entries +from setuptools.dist import Distribution + +from . import contexts, environment +from .textwrap import DALS + + +class Environment(str): + pass + + +@pytest.fixture +def env(): + with contexts.tempdir(prefix='setuptools-test.') as env_dir: + env = Environment(env_dir) + os.chmod(env_dir, stat.S_IRWXU) + subs = 'home', 'lib', 'scripts', 'data', 'egg-base' + env.paths = dict((dirname, os.path.join(env_dir, dirname)) for dirname in subs) + list(map(os.mkdir, env.paths.values())) + path.build({ + env.paths['home']: { + '.pydistutils.cfg': DALS( + """ + [egg_info] + egg-base = {egg-base} + """.format(**env.paths) + ) + } + }) + yield env + + +class TestEggInfo: + setup_script = DALS( + """ + from setuptools import setup + + setup( + name='foo', + py_modules=['hello'], + entry_points={'console_scripts': ['hi = hello.run']}, + zip_safe=False, + ) + """ + ) + + def _create_project(self): + path.build({ + 'setup.py': self.setup_script, + 'hello.py': DALS( + """ + def run(): + print('hello') + """ + ), + }) + + @staticmethod + def _extract_mv_version(pkg_info_lines: list[str]) -> tuple[int, int]: + version_str = pkg_info_lines[0].split(' ')[1] + major, minor = map(int, version_str.split('.')[:2]) + return major, minor + + def test_egg_info_save_version_info_setup_empty(self, tmpdir_cwd, env): + """ + When the egg_info section is empty or not present, running + save_version_info should add the settings to the setup.cfg + in a deterministic order. + """ + setup_cfg = os.path.join(env.paths['home'], 'setup.cfg') + dist = Distribution() + ei = egg_info(dist) + ei.initialize_options() + ei.save_version_info(setup_cfg) + + with open(setup_cfg, 'r', encoding="utf-8") as f: + content = f.read() + + assert '[egg_info]' in content + assert 'tag_build =' in content + assert 'tag_date = 0' in content + + expected_order = ( + 'tag_build', + 'tag_date', + ) + + self._validate_content_order(content, expected_order) + + @staticmethod + def _validate_content_order(content, expected): + """ + Assert that the strings in expected appear in content + in order. + """ + pattern = '.*'.join(expected) + flags = re.MULTILINE | re.DOTALL + assert re.search(pattern, content, flags) + + def test_egg_info_save_version_info_setup_defaults(self, tmpdir_cwd, env): + """ + When running save_version_info on an existing setup.cfg + with the 'default' values present from a previous run, + the file should remain unchanged. + """ + setup_cfg = os.path.join(env.paths['home'], 'setup.cfg') + path.build({ + setup_cfg: DALS( + """ + [egg_info] + tag_build = + tag_date = 0 + """ + ), + }) + dist = Distribution() + ei = egg_info(dist) + ei.initialize_options() + ei.save_version_info(setup_cfg) + + with open(setup_cfg, 'r', encoding="utf-8") as f: + content = f.read() + + assert '[egg_info]' in content + assert 'tag_build =' in content + assert 'tag_date = 0' in content + + expected_order = ( + 'tag_build', + 'tag_date', + ) + + self._validate_content_order(content, expected_order) + + def test_expected_files_produced(self, tmpdir_cwd, env): + self._create_project() + + self._run_egg_info_command(tmpdir_cwd, env) + actual = os.listdir('foo.egg-info') + + expected = [ + 'PKG-INFO', + 'SOURCES.txt', + 'dependency_links.txt', + 'entry_points.txt', + 'not-zip-safe', + 'top_level.txt', + ] + assert sorted(actual) == expected + + def test_handling_utime_error(self, tmpdir_cwd, env): + dist = Distribution() + ei = egg_info(dist) + utime_patch = mock.patch('os.utime', side_effect=OSError("TEST")) + mkpath_patch = mock.patch( + 'setuptools.command.egg_info.egg_info.mkpath', return_val=None + ) + + with utime_patch, mkpath_patch: + import distutils.errors + + msg = r"Cannot update time stamp of directory 'None'" + with pytest.raises(distutils.errors.DistutilsFileError, match=msg): + ei.run() + + def test_license_is_a_string(self, tmpdir_cwd, env): + setup_config = DALS( + """ + [metadata] + name=foo + version=0.0.1 + license=file:MIT + """ + ) + + setup_script = DALS( + """ + from setuptools import setup + + setup() + """ + ) + + path.build({ + 'setup.py': setup_script, + 'setup.cfg': setup_config, + }) + + # This command should fail with a ValueError, but because it's + # currently configured to use a subprocess, the actual traceback + # object is lost and we need to parse it from stderr + with pytest.raises(AssertionError) as exc: + self._run_egg_info_command(tmpdir_cwd, env) + + # The only argument to the assertion error should be a traceback + # containing a ValueError + assert 'ValueError' in exc.value.args[0] + + def test_rebuilt(self, tmpdir_cwd, env): + """Ensure timestamps are updated when the command is re-run.""" + self._create_project() + + self._run_egg_info_command(tmpdir_cwd, env) + timestamp_a = os.path.getmtime('foo.egg-info') + + # arbitrary sleep just to handle *really* fast systems + time.sleep(0.001) + + self._run_egg_info_command(tmpdir_cwd, env) + timestamp_b = os.path.getmtime('foo.egg-info') + + assert timestamp_a != timestamp_b + + def test_manifest_template_is_read(self, tmpdir_cwd, env): + self._create_project() + path.build({ + 'MANIFEST.in': DALS( + """ + recursive-include docs *.rst + """ + ), + 'docs': { + 'usage.rst': "Run 'hi'", + }, + }) + self._run_egg_info_command(tmpdir_cwd, env) + egg_info_dir = os.path.join('.', 'foo.egg-info') + sources_txt = os.path.join(egg_info_dir, 'SOURCES.txt') + with open(sources_txt, encoding="utf-8") as f: + assert 'docs/usage.rst' in f.read().split('\n') + + def _setup_script_with_requires(self, requires, use_setup_cfg=False): + setup_script = DALS( + """ + from setuptools import setup + + setup(name='foo', zip_safe=False, %s) + """ + ) % ('' if use_setup_cfg else requires) + setup_config = requires if use_setup_cfg else '' + path.build({ + 'setup.py': setup_script, + 'setup.cfg': setup_config, + }) + + mismatch_marker = f"python_version<'{sys.version_info[0]}'" + # Alternate equivalent syntax. + mismatch_marker_alternate = f'python_version < "{sys.version_info[0]}"' + invalid_marker = "<=>++" + + class RequiresTestHelper: + @staticmethod + def parametrize(*test_list, **format_dict): + idlist = [] + argvalues = [] + for test in test_list: + test_params = test.lstrip().split('\n\n', 3) + name_kwargs = test_params.pop(0).split('\n') + if len(name_kwargs) > 1: + val = name_kwargs[1].strip() + install_cmd_kwargs = ast.literal_eval(val) + else: + install_cmd_kwargs = {} + name = name_kwargs[0].strip() + setup_py_requires, setup_cfg_requires, expected_requires = [ + DALS(a).format(**format_dict) for a in test_params + ] + for id_, requires, use_cfg in ( + (name, setup_py_requires, False), + (name + '_in_setup_cfg', setup_cfg_requires, True), + ): + idlist.append(id_) + marks = () + if requires.startswith('@xfail\n'): + requires = requires[7:] + marks = pytest.mark.xfail + argvalues.append( + pytest.param( + requires, + use_cfg, + expected_requires, + install_cmd_kwargs, + marks=marks, + ) + ) + return pytest.mark.parametrize( + ( + "requires", + "use_setup_cfg", + "expected_requires", + "install_cmd_kwargs", + ), + argvalues, + ids=idlist, + ) + + @RequiresTestHelper.parametrize( + # Format of a test: + # + # id + # install_cmd_kwargs [optional] + # + # requires block (when used in setup.py) + # + # requires block (when used in setup.cfg) + # + # expected contents of requires.txt + """ + install_requires_deterministic + + install_requires=["wheel>=0.5", "pytest"] + + [options] + install_requires = + wheel>=0.5 + pytest + + wheel>=0.5 + pytest + """, + """ + install_requires_ordered + + install_requires=["pytest>=3.0.2,!=10.9999"] + + [options] + install_requires = + pytest>=3.0.2,!=10.9999 + + pytest!=10.9999,>=3.0.2 + """, + """ + install_requires_with_marker + + install_requires=["barbazquux;{mismatch_marker}"], + + [options] + install_requires = + barbazquux; {mismatch_marker} + + [:{mismatch_marker_alternate}] + barbazquux + """, + """ + install_requires_with_extra + {'cmd': ['egg_info']} + + install_requires=["barbazquux [test]"], + + [options] + install_requires = + barbazquux [test] + + barbazquux[test] + """, + """ + install_requires_with_extra_and_marker + + install_requires=["barbazquux [test]; {mismatch_marker}"], + + [options] + install_requires = + barbazquux [test]; {mismatch_marker} + + [:{mismatch_marker_alternate}] + barbazquux[test] + """, + """ + setup_requires_with_markers + + setup_requires=["barbazquux;{mismatch_marker}"], + + [options] + setup_requires = + barbazquux; {mismatch_marker} + + """, + """ + extras_require_with_extra + {'cmd': ['egg_info']} + + extras_require={{"extra": ["barbazquux [test]"]}}, + + [options.extras_require] + extra = barbazquux [test] + + [extra] + barbazquux[test] + """, + """ + extras_require_with_extra_and_marker_in_req + + extras_require={{"extra": ["barbazquux [test]; {mismatch_marker}"]}}, + + [options.extras_require] + extra = + barbazquux [test]; {mismatch_marker} + + [extra] + + [extra:{mismatch_marker_alternate}] + barbazquux[test] + """, + # FIXME: ConfigParser does not allow : in key names! + """ + extras_require_with_marker + + extras_require={{":{mismatch_marker}": ["barbazquux"]}}, + + @xfail + [options.extras_require] + :{mismatch_marker} = barbazquux + + [:{mismatch_marker}] + barbazquux + """, + """ + extras_require_with_marker_in_req + + extras_require={{"extra": ["barbazquux; {mismatch_marker}"]}}, + + [options.extras_require] + extra = + barbazquux; {mismatch_marker} + + [extra] + + [extra:{mismatch_marker_alternate}] + barbazquux + """, + """ + extras_require_with_empty_section + + extras_require={{"empty": []}}, + + [options.extras_require] + empty = + + [empty] + """, + # Format arguments. + invalid_marker=invalid_marker, + mismatch_marker=mismatch_marker, + mismatch_marker_alternate=mismatch_marker_alternate, + ) + def test_requires( + self, + tmpdir_cwd, + env, + requires, + use_setup_cfg, + expected_requires, + install_cmd_kwargs, + ): + self._setup_script_with_requires(requires, use_setup_cfg) + self._run_egg_info_command(tmpdir_cwd, env, **install_cmd_kwargs) + egg_info_dir = os.path.join('.', 'foo.egg-info') + requires_txt = os.path.join(egg_info_dir, 'requires.txt') + if os.path.exists(requires_txt): + with open(requires_txt, encoding="utf-8") as fp: + install_requires = fp.read() + else: + install_requires = '' + assert install_requires.lstrip() == expected_requires + assert glob.glob(os.path.join(env.paths['lib'], 'barbazquux*')) == [] + + def test_install_requires_unordered_disallowed(self, tmpdir_cwd, env): + """ + Packages that pass unordered install_requires sequences + should be rejected as they produce non-deterministic + builds. See #458. + """ + req = 'install_requires={"fake-factory==0.5.2", "pytz"}' + self._setup_script_with_requires(req) + with pytest.raises(AssertionError): + self._run_egg_info_command(tmpdir_cwd, env) + + def test_extras_require_with_invalid_marker(self, tmpdir_cwd, env): + tmpl = 'extras_require={{":{marker}": ["barbazquux"]}},' + req = tmpl.format(marker=self.invalid_marker) + self._setup_script_with_requires(req) + with pytest.raises(AssertionError): + self._run_egg_info_command(tmpdir_cwd, env) + assert glob.glob(os.path.join(env.paths['lib'], 'barbazquux*')) == [] + + def test_extras_require_with_invalid_marker_in_req(self, tmpdir_cwd, env): + tmpl = 'extras_require={{"extra": ["barbazquux; {marker}"]}},' + req = tmpl.format(marker=self.invalid_marker) + self._setup_script_with_requires(req) + with pytest.raises(AssertionError): + self._run_egg_info_command(tmpdir_cwd, env) + assert glob.glob(os.path.join(env.paths['lib'], 'barbazquux*')) == [] + + def test_provides_extra(self, tmpdir_cwd, env): + self._setup_script_with_requires('extras_require={"foobar": ["barbazquux"]},') + environ = os.environ.copy().update( + HOME=env.paths['home'], + ) + environment.run_setup_py( + cmd=['egg_info'], + pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), + data_stream=1, + env=environ, + ) + egg_info_dir = os.path.join('.', 'foo.egg-info') + with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: + pkg_info_lines = fp.read().split('\n') + assert 'Provides-Extra: foobar' in pkg_info_lines + assert 'Metadata-Version: 2.4' in pkg_info_lines + + def test_doesnt_provides_extra(self, tmpdir_cwd, env): + self._setup_script_with_requires( + """install_requires=["spam ; python_version<'3.6'"]""" + ) + environ = os.environ.copy().update( + HOME=env.paths['home'], + ) + environment.run_setup_py( + cmd=['egg_info'], + pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), + data_stream=1, + env=environ, + ) + egg_info_dir = os.path.join('.', 'foo.egg-info') + with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: + pkg_info_text = fp.read() + assert 'Provides-Extra:' not in pkg_info_text + + @pytest.mark.parametrize( + ('files', 'license_in_sources'), + [ + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_file = LICENSE + """ + ), + 'LICENSE': "Test license", + }, + True, + ), # with license + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_file = INVALID_LICENSE + """ + ), + 'LICENSE': "Test license", + }, + False, + ), # with an invalid license + ( + { + 'setup.cfg': DALS( + """ + """ + ), + 'LICENSE': "Test license", + }, + True, + ), # no license_file attribute, LICENSE auto-included + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_file = LICENSE + """ + ), + 'MANIFEST.in': "exclude LICENSE", + 'LICENSE': "Test license", + }, + True, + ), # manifest is overwritten by license_file + pytest.param( + { + 'setup.cfg': DALS( + """ + [metadata] + license_file = LICEN[CS]E* + """ + ), + 'LICENSE': "Test license", + }, + True, + id="glob_pattern", + ), + ], + ) + def test_setup_cfg_license_file(self, tmpdir_cwd, env, files, license_in_sources): + self._create_project() + path.build(files) + + environment.run_setup_py( + cmd=['egg_info'], + pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), + ) + egg_info_dir = os.path.join('.', 'foo.egg-info') + + sources_text = Path(egg_info_dir, "SOURCES.txt").read_text(encoding="utf-8") + + if license_in_sources: + assert 'LICENSE' in sources_text + else: + assert 'LICENSE' not in sources_text + # for invalid license test + assert 'INVALID_LICENSE' not in sources_text + + @pytest.mark.parametrize( + ('files', 'incl_licenses', 'excl_licenses'), + [ + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_files = + LICENSE-ABC + LICENSE-XYZ + """ + ), + 'LICENSE-ABC': "ABC license", + 'LICENSE-XYZ': "XYZ license", + }, + ['LICENSE-ABC', 'LICENSE-XYZ'], + [], + ), # with licenses + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_files = LICENSE-ABC, LICENSE-XYZ + """ + ), + 'LICENSE-ABC': "ABC license", + 'LICENSE-XYZ': "XYZ license", + }, + ['LICENSE-ABC', 'LICENSE-XYZ'], + [], + ), # with commas + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_files = + LICENSE-ABC + """ + ), + 'LICENSE-ABC': "ABC license", + 'LICENSE-XYZ': "XYZ license", + }, + ['LICENSE-ABC'], + ['LICENSE-XYZ'], + ), # with one license + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_files = + """ + ), + 'LICENSE-ABC': "ABC license", + 'LICENSE-XYZ': "XYZ license", + }, + [], + ['LICENSE-ABC', 'LICENSE-XYZ'], + ), # empty + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_files = LICENSE-XYZ + """ + ), + 'LICENSE-ABC': "ABC license", + 'LICENSE-XYZ': "XYZ license", + }, + ['LICENSE-XYZ'], + ['LICENSE-ABC'], + ), # on same line + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_files = + LICENSE-ABC + INVALID_LICENSE + """ + ), + 'LICENSE-ABC': "Test license", + }, + ['LICENSE-ABC'], + ['INVALID_LICENSE'], + ), # with an invalid license + ( + { + 'setup.cfg': DALS( + """ + """ + ), + 'LICENSE': "Test license", + }, + ['LICENSE'], + [], + ), # no license_files attribute, LICENSE auto-included + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_files = LICENSE + """ + ), + 'MANIFEST.in': "exclude LICENSE", + 'LICENSE': "Test license", + }, + ['LICENSE'], + [], + ), # manifest is overwritten by license_files + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_files = + LICENSE-ABC + LICENSE-XYZ + """ + ), + 'MANIFEST.in': "exclude LICENSE-XYZ", + 'LICENSE-ABC': "ABC license", + 'LICENSE-XYZ': "XYZ license", + # manifest is overwritten by license_files + }, + ['LICENSE-ABC', 'LICENSE-XYZ'], + [], + ), + pytest.param( + { + 'setup.cfg': "", + 'LICENSE-ABC': "ABC license", + 'COPYING-ABC': "ABC copying", + 'NOTICE-ABC': "ABC notice", + 'AUTHORS-ABC': "ABC authors", + 'LICENCE-XYZ': "XYZ license", + 'LICENSE': "License", + 'INVALID-LICENSE': "Invalid license", + }, + [ + 'LICENSE-ABC', + 'COPYING-ABC', + 'NOTICE-ABC', + 'AUTHORS-ABC', + 'LICENCE-XYZ', + 'LICENSE', + ], + ['INVALID-LICENSE'], + # ('LICEN[CS]E*', 'COPYING*', 'NOTICE*', 'AUTHORS*') + id="default_glob_patterns", + ), + pytest.param( + { + 'setup.cfg': DALS( + """ + [metadata] + license_files = + LICENSE* + """ + ), + 'LICENSE-ABC': "ABC license", + 'NOTICE-XYZ': "XYZ notice", + }, + ['LICENSE-ABC'], + ['NOTICE-XYZ'], + id="no_default_glob_patterns", + ), + pytest.param( + { + 'setup.cfg': DALS( + """ + [metadata] + license_files = + LICENSE-ABC + LICENSE* + """ + ), + 'LICENSE-ABC': "ABC license", + }, + ['LICENSE-ABC'], + [], + id="files_only_added_once", + ), + pytest.param( + { + 'setup.cfg': DALS( + """ + [metadata] + license_files = **/LICENSE + """ + ), + 'LICENSE': "ABC license", + 'LICENSE-OTHER': "Don't include", + 'vendor': {'LICENSE': "Vendor license"}, + }, + ['LICENSE', 'vendor/LICENSE'], + ['LICENSE-OTHER'], + id="recursive_glob", + ), + ], + ) + def test_setup_cfg_license_files( + self, tmpdir_cwd, env, files, incl_licenses, excl_licenses + ): + self._create_project() + path.build(files) + + environment.run_setup_py( + cmd=['egg_info'], + pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), + ) + egg_info_dir = os.path.join('.', 'foo.egg-info') + + sources_text = Path(egg_info_dir, "SOURCES.txt").read_text(encoding="utf-8") + sources_lines = [line.strip() for line in sources_text.splitlines()] + + for lf in incl_licenses: + assert sources_lines.count(lf) == 1 + + for lf in excl_licenses: + assert sources_lines.count(lf) == 0 + + @pytest.mark.parametrize( + ('files', 'incl_licenses', 'excl_licenses'), + [ + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_file = + license_files = + """ + ), + 'LICENSE-ABC': "ABC license", + 'LICENSE-XYZ': "XYZ license", + }, + [], + ['LICENSE-ABC', 'LICENSE-XYZ'], + ), # both empty + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_file = + LICENSE-ABC + LICENSE-XYZ + """ + ), + 'LICENSE-ABC': "ABC license", + 'LICENSE-XYZ': "XYZ license", + # license_file is still singular + }, + [], + ['LICENSE-ABC', 'LICENSE-XYZ'], + ), + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_file = LICENSE-ABC + license_files = + LICENSE-XYZ + LICENSE-PQR + """ + ), + 'LICENSE-ABC': "ABC license", + 'LICENSE-PQR': "PQR license", + 'LICENSE-XYZ': "XYZ license", + }, + ['LICENSE-ABC', 'LICENSE-PQR', 'LICENSE-XYZ'], + [], + ), # combined + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_file = LICENSE-ABC + license_files = + LICENSE-ABC + LICENSE-XYZ + LICENSE-PQR + """ + ), + 'LICENSE-ABC': "ABC license", + 'LICENSE-PQR': "PQR license", + 'LICENSE-XYZ': "XYZ license", + # duplicate license + }, + ['LICENSE-ABC', 'LICENSE-PQR', 'LICENSE-XYZ'], + [], + ), + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_file = LICENSE-ABC + license_files = + LICENSE-XYZ + """ + ), + 'LICENSE-ABC': "ABC license", + 'LICENSE-PQR': "PQR license", + 'LICENSE-XYZ': "XYZ license", + # combined subset + }, + ['LICENSE-ABC', 'LICENSE-XYZ'], + ['LICENSE-PQR'], + ), + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_file = LICENSE-ABC + license_files = + LICENSE-XYZ + LICENSE-PQR + """ + ), + 'LICENSE-PQR': "Test license", + # with invalid licenses + }, + ['LICENSE-PQR'], + ['LICENSE-ABC', 'LICENSE-XYZ'], + ), + ( + { + 'setup.cfg': DALS( + """ + [metadata] + license_file = LICENSE-ABC + license_files = + LICENSE-PQR + LICENSE-XYZ + """ + ), + 'MANIFEST.in': "exclude LICENSE-ABC\nexclude LICENSE-PQR", + 'LICENSE-ABC': "ABC license", + 'LICENSE-PQR': "PQR license", + 'LICENSE-XYZ': "XYZ license", + # manifest is overwritten + }, + ['LICENSE-ABC', 'LICENSE-PQR', 'LICENSE-XYZ'], + [], + ), + pytest.param( + { + 'setup.cfg': DALS( + """ + [metadata] + license_file = LICENSE* + """ + ), + 'LICENSE-ABC': "ABC license", + 'NOTICE-XYZ': "XYZ notice", + }, + ['LICENSE-ABC'], + ['NOTICE-XYZ'], + id="no_default_glob_patterns", + ), + pytest.param( + { + 'setup.cfg': DALS( + """ + [metadata] + license_file = LICENSE* + license_files = + NOTICE* + """ + ), + 'LICENSE-ABC': "ABC license", + 'NOTICE-ABC': "ABC notice", + 'AUTHORS-ABC': "ABC authors", + }, + ['LICENSE-ABC', 'NOTICE-ABC'], + ['AUTHORS-ABC'], + id="combined_glob_patterrns", + ), + ], + ) + def test_setup_cfg_license_file_license_files( + self, tmpdir_cwd, env, files, incl_licenses, excl_licenses + ): + self._create_project() + path.build(files) + + environment.run_setup_py( + cmd=['egg_info'], + pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), + ) + egg_info_dir = os.path.join('.', 'foo.egg-info') + + sources_text = Path(egg_info_dir, "SOURCES.txt").read_text(encoding="utf-8") + sources_lines = [line.strip() for line in sources_text.splitlines()] + + for lf in incl_licenses: + assert sources_lines.count(lf) == 1 + + for lf in excl_licenses: + assert sources_lines.count(lf) == 0 + + def test_license_file_attr_pkg_info(self, tmpdir_cwd, env): + """All matched license files should have a corresponding License-File.""" + self._create_project() + path.build({ + "setup.cfg": DALS( + """ + [metadata] + license_files = + NOTICE* + LICENSE* + **/LICENSE + """ + ), + "LICENSE-ABC": "ABC license", + "LICENSE-XYZ": "XYZ license", + "NOTICE": "included", + "IGNORE": "not include", + "vendor": {'LICENSE': "Vendor license"}, + }) + + environment.run_setup_py( + cmd=['egg_info'], + pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), + ) + egg_info_dir = os.path.join('.', 'foo.egg-info') + with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: + pkg_info_lines = fp.read().split('\n') + license_file_lines = [ + line for line in pkg_info_lines if line.startswith('License-File:') + ] + + # Only 'NOTICE', LICENSE-ABC', and 'LICENSE-XYZ' should have been matched + # Also assert that order from license_files is keeped + assert len(license_file_lines) == 4 + assert "License-File: NOTICE" == license_file_lines[0] + assert "License-File: LICENSE-ABC" in license_file_lines[1:] + assert "License-File: LICENSE-XYZ" in license_file_lines[1:] + assert "License-File: vendor/LICENSE" in license_file_lines[3] + + def test_metadata_version(self, tmpdir_cwd, env): + """Make sure latest metadata version is used by default.""" + self._setup_script_with_requires("") + environment.run_setup_py( + cmd=['egg_info'], + pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), + data_stream=1, + ) + egg_info_dir = os.path.join('.', 'foo.egg-info') + with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: + pkg_info_lines = fp.read().split('\n') + # Update metadata version if changed + assert self._extract_mv_version(pkg_info_lines) == (2, 4) + + def test_long_description_content_type(self, tmpdir_cwd, env): + # Test that specifying a `long_description_content_type` keyword arg to + # the `setup` function results in writing a `Description-Content-Type` + # line to the `PKG-INFO` file in the `.egg-info` + # directory. + # `Description-Content-Type` is described at + # https://github.com/pypa/python-packaging-user-guide/pull/258 + + self._setup_script_with_requires( + """long_description_content_type='text/markdown',""" + ) + environ = os.environ.copy().update( + HOME=env.paths['home'], + ) + environment.run_setup_py( + cmd=['egg_info'], + pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), + data_stream=1, + env=environ, + ) + egg_info_dir = os.path.join('.', 'foo.egg-info') + with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: + pkg_info_lines = fp.read().split('\n') + expected_line = 'Description-Content-Type: text/markdown' + assert expected_line in pkg_info_lines + assert 'Metadata-Version: 2.4' in pkg_info_lines + + def test_long_description(self, tmpdir_cwd, env): + # Test that specifying `long_description` and `long_description_content_type` + # keyword args to the `setup` function results in writing + # the description in the message payload of the `PKG-INFO` file + # in the `.egg-info` directory. + self._setup_script_with_requires( + "long_description='This is a long description\\nover multiple lines'," + "long_description_content_type='text/markdown'," + ) + environment.run_setup_py( + cmd=['egg_info'], + pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), + data_stream=1, + ) + egg_info_dir = os.path.join('.', 'foo.egg-info') + with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: + pkg_info_lines = fp.read().split('\n') + assert 'Metadata-Version: 2.4' in pkg_info_lines + assert '' == pkg_info_lines[-1] # last line should be empty + long_desc_lines = pkg_info_lines[pkg_info_lines.index('') :] + assert 'This is a long description' in long_desc_lines + assert 'over multiple lines' in long_desc_lines + + def test_project_urls(self, tmpdir_cwd, env): + # Test that specifying a `project_urls` dict to the `setup` + # function results in writing multiple `Project-URL` lines to + # the `PKG-INFO` file in the `.egg-info` + # directory. + # `Project-URL` is described at https://packaging.python.org + # /specifications/core-metadata/#project-url-multiple-use + + self._setup_script_with_requires( + """project_urls={ + 'Link One': 'https://example.com/one/', + 'Link Two': 'https://example.com/two/', + },""" + ) + environ = os.environ.copy().update( + HOME=env.paths['home'], + ) + environment.run_setup_py( + cmd=['egg_info'], + pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), + data_stream=1, + env=environ, + ) + egg_info_dir = os.path.join('.', 'foo.egg-info') + with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: + pkg_info_lines = fp.read().split('\n') + expected_line = 'Project-URL: Link One, https://example.com/one/' + assert expected_line in pkg_info_lines + expected_line = 'Project-URL: Link Two, https://example.com/two/' + assert expected_line in pkg_info_lines + assert self._extract_mv_version(pkg_info_lines) >= (1, 2) + + def test_license(self, tmpdir_cwd, env): + """Test single line license.""" + self._setup_script_with_requires("license='MIT',") + environment.run_setup_py( + cmd=['egg_info'], + pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), + data_stream=1, + ) + egg_info_dir = os.path.join('.', 'foo.egg-info') + with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: + pkg_info_lines = fp.read().split('\n') + assert 'License: MIT' in pkg_info_lines + + def test_license_escape(self, tmpdir_cwd, env): + """Test license is escaped correctly if longer than one line.""" + self._setup_script_with_requires( + "license='This is a long license text \\nover multiple lines'," + ) + environment.run_setup_py( + cmd=['egg_info'], + pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), + data_stream=1, + ) + egg_info_dir = os.path.join('.', 'foo.egg-info') + with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: + pkg_info_lines = fp.read().split('\n') + + assert 'License: This is a long license text ' in pkg_info_lines + assert ' over multiple lines' in pkg_info_lines + assert 'text \n over multiple' in '\n'.join(pkg_info_lines) + + def test_python_requires_egg_info(self, tmpdir_cwd, env): + self._setup_script_with_requires("""python_requires='>=2.7.12',""") + environ = os.environ.copy().update( + HOME=env.paths['home'], + ) + environment.run_setup_py( + cmd=['egg_info'], + pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), + data_stream=1, + env=environ, + ) + egg_info_dir = os.path.join('.', 'foo.egg-info') + with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: + pkg_info_lines = fp.read().split('\n') + assert 'Requires-Python: >=2.7.12' in pkg_info_lines + assert self._extract_mv_version(pkg_info_lines) >= (1, 2) + + def test_manifest_maker_warning_suppression(self): + fixtures = [ + "standard file not found: should have one of foo.py, bar.py", + "standard file 'setup.py' not found", + ] + + for msg in fixtures: + assert manifest_maker._should_suppress_warning(msg) + + def test_egg_info_includes_setup_py(self, tmpdir_cwd): + self._create_project() + dist = Distribution({"name": "foo", "version": "0.0.1"}) + dist.script_name = "non_setup.py" + egg_info_instance = egg_info(dist) + egg_info_instance.finalize_options() + egg_info_instance.run() + + assert 'setup.py' in egg_info_instance.filelist.files + + with open(egg_info_instance.egg_info + "/SOURCES.txt", encoding="utf-8") as f: + sources = f.read().split('\n') + assert 'setup.py' in sources + + def _run_egg_info_command(self, tmpdir_cwd, env, cmd=None, output=None): + environ = os.environ.copy().update( + HOME=env.paths['home'], + ) + if cmd is None: + cmd = [ + 'egg_info', + ] + code, data = environment.run_setup_py( + cmd=cmd, + pypath=os.pathsep.join([env.paths['lib'], str(tmpdir_cwd)]), + data_stream=1, + env=environ, + ) + assert not code, data + + if output: + assert output in data + + def test_egg_info_tag_only_once(self, tmpdir_cwd, env): + self._create_project() + path.build({ + 'setup.cfg': DALS( + """ + [egg_info] + tag_build = dev + tag_date = 0 + tag_svn_revision = 0 + """ + ), + }) + self._run_egg_info_command(tmpdir_cwd, env) + egg_info_dir = os.path.join('.', 'foo.egg-info') + with open(os.path.join(egg_info_dir, 'PKG-INFO'), encoding="utf-8") as fp: + pkg_info_lines = fp.read().split('\n') + assert 'Version: 0.0.0.dev0' in pkg_info_lines + + +class TestWriteEntries: + def test_invalid_entry_point(self, tmpdir_cwd, env): + dist = Distribution({"name": "foo", "version": "0.0.1"}) + dist.entry_points = {"foo": "foo = invalid-identifier:foo"} + cmd = dist.get_command_obj("egg_info") + expected_msg = r"(Invalid object reference|Problems to parse)" + with pytest.raises((errors.OptionError, ValueError), match=expected_msg) as ex: + write_entries(cmd, "entry_points", "entry_points.txt") + assert "ensure entry-point follows the spec" in ex.value.args[0] + assert "invalid-identifier" in str(ex.value) + + def test_valid_entry_point(self, tmpdir_cwd, env): + dist = Distribution({"name": "foo", "version": "0.0.1"}) + dist.entry_points = { + "abc": "foo = bar:baz", + "def": ["faa = bor:boz"], + } + cmd = dist.get_command_obj("egg_info") + write_entries(cmd, "entry_points", "entry_points.txt") + content = Path("entry_points.txt").read_text(encoding="utf-8") + assert "[abc]\nfoo = bar:baz\n" in content + assert "[def]\nfaa = bor:boz\n" in content diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_extern.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_extern.py new file mode 100644 index 000000000..d7eb3c62c --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_extern.py @@ -0,0 +1,15 @@ +import importlib +import pickle + +import packaging + +from setuptools import Distribution + + +def test_reimport_extern(): + packaging2 = importlib.import_module(packaging.__name__) + assert packaging is packaging2 + + +def test_distribution_picklable(): + pickle.loads(pickle.dumps(Distribution())) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_find_packages.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_find_packages.py new file mode 100644 index 000000000..9fd9f8f66 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_find_packages.py @@ -0,0 +1,218 @@ +"""Tests for automatic package discovery""" + +import os +import shutil +import tempfile + +import pytest + +from setuptools import find_namespace_packages, find_packages +from setuptools.discovery import FlatLayoutPackageFinder + +from .compat.py39 import os_helper + + +class TestFindPackages: + def setup_method(self, method): + self.dist_dir = tempfile.mkdtemp() + self._make_pkg_structure() + + def teardown_method(self, method): + shutil.rmtree(self.dist_dir) + + def _make_pkg_structure(self): + """Make basic package structure. + + dist/ + docs/ + conf.py + pkg/ + __pycache__/ + nspkg/ + mod.py + subpkg/ + assets/ + asset + __init__.py + setup.py + + """ + self.docs_dir = self._mkdir('docs', self.dist_dir) + self._touch('conf.py', self.docs_dir) + self.pkg_dir = self._mkdir('pkg', self.dist_dir) + self._mkdir('__pycache__', self.pkg_dir) + self.ns_pkg_dir = self._mkdir('nspkg', self.pkg_dir) + self._touch('mod.py', self.ns_pkg_dir) + self.sub_pkg_dir = self._mkdir('subpkg', self.pkg_dir) + self.asset_dir = self._mkdir('assets', self.sub_pkg_dir) + self._touch('asset', self.asset_dir) + self._touch('__init__.py', self.sub_pkg_dir) + self._touch('setup.py', self.dist_dir) + + def _mkdir(self, path, parent_dir=None): + if parent_dir: + path = os.path.join(parent_dir, path) + os.mkdir(path) + return path + + def _touch(self, path, dir_=None): + if dir_: + path = os.path.join(dir_, path) + open(path, 'wb').close() + return path + + def test_regular_package(self): + self._touch('__init__.py', self.pkg_dir) + packages = find_packages(self.dist_dir) + assert packages == ['pkg', 'pkg.subpkg'] + + def test_exclude(self): + self._touch('__init__.py', self.pkg_dir) + packages = find_packages(self.dist_dir, exclude=('pkg.*',)) + assert packages == ['pkg'] + + def test_exclude_recursive(self): + """ + Excluding a parent package should not exclude child packages as well. + """ + self._touch('__init__.py', self.pkg_dir) + self._touch('__init__.py', self.sub_pkg_dir) + packages = find_packages(self.dist_dir, exclude=('pkg',)) + assert packages == ['pkg.subpkg'] + + def test_include_excludes_other(self): + """ + If include is specified, other packages should be excluded. + """ + self._touch('__init__.py', self.pkg_dir) + alt_dir = self._mkdir('other_pkg', self.dist_dir) + self._touch('__init__.py', alt_dir) + packages = find_packages(self.dist_dir, include=['other_pkg']) + assert packages == ['other_pkg'] + + def test_dir_with_dot_is_skipped(self): + shutil.rmtree(os.path.join(self.dist_dir, 'pkg/subpkg/assets')) + data_dir = self._mkdir('some.data', self.pkg_dir) + self._touch('__init__.py', data_dir) + self._touch('file.dat', data_dir) + packages = find_packages(self.dist_dir) + assert 'pkg.some.data' not in packages + + def test_dir_with_packages_in_subdir_is_excluded(self): + """ + Ensure that a package in a non-package such as build/pkg/__init__.py + is excluded. + """ + build_dir = self._mkdir('build', self.dist_dir) + build_pkg_dir = self._mkdir('pkg', build_dir) + self._touch('__init__.py', build_pkg_dir) + packages = find_packages(self.dist_dir) + assert 'build.pkg' not in packages + + @pytest.mark.skipif(not os_helper.can_symlink(), reason='Symlink support required') + def test_symlinked_packages_are_included(self): + """ + A symbolically-linked directory should be treated like any other + directory when matched as a package. + + Create a link from lpkg -> pkg. + """ + self._touch('__init__.py', self.pkg_dir) + linked_pkg = os.path.join(self.dist_dir, 'lpkg') + os.symlink('pkg', linked_pkg) + assert os.path.isdir(linked_pkg) + packages = find_packages(self.dist_dir) + assert 'lpkg' in packages + + def _assert_packages(self, actual, expected): + assert set(actual) == set(expected) + + def test_pep420_ns_package(self): + packages = find_namespace_packages( + self.dist_dir, include=['pkg*'], exclude=['pkg.subpkg.assets'] + ) + self._assert_packages(packages, ['pkg', 'pkg.nspkg', 'pkg.subpkg']) + + def test_pep420_ns_package_no_includes(self): + packages = find_namespace_packages(self.dist_dir, exclude=['pkg.subpkg.assets']) + self._assert_packages(packages, ['docs', 'pkg', 'pkg.nspkg', 'pkg.subpkg']) + + def test_pep420_ns_package_no_includes_or_excludes(self): + packages = find_namespace_packages(self.dist_dir) + expected = ['docs', 'pkg', 'pkg.nspkg', 'pkg.subpkg', 'pkg.subpkg.assets'] + self._assert_packages(packages, expected) + + def test_regular_package_with_nested_pep420_ns_packages(self): + self._touch('__init__.py', self.pkg_dir) + packages = find_namespace_packages( + self.dist_dir, exclude=['docs', 'pkg.subpkg.assets'] + ) + self._assert_packages(packages, ['pkg', 'pkg.nspkg', 'pkg.subpkg']) + + def test_pep420_ns_package_no_non_package_dirs(self): + shutil.rmtree(self.docs_dir) + shutil.rmtree(os.path.join(self.dist_dir, 'pkg/subpkg/assets')) + packages = find_namespace_packages(self.dist_dir) + self._assert_packages(packages, ['pkg', 'pkg.nspkg', 'pkg.subpkg']) + + +class TestFlatLayoutPackageFinder: + EXAMPLES = { + "hidden-folders": ( + [".pkg/__init__.py", "pkg/__init__.py", "pkg/nested/file.txt"], + ["pkg", "pkg.nested"], + ), + "private-packages": ( + ["_pkg/__init__.py", "pkg/_private/__init__.py"], + ["pkg", "pkg._private"], + ), + "invalid-name": ( + ["invalid-pkg/__init__.py", "other.pkg/__init__.py", "yet,another/file.py"], + [], + ), + "docs": (["pkg/__init__.py", "docs/conf.py", "docs/readme.rst"], ["pkg"]), + "tests": ( + ["pkg/__init__.py", "tests/test_pkg.py", "tests/__init__.py"], + ["pkg"], + ), + "examples": ( + [ + "pkg/__init__.py", + "examples/__init__.py", + "examples/file.py", + "example/other_file.py", + # Sub-packages should always be fine + "pkg/example/__init__.py", + "pkg/examples/__init__.py", + ], + ["pkg", "pkg.examples", "pkg.example"], + ), + "tool-specific": ( + [ + "htmlcov/index.html", + "pkg/__init__.py", + "tasks/__init__.py", + "tasks/subpackage/__init__.py", + "fabfile/__init__.py", + "fabfile/subpackage/__init__.py", + # Sub-packages should always be fine + "pkg/tasks/__init__.py", + "pkg/fabfile/__init__.py", + ], + ["pkg", "pkg.tasks", "pkg.fabfile"], + ), + } + + @pytest.mark.parametrize("example", EXAMPLES.keys()) + def test_unwanted_directories_not_included(self, tmp_path, example): + files, expected_packages = self.EXAMPLES[example] + ensure_files(tmp_path, files) + found_packages = FlatLayoutPackageFinder.find(str(tmp_path)) + assert set(found_packages) == set(expected_packages) + + +def ensure_files(root_path, files): + for file in files: + path = root_path / file + path.parent.mkdir(parents=True, exist_ok=True) + path.touch() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_find_py_modules.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_find_py_modules.py new file mode 100644 index 000000000..8034b5442 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_find_py_modules.py @@ -0,0 +1,73 @@ +"""Tests for automatic discovery of modules""" + +import os + +import pytest + +from setuptools.discovery import FlatLayoutModuleFinder, ModuleFinder + +from .compat.py39 import os_helper +from .test_find_packages import ensure_files + + +class TestModuleFinder: + def find(self, path, *args, **kwargs): + return set(ModuleFinder.find(str(path), *args, **kwargs)) + + EXAMPLES = { + # circumstance: (files, kwargs, expected_modules) + "simple_folder": ( + ["file.py", "other.py"], + {}, # kwargs + ["file", "other"], + ), + "exclude": ( + ["file.py", "other.py"], + {"exclude": ["f*"]}, + ["other"], + ), + "include": ( + ["file.py", "fole.py", "other.py"], + {"include": ["f*"], "exclude": ["fo*"]}, + ["file"], + ), + "invalid-name": (["my-file.py", "other.file.py"], {}, []), + } + + @pytest.mark.parametrize("example", EXAMPLES.keys()) + def test_finder(self, tmp_path, example): + files, kwargs, expected_modules = self.EXAMPLES[example] + ensure_files(tmp_path, files) + assert self.find(tmp_path, **kwargs) == set(expected_modules) + + @pytest.mark.skipif(not os_helper.can_symlink(), reason='Symlink support required') + def test_symlinked_packages_are_included(self, tmp_path): + src = "_myfiles/file.py" + ensure_files(tmp_path, [src]) + os.symlink(tmp_path / src, tmp_path / "link.py") + assert self.find(tmp_path) == {"link"} + + +class TestFlatLayoutModuleFinder: + def find(self, path, *args, **kwargs): + return set(FlatLayoutModuleFinder.find(str(path))) + + EXAMPLES = { + # circumstance: (files, expected_modules) + "hidden-files": ([".module.py"], []), + "private-modules": (["_module.py"], []), + "common-names": ( + ["setup.py", "conftest.py", "test.py", "tests.py", "example.py", "mod.py"], + ["mod"], + ), + "tool-specific": ( + ["tasks.py", "fabfile.py", "noxfile.py", "dodo.py", "manage.py", "mod.py"], + ["mod"], + ), + } + + @pytest.mark.parametrize("example", EXAMPLES.keys()) + def test_unwanted_files_not_included(self, tmp_path, example): + files, expected_modules = self.EXAMPLES[example] + ensure_files(tmp_path, files) + assert self.find(tmp_path) == set(expected_modules) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_glob.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_glob.py new file mode 100644 index 000000000..8d225a446 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_glob.py @@ -0,0 +1,45 @@ +import pytest +from jaraco import path + +from setuptools.glob import glob + + +@pytest.mark.parametrize( + ('tree', 'pattern', 'matches'), + ( + ('', b'', []), + ('', '', []), + ( + """ + appveyor.yml + CHANGES.rst + LICENSE + MANIFEST.in + pyproject.toml + README.rst + setup.cfg + setup.py + """, + '*.rst', + ('CHANGES.rst', 'README.rst'), + ), + ( + """ + appveyor.yml + CHANGES.rst + LICENSE + MANIFEST.in + pyproject.toml + README.rst + setup.cfg + setup.py + """, + b'*.rst', + (b'CHANGES.rst', b'README.rst'), + ), + ), +) +def test_glob(monkeypatch, tmpdir, tree, pattern, matches): + monkeypatch.chdir(tmpdir) + path.build({name: '' for name in tree.split()}) + assert list(sorted(glob(pattern))) == list(sorted(matches)) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_install_scripts.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_install_scripts.py new file mode 100644 index 000000000..e62a6b7f3 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_install_scripts.py @@ -0,0 +1,89 @@ +"""install_scripts tests""" + +import sys + +import pytest + +from setuptools.command.install_scripts import install_scripts +from setuptools.dist import Distribution + +from . import contexts + + +class TestInstallScripts: + settings = dict( + name='foo', + entry_points={'console_scripts': ['foo=foo:foo']}, + version='0.0', + ) + unix_exe = '/usr/dummy-test-path/local/bin/python' + unix_spaces_exe = '/usr/bin/env dummy-test-python' + win32_exe = 'C:\\Dummy Test Path\\Program Files\\Python 3.6\\python.exe' + + def _run_install_scripts(self, install_dir, executable=None): + dist = Distribution(self.settings) + dist.script_name = 'setup.py' + cmd = install_scripts(dist) + cmd.install_dir = install_dir + if executable is not None: + bs = cmd.get_finalized_command('build_scripts') + bs.executable = executable + cmd.ensure_finalized() + with contexts.quiet(): + cmd.run() + + @pytest.mark.skipif(sys.platform == 'win32', reason='non-Windows only') + def test_sys_executable_escaping_unix(self, tmpdir, monkeypatch): + """ + Ensure that shebang is not quoted on Unix when getting the Python exe + from sys.executable. + """ + expected = f'#!{self.unix_exe}\n' + monkeypatch.setattr('sys.executable', self.unix_exe) + with tmpdir.as_cwd(): + self._run_install_scripts(str(tmpdir)) + with open(str(tmpdir.join('foo')), 'r', encoding="utf-8") as f: + actual = f.readline() + assert actual == expected + + @pytest.mark.skipif(sys.platform != 'win32', reason='Windows only') + def test_sys_executable_escaping_win32(self, tmpdir, monkeypatch): + """ + Ensure that shebang is quoted on Windows when getting the Python exe + from sys.executable and it contains a space. + """ + expected = f'#!"{self.win32_exe}"\n' + monkeypatch.setattr('sys.executable', self.win32_exe) + with tmpdir.as_cwd(): + self._run_install_scripts(str(tmpdir)) + with open(str(tmpdir.join('foo-script.py')), 'r', encoding="utf-8") as f: + actual = f.readline() + assert actual == expected + + @pytest.mark.skipif(sys.platform == 'win32', reason='non-Windows only') + def test_executable_with_spaces_escaping_unix(self, tmpdir): + """ + Ensure that shebang on Unix is not quoted, even when + a value with spaces + is specified using --executable. + """ + expected = f'#!{self.unix_spaces_exe}\n' + with tmpdir.as_cwd(): + self._run_install_scripts(str(tmpdir), self.unix_spaces_exe) + with open(str(tmpdir.join('foo')), 'r', encoding="utf-8") as f: + actual = f.readline() + assert actual == expected + + @pytest.mark.skipif(sys.platform != 'win32', reason='Windows only') + def test_executable_arg_escaping_win32(self, tmpdir): + """ + Ensure that shebang on Windows is quoted when + getting a path with spaces + from --executable, that is itself properly quoted. + """ + expected = f'#!"{self.win32_exe}"\n' + with tmpdir.as_cwd(): + self._run_install_scripts(str(tmpdir), '"' + self.win32_exe + '"') + with open(str(tmpdir.join('foo-script.py')), 'r', encoding="utf-8") as f: + actual = f.readline() + assert actual == expected diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_logging.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_logging.py new file mode 100644 index 000000000..ea58001e9 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_logging.py @@ -0,0 +1,76 @@ +import functools +import inspect +import logging +import sys + +import pytest + +IS_PYPY = '__pypy__' in sys.builtin_module_names + + +setup_py = """\ +from setuptools import setup + +setup( + name="test_logging", + version="0.0" +) +""" + + +@pytest.mark.parametrize( + ('flag', 'expected_level'), [("--dry-run", "INFO"), ("--verbose", "DEBUG")] +) +def test_verbosity_level(tmp_path, monkeypatch, flag, expected_level): + """Make sure the correct verbosity level is set (issue #3038)""" + import setuptools # noqa: F401 # import setuptools to monkeypatch distutils + + import distutils # <- load distutils after all the patches take place + + logger = logging.Logger(__name__) + monkeypatch.setattr(logging, "root", logger) + unset_log_level = logger.getEffectiveLevel() + assert logging.getLevelName(unset_log_level) == "NOTSET" + + setup_script = tmp_path / "setup.py" + setup_script.write_text(setup_py, encoding="utf-8") + dist = distutils.core.run_setup(setup_script, stop_after="init") + dist.script_args = [flag, "sdist"] + dist.parse_command_line() # <- where the log level is set + log_level = logger.getEffectiveLevel() + log_level_name = logging.getLevelName(log_level) + assert log_level_name == expected_level + + +def flaky_on_pypy(func): + @functools.wraps(func) + def _func(): + try: + func() + except AssertionError: # pragma: no cover + if IS_PYPY: + msg = "Flaky monkeypatch on PyPy (#4124)" + pytest.xfail(f"{msg}. Original discussion in #3707, #3709.") + raise + + return _func + + +@flaky_on_pypy +def test_patching_does_not_cause_problems(): + # Ensure `dist.log` is only patched if necessary + + import _distutils_hack + + import setuptools.logging + + from distutils import dist + + setuptools.logging.configure() + + if _distutils_hack.enabled(): + # Modern logging infra, no problematic patching. + assert dist.__file__ is None or "setuptools" in dist.__file__ + assert isinstance(dist.log, logging.Logger) + else: + assert inspect.ismodule(dist.log) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_manifest.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_manifest.py new file mode 100644 index 000000000..903a528db --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_manifest.py @@ -0,0 +1,622 @@ +"""sdist tests""" + +from __future__ import annotations + +import contextlib +import io +import itertools +import logging +import os +import shutil +import sys +import tempfile + +import pytest + +from setuptools.command.egg_info import FileList, egg_info, translate_pattern +from setuptools.dist import Distribution +from setuptools.tests.textwrap import DALS + +from distutils import log +from distutils.errors import DistutilsTemplateError + +IS_PYPY = '__pypy__' in sys.builtin_module_names + + +def make_local_path(s): + """Converts '/' in a string to os.sep""" + return s.replace('/', os.sep) + + +SETUP_ATTRS = { + 'name': 'app', + 'version': '0.0', + 'packages': ['app'], +} + +SETUP_PY = f"""\ +from setuptools import setup + +setup(**{SETUP_ATTRS!r}) +""" + + +@contextlib.contextmanager +def quiet(): + old_stdout, old_stderr = sys.stdout, sys.stderr + sys.stdout, sys.stderr = io.StringIO(), io.StringIO() + try: + yield + finally: + sys.stdout, sys.stderr = old_stdout, old_stderr + + +def touch(filename): + open(filename, 'wb').close() + + +# The set of files always in the manifest, including all files in the +# .egg-info directory +default_files = frozenset( + map( + make_local_path, + [ + 'README.rst', + 'MANIFEST.in', + 'setup.py', + 'app.egg-info/PKG-INFO', + 'app.egg-info/SOURCES.txt', + 'app.egg-info/dependency_links.txt', + 'app.egg-info/top_level.txt', + 'app/__init__.py', + ], + ) +) + + +translate_specs: list[tuple[str, list[str], list[str]]] = [ + ('foo', ['foo'], ['bar', 'foobar']), + ('foo/bar', ['foo/bar'], ['foo/bar/baz', './foo/bar', 'foo']), + # Glob matching + ('*.txt', ['foo.txt', 'bar.txt'], ['foo/foo.txt']), + ('dir/*.txt', ['dir/foo.txt', 'dir/bar.txt', 'dir/.txt'], ['notdir/foo.txt']), + ('*/*.py', ['bin/start.py'], []), + ('docs/page-?.txt', ['docs/page-9.txt'], ['docs/page-10.txt']), + # Globstars change what they mean depending upon where they are + ( + 'foo/**/bar', + ['foo/bing/bar', 'foo/bing/bang/bar', 'foo/bar'], + ['foo/abar'], + ), + ( + 'foo/**', + ['foo/bar/bing.py', 'foo/x'], + ['/foo/x'], + ), + ( + '**', + ['x', 'abc/xyz', '@nything'], + [], + ), + # Character classes + ( + 'pre[one]post', + ['preopost', 'prenpost', 'preepost'], + ['prepost', 'preonepost'], + ), + ( + 'hello[!one]world', + ['helloxworld', 'helloyworld'], + ['hellooworld', 'helloworld', 'hellooneworld'], + ), + ( + '[]one].txt', + ['o.txt', '].txt', 'e.txt'], + ['one].txt'], + ), + ( + 'foo[!]one]bar', + ['fooybar'], + ['foo]bar', 'fooobar', 'fooebar'], + ), +] +""" +A spec of inputs for 'translate_pattern' and matches and mismatches +for that input. +""" + +match_params = itertools.chain.from_iterable( + zip(itertools.repeat(pattern), matches) + for pattern, matches, mismatches in translate_specs +) + + +@pytest.fixture(params=match_params) +def pattern_match(request): + return map(make_local_path, request.param) + + +mismatch_params = itertools.chain.from_iterable( + zip(itertools.repeat(pattern), mismatches) + for pattern, matches, mismatches in translate_specs +) + + +@pytest.fixture(params=mismatch_params) +def pattern_mismatch(request): + return map(make_local_path, request.param) + + +def test_translated_pattern_match(pattern_match): + pattern, target = pattern_match + assert translate_pattern(pattern).match(target) + + +def test_translated_pattern_mismatch(pattern_mismatch): + pattern, target = pattern_mismatch + assert not translate_pattern(pattern).match(target) + + +class TempDirTestCase: + def setup_method(self, method): + self.temp_dir = tempfile.mkdtemp() + self.old_cwd = os.getcwd() + os.chdir(self.temp_dir) + + def teardown_method(self, method): + os.chdir(self.old_cwd) + shutil.rmtree(self.temp_dir) + + +class TestManifestTest(TempDirTestCase): + def setup_method(self, method): + super().setup_method(method) + + f = open(os.path.join(self.temp_dir, 'setup.py'), 'w', encoding="utf-8") + f.write(SETUP_PY) + f.close() + """ + Create a file tree like: + - LICENSE + - README.rst + - testing.rst + - .hidden.rst + - app/ + - __init__.py + - a.txt + - b.txt + - c.rst + - static/ + - app.js + - app.js.map + - app.css + - app.css.map + """ + + for fname in ['README.rst', '.hidden.rst', 'testing.rst', 'LICENSE']: + touch(os.path.join(self.temp_dir, fname)) + + # Set up the rest of the test package + test_pkg = os.path.join(self.temp_dir, 'app') + os.mkdir(test_pkg) + for fname in ['__init__.py', 'a.txt', 'b.txt', 'c.rst']: + touch(os.path.join(test_pkg, fname)) + + # Some compiled front-end assets to include + static = os.path.join(test_pkg, 'static') + os.mkdir(static) + for fname in ['app.js', 'app.js.map', 'app.css', 'app.css.map']: + touch(os.path.join(static, fname)) + + def make_manifest(self, contents): + """Write a MANIFEST.in.""" + manifest = os.path.join(self.temp_dir, 'MANIFEST.in') + with open(manifest, 'w', encoding="utf-8") as f: + f.write(DALS(contents)) + + def get_files(self): + """Run egg_info and get all the files to include, as a set""" + dist = Distribution(SETUP_ATTRS) + dist.script_name = 'setup.py' + cmd = egg_info(dist) + cmd.ensure_finalized() + + cmd.run() + + return set(cmd.filelist.files) + + def test_no_manifest(self): + """Check a missing MANIFEST.in includes only the standard files.""" + assert (default_files - set(['MANIFEST.in'])) == self.get_files() + + def test_empty_files(self): + """Check an empty MANIFEST.in includes only the standard files.""" + self.make_manifest("") + assert default_files == self.get_files() + + def test_include(self): + """Include extra rst files in the project root.""" + self.make_manifest("include *.rst") + files = default_files | set(['testing.rst', '.hidden.rst']) + assert files == self.get_files() + + def test_exclude(self): + """Include everything in app/ except the text files""" + ml = make_local_path + self.make_manifest( + """ + include app/* + exclude app/*.txt + """ + ) + files = default_files | set([ml('app/c.rst')]) + assert files == self.get_files() + + def test_include_multiple(self): + """Include with multiple patterns.""" + ml = make_local_path + self.make_manifest("include app/*.txt app/static/*") + files = default_files | set([ + ml('app/a.txt'), + ml('app/b.txt'), + ml('app/static/app.js'), + ml('app/static/app.js.map'), + ml('app/static/app.css'), + ml('app/static/app.css.map'), + ]) + assert files == self.get_files() + + def test_graft(self): + """Include the whole app/static/ directory.""" + ml = make_local_path + self.make_manifest("graft app/static") + files = default_files | set([ + ml('app/static/app.js'), + ml('app/static/app.js.map'), + ml('app/static/app.css'), + ml('app/static/app.css.map'), + ]) + assert files == self.get_files() + + def test_graft_glob_syntax(self): + """Include the whole app/static/ directory.""" + ml = make_local_path + self.make_manifest("graft */static") + files = default_files | set([ + ml('app/static/app.js'), + ml('app/static/app.js.map'), + ml('app/static/app.css'), + ml('app/static/app.css.map'), + ]) + assert files == self.get_files() + + def test_graft_global_exclude(self): + """Exclude all *.map files in the project.""" + ml = make_local_path + self.make_manifest( + """ + graft app/static + global-exclude *.map + """ + ) + files = default_files | set([ml('app/static/app.js'), ml('app/static/app.css')]) + assert files == self.get_files() + + def test_global_include(self): + """Include all *.rst, *.js, and *.css files in the whole tree.""" + ml = make_local_path + self.make_manifest( + """ + global-include *.rst *.js *.css + """ + ) + files = default_files | set([ + '.hidden.rst', + 'testing.rst', + ml('app/c.rst'), + ml('app/static/app.js'), + ml('app/static/app.css'), + ]) + assert files == self.get_files() + + def test_graft_prune(self): + """Include all files in app/, except for the whole app/static/ dir.""" + ml = make_local_path + self.make_manifest( + """ + graft app + prune app/static + """ + ) + files = default_files | set([ml('app/a.txt'), ml('app/b.txt'), ml('app/c.rst')]) + assert files == self.get_files() + + +class TestFileListTest(TempDirTestCase): + """ + A copy of the relevant bits of distutils/tests/test_filelist.py, + to ensure setuptools' version of FileList keeps parity with distutils. + """ + + @pytest.fixture(autouse=os.getenv("SETUPTOOLS_USE_DISTUTILS") == "stdlib") + def _compat_record_logs(self, monkeypatch, caplog): + """Account for stdlib compatibility""" + + def _log(_logger, level, msg, args): + exc = sys.exc_info() + rec = logging.LogRecord("distutils", level, "", 0, msg, args, exc) + caplog.records.append(rec) + + monkeypatch.setattr(log.Log, "_log", _log) + + def get_records(self, caplog, *levels): + return [r for r in caplog.records if r.levelno in levels] + + def assertNoWarnings(self, caplog): + assert self.get_records(caplog, log.WARN) == [] + caplog.clear() + + def assertWarnings(self, caplog): + if IS_PYPY and not caplog.records: + pytest.xfail("caplog checks may not work well in PyPy") + else: + assert len(self.get_records(caplog, log.WARN)) > 0 + caplog.clear() + + def make_files(self, files): + for file in files: + file = os.path.join(self.temp_dir, file) + dirname, _basename = os.path.split(file) + os.makedirs(dirname, exist_ok=True) + touch(file) + + def test_process_template_line(self): + # testing all MANIFEST.in template patterns + file_list = FileList() + ml = make_local_path + + # simulated file list + self.make_files([ + 'foo.tmp', + 'ok', + 'xo', + 'four.txt', + 'buildout.cfg', + # filelist does not filter out VCS directories, + # it's sdist that does + ml('.hg/last-message.txt'), + ml('global/one.txt'), + ml('global/two.txt'), + ml('global/files.x'), + ml('global/here.tmp'), + ml('f/o/f.oo'), + ml('dir/graft-one'), + ml('dir/dir2/graft2'), + ml('dir3/ok'), + ml('dir3/sub/ok.txt'), + ]) + + MANIFEST_IN = DALS( + """\ + include ok + include xo + exclude xo + include foo.tmp + include buildout.cfg + global-include *.x + global-include *.txt + global-exclude *.tmp + recursive-include f *.oo + recursive-exclude global *.x + graft dir + prune dir3 + """ + ) + + for line in MANIFEST_IN.split('\n'): + if not line: + continue + file_list.process_template_line(line) + + wanted = [ + 'buildout.cfg', + 'four.txt', + 'ok', + ml('.hg/last-message.txt'), + ml('dir/graft-one'), + ml('dir/dir2/graft2'), + ml('f/o/f.oo'), + ml('global/one.txt'), + ml('global/two.txt'), + ] + + file_list.sort() + assert file_list.files == wanted + + def test_exclude_pattern(self): + # return False if no match + file_list = FileList() + assert not file_list.exclude_pattern('*.py') + + # return True if files match + file_list = FileList() + file_list.files = ['a.py', 'b.py'] + assert file_list.exclude_pattern('*.py') + + # test excludes + file_list = FileList() + file_list.files = ['a.py', 'a.txt'] + file_list.exclude_pattern('*.py') + file_list.sort() + assert file_list.files == ['a.txt'] + + def test_include_pattern(self): + # return False if no match + file_list = FileList() + self.make_files([]) + assert not file_list.include_pattern('*.py') + + # return True if files match + file_list = FileList() + self.make_files(['a.py', 'b.txt']) + assert file_list.include_pattern('*.py') + + # test * matches all files + file_list = FileList() + self.make_files(['a.py', 'b.txt']) + file_list.include_pattern('*') + file_list.sort() + assert file_list.files == ['a.py', 'b.txt'] + + def test_process_template_line_invalid(self): + # invalid lines + file_list = FileList() + for action in ( + 'include', + 'exclude', + 'global-include', + 'global-exclude', + 'recursive-include', + 'recursive-exclude', + 'graft', + 'prune', + 'blarg', + ): + with pytest.raises(DistutilsTemplateError): + file_list.process_template_line(action) + + def test_include(self, caplog): + caplog.set_level(logging.DEBUG) + ml = make_local_path + # include + file_list = FileList() + self.make_files(['a.py', 'b.txt', ml('d/c.py')]) + + file_list.process_template_line('include *.py') + file_list.sort() + assert file_list.files == ['a.py'] + self.assertNoWarnings(caplog) + + file_list.process_template_line('include *.rb') + file_list.sort() + assert file_list.files == ['a.py'] + self.assertWarnings(caplog) + + def test_exclude(self, caplog): + caplog.set_level(logging.DEBUG) + ml = make_local_path + # exclude + file_list = FileList() + file_list.files = ['a.py', 'b.txt', ml('d/c.py')] + + file_list.process_template_line('exclude *.py') + file_list.sort() + assert file_list.files == ['b.txt', ml('d/c.py')] + self.assertNoWarnings(caplog) + + file_list.process_template_line('exclude *.rb') + file_list.sort() + assert file_list.files == ['b.txt', ml('d/c.py')] + self.assertWarnings(caplog) + + def test_global_include(self, caplog): + caplog.set_level(logging.DEBUG) + ml = make_local_path + # global-include + file_list = FileList() + self.make_files(['a.py', 'b.txt', ml('d/c.py')]) + + file_list.process_template_line('global-include *.py') + file_list.sort() + assert file_list.files == ['a.py', ml('d/c.py')] + self.assertNoWarnings(caplog) + + file_list.process_template_line('global-include *.rb') + file_list.sort() + assert file_list.files == ['a.py', ml('d/c.py')] + self.assertWarnings(caplog) + + def test_global_exclude(self, caplog): + caplog.set_level(logging.DEBUG) + ml = make_local_path + # global-exclude + file_list = FileList() + file_list.files = ['a.py', 'b.txt', ml('d/c.py')] + + file_list.process_template_line('global-exclude *.py') + file_list.sort() + assert file_list.files == ['b.txt'] + self.assertNoWarnings(caplog) + + file_list.process_template_line('global-exclude *.rb') + file_list.sort() + assert file_list.files == ['b.txt'] + self.assertWarnings(caplog) + + def test_recursive_include(self, caplog): + caplog.set_level(logging.DEBUG) + ml = make_local_path + # recursive-include + file_list = FileList() + self.make_files(['a.py', ml('d/b.py'), ml('d/c.txt'), ml('d/d/e.py')]) + + file_list.process_template_line('recursive-include d *.py') + file_list.sort() + assert file_list.files == [ml('d/b.py'), ml('d/d/e.py')] + self.assertNoWarnings(caplog) + + file_list.process_template_line('recursive-include e *.py') + file_list.sort() + assert file_list.files == [ml('d/b.py'), ml('d/d/e.py')] + self.assertWarnings(caplog) + + def test_recursive_exclude(self, caplog): + caplog.set_level(logging.DEBUG) + ml = make_local_path + # recursive-exclude + file_list = FileList() + file_list.files = ['a.py', ml('d/b.py'), ml('d/c.txt'), ml('d/d/e.py')] + + file_list.process_template_line('recursive-exclude d *.py') + file_list.sort() + assert file_list.files == ['a.py', ml('d/c.txt')] + self.assertNoWarnings(caplog) + + file_list.process_template_line('recursive-exclude e *.py') + file_list.sort() + assert file_list.files == ['a.py', ml('d/c.txt')] + self.assertWarnings(caplog) + + def test_graft(self, caplog): + caplog.set_level(logging.DEBUG) + ml = make_local_path + # graft + file_list = FileList() + self.make_files(['a.py', ml('d/b.py'), ml('d/d/e.py'), ml('f/f.py')]) + + file_list.process_template_line('graft d') + file_list.sort() + assert file_list.files == [ml('d/b.py'), ml('d/d/e.py')] + self.assertNoWarnings(caplog) + + file_list.process_template_line('graft e') + file_list.sort() + assert file_list.files == [ml('d/b.py'), ml('d/d/e.py')] + self.assertWarnings(caplog) + + def test_prune(self, caplog): + caplog.set_level(logging.DEBUG) + ml = make_local_path + # prune + file_list = FileList() + file_list.files = ['a.py', ml('d/b.py'), ml('d/d/e.py'), ml('f/f.py')] + + file_list.process_template_line('prune d') + file_list.sort() + assert file_list.files == ['a.py', ml('f/f.py')] + self.assertNoWarnings(caplog) + + file_list.process_template_line('prune e') + file_list.sort() + assert file_list.files == ['a.py', ml('f/f.py')] + self.assertWarnings(caplog) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_namespaces.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_namespaces.py new file mode 100644 index 000000000..a0f4120bf --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_namespaces.py @@ -0,0 +1,138 @@ +import subprocess +import sys + +from setuptools._path import paths_on_pythonpath + +from . import namespaces + + +class TestNamespaces: + def test_mixed_site_and_non_site(self, tmpdir): + """ + Installing two packages sharing the same namespace, one installed + to a site dir and the other installed just to a path on PYTHONPATH + should leave the namespace in tact and both packages reachable by + import. + """ + pkg_A = namespaces.build_namespace_package(tmpdir, 'myns.pkgA') + pkg_B = namespaces.build_namespace_package(tmpdir, 'myns.pkgB') + site_packages = tmpdir / 'site-packages' + path_packages = tmpdir / 'path-packages' + targets = site_packages, path_packages + # use pip to install to the target directory + install_cmd = [ + sys.executable, + '-m', + 'pip.__main__', + 'install', + str(pkg_A), + '-t', + str(site_packages), + ] + subprocess.check_call(install_cmd) + namespaces.make_site_dir(site_packages) + install_cmd = [ + sys.executable, + '-m', + 'pip.__main__', + 'install', + str(pkg_B), + '-t', + str(path_packages), + ] + subprocess.check_call(install_cmd) + try_import = [ + sys.executable, + '-c', + 'import myns.pkgA; import myns.pkgB', + ] + with paths_on_pythonpath(map(str, targets)): + subprocess.check_call(try_import) + + def test_pkg_resources_import(self, tmpdir): + """ + Ensure that a namespace package doesn't break on import + of pkg_resources. + """ + pkg = namespaces.build_namespace_package(tmpdir, 'myns.pkgA') + target = tmpdir / 'packages' + target.mkdir() + install_cmd = [ + sys.executable, + '-m', + 'pip', + 'install', + '-t', + str(target), + str(pkg), + ] + with paths_on_pythonpath([str(target)]): + subprocess.check_call(install_cmd) + namespaces.make_site_dir(target) + try_import = [ + sys.executable, + '-c', + 'import pkg_resources', + ] + with paths_on_pythonpath([str(target)]): + subprocess.check_call(try_import) + + def test_namespace_package_installed_and_cwd(self, tmpdir): + """ + Installing a namespace packages but also having it in the current + working directory, only one version should take precedence. + """ + pkg_A = namespaces.build_namespace_package(tmpdir, 'myns.pkgA') + target = tmpdir / 'packages' + # use pip to install to the target directory + install_cmd = [ + sys.executable, + '-m', + 'pip.__main__', + 'install', + str(pkg_A), + '-t', + str(target), + ] + subprocess.check_call(install_cmd) + namespaces.make_site_dir(target) + + # ensure that package imports and pkg_resources imports + pkg_resources_imp = [ + sys.executable, + '-c', + 'import pkg_resources; import myns.pkgA', + ] + with paths_on_pythonpath([str(target)]): + subprocess.check_call(pkg_resources_imp, cwd=str(pkg_A)) + + def test_packages_in_the_same_namespace_installed_and_cwd(self, tmpdir): + """ + Installing one namespace package and also have another in the same + namespace in the current working directory, both of them must be + importable. + """ + pkg_A = namespaces.build_namespace_package(tmpdir, 'myns.pkgA') + pkg_B = namespaces.build_namespace_package(tmpdir, 'myns.pkgB') + target = tmpdir / 'packages' + # use pip to install to the target directory + install_cmd = [ + sys.executable, + '-m', + 'pip.__main__', + 'install', + str(pkg_A), + '-t', + str(target), + ] + subprocess.check_call(install_cmd) + namespaces.make_site_dir(target) + + # ensure that all packages import and pkg_resources imports + pkg_resources_imp = [ + sys.executable, + '-c', + 'import pkg_resources; import myns.pkgA; import myns.pkgB', + ] + with paths_on_pythonpath([str(target)]): + subprocess.check_call(pkg_resources_imp, cwd=str(pkg_B)) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_scripts.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_scripts.py new file mode 100644 index 000000000..8641f7b63 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_scripts.py @@ -0,0 +1,12 @@ +from setuptools import _scripts + + +class TestWindowsScriptWriter: + def test_header(self): + hdr = _scripts.WindowsScriptWriter.get_header('') + assert hdr.startswith('#!') + assert hdr.endswith('\n') + hdr = hdr.lstrip('#!') + hdr = hdr.rstrip('\n') + # header should not start with an escaped quote + assert not hdr.startswith('\\"') diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_sdist.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_sdist.py new file mode 100644 index 000000000..19d8ddf6d --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_sdist.py @@ -0,0 +1,984 @@ +"""sdist tests""" + +import contextlib +import io +import logging +import os +import pathlib +import sys +import tarfile +import tempfile +import unicodedata +from inspect import cleandoc +from pathlib import Path +from unittest import mock + +import jaraco.path +import pytest + +from setuptools import Command, SetuptoolsDeprecationWarning +from setuptools._importlib import metadata +from setuptools.command.egg_info import manifest_maker +from setuptools.command.sdist import sdist +from setuptools.dist import Distribution +from setuptools.extension import Extension +from setuptools.tests import fail_on_ascii + +from .text import Filenames + +import distutils +from distutils.core import run_setup + +SETUP_ATTRS = { + 'name': 'sdist_test', + 'version': '0.0', + 'packages': ['sdist_test'], + 'package_data': {'sdist_test': ['*.txt']}, + 'data_files': [("data", [os.path.join("d", "e.dat")])], +} + +SETUP_PY = f"""\ +from setuptools import setup + +setup(**{SETUP_ATTRS!r}) +""" + +EXTENSION = Extension( + name="sdist_test.f", + sources=[os.path.join("sdist_test", "f.c")], + depends=[os.path.join("sdist_test", "f.h")], +) +EXTENSION_SOURCES = EXTENSION.sources + EXTENSION.depends + + +@contextlib.contextmanager +def quiet(): + old_stdout, old_stderr = sys.stdout, sys.stderr + sys.stdout, sys.stderr = io.StringIO(), io.StringIO() + try: + yield + finally: + sys.stdout, sys.stderr = old_stdout, old_stderr + + +# Convert to POSIX path +def posix(path): + if not isinstance(path, str): + return path.replace(os.sep.encode('ascii'), b'/') + else: + return path.replace(os.sep, '/') + + +# HFS Plus uses decomposed UTF-8 +def decompose(path): + if isinstance(path, str): + return unicodedata.normalize('NFD', path) + try: + path = path.decode('utf-8') + path = unicodedata.normalize('NFD', path) + path = path.encode('utf-8') + except UnicodeError: + pass # Not UTF-8 + return path + + +def read_all_bytes(filename): + with open(filename, 'rb') as fp: + return fp.read() + + +def latin1_fail(): + try: + desc, filename = tempfile.mkstemp(suffix=Filenames.latin_1) + os.close(desc) + os.remove(filename) + except Exception: + return True + + +fail_on_latin1_encoded_filenames = pytest.mark.xfail( + latin1_fail(), + reason="System does not support latin-1 filenames", +) + + +skip_under_xdist = pytest.mark.skipif( + "os.environ.get('PYTEST_XDIST_WORKER')", + reason="pytest-dev/pytest-xdist#843", +) +skip_under_stdlib_distutils = pytest.mark.skipif( + not distutils.__package__.startswith('setuptools'), + reason="the test is not supported with stdlib distutils", +) + + +def touch(path): + open(path, 'wb').close() + return path + + +def symlink_or_skip_test(src, dst): + try: + os.symlink(src, dst) + except (OSError, NotImplementedError): + pytest.skip("symlink not supported in OS") + return None + return dst + + +class TestSdistTest: + @pytest.fixture(autouse=True) + def source_dir(self, tmpdir): + tmpdir = tmpdir / "project_root" + tmpdir.mkdir() + + (tmpdir / 'setup.py').write_text(SETUP_PY, encoding='utf-8') + + # Set up the rest of the test package + test_pkg = tmpdir / 'sdist_test' + test_pkg.mkdir() + data_folder = tmpdir / 'd' + data_folder.mkdir() + # *.rst was not included in package_data, so c.rst should not be + # automatically added to the manifest when not under version control + for fname in ['__init__.py', 'a.txt', 'b.txt', 'c.rst']: + touch(test_pkg / fname) + touch(data_folder / 'e.dat') + # C sources are not included by default, but they will be, + # if an extension module uses them as sources or depends + for fname in EXTENSION_SOURCES: + touch(tmpdir / fname) + + with tmpdir.as_cwd(): + yield tmpdir + + def assert_package_data_in_manifest(self, cmd): + manifest = cmd.filelist.files + assert os.path.join('sdist_test', 'a.txt') in manifest + assert os.path.join('sdist_test', 'b.txt') in manifest + assert os.path.join('sdist_test', 'c.rst') not in manifest + assert os.path.join('d', 'e.dat') in manifest + + def setup_with_extension(self): + setup_attrs = {**SETUP_ATTRS, 'ext_modules': [EXTENSION]} + + dist = Distribution(setup_attrs) + dist.script_name = 'setup.py' + cmd = sdist(dist) + cmd.ensure_finalized() + + with quiet(): + cmd.run() + + return cmd + + def test_package_data_in_sdist(self): + """Regression test for pull request #4: ensures that files listed in + package_data are included in the manifest even if they're not added to + version control. + """ + + dist = Distribution(SETUP_ATTRS) + dist.script_name = 'setup.py' + cmd = sdist(dist) + cmd.ensure_finalized() + + with quiet(): + cmd.run() + + self.assert_package_data_in_manifest(cmd) + + def test_package_data_and_include_package_data_in_sdist(self): + """ + Ensure package_data and include_package_data work + together. + """ + setup_attrs = {**SETUP_ATTRS, 'include_package_data': True} + assert setup_attrs['package_data'] + + dist = Distribution(setup_attrs) + dist.script_name = 'setup.py' + cmd = sdist(dist) + cmd.ensure_finalized() + + with quiet(): + cmd.run() + + self.assert_package_data_in_manifest(cmd) + + def test_extension_sources_in_sdist(self): + """ + Ensure that the files listed in Extension.sources and Extension.depends + are automatically included in the manifest. + """ + cmd = self.setup_with_extension() + self.assert_package_data_in_manifest(cmd) + manifest = cmd.filelist.files + for path in EXTENSION_SOURCES: + assert path in manifest + + def test_missing_extension_sources(self): + """ + Similar to test_extension_sources_in_sdist but the referenced files don't exist. + Missing files should not be included in distribution (with no error raised). + """ + for path in EXTENSION_SOURCES: + os.remove(path) + + cmd = self.setup_with_extension() + self.assert_package_data_in_manifest(cmd) + manifest = cmd.filelist.files + for path in EXTENSION_SOURCES: + assert path not in manifest + + def test_symlinked_extension_sources(self): + """ + Similar to test_extension_sources_in_sdist but the referenced files are + instead symbolic links to project-local files. Referenced file paths + should be included. Symlink targets themselves should NOT be included. + """ + symlinked = [] + for path in EXTENSION_SOURCES: + base, ext = os.path.splitext(path) + target = base + "_target." + ext + + os.rename(path, target) + symlink_or_skip_test(os.path.basename(target), path) + symlinked.append(target) + + cmd = self.setup_with_extension() + self.assert_package_data_in_manifest(cmd) + manifest = cmd.filelist.files + for path in EXTENSION_SOURCES: + assert path in manifest + for path in symlinked: + assert path not in manifest + + _INVALID_PATHS = { + "must be relative": lambda: ( + os.path.abspath(os.path.join("sdist_test", "f.h")) + ), + "can't have `..` segments": lambda: ( + os.path.join("sdist_test", "..", "sdist_test", "f.h") + ), + "doesn't exist": lambda: ( + os.path.join("sdist_test", "this_file_does_not_exist.h") + ), + "must be inside the project root": lambda: ( + symlink_or_skip_test( + touch(os.path.join("..", "outside_of_project_root.h")), + "symlink.h", + ) + ), + } + + @skip_under_stdlib_distutils + @pytest.mark.parametrize("reason", _INVALID_PATHS.keys()) + def test_invalid_extension_depends(self, reason, caplog): + """ + Due to backwards compatibility reasons, `Extension.depends` should accept + invalid/weird paths, but then ignore them when building a sdist. + + This test verifies that the source distribution is still built + successfully with such paths, but that instead of adding these paths to + the manifest, we emit an informational message, notifying the user that + the invalid path won't be automatically included. + """ + invalid_path = self._INVALID_PATHS[reason]() + extension = Extension( + name="sdist_test.f", + sources=[], + depends=[invalid_path], + ) + setup_attrs = {**SETUP_ATTRS, 'ext_modules': [extension]} + + dist = Distribution(setup_attrs) + dist.script_name = 'setup.py' + cmd = sdist(dist) + cmd.ensure_finalized() + + with quiet(), caplog.at_level(logging.INFO): + cmd.run() + + self.assert_package_data_in_manifest(cmd) + manifest = cmd.filelist.files + assert invalid_path not in manifest + + expected_message = [ + message + for (logger, level, message) in caplog.record_tuples + if ( + logger == "root" # + and level == logging.INFO # + and invalid_path in message # + ) + ] + assert len(expected_message) == 1 + (expected_message,) = expected_message + assert reason in expected_message + + def test_custom_build_py(self): + """ + Ensure projects defining custom build_py don't break + when creating sdists (issue #2849) + """ + from distutils.command.build_py import build_py as OrigBuildPy + + using_custom_command_guard = mock.Mock() + + class CustomBuildPy(OrigBuildPy): + """ + Some projects have custom commands inheriting from `distutils` + """ + + def get_data_files(self): + using_custom_command_guard() + return super().get_data_files() + + setup_attrs = {**SETUP_ATTRS, 'include_package_data': True} + assert setup_attrs['package_data'] + + dist = Distribution(setup_attrs) + dist.script_name = 'setup.py' + cmd = sdist(dist) + cmd.ensure_finalized() + + # Make sure we use the custom command + cmd.cmdclass = {'build_py': CustomBuildPy} + cmd.distribution.cmdclass = {'build_py': CustomBuildPy} + assert cmd.distribution.get_command_class('build_py') == CustomBuildPy + + msg = "setuptools instead of distutils" + with quiet(), pytest.warns(SetuptoolsDeprecationWarning, match=msg): + cmd.run() + + using_custom_command_guard.assert_called() + self.assert_package_data_in_manifest(cmd) + + def test_setup_py_exists(self): + dist = Distribution(SETUP_ATTRS) + dist.script_name = 'foo.py' + cmd = sdist(dist) + cmd.ensure_finalized() + + with quiet(): + cmd.run() + + manifest = cmd.filelist.files + assert 'setup.py' in manifest + + def test_setup_py_missing(self): + dist = Distribution(SETUP_ATTRS) + dist.script_name = 'foo.py' + cmd = sdist(dist) + cmd.ensure_finalized() + + if os.path.exists("setup.py"): + os.remove("setup.py") + with quiet(): + cmd.run() + + manifest = cmd.filelist.files + assert 'setup.py' not in manifest + + def test_setup_py_excluded(self): + with open("MANIFEST.in", "w", encoding="utf-8") as manifest_file: + manifest_file.write("exclude setup.py") + + dist = Distribution(SETUP_ATTRS) + dist.script_name = 'foo.py' + cmd = sdist(dist) + cmd.ensure_finalized() + + with quiet(): + cmd.run() + + manifest = cmd.filelist.files + assert 'setup.py' not in manifest + + def test_defaults_case_sensitivity(self, source_dir): + """ + Make sure default files (README.*, etc.) are added in a case-sensitive + way to avoid problems with packages built on Windows. + """ + + touch(source_dir / 'readme.rst') + touch(source_dir / 'SETUP.cfg') + + dist = Distribution(SETUP_ATTRS) + # the extension deliberately capitalized for this test + # to make sure the actual filename (not capitalized) gets added + # to the manifest + dist.script_name = 'setup.PY' + cmd = sdist(dist) + cmd.ensure_finalized() + + with quiet(): + cmd.run() + + # lowercase all names so we can test in a + # case-insensitive way to make sure the files + # are not included. + manifest = map(lambda x: x.lower(), cmd.filelist.files) + assert 'readme.rst' not in manifest, manifest + assert 'setup.py' not in manifest, manifest + assert 'setup.cfg' not in manifest, manifest + + def test_exclude_dev_only_cache_folders(self, source_dir): + included = { + # Emulate problem in https://github.com/pypa/setuptools/issues/4601 + "MANIFEST.in": ( + "global-include LICEN[CS]E* COPYING* NOTICE* AUTHORS*\n" + "global-include *.txt\n" + ), + # For the sake of being conservative and limiting unforeseen side-effects + # we just exclude dev-only cache folders at the root of the repository: + "test/.venv/lib/python3.9/site-packages/bar-2.dist-info/AUTHORS.rst": "", + "src/.nox/py/lib/python3.12/site-packages/bar-2.dist-info/COPYING.txt": "", + "doc/.tox/default/lib/python3.11/site-packages/foo-4.dist-info/LICENSE": "", + # Let's test against false positives with similarly named files: + ".venv-requirements.txt": "", + ".tox-coveragerc.txt": "", + ".noxy/coveragerc.txt": "", + } + + excluded = { + # .tox/.nox/.venv are well-know folders present at the root of Python repos + # and therefore should be excluded + ".tox/release/lib/python3.11/site-packages/foo-4.dist-info/LICENSE": "", + ".nox/py/lib/python3.12/site-packages/bar-2.dist-info/COPYING.txt": "", + ".venv/lib/python3.9/site-packages/bar-2.dist-info/AUTHORS.rst": "", + } + + for file, content in {**excluded, **included}.items(): + Path(source_dir, file).parent.mkdir(parents=True, exist_ok=True) + Path(source_dir, file).write_text(content, encoding="utf-8") + + cmd = self.setup_with_extension() + self.assert_package_data_in_manifest(cmd) + manifest = {f.replace(os.sep, '/') for f in cmd.filelist.files} + for path in excluded: + assert os.path.exists(path) + assert path not in manifest, (path, manifest) + for path in included: + assert os.path.exists(path) + assert path in manifest, (path, manifest) + + @fail_on_ascii + def test_manifest_is_written_with_utf8_encoding(self): + # Test for #303. + dist = Distribution(SETUP_ATTRS) + dist.script_name = 'setup.py' + mm = manifest_maker(dist) + mm.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') + os.mkdir('sdist_test.egg-info') + + # UTF-8 filename + filename = os.path.join('sdist_test', 'smörbröd.py') + + # Must create the file or it will get stripped. + touch(filename) + + # Add UTF-8 filename and write manifest + with quiet(): + mm.run() + mm.filelist.append(filename) + mm.write_manifest() + + contents = read_all_bytes(mm.manifest) + + # The manifest should be UTF-8 encoded + u_contents = contents.decode('UTF-8') + + # The manifest should contain the UTF-8 filename + assert posix(filename) in u_contents + + @fail_on_ascii + def test_write_manifest_allows_utf8_filenames(self): + # Test for #303. + dist = Distribution(SETUP_ATTRS) + dist.script_name = 'setup.py' + mm = manifest_maker(dist) + mm.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') + os.mkdir('sdist_test.egg-info') + + filename = os.path.join(b'sdist_test', Filenames.utf_8) + + # Must touch the file or risk removal + touch(filename) + + # Add filename and write manifest + with quiet(): + mm.run() + u_filename = filename.decode('utf-8') + mm.filelist.files.append(u_filename) + # Re-write manifest + mm.write_manifest() + + contents = read_all_bytes(mm.manifest) + + # The manifest should be UTF-8 encoded + contents.decode('UTF-8') + + # The manifest should contain the UTF-8 filename + assert posix(filename) in contents + + # The filelist should have been updated as well + assert u_filename in mm.filelist.files + + @skip_under_xdist + def test_write_manifest_skips_non_utf8_filenames(self): + """ + Files that cannot be encoded to UTF-8 (specifically, those that + weren't originally successfully decoded and have surrogate + escapes) should be omitted from the manifest. + See https://bitbucket.org/tarek/distribute/issue/303 for history. + """ + dist = Distribution(SETUP_ATTRS) + dist.script_name = 'setup.py' + mm = manifest_maker(dist) + mm.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') + os.mkdir('sdist_test.egg-info') + + # Latin-1 filename + filename = os.path.join(b'sdist_test', Filenames.latin_1) + + # Add filename with surrogates and write manifest + with quiet(): + mm.run() + u_filename = filename.decode('utf-8', 'surrogateescape') + mm.filelist.append(u_filename) + # Re-write manifest + mm.write_manifest() + + contents = read_all_bytes(mm.manifest) + + # The manifest should be UTF-8 encoded + contents.decode('UTF-8') + + # The Latin-1 filename should have been skipped + assert posix(filename) not in contents + + # The filelist should have been updated as well + assert u_filename not in mm.filelist.files + + @fail_on_ascii + def test_manifest_is_read_with_utf8_encoding(self): + # Test for #303. + dist = Distribution(SETUP_ATTRS) + dist.script_name = 'setup.py' + cmd = sdist(dist) + cmd.ensure_finalized() + + # Create manifest + with quiet(): + cmd.run() + + # Add UTF-8 filename to manifest + filename = os.path.join(b'sdist_test', Filenames.utf_8) + cmd.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') + manifest = open(cmd.manifest, 'ab') + manifest.write(b'\n' + filename) + manifest.close() + + # The file must exist to be included in the filelist + touch(filename) + + # Re-read manifest + cmd.filelist.files = [] + with quiet(): + cmd.read_manifest() + + # The filelist should contain the UTF-8 filename + filename = filename.decode('utf-8') + assert filename in cmd.filelist.files + + @fail_on_latin1_encoded_filenames + def test_read_manifest_skips_non_utf8_filenames(self): + # Test for #303. + dist = Distribution(SETUP_ATTRS) + dist.script_name = 'setup.py' + cmd = sdist(dist) + cmd.ensure_finalized() + + # Create manifest + with quiet(): + cmd.run() + + # Add Latin-1 filename to manifest + filename = os.path.join(b'sdist_test', Filenames.latin_1) + cmd.manifest = os.path.join('sdist_test.egg-info', 'SOURCES.txt') + manifest = open(cmd.manifest, 'ab') + manifest.write(b'\n' + filename) + manifest.close() + + # The file must exist to be included in the filelist + touch(filename) + + # Re-read manifest + cmd.filelist.files = [] + with quiet(): + cmd.read_manifest() + + # The Latin-1 filename should have been skipped + filename = filename.decode('latin-1') + assert filename not in cmd.filelist.files + + @fail_on_ascii + @fail_on_latin1_encoded_filenames + def test_sdist_with_utf8_encoded_filename(self): + # Test for #303. + dist = Distribution(self.make_strings(SETUP_ATTRS)) + dist.script_name = 'setup.py' + cmd = sdist(dist) + cmd.ensure_finalized() + + filename = os.path.join(b'sdist_test', Filenames.utf_8) + touch(filename) + + with quiet(): + cmd.run() + + if sys.platform == 'darwin': + filename = decompose(filename) + + fs_enc = sys.getfilesystemencoding() + + if sys.platform == 'win32': + if fs_enc == 'cp1252': + # Python mangles the UTF-8 filename + filename = filename.decode('cp1252') + assert filename in cmd.filelist.files + else: + filename = filename.decode('mbcs') + assert filename in cmd.filelist.files + else: + filename = filename.decode('utf-8') + assert filename in cmd.filelist.files + + @classmethod + def make_strings(cls, item): + if isinstance(item, dict): + return {key: cls.make_strings(value) for key, value in item.items()} + if isinstance(item, list): + return list(map(cls.make_strings, item)) + return str(item) + + @fail_on_latin1_encoded_filenames + @skip_under_xdist + def test_sdist_with_latin1_encoded_filename(self): + # Test for #303. + dist = Distribution(self.make_strings(SETUP_ATTRS)) + dist.script_name = 'setup.py' + cmd = sdist(dist) + cmd.ensure_finalized() + + # Latin-1 filename + filename = os.path.join(b'sdist_test', Filenames.latin_1) + touch(filename) + assert os.path.isfile(filename) + + with quiet(): + cmd.run() + + # not all windows systems have a default FS encoding of cp1252 + if sys.platform == 'win32': + # Latin-1 is similar to Windows-1252 however + # on mbcs filesys it is not in latin-1 encoding + fs_enc = sys.getfilesystemencoding() + if fs_enc != 'mbcs': + fs_enc = 'latin-1' + filename = filename.decode(fs_enc) + + assert filename in cmd.filelist.files + else: + # The Latin-1 filename should have been skipped + filename = filename.decode('latin-1') + assert filename not in cmd.filelist.files + + _EXAMPLE_DIRECTIVES = { + "setup.cfg - long_description and version": """ + [metadata] + name = testing + version = file: src/VERSION.txt + license_files = DOWHATYOUWANT + long_description = file: README.rst, USAGE.rst + """, + "pyproject.toml - static readme/license files and dynamic version": """ + [project] + name = "testing" + readme = "USAGE.rst" + license-files = ["DOWHATYOUWANT"] + dynamic = ["version"] + [tool.setuptools.dynamic] + version = {file = ["src/VERSION.txt"]} + """, + "pyproject.toml - directive with str instead of list": """ + [project] + name = "testing" + readme = "USAGE.rst" + license-files = ["DOWHATYOUWANT"] + dynamic = ["version"] + [tool.setuptools.dynamic] + version = {file = "src/VERSION.txt"} + """, + "pyproject.toml - deprecated license table with file entry": """ + [project] + name = "testing" + readme = "USAGE.rst" + license = {file = "DOWHATYOUWANT"} + dynamic = ["version"] + [tool.setuptools.dynamic] + version = {file = "src/VERSION.txt"} + """, + } + + @pytest.mark.parametrize("config", _EXAMPLE_DIRECTIVES.keys()) + @pytest.mark.filterwarnings( + "ignore:.project.license. as a TOML table is deprecated" + ) + def test_add_files_referenced_by_config_directives(self, source_dir, config): + config_file, _, _ = config.partition(" - ") + config_text = self._EXAMPLE_DIRECTIVES[config] + (source_dir / 'src').mkdir() + (source_dir / 'src/VERSION.txt').write_text("0.42", encoding="utf-8") + (source_dir / 'README.rst').write_text("hello world!", encoding="utf-8") + (source_dir / 'USAGE.rst').write_text("hello world!", encoding="utf-8") + (source_dir / 'DOWHATYOUWANT').write_text("hello world!", encoding="utf-8") + (source_dir / config_file).write_text(config_text, encoding="utf-8") + + dist = Distribution({"packages": []}) + dist.script_name = 'setup.py' + dist.parse_config_files() + + cmd = sdist(dist) + cmd.ensure_finalized() + with quiet(): + cmd.run() + + assert ( + 'src/VERSION.txt' in cmd.filelist.files + or 'src\\VERSION.txt' in cmd.filelist.files + ) + assert 'USAGE.rst' in cmd.filelist.files + assert 'DOWHATYOUWANT' in cmd.filelist.files + assert '/' not in cmd.filelist.files + assert '\\' not in cmd.filelist.files + + def test_pyproject_toml_in_sdist(self, source_dir): + """ + Check if pyproject.toml is included in source distribution if present + """ + touch(source_dir / 'pyproject.toml') + dist = Distribution(SETUP_ATTRS) + dist.script_name = 'setup.py' + cmd = sdist(dist) + cmd.ensure_finalized() + with quiet(): + cmd.run() + manifest = cmd.filelist.files + assert 'pyproject.toml' in manifest + + def test_pyproject_toml_excluded(self, source_dir): + """ + Check that pyproject.toml can excluded even if present + """ + touch(source_dir / 'pyproject.toml') + with open('MANIFEST.in', 'w', encoding="utf-8") as mts: + print('exclude pyproject.toml', file=mts) + dist = Distribution(SETUP_ATTRS) + dist.script_name = 'setup.py' + cmd = sdist(dist) + cmd.ensure_finalized() + with quiet(): + cmd.run() + manifest = cmd.filelist.files + assert 'pyproject.toml' not in manifest + + def test_build_subcommand_source_files(self, source_dir): + touch(source_dir / '.myfile~') + + # Sanity check: without custom commands file list should not be affected + dist = Distribution({**SETUP_ATTRS, "script_name": "setup.py"}) + cmd = sdist(dist) + cmd.ensure_finalized() + with quiet(): + cmd.run() + manifest = cmd.filelist.files + assert '.myfile~' not in manifest + + # Test: custom command should be able to augment file list + dist = Distribution({**SETUP_ATTRS, "script_name": "setup.py"}) + build = dist.get_command_obj("build") + build.sub_commands = [*build.sub_commands, ("build_custom", None)] + + class build_custom(Command): + def initialize_options(self): ... + + def finalize_options(self): ... + + def run(self): ... + + def get_source_files(self): + return ['.myfile~'] + + dist.cmdclass.update(build_custom=build_custom) + + cmd = sdist(dist) + cmd.use_defaults = True + cmd.ensure_finalized() + with quiet(): + cmd.run() + manifest = cmd.filelist.files + assert '.myfile~' in manifest + + @pytest.mark.skipif("os.environ.get('SETUPTOOLS_USE_DISTUTILS') == 'stdlib'") + def test_build_base_pathlib(self, source_dir): + """ + Ensure if build_base is a pathlib.Path, the build still succeeds. + """ + dist = Distribution({ + **SETUP_ATTRS, + "script_name": "setup.py", + "options": {"build": {"build_base": pathlib.Path('build')}}, + }) + cmd = sdist(dist) + cmd.ensure_finalized() + with quiet(): + cmd.run() + + +def test_default_revctrl(): + """ + When _default_revctrl was removed from the `setuptools.command.sdist` + module in 10.0, it broke some systems which keep an old install of + setuptools (Distribute) around. Those old versions require that the + setuptools package continue to implement that interface, so this + function provides that interface, stubbed. See #320 for details. + + This interface must be maintained until Ubuntu 12.04 is no longer + supported (by Setuptools). + """ + (ep,) = metadata.EntryPoints._from_text( + """ + [setuptools.file_finders] + svn_cvs = setuptools.command.sdist:_default_revctrl + """ + ) + res = ep.load() + assert hasattr(res, '__iter__') + + +class TestRegressions: + """ + Can be removed/changed if the project decides to change how it handles symlinks + or external files. + """ + + @staticmethod + def files_for_symlink_in_extension_depends(tmp_path, dep_path): + return { + "external": { + "dir": {"file.h": ""}, + }, + "project": { + "setup.py": cleandoc( + f""" + from setuptools import Extension, setup + setup( + name="myproj", + version="42", + ext_modules=[ + Extension( + "hello", sources=["hello.pyx"], + depends=[{dep_path!r}] + ) + ], + ) + """ + ), + "hello.pyx": "", + "MANIFEST.in": "global-include *.h", + }, + } + + @pytest.mark.parametrize( + "dep_path", ("myheaders/dir/file.h", "myheaders/dir/../dir/file.h") + ) + def test_symlink_in_extension_depends(self, monkeypatch, tmp_path, dep_path): + # Given a project with a symlinked dir and a "depends" targeting that dir + files = self.files_for_symlink_in_extension_depends(tmp_path, dep_path) + jaraco.path.build(files, prefix=str(tmp_path)) + symlink_or_skip_test(tmp_path / "external", tmp_path / "project/myheaders") + + # When `sdist` runs, there should be no error + members = run_sdist(monkeypatch, tmp_path / "project") + # and the sdist should contain the symlinked files + for expected in ( + "myproj-42/hello.pyx", + "myproj-42/myheaders/dir/file.h", + ): + assert expected in members + + @staticmethod + def files_for_external_path_in_extension_depends(tmp_path, dep_path): + head, _, tail = dep_path.partition("$tmp_path$/") + dep_path = tmp_path / tail if tail else head + + return { + "external": { + "dir": {"file.h": ""}, + }, + "project": { + "setup.py": cleandoc( + f""" + from setuptools import Extension, setup + setup( + name="myproj", + version="42", + ext_modules=[ + Extension( + "hello", sources=["hello.pyx"], + depends=[{str(dep_path)!r}] + ) + ], + ) + """ + ), + "hello.pyx": "", + "MANIFEST.in": "global-include *.h", + }, + } + + @pytest.mark.parametrize( + "dep_path", ("$tmp_path$/external/dir/file.h", "../external/dir/file.h") + ) + def test_external_path_in_extension_depends(self, monkeypatch, tmp_path, dep_path): + # Given a project with a "depends" targeting an external dir + files = self.files_for_external_path_in_extension_depends(tmp_path, dep_path) + jaraco.path.build(files, prefix=str(tmp_path)) + # When `sdist` runs, there should be no error + members = run_sdist(monkeypatch, tmp_path / "project") + # and the sdist should not contain the external file + for name in members: + assert "file.h" not in name + + +def run_sdist(monkeypatch, project): + """Given a project directory, run the sdist and return its contents""" + monkeypatch.chdir(project) + with quiet(): + run_setup("setup.py", ["sdist"]) + + archive = next((project / "dist").glob("*.tar.gz")) + with tarfile.open(str(archive)) as tar: + return set(tar.getnames()) + + +def test_sanity_check_setuptools_own_sdist(setuptools_sdist): + with tarfile.open(setuptools_sdist) as tar: + files = tar.getnames() + + # setuptools sdist should not include the .tox folder + tox_files = [name for name in files if ".tox" in name] + assert len(tox_files) == 0, f"not empty {tox_files}" diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_setopt.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_setopt.py new file mode 100644 index 000000000..ccf25618a --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_setopt.py @@ -0,0 +1,40 @@ +import configparser + +from setuptools.command import setopt + + +class TestEdit: + @staticmethod + def parse_config(filename): + parser = configparser.ConfigParser() + with open(filename, encoding='utf-8') as reader: + parser.read_file(reader) + return parser + + @staticmethod + def write_text(file, content): + with open(file, 'wb') as strm: + strm.write(content.encode('utf-8')) + + def test_utf8_encoding_retained(self, tmpdir): + """ + When editing a file, non-ASCII characters encoded in + UTF-8 should be retained. + """ + config = tmpdir.join('setup.cfg') + self.write_text(str(config), '[names]\njaraco=джарако') + setopt.edit_config(str(config), dict(names=dict(other='yes'))) + parser = self.parse_config(str(config)) + assert parser.get('names', 'jaraco') == 'джарако' + assert parser.get('names', 'other') == 'yes' + + def test_case_retained(self, tmpdir): + """ + When editing a file, case of keys should be retained. + """ + config = tmpdir.join('setup.cfg') + self.write_text(str(config), '[names]\nFoO=bAr') + setopt.edit_config(str(config), dict(names=dict(oTher='yes'))) + actual = config.read_text(encoding='ascii') + assert 'FoO' in actual + assert 'oTher' in actual diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_setuptools.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_setuptools.py new file mode 100644 index 000000000..1d56e1a8a --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_setuptools.py @@ -0,0 +1,290 @@ +"""Tests for the 'setuptools' package""" + +import os +import re +import sys +from zipfile import ZipFile + +import pytest +from packaging.version import Version + +import setuptools +import setuptools.depends as dep +import setuptools.dist +from setuptools.depends import Require + +import distutils.cmd +import distutils.core +from distutils.core import Extension +from distutils.errors import DistutilsSetupError + + +@pytest.fixture(autouse=True) +def isolated_dir(tmpdir_cwd): + return + + +def makeSetup(**args): + """Return distribution from 'setup(**args)', without executing commands""" + + distutils.core._setup_stop_after = "commandline" + + # Don't let system command line leak into tests! + args.setdefault('script_args', ['install']) + + try: + return setuptools.setup(**args) + finally: + distutils.core._setup_stop_after = None + + +needs_bytecode = pytest.mark.skipif( + not hasattr(dep, 'get_module_constant'), + reason="bytecode support not available", +) + + +class TestDepends: + def testExtractConst(self): + if not hasattr(dep, 'extract_constant'): + # skip on non-bytecode platforms + return + + def f1(): + global x, y, z + x = "test" + y = z # pyright: ignore[reportUnboundVariable] # Explicitly testing for this runtime issue + + fc = f1.__code__ + + # unrecognized name + assert dep.extract_constant(fc, 'q', -1) is None + + # constant assigned + assert dep.extract_constant(fc, 'x', -1) == "test" + + # expression assigned + assert dep.extract_constant(fc, 'y', -1) == -1 + + # recognized name, not assigned + assert dep.extract_constant(fc, 'z', -1) is None + + def testFindModule(self): + with pytest.raises(ImportError): + dep.find_module('no-such.-thing') + with pytest.raises(ImportError): + dep.find_module('setuptools.non-existent') + f, _p, _i = dep.find_module('setuptools.tests') + f.close() + + @needs_bytecode + def testModuleExtract(self): + from json import __version__ + + assert dep.get_module_constant('json', '__version__') == __version__ + assert dep.get_module_constant('sys', 'version') == sys.version + assert ( + dep.get_module_constant('setuptools.tests.test_setuptools', '__doc__') + == __doc__ + ) + + @needs_bytecode + def testRequire(self): + req = Require('Json', '1.0.3', 'json') + + assert req.name == 'Json' + assert req.module == 'json' + assert req.requested_version == Version('1.0.3') + assert req.attribute == '__version__' + assert req.full_name() == 'Json-1.0.3' + + from json import __version__ + + assert str(req.get_version()) == __version__ + assert req.version_ok('1.0.9') + assert not req.version_ok('0.9.1') + assert not req.version_ok('unknown') + + assert req.is_present() + assert req.is_current() + + req = Require('Do-what-I-mean', '1.0', 'd-w-i-m') + assert not req.is_present() + assert not req.is_current() + + @needs_bytecode + def test_require_present(self): + # In #1896, this test was failing for months with the only + # complaint coming from test runners (not end users). + # TODO: Evaluate if this code is needed at all. + req = Require('Tests', None, 'tests', homepage="http://example.com") + assert req.format is None + assert req.attribute is None + assert req.requested_version is None + assert req.full_name() == 'Tests' + assert req.homepage == 'http://example.com' + + from setuptools.tests import __path__ + + paths = [os.path.dirname(p) for p in __path__] + assert req.is_present(paths) + assert req.is_current(paths) + + +class TestDistro: + def setup_method(self, method): + self.e1 = Extension('bar.ext', ['bar.c']) + self.e2 = Extension('c.y', ['y.c']) + + self.dist = makeSetup( + packages=['a', 'a.b', 'a.b.c', 'b', 'c'], + py_modules=['b.d', 'x'], + ext_modules=(self.e1, self.e2), + package_dir={}, + ) + + def testDistroType(self): + assert isinstance(self.dist, setuptools.dist.Distribution) + + def testExcludePackage(self): + self.dist.exclude_package('a') + assert self.dist.packages == ['b', 'c'] + + self.dist.exclude_package('b') + assert self.dist.packages == ['c'] + assert self.dist.py_modules == ['x'] + assert self.dist.ext_modules == [self.e1, self.e2] + + self.dist.exclude_package('c') + assert self.dist.packages == [] + assert self.dist.py_modules == ['x'] + assert self.dist.ext_modules == [self.e1] + + # test removals from unspecified options + makeSetup().exclude_package('x') + + def testIncludeExclude(self): + # remove an extension + self.dist.exclude(ext_modules=[self.e1]) + assert self.dist.ext_modules == [self.e2] + + # add it back in + self.dist.include(ext_modules=[self.e1]) + assert self.dist.ext_modules == [self.e2, self.e1] + + # should not add duplicate + self.dist.include(ext_modules=[self.e1]) + assert self.dist.ext_modules == [self.e2, self.e1] + + def testExcludePackages(self): + self.dist.exclude(packages=['c', 'b', 'a']) + assert self.dist.packages == [] + assert self.dist.py_modules == ['x'] + assert self.dist.ext_modules == [self.e1] + + def testEmpty(self): + dist = makeSetup() + dist.include(packages=['a'], py_modules=['b'], ext_modules=[self.e2]) + dist = makeSetup() + dist.exclude(packages=['a'], py_modules=['b'], ext_modules=[self.e2]) + + def testContents(self): + assert self.dist.has_contents_for('a') + self.dist.exclude_package('a') + assert not self.dist.has_contents_for('a') + + assert self.dist.has_contents_for('b') + self.dist.exclude_package('b') + assert not self.dist.has_contents_for('b') + + assert self.dist.has_contents_for('c') + self.dist.exclude_package('c') + assert not self.dist.has_contents_for('c') + + def testInvalidIncludeExclude(self): + with pytest.raises(DistutilsSetupError): + self.dist.include(nonexistent_option='x') + with pytest.raises(DistutilsSetupError): + self.dist.exclude(nonexistent_option='x') + with pytest.raises(DistutilsSetupError): + self.dist.include(packages={'x': 'y'}) + with pytest.raises(DistutilsSetupError): + self.dist.exclude(packages={'x': 'y'}) + with pytest.raises(DistutilsSetupError): + self.dist.include(ext_modules={'x': 'y'}) + with pytest.raises(DistutilsSetupError): + self.dist.exclude(ext_modules={'x': 'y'}) + + with pytest.raises(DistutilsSetupError): + self.dist.include(package_dir=['q']) + with pytest.raises(DistutilsSetupError): + self.dist.exclude(package_dir=['q']) + + +@pytest.fixture +def example_source(tmpdir): + tmpdir.mkdir('foo') + (tmpdir / 'foo/bar.py').write('') + (tmpdir / 'readme.txt').write('') + return tmpdir + + +def test_findall(example_source): + found = list(setuptools.findall(str(example_source))) + expected = ['readme.txt', 'foo/bar.py'] + expected = [example_source.join(fn) for fn in expected] + assert found == expected + + +def test_findall_curdir(example_source): + with example_source.as_cwd(): + found = list(setuptools.findall()) + expected = ['readme.txt', os.path.join('foo', 'bar.py')] + assert found == expected + + +@pytest.fixture +def can_symlink(tmpdir): + """ + Skip if cannot create a symbolic link + """ + link_fn = 'link' + target_fn = 'target' + try: + os.symlink(target_fn, link_fn) + except (OSError, NotImplementedError, AttributeError): + pytest.skip("Cannot create symbolic links") + os.remove(link_fn) + + +@pytest.mark.usefixtures("can_symlink") +def test_findall_missing_symlink(tmpdir): + with tmpdir.as_cwd(): + os.symlink('foo', 'bar') + found = list(setuptools.findall()) + assert found == [] + + +@pytest.mark.xfail(reason="unable to exclude tests; #4475 #3260") +def test_its_own_wheel_does_not_contain_tests(setuptools_wheel): + with ZipFile(setuptools_wheel) as zipfile: + contents = [f.replace(os.sep, '/') for f in zipfile.namelist()] + + for member in contents: + assert '/tests/' not in member + + +def test_wheel_includes_cli_scripts(setuptools_wheel): + with ZipFile(setuptools_wheel) as zipfile: + contents = [f.replace(os.sep, '/') for f in zipfile.namelist()] + + assert any('cli-64.exe' in member for member in contents) + + +def test_wheel_includes_vendored_metadata(setuptools_wheel): + with ZipFile(setuptools_wheel) as zipfile: + contents = [f.replace(os.sep, '/') for f in zipfile.namelist()] + + assert any( + re.search(r'_vendor/.*\.dist-info/METADATA', member) for member in contents + ) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_shutil_wrapper.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_shutil_wrapper.py new file mode 100644 index 000000000..74ff7e9a8 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_shutil_wrapper.py @@ -0,0 +1,23 @@ +import stat +import sys +from unittest.mock import Mock + +from setuptools import _shutil + + +def test_rmtree_readonly(monkeypatch, tmp_path): + """Verify onerr works as expected""" + + tmp_dir = tmp_path / "with_readonly" + tmp_dir.mkdir() + some_file = tmp_dir.joinpath("file.txt") + some_file.touch() + some_file.chmod(stat.S_IREAD) + + expected_count = 1 if sys.platform.startswith("win") else 0 + chmod_fn = Mock(wraps=_shutil.attempt_chmod_verbose) + monkeypatch.setattr(_shutil, "attempt_chmod_verbose", chmod_fn) + + _shutil.rmtree(tmp_dir) + assert chmod_fn.call_count == expected_count + assert not tmp_dir.is_dir() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_unicode_utils.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_unicode_utils.py new file mode 100644 index 000000000..a24a9bd53 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_unicode_utils.py @@ -0,0 +1,10 @@ +from setuptools import unicode_utils + + +def test_filesys_decode_fs_encoding_is_None(monkeypatch): + """ + Test filesys_decode does not raise TypeError when + getfilesystemencoding returns None. + """ + monkeypatch.setattr('sys.getfilesystemencoding', lambda: None) + unicode_utils.filesys_decode(b'test') diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_virtualenv.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_virtualenv.py new file mode 100644 index 000000000..b02949baf --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_virtualenv.py @@ -0,0 +1,113 @@ +import os +import subprocess +import sys +from urllib.error import URLError +from urllib.request import urlopen + +import pytest + + +@pytest.fixture(autouse=True) +def pytest_virtualenv_works(venv): + """ + pytest_virtualenv may not work. if it doesn't, skip these + tests. See #1284. + """ + venv_prefix = venv.run(["python", "-c", "import sys; print(sys.prefix)"]).strip() + if venv_prefix == sys.prefix: + pytest.skip("virtualenv is broken (see pypa/setuptools#1284)") + + +def test_clean_env_install(venv_without_setuptools, setuptools_wheel): + """ + Check setuptools can be installed in a clean environment. + """ + cmd = ["python", "-m", "pip", "install", str(setuptools_wheel)] + venv_without_setuptools.run(cmd) + + +def access_pypi(): + # Detect if tests are being run without connectivity + if not os.environ.get('NETWORK_REQUIRED', False): # pragma: nocover + try: + urlopen('https://pypi.org', timeout=1) + except URLError: + # No network, disable most of these tests + return False + + return True + + +@pytest.mark.skipif( + 'platform.python_implementation() == "PyPy"', + reason="https://github.com/pypa/setuptools/pull/2865#issuecomment-965834995", +) +@pytest.mark.skipif(not access_pypi(), reason="no network") +# ^-- Even when it is not necessary to install a different version of `pip` +# the build process will still try to download `wheel`, see #3147 and #2986. +@pytest.mark.parametrize( + 'pip_version', + [ + None, + pytest.param( + 'pip<20.1', + marks=pytest.mark.xfail( + 'sys.version_info >= (3, 12)', + reason="pip 23.1.2 required for Python 3.12 and later", + ), + ), + pytest.param( + 'pip<21', + marks=pytest.mark.xfail( + 'sys.version_info >= (3, 12)', + reason="pip 23.1.2 required for Python 3.12 and later", + ), + ), + pytest.param( + 'pip<22', + marks=pytest.mark.xfail( + 'sys.version_info >= (3, 12)', + reason="pip 23.1.2 required for Python 3.12 and later", + ), + ), + pytest.param( + 'pip<23', + marks=pytest.mark.xfail( + 'sys.version_info >= (3, 12)', + reason="pip 23.1.2 required for Python 3.12 and later", + ), + ), + pytest.param( + 'https://github.com/pypa/pip/archive/main.zip', + marks=pytest.mark.xfail(reason='#2975'), + ), + ], +) +def test_pip_upgrade_from_source( + pip_version, venv_without_setuptools, setuptools_wheel, setuptools_sdist +): + """ + Check pip can upgrade setuptools from source. + """ + # Install pip/wheel, in a venv without setuptools (as it + # should not be needed for bootstrapping from source) + venv = venv_without_setuptools + venv.run(["pip", "install", "-U", "wheel"]) + if pip_version is not None: + venv.run(["python", "-m", "pip", "install", "-U", pip_version, "--retries=1"]) + with pytest.raises(subprocess.CalledProcessError): + # Meta-test to make sure setuptools is not installed + venv.run(["python", "-c", "import setuptools"]) + + # Then install from wheel. + venv.run(["pip", "install", str(setuptools_wheel)]) + # And finally try to upgrade from source. + venv.run(["pip", "install", "--no-cache-dir", "--upgrade", str(setuptools_sdist)]) + + +def test_no_missing_dependencies(bare_venv, request): + """ + Quick and dirty test to ensure all external dependencies are vendored. + """ + setuptools_dir = request.config.rootdir + bare_venv.run(['python', 'setup.py', '--help'], cwd=setuptools_dir) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_warnings.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_warnings.py new file mode 100644 index 000000000..41193d4f7 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_warnings.py @@ -0,0 +1,106 @@ +from inspect import cleandoc + +import pytest + +from setuptools.warnings import SetuptoolsDeprecationWarning, SetuptoolsWarning + +_EXAMPLES = { + "default": dict( + args=("Hello {x}", "\n\t{target} {v:.1f}"), + kwargs={"x": 5, "v": 3, "target": "World"}, + expected=""" + Hello 5 + !! + + ******************************************************************************** + World 3.0 + ******************************************************************************** + + !! + """, + ), + "futue_due_date": dict( + args=("Summary", "Lorem ipsum"), + kwargs={"due_date": (9999, 11, 22)}, + expected=""" + Summary + !! + + ******************************************************************************** + Lorem ipsum + + By 9999-Nov-22, you need to update your project and remove deprecated calls + or your builds will no longer be supported. + ******************************************************************************** + + !! + """, + ), + "past_due_date_with_docs": dict( + args=("Summary", "Lorem ipsum"), + kwargs={"due_date": (2000, 11, 22), "see_docs": "some_page.html"}, + expected=""" + Summary + !! + + ******************************************************************************** + Lorem ipsum + + This deprecation is overdue, please update your project and remove deprecated + calls to avoid build errors in the future. + + See https://setuptools.pypa.io/en/latest/some_page.html for details. + ******************************************************************************** + + !! + """, + ), +} + + +@pytest.mark.parametrize("example_name", _EXAMPLES.keys()) +def test_formatting(monkeypatch, example_name): + """ + It should automatically handle indentation, interpolation and things like due date. + """ + args = _EXAMPLES[example_name]["args"] + kwargs = _EXAMPLES[example_name]["kwargs"] + expected = _EXAMPLES[example_name]["expected"] + + monkeypatch.setenv("SETUPTOOLS_ENFORCE_DEPRECATION", "false") + with pytest.warns(SetuptoolsWarning) as warn_info: + SetuptoolsWarning.emit(*args, **kwargs) + assert _get_message(warn_info) == cleandoc(expected) + + +def test_due_date_enforcement(monkeypatch): + class _MyDeprecation(SetuptoolsDeprecationWarning): + _SUMMARY = "Summary" + _DETAILS = "Lorem ipsum" + _DUE_DATE = (2000, 11, 22) + _SEE_DOCS = "some_page.html" + + monkeypatch.setenv("SETUPTOOLS_ENFORCE_DEPRECATION", "true") + with pytest.raises(SetuptoolsDeprecationWarning) as exc_info: + _MyDeprecation.emit() + + expected = """ + Summary + !! + + ******************************************************************************** + Lorem ipsum + + This deprecation is overdue, please update your project and remove deprecated + calls to avoid build errors in the future. + + See https://setuptools.pypa.io/en/latest/some_page.html for details. + ******************************************************************************** + + !! + """ + assert str(exc_info.value) == cleandoc(expected) + + +def _get_message(warn_info): + return next(warn.message.args[0] for warn in warn_info) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_wheel.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_wheel.py new file mode 100644 index 000000000..f91465084 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_wheel.py @@ -0,0 +1,690 @@ +"""wheel tests""" + +from __future__ import annotations + +import contextlib +import glob +import inspect +import os +import pathlib +import stat +import subprocess +import sys +import sysconfig +import zipfile +from typing import Any + +import pytest +from jaraco import path +from packaging.tags import parse_tag + +from setuptools._importlib import metadata +from setuptools.wheel import Wheel + +from .contexts import tempdir +from .textwrap import DALS + +from distutils.sysconfig import get_config_var +from distutils.util import get_platform + +WHEEL_INFO_TESTS = ( + ('invalid.whl', ValueError), + ( + 'simplewheel-2.0-1-py2.py3-none-any.whl', + { + 'project_name': 'simplewheel', + 'version': '2.0', + 'build': '1', + 'py_version': 'py2.py3', + 'abi': 'none', + 'platform': 'any', + }, + ), + ( + 'simple.dist-0.1-py2.py3-none-any.whl', + { + 'project_name': 'simple.dist', + 'version': '0.1', + 'build': None, + 'py_version': 'py2.py3', + 'abi': 'none', + 'platform': 'any', + }, + ), + ( + 'example_pkg_a-1-py3-none-any.whl', + { + 'project_name': 'example_pkg_a', + 'version': '1', + 'build': None, + 'py_version': 'py3', + 'abi': 'none', + 'platform': 'any', + }, + ), + ( + 'PyQt5-5.9-5.9.1-cp35.cp36.cp37-abi3-manylinux1_x86_64.whl', + { + 'project_name': 'PyQt5', + 'version': '5.9', + 'build': '5.9.1', + 'py_version': 'cp35.cp36.cp37', + 'abi': 'abi3', + 'platform': 'manylinux1_x86_64', + }, + ), +) + + +@pytest.mark.parametrize( + ('filename', 'info'), WHEEL_INFO_TESTS, ids=[t[0] for t in WHEEL_INFO_TESTS] +) +def test_wheel_info(filename, info): + if inspect.isclass(info): + with pytest.raises(info): + Wheel(filename) + return + w = Wheel(filename) + assert {k: getattr(w, k) for k in info.keys()} == info + + +@contextlib.contextmanager +def build_wheel(extra_file_defs=None, **kwargs): + file_defs = { + 'setup.py': ( + DALS( + """ + # -*- coding: utf-8 -*- + from setuptools import setup + import setuptools + setup(**%r) + """ + ) + % kwargs + ).encode('utf-8'), + } + if extra_file_defs: + file_defs.update(extra_file_defs) + with tempdir() as source_dir: + path.build(file_defs, source_dir) + subprocess.check_call( + (sys.executable, 'setup.py', '-q', 'bdist_wheel'), cwd=source_dir + ) + yield glob.glob(os.path.join(source_dir, 'dist', '*.whl'))[0] + + +def tree_set(root): + contents = set() + for dirpath, dirnames, filenames in os.walk(root): + for filename in filenames: + contents.add(os.path.join(os.path.relpath(dirpath, root), filename)) + return contents + + +def flatten_tree(tree): + """Flatten nested dicts and lists into a full list of paths""" + output = set() + for node, contents in tree.items(): + if isinstance(contents, dict): + contents = flatten_tree(contents) + + for elem in contents: + if isinstance(elem, dict): + output |= {os.path.join(node, val) for val in flatten_tree(elem)} + else: + output.add(os.path.join(node, elem)) + return output + + +def format_install_tree(tree): + return { + x.format( + py_version=sysconfig.get_python_version(), + platform=get_platform(), + shlib_ext=get_config_var('EXT_SUFFIX') or get_config_var('SO'), + ) + for x in tree + } + + +def _check_wheel_install( + filename, install_dir, install_tree_includes, project_name, version, requires_txt +): + w = Wheel(filename) + egg_path = os.path.join(install_dir, w.egg_name()) + w.install_as_egg(egg_path) + if install_tree_includes is not None: + install_tree = format_install_tree(install_tree_includes) + exp = tree_set(install_dir) + assert install_tree.issubset(exp), install_tree - exp + + (dist,) = metadata.Distribution.discover(path=[egg_path]) + + # pyright is nitpicky; fine to assume dist.metadata.__getitem__ will fail or return None + # (https://github.com/pypa/setuptools/pull/5006#issuecomment-2894774288) + assert dist.metadata['Name'] == project_name # pyright: ignore # noqa: PGH003 + assert dist.metadata['Version'] == version # pyright: ignore # noqa: PGH003 + assert dist.read_text('requires.txt') == requires_txt + + +class Record: + def __init__(self, id, **kwargs): + self._id = id + self._fields = kwargs + + def __repr__(self) -> str: + return f'{self._id}(**{self._fields!r})' + + +# Using Any to avoid possible type union issues later in test +# making a TypedDict is not worth in a test and anonymous/inline TypedDict are experimental +# https://github.com/python/mypy/issues/9884 +WHEEL_INSTALL_TESTS: tuple[dict[str, Any], ...] = ( + dict( + id='basic', + file_defs={'foo': {'__init__.py': ''}}, + setup_kwargs=dict( + packages=['foo'], + ), + install_tree=flatten_tree({ + 'foo-1.0-py{py_version}.egg': { + 'EGG-INFO': ['PKG-INFO', 'RECORD', 'WHEEL', 'top_level.txt'], + 'foo': ['__init__.py'], + } + }), + ), + dict( + id='utf-8', + setup_kwargs=dict( + description='Description accentuée', + ), + ), + dict( + id='data', + file_defs={ + 'data.txt': DALS( + """ + Some data... + """ + ), + }, + setup_kwargs=dict( + data_files=[('data_dir', ['data.txt'])], + ), + install_tree=flatten_tree({ + 'foo-1.0-py{py_version}.egg': { + 'EGG-INFO': ['PKG-INFO', 'RECORD', 'WHEEL', 'top_level.txt'], + 'data_dir': ['data.txt'], + } + }), + ), + dict( + id='extension', + file_defs={ + 'extension.c': DALS( + """ + #include "Python.h" + + #if PY_MAJOR_VERSION >= 3 + + static struct PyModuleDef moduledef = { + PyModuleDef_HEAD_INIT, + "extension", + NULL, + 0, + NULL, + NULL, + NULL, + NULL, + NULL + }; + + #define INITERROR return NULL + + PyMODINIT_FUNC PyInit_extension(void) + + #else + + #define INITERROR return + + void initextension(void) + + #endif + { + #if PY_MAJOR_VERSION >= 3 + PyObject *module = PyModule_Create(&moduledef); + #else + PyObject *module = Py_InitModule("extension", NULL); + #endif + if (module == NULL) + INITERROR; + #if PY_MAJOR_VERSION >= 3 + return module; + #endif + } + """ + ), + }, + setup_kwargs=dict( + ext_modules=[ + Record( + 'setuptools.Extension', name='extension', sources=['extension.c'] + ) + ], + ), + install_tree=flatten_tree({ + 'foo-1.0-py{py_version}-{platform}.egg': [ + 'extension{shlib_ext}', + { + 'EGG-INFO': [ + 'PKG-INFO', + 'RECORD', + 'WHEEL', + 'top_level.txt', + ] + }, + ] + }), + ), + dict( + id='header', + file_defs={ + 'header.h': DALS( + """ + """ + ), + }, + setup_kwargs=dict( + headers=['header.h'], + ), + install_tree=flatten_tree({ + 'foo-1.0-py{py_version}.egg': [ + 'header.h', + { + 'EGG-INFO': [ + 'PKG-INFO', + 'RECORD', + 'WHEEL', + 'top_level.txt', + ] + }, + ] + }), + ), + dict( + id='script', + file_defs={ + 'script.py': DALS( + """ + #/usr/bin/python + print('hello world!') + """ + ), + 'script.sh': DALS( + """ + #/bin/sh + echo 'hello world!' + """ + ), + }, + setup_kwargs=dict( + scripts=['script.py', 'script.sh'], + ), + install_tree=flatten_tree({ + 'foo-1.0-py{py_version}.egg': { + 'EGG-INFO': [ + 'PKG-INFO', + 'RECORD', + 'WHEEL', + 'top_level.txt', + {'scripts': ['script.py', 'script.sh']}, + ] + } + }), + ), + dict( + id='requires1', + install_requires='foobar==2.0', + install_tree=flatten_tree({ + 'foo-1.0-py{py_version}.egg': { + 'EGG-INFO': [ + 'PKG-INFO', + 'RECORD', + 'WHEEL', + 'requires.txt', + 'top_level.txt', + ] + } + }), + requires_txt=DALS( + """ + foobar==2.0 + """ + ), + ), + dict( + id='requires2', + install_requires=f""" + bar + foo<=2.0; {sys.platform!r} in sys_platform + """, + requires_txt=DALS( + """ + bar + foo<=2.0 + """ + ), + ), + dict( + id='requires3', + install_requires=f""" + bar; {sys.platform!r} != sys_platform + """, + ), + dict( + id='requires4', + install_requires=""" + foo + """, + extras_require={ + 'extra': 'foobar>3', + }, + requires_txt=DALS( + """ + foo + + [extra] + foobar>3 + """ + ), + ), + dict( + id='requires5', + extras_require={ + 'extra': f'foobar; {sys.platform!r} != sys_platform', + }, + requires_txt='\n' + + DALS( + """ + [extra] + """ + ), + ), + dict( + id='requires_ensure_order', + install_requires=""" + foo + bar + baz + qux + """, + extras_require={ + 'extra': """ + foobar>3 + barbaz>4 + bazqux>5 + quxzap>6 + """, + }, + requires_txt=DALS( + """ + foo + bar + baz + qux + + [extra] + foobar>3 + barbaz>4 + bazqux>5 + quxzap>6 + """ + ), + ), + dict( + id='namespace_package', + file_defs={ + 'foo': { + 'bar': {'__init__.py': ''}, + }, + }, + setup_kwargs=dict( + namespace_packages=['foo'], + packages=['foo.bar'], + ), + install_tree=flatten_tree({ + 'foo-1.0-py{py_version}.egg': [ + 'foo-1.0-py{py_version}-nspkg.pth', + { + 'EGG-INFO': [ + 'PKG-INFO', + 'RECORD', + 'WHEEL', + 'namespace_packages.txt', + 'top_level.txt', + ] + }, + { + 'foo': [ + '__init__.py', + {'bar': ['__init__.py']}, + ] + }, + ] + }), + ), + dict( + id='empty_namespace_package', + file_defs={ + 'foobar': { + '__init__.py': ( + "__import__('pkg_resources').declare_namespace(__name__)" + ) + }, + }, + setup_kwargs=dict( + namespace_packages=['foobar'], + packages=['foobar'], + ), + install_tree=flatten_tree({ + 'foo-1.0-py{py_version}.egg': [ + 'foo-1.0-py{py_version}-nspkg.pth', + { + 'EGG-INFO': [ + 'PKG-INFO', + 'RECORD', + 'WHEEL', + 'namespace_packages.txt', + 'top_level.txt', + ] + }, + { + 'foobar': [ + '__init__.py', + ] + }, + ] + }), + ), + dict( + id='data_in_package', + file_defs={ + 'foo': { + '__init__.py': '', + 'data_dir': { + 'data.txt': DALS( + """ + Some data... + """ + ), + }, + } + }, + setup_kwargs=dict( + packages=['foo'], + data_files=[('foo/data_dir', ['foo/data_dir/data.txt'])], + ), + install_tree=flatten_tree({ + 'foo-1.0-py{py_version}.egg': { + 'EGG-INFO': [ + 'PKG-INFO', + 'RECORD', + 'WHEEL', + 'top_level.txt', + ], + 'foo': [ + '__init__.py', + { + 'data_dir': [ + 'data.txt', + ] + }, + ], + } + }), + ), +) + + +@pytest.mark.parametrize( + 'params', + WHEEL_INSTALL_TESTS, + ids=[params['id'] for params in WHEEL_INSTALL_TESTS], +) +def test_wheel_install(params): + project_name = params.get('name', 'foo') + version = params.get('version', '1.0') + install_requires = params.get('install_requires', []) + extras_require = params.get('extras_require', {}) + requires_txt = params.get('requires_txt', None) + install_tree = params.get('install_tree') + file_defs = params.get('file_defs', {}) + setup_kwargs = params.get('setup_kwargs', {}) + with ( + build_wheel( + name=project_name, + version=version, + install_requires=install_requires, + extras_require=extras_require, + extra_file_defs=file_defs, + **setup_kwargs, + ) as filename, + tempdir() as install_dir, + ): + _check_wheel_install( + filename, install_dir, install_tree, project_name, version, requires_txt + ) + + +def test_wheel_no_dist_dir(): + project_name = 'nodistinfo' + version = '1.0' + wheel_name = f'{project_name}-{version}-py2.py3-none-any.whl' + with tempdir() as source_dir: + wheel_path = os.path.join(source_dir, wheel_name) + # create an empty zip file + zipfile.ZipFile(wheel_path, 'w').close() + with tempdir() as install_dir: + with pytest.raises(ValueError): + _check_wheel_install( + wheel_path, install_dir, None, project_name, version, None + ) + + +def test_wheel_is_compatible(monkeypatch): + def sys_tags(): + return { + (t.interpreter, t.abi, t.platform) + for t in parse_tag('cp36-cp36m-manylinux1_x86_64') + } + + monkeypatch.setattr('setuptools.wheel._get_supported_tags', sys_tags) + assert Wheel('onnxruntime-0.1.2-cp36-cp36m-manylinux1_x86_64.whl').is_compatible() + + +def test_wheel_mode(): + @contextlib.contextmanager + def build_wheel(extra_file_defs=None, **kwargs): + file_defs = { + 'setup.py': ( + DALS( + """ + # -*- coding: utf-8 -*- + from setuptools import setup + import setuptools + setup(**%r) + """ + ) + % kwargs + ).encode('utf-8'), + } + if extra_file_defs: + file_defs.update(extra_file_defs) + with tempdir() as source_dir: + path.build(file_defs, source_dir) + runsh = pathlib.Path(source_dir) / "script.sh" + os.chmod(runsh, 0o777) + subprocess.check_call( + (sys.executable, 'setup.py', '-q', 'bdist_wheel'), cwd=source_dir + ) + yield glob.glob(os.path.join(source_dir, 'dist', '*.whl'))[0] + + params = dict( + id='script', + file_defs={ + 'script.py': DALS( + """ + #/usr/bin/python + print('hello world!') + """ + ), + 'script.sh': DALS( + """ + #/bin/sh + echo 'hello world!' + """ + ), + }, + setup_kwargs=dict( + scripts=['script.py', 'script.sh'], + ), + install_tree=flatten_tree({ + 'foo-1.0-py{py_version}.egg': { + 'EGG-INFO': [ + 'PKG-INFO', + 'RECORD', + 'WHEEL', + 'top_level.txt', + {'scripts': ['script.py', 'script.sh']}, + ] + } + }), + ) + + project_name = params.get('name', 'foo') + version = params.get('version', '1.0') + install_tree = params.get('install_tree') + file_defs = params.get('file_defs', {}) + setup_kwargs = params.get('setup_kwargs', {}) + + with ( + build_wheel( + name=project_name, + version=version, + install_requires=[], + extras_require={}, + extra_file_defs=file_defs, + **setup_kwargs, + ) as filename, + tempdir() as install_dir, + ): + _check_wheel_install( + filename, install_dir, install_tree, project_name, version, None + ) + w = Wheel(filename) + base = pathlib.Path(install_dir) / w.egg_name() + script_sh = base / "EGG-INFO" / "scripts" / "script.sh" + assert script_sh.exists() + if sys.platform != 'win32': + # Editable file mode has no effect on Windows + assert oct(stat.S_IMODE(script_sh.stat().st_mode)) == "0o777" diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_windows_wrappers.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_windows_wrappers.py new file mode 100644 index 000000000..4f990eb1c --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/test_windows_wrappers.py @@ -0,0 +1,258 @@ +""" +Python Script Wrapper for Windows +================================= + +setuptools includes wrappers for Python scripts that allows them to be +executed like regular windows programs. There are 2 wrappers, one +for command-line programs, cli.exe, and one for graphical programs, +gui.exe. These programs are almost identical, function pretty much +the same way, and are generated from the same source file. The +wrapper programs are used by copying them to the directory containing +the script they are to wrap and with the same name as the script they +are to wrap. +""" + +import pathlib +import platform +import subprocess +import sys +import textwrap + +import pytest + +from setuptools._importlib import resources + +pytestmark = pytest.mark.skipif(sys.platform != 'win32', reason="Windows only") + + +class WrapperTester: + @classmethod + def prep_script(cls, template): + python_exe = subprocess.list2cmdline([sys.executable]) + return template % locals() + + @classmethod + def create_script(cls, tmpdir): + """ + Create a simple script, foo-script.py + + Note that the script starts with a Unix-style '#!' line saying which + Python executable to run. The wrapper will use this line to find the + correct Python executable. + """ + + script = cls.prep_script(cls.script_tmpl) + + with (tmpdir / cls.script_name).open('w') as f: + f.write(script) + + # also copy cli.exe to the sample directory + with (tmpdir / cls.wrapper_name).open('wb') as f: + w = resources.files('setuptools').joinpath(cls.wrapper_source).read_bytes() + f.write(w) + + +def win_launcher_exe(prefix): + """A simple routine to select launcher script based on platform.""" + assert prefix in ('cli', 'gui') + if platform.machine() == "ARM64": + return f"{prefix}-arm64.exe" + else: + return f"{prefix}-32.exe" + + +class TestCLI(WrapperTester): + script_name = 'foo-script.py' + wrapper_name = 'foo.exe' + wrapper_source = win_launcher_exe('cli') + + script_tmpl = textwrap.dedent( + """ + #!%(python_exe)s + import sys + input = repr(sys.stdin.read()) + print(sys.argv[0][-14:]) + print(sys.argv[1:]) + print(input) + if __debug__: + print('non-optimized') + """ + ).lstrip() + + def test_basic(self, tmpdir): + """ + When the copy of cli.exe, foo.exe in this example, runs, it examines + the path name it was run with and computes a Python script path name + by removing the '.exe' suffix and adding the '-script.py' suffix. (For + GUI programs, the suffix '-script.pyw' is added.) This is why we + named out script the way we did. Now we can run out script by running + the wrapper: + + This example was a little pathological in that it exercised windows + (MS C runtime) quoting rules: + + - Strings containing spaces are surrounded by double quotes. + + - Double quotes in strings need to be escaped by preceding them with + back slashes. + + - One or more backslashes preceding double quotes need to be escaped + by preceding each of them with back slashes. + """ + self.create_script(tmpdir) + cmd = [ + str(tmpdir / 'foo.exe'), + 'arg1', + 'arg 2', + 'arg "2\\"', + 'arg 4\\', + 'arg5 a\\\\b', + ] + proc = subprocess.Popen( + cmd, + stdout=subprocess.PIPE, + stdin=subprocess.PIPE, + text=True, + encoding="utf-8", + ) + stdout, _stderr = proc.communicate('hello\nworld\n') + actual = stdout.replace('\r\n', '\n') + expected = textwrap.dedent( + r""" + \foo-script.py + ['arg1', 'arg 2', 'arg "2\\"', 'arg 4\\', 'arg5 a\\\\b'] + 'hello\nworld\n' + non-optimized + """ + ).lstrip() + assert actual == expected + + def test_symlink(self, tmpdir): + """ + Ensure that symlink for the foo.exe is working correctly. + """ + script_dir = tmpdir / "script_dir" + script_dir.mkdir() + self.create_script(script_dir) + symlink = pathlib.Path(tmpdir / "foo.exe") + symlink.symlink_to(script_dir / "foo.exe") + + cmd = [ + str(tmpdir / 'foo.exe'), + 'arg1', + 'arg 2', + 'arg "2\\"', + 'arg 4\\', + 'arg5 a\\\\b', + ] + proc = subprocess.Popen( + cmd, + stdout=subprocess.PIPE, + stdin=subprocess.PIPE, + text=True, + encoding="utf-8", + ) + stdout, _stderr = proc.communicate('hello\nworld\n') + actual = stdout.replace('\r\n', '\n') + expected = textwrap.dedent( + r""" + \foo-script.py + ['arg1', 'arg 2', 'arg "2\\"', 'arg 4\\', 'arg5 a\\\\b'] + 'hello\nworld\n' + non-optimized + """ + ).lstrip() + assert actual == expected + + def test_with_options(self, tmpdir): + """ + Specifying Python Command-line Options + -------------------------------------- + + You can specify a single argument on the '#!' line. This can be used + to specify Python options like -O, to run in optimized mode or -i + to start the interactive interpreter. You can combine multiple + options as usual. For example, to run in optimized mode and + enter the interpreter after running the script, you could use -Oi: + """ + self.create_script(tmpdir) + tmpl = textwrap.dedent( + """ + #!%(python_exe)s -Oi + import sys + input = repr(sys.stdin.read()) + print(sys.argv[0][-14:]) + print(sys.argv[1:]) + print(input) + if __debug__: + print('non-optimized') + sys.ps1 = '---' + """ + ).lstrip() + with (tmpdir / 'foo-script.py').open('w') as f: + f.write(self.prep_script(tmpl)) + cmd = [str(tmpdir / 'foo.exe')] + proc = subprocess.Popen( + cmd, + stdout=subprocess.PIPE, + stdin=subprocess.PIPE, + stderr=subprocess.STDOUT, + text=True, + encoding="utf-8", + ) + stdout, _stderr = proc.communicate() + actual = stdout.replace('\r\n', '\n') + expected = textwrap.dedent( + r""" + \foo-script.py + [] + '' + --- + """ + ).lstrip() + assert actual == expected + + +class TestGUI(WrapperTester): + """ + Testing the GUI Version + ----------------------- + """ + + script_name = 'bar-script.pyw' + wrapper_source = win_launcher_exe('gui') + wrapper_name = 'bar.exe' + + script_tmpl = textwrap.dedent( + """ + #!%(python_exe)s + import sys + f = open(sys.argv[1], 'wb') + bytes_written = f.write(repr(sys.argv[2]).encode('utf-8')) + f.close() + """ + ).strip() + + def test_basic(self, tmpdir): + """Test the GUI version with the simple script, bar-script.py""" + self.create_script(tmpdir) + + cmd = [ + str(tmpdir / 'bar.exe'), + str(tmpdir / 'test_output.txt'), + 'Test Argument', + ] + proc = subprocess.Popen( + cmd, + stdout=subprocess.PIPE, + stdin=subprocess.PIPE, + stderr=subprocess.STDOUT, + text=True, + encoding="utf-8", + ) + stdout, stderr = proc.communicate() + assert not stdout + assert not stderr + with (tmpdir / 'test_output.txt').open('rb') as f_out: + actual = f_out.read().decode('ascii') + assert actual == repr('Test Argument') diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/text.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/text.py new file mode 100644 index 000000000..e05cc633e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/text.py @@ -0,0 +1,4 @@ +class Filenames: + unicode = 'smörbröd.py' + latin_1 = unicode.encode('latin-1') + utf_8 = unicode.encode('utf-8') diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/textwrap.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/textwrap.py new file mode 100644 index 000000000..5e39618dc --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/tests/textwrap.py @@ -0,0 +1,6 @@ +import textwrap + + +def DALS(s): + "dedent and left-strip" + return textwrap.dedent(s).lstrip() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/unicode_utils.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/unicode_utils.py new file mode 100644 index 000000000..f502f5b08 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/unicode_utils.py @@ -0,0 +1,102 @@ +import sys +import unicodedata +from configparser import RawConfigParser + +from .compat import py39 +from .warnings import SetuptoolsDeprecationWarning + + +# HFS Plus uses decomposed UTF-8 +def decompose(path): + if isinstance(path, str): + return unicodedata.normalize('NFD', path) + try: + path = path.decode('utf-8') + path = unicodedata.normalize('NFD', path) + path = path.encode('utf-8') + except UnicodeError: + pass # Not UTF-8 + return path + + +def filesys_decode(path): + """ + Ensure that the given path is decoded, + ``None`` when no expected encoding works + """ + + if isinstance(path, str): + return path + + fs_enc = sys.getfilesystemencoding() or 'utf-8' + candidates = fs_enc, 'utf-8' + + for enc in candidates: + try: + return path.decode(enc) + except UnicodeDecodeError: + continue + + return None + + +def try_encode(string, enc): + "turn unicode encoding into a functional routine" + try: + return string.encode(enc) + except UnicodeEncodeError: + return None + + +def _read_utf8_with_fallback(file: str, fallback_encoding=py39.LOCALE_ENCODING) -> str: + """ + First try to read the file with UTF-8, if there is an error fallback to a + different encoding ("locale" by default). Returns the content of the file. + Also useful when reading files that might have been produced by an older version of + setuptools. + """ + try: + with open(file, "r", encoding="utf-8") as f: + return f.read() + except UnicodeDecodeError: # pragma: no cover + _Utf8EncodingNeeded.emit(file=file, fallback_encoding=fallback_encoding) + with open(file, "r", encoding=fallback_encoding) as f: + return f.read() + + +def _cfg_read_utf8_with_fallback( + cfg: RawConfigParser, file: str, fallback_encoding=py39.LOCALE_ENCODING +) -> None: + """Same idea as :func:`_read_utf8_with_fallback`, but for the + :meth:`RawConfigParser.read` method. + + This method may call ``cfg.clear()``. + """ + try: + cfg.read(file, encoding="utf-8") + except UnicodeDecodeError: # pragma: no cover + _Utf8EncodingNeeded.emit(file=file, fallback_encoding=fallback_encoding) + cfg.clear() + cfg.read(file, encoding=fallback_encoding) + + +class _Utf8EncodingNeeded(SetuptoolsDeprecationWarning): + _SUMMARY = """ + `encoding="utf-8"` fails with {file!r}, trying `encoding={fallback_encoding!r}`. + """ + + _DETAILS = """ + Fallback behavior for UTF-8 is considered **deprecated** and future versions of + `setuptools` 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? + # Will we be able to remove this? + # The question comes to mind mainly because of sdists that have been produced + # by old versions of setuptools and published to PyPI... diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/version.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/version.py new file mode 100644 index 000000000..ec253c414 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/version.py @@ -0,0 +1,6 @@ +from ._importlib import metadata + +try: + __version__ = metadata.version('setuptools') or '0.dev0+unknown' +except Exception: + __version__ = '0.dev0+unknown' diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/warnings.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/warnings.py new file mode 100644 index 000000000..96467787c --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/warnings.py @@ -0,0 +1,110 @@ +"""Provide basic warnings used by setuptools modules. + +Using custom classes (other than ``UserWarning``) allow users to set +``PYTHONWARNINGS`` filters to run tests and prepare for upcoming changes in +setuptools. +""" + +from __future__ import annotations + +import os +import warnings +from datetime import date +from inspect import cleandoc +from textwrap import indent +from typing import TYPE_CHECKING + +if TYPE_CHECKING: + from typing_extensions import TypeAlias + +_DueDate: TypeAlias = tuple[int, int, int] # time tuple +_INDENT = 8 * " " +_TEMPLATE = f"""{80 * '*'}\n{{details}}\n{80 * '*'}""" + + +class SetuptoolsWarning(UserWarning): + """Base class in ``setuptools`` warning hierarchy.""" + + @classmethod + def emit( + cls, + summary: str | None = None, + details: str | None = None, + due_date: _DueDate | None = None, + see_docs: str | None = None, + see_url: str | None = None, + stacklevel: int = 2, + **kwargs, + ) -> None: + """Private: reserved for ``setuptools`` internal use only""" + # Default values: + summary_ = summary or getattr(cls, "_SUMMARY", None) or "" + details_ = details or getattr(cls, "_DETAILS", None) or "" + due_date = due_date or getattr(cls, "_DUE_DATE", None) + docs_ref = see_docs or getattr(cls, "_SEE_DOCS", None) + docs_url = docs_ref and f"https://setuptools.pypa.io/en/latest/{docs_ref}" + see_url = see_url or getattr(cls, "_SEE_URL", None) + due = date(*due_date) if due_date else None + + text = cls._format(summary_, details_, due, see_url or docs_url, kwargs) + if due and due < date.today() and _should_enforce(): + raise cls(text) + warnings.warn(text, cls, stacklevel=stacklevel + 1) + + @classmethod + def _format( + cls, + summary: str, + details: str, + due_date: date | None = None, + see_url: str | None = None, + format_args: dict | None = None, + ) -> str: + """Private: reserved for ``setuptools`` internal use only""" + today = date.today() + summary = cleandoc(summary).format_map(format_args or {}) + possible_parts = [ + cleandoc(details).format_map(format_args or {}), + ( + f"\nBy {due_date:%Y-%b-%d}, you need to update your project and remove " + "deprecated calls\nor your builds will no longer be supported." + if due_date and due_date > today + else None + ), + ( + "\nThis deprecation is overdue, please update your project and remove " + "deprecated\ncalls to avoid build errors in the future." + if due_date and due_date < today + else None + ), + (f"\nSee {see_url} for details." if see_url else None), + ] + parts = [x for x in possible_parts if x] + if parts: + body = indent(_TEMPLATE.format(details="\n".join(parts)), _INDENT) + return "\n".join([summary, "!!\n", body, "\n!!"]) + return summary + + +class InformationOnly(SetuptoolsWarning): + """Currently there is no clear way of displaying messages to the users + that use the setuptools backend directly via ``pip``. + The only thing that might work is a warning, although it is not the + most appropriate tool for the job... + + See pypa/packaging-problems#558. + """ + + +class SetuptoolsDeprecationWarning(SetuptoolsWarning): + """ + Base class for warning deprecations in ``setuptools`` + + This class is not derived from ``DeprecationWarning``, and as such is + visible by default. + """ + + +def _should_enforce(): + enforce = os.getenv("SETUPTOOLS_ENFORCE_DEPRECATION", "false").lower() + return enforce in ("true", "on", "ok", "1") diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/wheel.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/wheel.py new file mode 100644 index 000000000..124e01ad2 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/wheel.py @@ -0,0 +1,261 @@ +"""Wheels support.""" + +import contextlib +import email +import functools +import itertools +import os +import posixpath +import re +import zipfile + +from packaging.requirements import Requirement +from packaging.tags import sys_tags +from packaging.utils import canonicalize_name +from packaging.version import Version as parse_version + +import setuptools +from setuptools.archive_util import _unpack_zipfile_obj +from setuptools.command.egg_info import _egg_basename, write_requirements + +from ._discovery import extras_from_deps +from ._importlib import metadata +from .unicode_utils import _read_utf8_with_fallback + +from distutils.util import get_platform + +WHEEL_NAME = re.compile( + r"""^(?P.+?)-(?P\d.*?) + ((-(?P\d.*?))?-(?P.+?)-(?P.+?)-(?P.+?) + )\.whl$""", + re.VERBOSE, +).match + +NAMESPACE_PACKAGE_INIT = "__import__('pkg_resources').declare_namespace(__name__)\n" + + +@functools.cache +def _get_supported_tags(): + # We calculate the supported tags only once, otherwise calling + # this method on thousands of wheels takes seconds instead of + # milliseconds. + return {(t.interpreter, t.abi, t.platform) for t in sys_tags()} + + +def unpack(src_dir, dst_dir) -> None: + """Move everything under `src_dir` to `dst_dir`, and delete the former.""" + for dirpath, dirnames, filenames in os.walk(src_dir): + subdir = os.path.relpath(dirpath, src_dir) + for f in filenames: + src = os.path.join(dirpath, f) + dst = os.path.join(dst_dir, subdir, f) + os.renames(src, dst) + for n, d in reversed(list(enumerate(dirnames))): + src = os.path.join(dirpath, d) + dst = os.path.join(dst_dir, subdir, d) + if not os.path.exists(dst): + # Directory does not exist in destination, + # rename it and prune it from os.walk list. + os.renames(src, dst) + del dirnames[n] + # Cleanup. + for dirpath, dirnames, filenames in os.walk(src_dir, topdown=True): + assert not filenames + os.rmdir(dirpath) + + +@contextlib.contextmanager +def disable_info_traces(): + """ + Temporarily disable info traces. + """ + from distutils import log + + saved = log.set_threshold(log.WARN) + try: + yield + finally: + log.set_threshold(saved) + + +class Wheel: + def __init__(self, filename) -> None: + match = WHEEL_NAME(os.path.basename(filename)) + if match is None: + raise ValueError(f'invalid wheel name: {filename!r}') + self.filename = filename + for k, v in match.groupdict().items(): + setattr(self, k, v) + + def tags(self): + """List tags (py_version, abi, platform) supported by this wheel.""" + return itertools.product( + self.py_version.split('.'), + self.abi.split('.'), + self.platform.split('.'), + ) + + def is_compatible(self): + """Is the wheel compatible with the current platform?""" + return next((True for t in self.tags() if t in _get_supported_tags()), False) + + def egg_name(self): + return ( + _egg_basename( + self.project_name, + self.version, + platform=(None if self.platform == 'any' else get_platform()), + ) + + ".egg" + ) + + def get_dist_info(self, zf): + # find the correct name of the .dist-info dir in the wheel file + for member in zf.namelist(): + dirname = posixpath.dirname(member) + if dirname.endswith('.dist-info') and canonicalize_name(dirname).startswith( + canonicalize_name(self.project_name) + ): + return dirname + raise ValueError("unsupported wheel format. .dist-info not found") + + def install_as_egg(self, destination_eggdir) -> None: + """Install wheel as an egg directory.""" + with zipfile.ZipFile(self.filename) as zf: + self._install_as_egg(destination_eggdir, zf) + + def _install_as_egg(self, destination_eggdir, zf): + dist_basename = f'{self.project_name}-{self.version}' + dist_info = self.get_dist_info(zf) + dist_data = f'{dist_basename}.data' + egg_info = os.path.join(destination_eggdir, 'EGG-INFO') + + self._convert_metadata(zf, destination_eggdir, dist_info, egg_info) + self._move_data_entries(destination_eggdir, dist_data) + self._fix_namespace_packages(egg_info, destination_eggdir) + + @staticmethod + def _convert_metadata(zf, destination_eggdir, dist_info, egg_info): + def get_metadata(name): + with zf.open(posixpath.join(dist_info, name)) as fp: + value = fp.read().decode('utf-8') + return email.parser.Parser().parsestr(value) + + wheel_metadata = get_metadata('WHEEL') + # Check wheel format version is supported. + wheel_version = parse_version(wheel_metadata.get('Wheel-Version')) + wheel_v1 = parse_version('1.0') <= wheel_version < parse_version('2.0dev0') + if not wheel_v1: + raise ValueError(f'unsupported wheel format version: {wheel_version}') + # Extract to target directory. + _unpack_zipfile_obj(zf, destination_eggdir) + dist_info = os.path.join(destination_eggdir, dist_info) + install_requires, extras_require = Wheel._convert_requires( + destination_eggdir, dist_info + ) + os.rename(dist_info, egg_info) + os.rename( + os.path.join(egg_info, 'METADATA'), + os.path.join(egg_info, 'PKG-INFO'), + ) + setup_dist = setuptools.Distribution( + attrs=dict( + install_requires=install_requires, + extras_require=extras_require, + ), + ) + with disable_info_traces(): + write_requirements( + setup_dist.get_command_obj('egg_info'), + None, + os.path.join(egg_info, 'requires.txt'), + ) + + @staticmethod + def _convert_requires(destination_eggdir, dist_info): + md = metadata.Distribution.at(dist_info).metadata + deps = md.get_all('Requires-Dist') or [] + reqs = list(map(Requirement, deps)) + + extras = extras_from_deps(deps) + + # Note: Evaluate and strip markers now, + # as it's difficult to convert back from the syntax: + # foobar; "linux" in sys_platform and extra == 'test' + def raw_req(req): + req = Requirement(str(req)) + req.marker = None + return str(req) + + def eval(req, **env): + return not req.marker or req.marker.evaluate(env) + + def for_extra(req): + try: + markers = req.marker._markers + except AttributeError: + markers = () + return set( + marker[2].value + for marker in markers + if isinstance(marker, tuple) and marker[0].value == 'extra' + ) + + install_requires = list( + map(raw_req, filter(eval, itertools.filterfalse(for_extra, reqs))) + ) + extras_require = { + extra: list( + map( + raw_req, + (req for req in reqs if for_extra(req) and eval(req, extra=extra)), + ) + ) + for extra in extras + } + return install_requires, extras_require + + @staticmethod + def _move_data_entries(destination_eggdir, dist_data): + """Move data entries to their correct location.""" + dist_data = os.path.join(destination_eggdir, dist_data) + dist_data_scripts = os.path.join(dist_data, 'scripts') + if os.path.exists(dist_data_scripts): + egg_info_scripts = os.path.join(destination_eggdir, 'EGG-INFO', 'scripts') + os.mkdir(egg_info_scripts) + for entry in os.listdir(dist_data_scripts): + # Remove bytecode, as it's not properly handled + # during easy_install scripts install phase. + if entry.endswith('.pyc'): + os.unlink(os.path.join(dist_data_scripts, entry)) + else: + os.rename( + os.path.join(dist_data_scripts, entry), + os.path.join(egg_info_scripts, entry), + ) + os.rmdir(dist_data_scripts) + for subdir in filter( + os.path.exists, + ( + os.path.join(dist_data, d) + for d in ('data', 'headers', 'purelib', 'platlib') + ), + ): + unpack(subdir, destination_eggdir) + if os.path.exists(dist_data): + os.rmdir(dist_data) + + @staticmethod + def _fix_namespace_packages(egg_info, destination_eggdir): + namespace_packages = os.path.join(egg_info, 'namespace_packages.txt') + if os.path.exists(namespace_packages): + namespace_packages = _read_utf8_with_fallback(namespace_packages).split() + + for mod in namespace_packages: + mod_dir = os.path.join(destination_eggdir, *mod.split('.')) + mod_init = os.path.join(mod_dir, '__init__.py') + if not os.path.exists(mod_dir): + os.mkdir(mod_dir) + if not os.path.exists(mod_init): + with open(mod_init, 'w', encoding="utf-8") as fp: + fp.write(NAMESPACE_PACKAGE_INIT) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/windows_support.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/windows_support.py new file mode 100644 index 000000000..7a2b53a29 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/windows_support.py @@ -0,0 +1,30 @@ +import platform + + +def windows_only(func): + if platform.system() != 'Windows': + return lambda *args, **kwargs: None + return func + + +@windows_only +def hide_file(path: str) -> None: + """ + Set the hidden attribute on a file or directory. + + From https://stackoverflow.com/questions/19622133/ + + `path` must be text. + """ + import ctypes + import ctypes.wintypes + + SetFileAttributes = ctypes.windll.kernel32.SetFileAttributesW + SetFileAttributes.argtypes = ctypes.wintypes.LPWSTR, ctypes.wintypes.DWORD + SetFileAttributes.restype = ctypes.wintypes.BOOL + + FILE_ATTRIBUTE_HIDDEN = 0x02 + + ret = SetFileAttributes(path, FILE_ATTRIBUTE_HIDDEN) + if not ret: + raise ctypes.WinError()

    8pQySR$67DgQ^wc&%si=M*SE)tsZhuak;K* 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/INSTALLER new file mode 100644 index 000000000..a1b589e38 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/LICENSE new file mode 100644 index 000000000..b49c3af06 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/LICENSE @@ -0,0 +1,166 @@ +GNU LESSER GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + + This version of the GNU Lesser General Public License incorporates +the terms and conditions of version 3 of the GNU General Public +License, supplemented by the additional permissions listed below. + + 0. Additional Definitions. + + As used herein, "this License" refers to version 3 of the GNU Lesser +General Public License, and the "GNU GPL" refers to version 3 of the GNU +General Public License. + + "The Library" refers to a covered work governed by this License, +other than an Application or a Combined Work as defined below. + + An "Application" is any work that makes use of an interface provided +by the Library, but which is not otherwise based on the Library. +Defining a subclass of a class defined by the Library is deemed a mode +of using an interface provided by the Library. + + A "Combined Work" is a work produced by combining or linking an +Application with the Library. The particular version of the Library +with which the Combined Work was made is also called the "Linked +Version". + + The "Minimal Corresponding Source" for a Combined Work means the +Corresponding Source for the Combined Work, excluding any source code +for portions of the Combined Work that, considered in isolation, are +based on the Application, and not on the Linked Version. + + The "Corresponding Application Code" for a Combined Work means the +object code and/or source code for the Application, including any data +and utility programs needed for reproducing the Combined Work from the +Application, but excluding the System Libraries of the Combined Work. + + 1. Exception to Section 3 of the GNU GPL. + + You may convey a covered work under sections 3 and 4 of this License +without being bound by section 3 of the GNU GPL. + + 2. Conveying Modified Versions. + + If you modify a copy of the Library, and, in your modifications, a +facility refers to a function or data to be supplied by an Application +that uses the facility (other than as an argument passed when the +facility is invoked), then you may convey a copy of the modified +version: + + a) under this License, provided that you make a good faith effort to + ensure that, in the event an Application does not supply the + function or data, the facility still operates, and performs + whatever part of its purpose remains meaningful, or + + b) under the GNU GPL, with none of the additional permissions of + this License applicable to that copy. + + 3. Object Code Incorporating Material from Library Header Files. + + The object code form of an Application may incorporate material from +a header file that is part of the Library. You may convey such object +code under terms of your choice, provided that, if the incorporated +material is not limited to numerical parameters, data structure +layouts and accessors, or small macros, inline functions and templates +(ten or fewer lines in length), you do both of the following: + + a) Give prominent notice with each copy of the object code that the + Library is used in it and that the Library and its use are + covered by this License. + + b) Accompany the object code with a copy of the GNU GPL and this license + document. + + 4. Combined Works. + + You may convey a Combined Work under terms of your choice that, +taken together, effectively do not restrict modification of the +portions of the Library contained in the Combined Work and reverse +engineering for debugging such modifications, if you also do each of +the following: + + a) Give prominent notice with each copy of the Combined Work that + the Library is used in it and that the Library and its use are + covered by this License. + + b) Accompany the Combined Work with a copy of the GNU GPL and this license + document. + + c) For a Combined Work that displays copyright notices during + execution, include the copyright notice for the Library among + these notices, as well as a reference directing the user to the + copies of the GNU GPL and this license document. + + d) Do one of the following: + + 0) Convey the Minimal Corresponding Source under the terms of this + License, and the Corresponding Application Code in a form + suitable for, and under terms that permit, the user to + recombine or relink the Application with a modified version of + the Linked Version to produce a modified Combined Work, in the + manner specified by section 6 of the GNU GPL for conveying + Corresponding Source. + + 1) Use a suitable shared library mechanism for linking with the + Library. A suitable mechanism is one that (a) uses at run time + a copy of the Library already present on the user's computer + system, and (b) will operate properly with a modified version + of the Library that is interface-compatible with the Linked + Version. + + e) Provide Installation Information, but only if you would otherwise + be required to provide such information under section 6 of the + GNU GPL, and only to the extent that such information is + necessary to install and execute a modified version of the + Combined Work produced by recombining or relinking the + Application with a modified version of the Linked Version. (If + you use option 4d0, the Installation Information must accompany + the Minimal Corresponding Source and Corresponding Application + Code. If you use option 4d1, you must provide the Installation + Information in the manner specified by section 6 of the GNU GPL + for conveying Corresponding Source.) + + 5. Combined Libraries. + + 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 that are not Applications and are not covered by this +License, and convey such a combined library under terms of your +choice, if you do both of the following: + + a) Accompany the combined library with a copy of the same work based + on the Library, uncombined with any other library facilities, + conveyed under the terms of this License. + + b) Give prominent notice with the combined library that part of it + is a work based on the Library, and explaining where to find the + accompanying uncombined form of the same work. + + 6. Revised Versions of the GNU Lesser General Public License. + + The Free Software Foundation may publish revised and/or new versions +of the GNU 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 as you received it specifies that a certain numbered version +of the GNU Lesser General Public License "or any later version" +applies to it, you have the option of following the terms and +conditions either of that published version or of any later version +published by the Free Software Foundation. If the Library as you +received it does not specify a version number of the GNU Lesser +General Public License, you may choose any version of the GNU Lesser +General Public License ever published by the Free Software Foundation. + + If the Library as you received it specifies that a proxy can decide +whether future versions of the GNU Lesser General Public License shall +apply, that proxy's public statement of acceptance of any version is +permanent authorization for you to choose that version for the +Library. + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/METADATA new file mode 100644 index 000000000..32214fb44 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/METADATA @@ -0,0 +1,420 @@ +Metadata-Version: 2.1 +Name: autocommand +Version: 2.2.2 +Summary: A library to create a command-line program from a function +Home-page: https://github.com/Lucretiel/autocommand +Author: Nathan West +License: LGPLv3 +Project-URL: Homepage, https://github.com/Lucretiel/autocommand +Project-URL: Bug Tracker, https://github.com/Lucretiel/autocommand/issues +Platform: any +Classifier: Development Status :: 6 - Mature +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3) +Classifier: Programming Language :: Python +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Topic :: Software Development +Classifier: Topic :: Software Development :: Libraries +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Requires-Python: >=3.7 +Description-Content-Type: text/markdown +License-File: LICENSE + +[![PyPI version](https://badge.fury.io/py/autocommand.svg)](https://badge.fury.io/py/autocommand) + +# autocommand + +A library to automatically generate and run simple argparse parsers from function signatures. + +## Installation + +Autocommand is installed via pip: + +``` +$ pip install autocommand +``` + +## Usage + +Autocommand turns a function into a command-line program. It converts the function's parameter signature into command-line arguments, and automatically runs the function if the module was called as `__main__`. In effect, it lets your create a smart main function. + +```python +from autocommand import autocommand + +# This program takes exactly one argument and echos it. +@autocommand(__name__) +def echo(thing): + print(thing) +``` + +``` +$ python echo.py hello +hello +$ python echo.py -h +usage: echo [-h] thing + +positional arguments: + thing + +optional arguments: + -h, --help show this help message and exit +$ python echo.py hello world # too many arguments +usage: echo.py [-h] thing +echo.py: error: unrecognized arguments: world +``` + +As you can see, autocommand converts the signature of the function into an argument spec. When you run the file as a program, autocommand collects the command-line arguments and turns them into function arguments. The function is executed with these arguments, and then the program exits with the return value of the function, via `sys.exit`. Autocommand also automatically creates a usage message, which can be invoked with `-h` or `--help`, and automatically prints an error message when provided with invalid arguments. + +### Types + +You can use a type annotation to give an argument a type. Any type (or in fact any callable) that returns an object when given a string argument can be used, though there are a few special cases that are described later. + +```python +@autocommand(__name__) +def net_client(host, port: int): + ... +``` + +Autocommand will catch `TypeErrors` raised by the type during argument parsing, so you can supply a callable and do some basic argument validation as well. + +### Trailing Arguments + +You can add a `*args` parameter to your function to give it trailing arguments. The command will collect 0 or more trailing arguments and supply them to `args` as a tuple. If a type annotation is supplied, the type is applied to each argument. + +```python +# Write the contents of each file, one by one +@autocommand(__name__) +def cat(*files): + for filename in files: + with open(filename) as file: + for line in file: + print(line.rstrip()) +``` + +``` +$ python cat.py -h +usage: ipython [-h] [file [file ...]] + +positional arguments: + file + +optional arguments: + -h, --help show this help message and exit +``` + +### Options + +To create `--option` switches, just assign a default. Autocommand will automatically create `--long` and `-s`hort switches. + +```python +@autocommand(__name__) +def do_with_config(argument, config='~/foo.conf'): + pass +``` + +``` +$ python example.py -h +usage: example.py [-h] [-c CONFIG] argument + +positional arguments: + argument + +optional arguments: + -h, --help show this help message and exit + -c CONFIG, --config CONFIG +``` + +The option's type is automatically deduced from the default, unless one is explicitly given in an annotation: + +```python +@autocommand(__name__) +def http_connect(host, port=80): + print('{}:{}'.format(host, port)) +``` + +``` +$ python http.py -h +usage: http.py [-h] [-p PORT] host + +positional arguments: + host + +optional arguments: + -h, --help show this help message and exit + -p PORT, --port PORT +$ python http.py localhost +localhost:80 +$ python http.py localhost -p 8080 +localhost:8080 +$ python http.py localhost -p blah +usage: http.py [-h] [-p PORT] host +http.py: error: argument -p/--port: invalid int value: 'blah' +``` + +#### None + +If an option is given a default value of `None`, it reads in a value as normal, but supplies `None` if the option isn't provided. + +#### Switches + +If an argument is given a default value of `True` or `False`, or +given an explicit `bool` type, it becomes an option switch. + +```python + @autocommand(__name__) + def example(verbose=False, quiet=False): + pass +``` + +``` +$ python example.py -h +usage: example.py [-h] [-v] [-q] + +optional arguments: + -h, --help show this help message and exit + -v, --verbose + -q, --quiet +``` + +Autocommand attempts to do the "correct thing" in these cases- if the default is `True`, then supplying the switch makes the argument `False`; if the type is `bool` and the default is some other `True` value, then supplying the switch makes the argument `False`, while not supplying the switch makes the argument the default value. + +Autocommand also supports the creation of switch inverters. Pass `add_nos=True` to `autocommand` to enable this. + +``` + @autocommand(__name__, add_nos=True) + def example(verbose=False): + pass +``` + +``` +$ python example.py -h +usage: ipython [-h] [-v] [--no-verbose] + +optional arguments: + -h, --help show this help message and exit + -v, --verbose + --no-verbose +``` + +Using the `--no-` version of a switch will pass the opposite value in as a function argument. If multiple switches are present, the last one takes precedence. + +#### Files + +If the default value is a file object, such as `sys.stdout`, then autocommand just looks for a string, for a file path. It doesn't do any special checking on the string, though (such as checking if the file exists); it's better to let the client decide how to handle errors in this case. Instead, it provides a special context manager called `smart_open`, which behaves exactly like `open` if a filename or other openable type is provided, but also lets you use already open files: + +```python +from autocommand import autocommand, smart_open +import sys + +# Write the contents of stdin, or a file, to stdout +@autocommand(__name__) +def write_out(infile=sys.stdin): + with smart_open(infile) as f: + for line in f: + print(line.rstrip()) + # If a file was opened, it is closed here. If it was just stdin, it is untouched. +``` + +``` +$ echo "Hello World!" | python write_out.py | tee hello.txt +Hello World! +$ python write_out.py --infile hello.txt +Hello World! +``` + +### Descriptions and docstrings + +The `autocommand` decorator accepts `description` and `epilog` kwargs, corresponding to the `description `_ and `epilog `_ of the `ArgumentParser`. If no description is given, but the decorated function has a docstring, then it is taken as the `description` for the `ArgumentParser`. You can also provide both the description and epilog in the docstring by splitting it into two sections with 4 or more - characters. + +```python +@autocommand(__name__) +def copy(infile=sys.stdin, outfile=sys.stdout): + ''' + Copy an the contents of a file (or stdin) to another file (or stdout) + ---------- + Some extra documentation in the epilog + ''' + with smart_open(infile) as istr: + with smart_open(outfile, 'w') as ostr: + for line in istr: + ostr.write(line) +``` + +``` +$ python copy.py -h +usage: copy.py [-h] [-i INFILE] [-o OUTFILE] + +Copy an the contents of a file (or stdin) to another file (or stdout) + +optional arguments: + -h, --help show this help message and exit + -i INFILE, --infile INFILE + -o OUTFILE, --outfile OUTFILE + +Some extra documentation in the epilog +$ echo "Hello World" | python copy.py --outfile hello.txt +$ python copy.py --infile hello.txt --outfile hello2.txt +$ python copy.py --infile hello2.txt +Hello World +``` + +### Parameter descriptions + +You can also attach description text to individual parameters in the annotation. To attach both a type and a description, supply them both in any order in a tuple + +```python +@autocommand(__name__) +def copy_net( + infile: 'The name of the file to send', + host: 'The host to send the file to', + port: (int, 'The port to connect to')): + + ''' + Copy a file over raw TCP to a remote destination. + ''' + # Left as an exercise to the reader +``` + +### Decorators and wrappers + +Autocommand automatically follows wrapper chains created by `@functools.wraps`. This means that you can apply other wrapping decorators to your main function, and autocommand will still correctly detect the signature. + +```python +from functools import wraps +from autocommand import autocommand + +def print_yielded(func): + ''' + Convert a generator into a function that prints all yielded elements + ''' + @wraps(func) + def wrapper(*args, **kwargs): + for thing in func(*args, **kwargs): + print(thing) + return wrapper + +@autocommand(__name__, + description= 'Print all the values from START to STOP, inclusive, in steps of STEP', + epilog= 'STOP and STEP default to 1') +@print_yielded +def seq(stop, start=1, step=1): + for i in range(start, stop + 1, step): + yield i +``` + +``` +$ seq.py -h +usage: seq.py [-h] [-s START] [-S STEP] stop + +Print all the values from START to STOP, inclusive, in steps of STEP + +positional arguments: + stop + +optional arguments: + -h, --help show this help message and exit + -s START, --start START + -S STEP, --step STEP + +STOP and STEP default to 1 +``` + +Even though autocommand is being applied to the `wrapper` returned by `print_yielded`, it still retreives the signature of the underlying `seq` function to create the argument parsing. + +### Custom Parser + +While autocommand's automatic parser generator is a powerful convenience, it doesn't cover all of the different features that argparse provides. If you need these features, you can provide your own parser as a kwarg to `autocommand`: + +```python +from argparse import ArgumentParser +from autocommand import autocommand + +parser = ArgumentParser() +# autocommand can't do optional positonal parameters +parser.add_argument('arg', nargs='?') +# or mutually exclusive options +group = parser.add_mutually_exclusive_group() +group.add_argument('-v', '--verbose', action='store_true') +group.add_argument('-q', '--quiet', action='store_true') + +@autocommand(__name__, parser=parser) +def main(arg, verbose, quiet): + print(arg, verbose, quiet) +``` + +``` +$ python parser.py -h +usage: write_file.py [-h] [-v | -q] [arg] + +positional arguments: + arg + +optional arguments: + -h, --help show this help message and exit + -v, --verbose + -q, --quiet +$ python parser.py +None False False +$ python parser.py hello +hello False False +$ python parser.py -v +None True False +$ python parser.py -q +None False True +$ python parser.py -vq +usage: parser.py [-h] [-v | -q] [arg] +parser.py: error: argument -q/--quiet: not allowed with argument -v/--verbose +``` + +Any parser should work fine, so long as each of the parser's arguments has a corresponding parameter in the decorated main function. The order of parameters doesn't matter, as long as they are all present. Note that when using a custom parser, autocommand doesn't modify the parser or the retrieved arguments. This means that no description/epilog will be added, and the function's type annotations and defaults (if present) will be ignored. + +## Testing and Library use + +The decorated function is only called and exited from if the first argument to `autocommand` is `'__main__'` or `True`. If it is neither of these values, or no argument is given, then a new main function is created by the decorator. This function has the signature `main(argv=None)`, and is intended to be called with arguments as if via `main(sys.argv[1:])`. The function has the attributes `parser` and `main`, which are the generated `ArgumentParser` and the original main function that was decorated. This is to facilitate testing and library use of your main. Calling the function triggers a `parse_args()` with the supplied arguments, and returns the result of the main function. Note that, while it returns instead of calling `sys.exit`, the `parse_args()` function will raise a `SystemExit` in the event of a parsing error or `-h/--help` argument. + +```python + @autocommand() + def test_prog(arg1, arg2: int, quiet=False, verbose=False): + if not quiet: + print(arg1, arg2) + if verbose: + print("LOUD NOISES") + + return 0 + + print(test_prog(['-v', 'hello', '80'])) +``` + +``` +$ python test_prog.py +hello 80 +LOUD NOISES +0 +``` + +If the function is called with no arguments, `sys.argv[1:]` is used. This is to allow the autocommand function to be used as a setuptools entry point. + +## Exceptions and limitations + +- There are a few possible exceptions that `autocommand` can raise. All of them derive from `autocommand.AutocommandError`. + + - If an invalid annotation is given (that is, it isn't a `type`, `str`, `(type, str)`, or `(str, type)`, an `AnnotationError` is raised. The `type` may be any callable, as described in the `Types`_ section. + - If the function has a `**kwargs` parameter, a `KWargError` is raised. + - If, somehow, the function has a positional-only parameter, a `PositionalArgError` is raised. This means that the argument doesn't have a name, which is currently not possible with a plain `def` or `lambda`, though many built-in functions have this kind of parameter. + +- There are a few argparse features that are not supported by autocommand. + + - It isn't possible to have an optional positional argument (as opposed to a `--option`). POSIX thinks this is bad form anyway. + - It isn't possible to have mutually exclusive arguments or options + - It isn't possible to have subcommands or subparsers, though I'm working on a few solutions involving classes or nested function definitions to allow this. + +## Development + +Autocommand cannot be important from the project root; this is to enforce separation of concerns and prevent accidental importing of `setup.py` or tests. To develop, install the project in editable mode: + +``` +$ python setup.py develop +``` + +This will create a link to the source files in the deployment directory, so that any source changes are reflected when it is imported. diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/RECORD new file mode 100644 index 000000000..6ebac007f --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/RECORD @@ -0,0 +1,18 @@ +autocommand-2.2.2.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +autocommand-2.2.2.dist-info/LICENSE,sha256=reeNBJgtaZctREqOFKlPh6IzTdOFXMgDSOqOJAqg3y0,7634 +autocommand-2.2.2.dist-info/METADATA,sha256=OADZuR3O6iBlpu1ieTgzYul6w4uOVrk0P0BO5TGGAJk,15006 +autocommand-2.2.2.dist-info/RECORD,, +autocommand-2.2.2.dist-info/WHEEL,sha256=2wepM1nk4DS4eFpYrW1TTqPcoGNfHhhO_i5m4cOimbo,92 +autocommand-2.2.2.dist-info/top_level.txt,sha256=AzfhgKKS8EdAwWUTSF8mgeVQbXOY9kokHB6kSqwwqu0,12 +autocommand/__init__.py,sha256=zko5Rnvolvb-UXjCx_2ArPTGBWwUK5QY4LIQIKYR7As,1037 +autocommand/__pycache__/__init__.cpython-312.pyc,, +autocommand/__pycache__/autoasync.cpython-312.pyc,, +autocommand/__pycache__/autocommand.cpython-312.pyc,, +autocommand/__pycache__/automain.cpython-312.pyc,, +autocommand/__pycache__/autoparse.cpython-312.pyc,, +autocommand/__pycache__/errors.cpython-312.pyc,, +autocommand/autoasync.py,sha256=AMdyrxNS4pqWJfP_xuoOcImOHWD-qT7x06wmKN1Vp-U,5680 +autocommand/autocommand.py,sha256=hmkEmQ72HtL55gnURVjDOnsfYlGd5lLXbvT4KG496Qw,2505 +autocommand/automain.py,sha256=A2b8i754Mxc_DjU9WFr6vqYDWlhz0cn8miu8d8EsxV8,2076 +autocommand/autoparse.py,sha256=WVWmZJPcbzUKXP40raQw_0HD8qPJ2V9VG1eFFmmnFxw,11642 +autocommand/errors.py,sha256=7aa3roh9Herd6nIKpQHNWEslWE8oq7GiHYVUuRqORnA,886 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/WHEEL new file mode 100644 index 000000000..57e3d840d --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.38.4) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/top_level.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/top_level.txt new file mode 100644 index 000000000..dda5158ff --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand-2.2.2.dist-info/top_level.txt @@ -0,0 +1 @@ +autocommand diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__init__.py new file mode 100644 index 000000000..73fbfca6b --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__init__.py @@ -0,0 +1,27 @@ +# Copyright 2014-2016 Nathan West +# +# This file is part of autocommand. +# +# autocommand is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# autocommand is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public License +# along with autocommand. If not, see . + +# flake8 flags all these imports as unused, hence the NOQAs everywhere. + +from .automain import automain # NOQA +from .autoparse import autoparse, smart_open # NOQA +from .autocommand import autocommand # NOQA + +try: + from .autoasync import autoasync # NOQA +except ImportError: # pragma: no cover + pass diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6cf66256eb4c5b0ba5272d0d9a735d2407e00e83 GIT binary patch literal 463 zcmYjNJugH-6uo!n?Z?A5dQn)36?TGFR92!O8!E4P8T%&oG4tkSW)|-s_ytrtjo+Zx z_ycT$LZuTTk*&kSS(Z3C@-b6n-R)*Y6SqkFw7Tq};-TtbFuo~s zrEOblrLW<`UBU2-_LSt534ThqijG!?ylV|@?{*fqRlNi%#P>%~Bi3t-Ki4R;5b% zg0JZb7tH^LnRoC;5b<*kaQYb*9-;9T5DcG!#@Bsy@*NPvhoI&?;n4WG^U4%lmS@Qo G&XR9k!G7HU literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__pycache__/autoasync.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__pycache__/autoasync.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..55ec832768bc8305497b9d5f45276ff2e95daca6 GIT binary patch literal 5044 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__pycache__/autocommand.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__pycache__/autocommand.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b120d49be960dc5a76885c3a619463dad567414a GIT binary patch literal 1325 zcmZuw&uiOO9REJ)>DTNePV6*Ev#vJD7+P10ZP$`h6X;=~tU0V^;3}4qc$4(BC%K7B z0%jB}u`;&9$O=1jx0duj*nKc|31kONv@qCdH#4WKcpMNrUe$fE_SMDl@5Dsl2hNA&bb0PQ0$U;Numnae=6bX?WNfAUi zQnpk}c&Hwz`|2Ig#q|f*ct;K5x~6B9sr^N(N$sF)mR(}C9J}n9u3a|icFVQB@S;YZ zh1XeRr{7`loq7nd)WIVPE?feILL+uuky$hAvXRG&Ij4$3Vwa<~*;I@+YNil~~i12c-P9 zC@(|TQoPmj8s{b>4;~_mn9Apmk-2B#10JZ{8PM5R#tw09!*uLDR%NFk)UZrKe&O_uJ#yJO<&4Tm&LCs?VD2}ic?u;zk$ z3|@Djmxp}eIJfwC_nH2p_-0ZlC08m>HXeWa?Z(qExxAFjUp>`usS@2hy#$4YBwtA8 zmy+T_Qd(qqnv)8P5$?@Eq5Np?d--JQ>Jxl2^>&2+m?}oOKFa~RkgBX0$J})6RNH9# z_9~@>>KZLD?f*^ie9YN+vRThCyKEx&22`fgOqAxvx}%qvd?Wv+ z%)OYLJDy)XnOr+o*Z#p*q*5Ok^j08WImTtmcU+f7>ym9xn!DxtgoatES?p(!S!S8f z)Enm;vqBe`H~&L}RR%o~A@ph)P~|1O)e}Udy~NACNtj(oriw{nmgB@UXJ+PJO}~dK guX`G(#lHa|?RTtlckL|TJ%24%;73UppCVoS4~-^GaR2}S literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__pycache__/automain.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/__pycache__/automain.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..58c3a001e47111c67a345864bdec514b71225d2b GIT binary patch literal 1897 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. + +from asyncio import get_event_loop, iscoroutine +from functools import wraps +from inspect import signature + + +async def _run_forever_coro(coro, args, kwargs, loop): + ''' + This helper function launches an async main function that was tagged with + forever=True. There are two possibilities: + + - The function is a normal function, which handles initializing the event + loop, which is then run forever + - The function is a coroutine, which needs to be scheduled in the event + loop, which is then run forever + - There is also the possibility that the function is a normal function + wrapping a coroutine function + + The function is therefore called unconditionally and scheduled in the event + loop if the return value is a coroutine object. + + The reason this is a separate function is to make absolutely sure that all + the objects created are garbage collected after all is said and done; we + do this to ensure that any exceptions raised in the tasks are collected + ASAP. + ''' + + # Personal note: I consider this an antipattern, as it relies on the use of + # unowned resources. The setup function dumps some stuff into the event + # loop where it just whirls in the ether without a well defined owner or + # lifetime. For this reason, there's a good chance I'll remove the + # forever=True feature from autoasync at some point in the future. + thing = coro(*args, **kwargs) + if iscoroutine(thing): + await thing + + +def autoasync(coro=None, *, loop=None, forever=False, pass_loop=False): + ''' + Convert an asyncio coroutine into a function which, when called, is + evaluted in an event loop, and the return value returned. This is intented + to make it easy to write entry points into asyncio coroutines, which + otherwise need to be explictly evaluted with an event loop's + run_until_complete. + + If `loop` is given, it is used as the event loop to run the coro in. If it + is None (the default), the loop is retreived using asyncio.get_event_loop. + This call is defered until the decorated function is called, so that + callers can install custom event loops or event loop policies after + @autoasync is applied. + + If `forever` is True, the loop is run forever after the decorated coroutine + is finished. Use this for servers created with asyncio.start_server and the + like. + + If `pass_loop` is True, the event loop object is passed into the coroutine + as the `loop` kwarg when the wrapper function is called. In this case, the + wrapper function's __signature__ is updated to remove this parameter, so + that autoparse can still be used on it without generating a parameter for + `loop`. + + This coroutine can be called with ( @autoasync(...) ) or without + ( @autoasync ) arguments. + + Examples: + + @autoasync + def get_file(host, port): + reader, writer = yield from asyncio.open_connection(host, port) + data = reader.read() + sys.stdout.write(data.decode()) + + get_file(host, port) + + @autoasync(forever=True, pass_loop=True) + def server(host, port, loop): + yield_from loop.create_server(Proto, host, port) + + server('localhost', 8899) + + ''' + if coro is None: + return lambda c: autoasync( + c, loop=loop, + forever=forever, + pass_loop=pass_loop) + + # The old and new signatures are required to correctly bind the loop + # parameter in 100% of cases, even if it's a positional parameter. + # NOTE: A future release will probably require the loop parameter to be + # a kwonly parameter. + if pass_loop: + old_sig = signature(coro) + new_sig = old_sig.replace(parameters=( + param for name, param in old_sig.parameters.items() + if name != "loop")) + + @wraps(coro) + def autoasync_wrapper(*args, **kwargs): + # Defer the call to get_event_loop so that, if a custom policy is + # installed after the autoasync decorator, it is respected at call time + local_loop = get_event_loop() if loop is None else loop + + # Inject the 'loop' argument. We have to use this signature binding to + # ensure it's injected in the correct place (positional, keyword, etc) + if pass_loop: + bound_args = old_sig.bind_partial() + bound_args.arguments.update( + loop=local_loop, + **new_sig.bind(*args, **kwargs).arguments) + args, kwargs = bound_args.args, bound_args.kwargs + + if forever: + local_loop.create_task(_run_forever_coro( + coro, args, kwargs, local_loop + )) + local_loop.run_forever() + else: + return local_loop.run_until_complete(coro(*args, **kwargs)) + + # Attach the updated signature. This allows 'pass_loop' to be used with + # autoparse + if pass_loop: + autoasync_wrapper.__signature__ = new_sig + + return autoasync_wrapper diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autocommand.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autocommand.py new file mode 100644 index 000000000..097e86de0 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autocommand.py @@ -0,0 +1,70 @@ +# Copyright 2014-2015 Nathan West +# +# This file is part of autocommand. +# +# autocommand is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# autocommand is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public License +# along with autocommand. If not, see . + +from .autoparse import autoparse +from .automain import automain +try: + from .autoasync import autoasync +except ImportError: # pragma: no cover + pass + + +def autocommand( + module, *, + description=None, + epilog=None, + add_nos=False, + parser=None, + loop=None, + forever=False, + pass_loop=False): + + if callable(module): + raise TypeError('autocommand requires a module name argument') + + def autocommand_decorator(func): + # Step 1: if requested, run it all in an asyncio event loop. autoasync + # patches the __signature__ of the decorated function, so that in the + # event that pass_loop is True, the `loop` parameter of the original + # function will *not* be interpreted as a command-line argument by + # autoparse + if loop is not None or forever or pass_loop: + func = autoasync( + func, + loop=None if loop is True else loop, + pass_loop=pass_loop, + forever=forever) + + # Step 2: create parser. We do this second so that the arguments are + # parsed and passed *before* entering the asyncio event loop, if it + # exists. This simplifies the stack trace and ensures errors are + # reported earlier. It also ensures that errors raised during parsing & + # passing are still raised if `forever` is True. + func = autoparse( + func, + description=description, + epilog=epilog, + add_nos=add_nos, + parser=parser) + + # Step 3: call the function automatically if __name__ == '__main__' (or + # if True was provided) + func = automain(module)(func) + + return func + + return autocommand_decorator diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/automain.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/automain.py new file mode 100644 index 000000000..6cc45db66 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/automain.py @@ -0,0 +1,59 @@ +# Copyright 2014-2015 Nathan West +# +# This file is part of autocommand. +# +# autocommand is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# autocommand is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public License +# along with autocommand. If not, see . + +import sys +from .errors import AutocommandError + + +class AutomainRequiresModuleError(AutocommandError, TypeError): + pass + + +def automain(module, *, args=(), kwargs=None): + ''' + This decorator automatically invokes a function if the module is being run + as the "__main__" module. Optionally, provide args or kwargs with which to + call the function. If `module` is "__main__", the function is called, and + the program is `sys.exit`ed with the return value. You can also pass `True` + to cause the function to be called unconditionally. If the function is not + called, it is returned unchanged by the decorator. + + Usage: + + @automain(__name__) # Pass __name__ to check __name__=="__main__" + def main(): + ... + + If __name__ is "__main__" here, the main function is called, and then + sys.exit called with the return value. + ''' + + # Check that @automain(...) was called, rather than @automain + if callable(module): + raise AutomainRequiresModuleError(module) + + if module == '__main__' or module is True: + if kwargs is None: + kwargs = {} + + # Use a function definition instead of a lambda for a neater traceback + def automain_decorator(main): + sys.exit(main(*args, **kwargs)) + + return automain_decorator + else: + return lambda main: main diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autoparse.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autoparse.py new file mode 100644 index 000000000..0276a3fae --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/autoparse.py @@ -0,0 +1,333 @@ +# Copyright 2014-2015 Nathan West +# +# This file is part of autocommand. +# +# autocommand is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# autocommand is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public License +# along with autocommand. If not, see . + +import sys +from re import compile as compile_regex +from inspect import signature, getdoc, Parameter +from argparse import ArgumentParser +from contextlib import contextmanager +from functools import wraps +from io import IOBase +from autocommand.errors import AutocommandError + + +_empty = Parameter.empty + + +class AnnotationError(AutocommandError): + '''Annotation error: annotation must be a string, type, or tuple of both''' + + +class PositionalArgError(AutocommandError): + ''' + Postional Arg Error: autocommand can't handle postional-only parameters + ''' + + +class KWArgError(AutocommandError): + '''kwarg Error: autocommand can't handle a **kwargs parameter''' + + +class DocstringError(AutocommandError): + '''Docstring error''' + + +class TooManySplitsError(DocstringError): + ''' + The docstring had too many ---- section splits. Currently we only support + using up to a single split, to split the docstring into description and + epilog parts. + ''' + + +def _get_type_description(annotation): + ''' + Given an annotation, return the (type, description) for the parameter. + If you provide an annotation that is somehow both a string and a callable, + the behavior is undefined. + ''' + if annotation is _empty: + return None, None + elif callable(annotation): + return annotation, None + elif isinstance(annotation, str): + return None, annotation + elif isinstance(annotation, tuple): + try: + arg1, arg2 = annotation + except ValueError as e: + raise AnnotationError(annotation) from e + else: + if callable(arg1) and isinstance(arg2, str): + return arg1, arg2 + elif isinstance(arg1, str) and callable(arg2): + return arg2, arg1 + + raise AnnotationError(annotation) + + +def _add_arguments(param, parser, used_char_args, add_nos): + ''' + Add the argument(s) to an ArgumentParser (using add_argument) for a given + parameter. used_char_args is the set of -short options currently already in + use, and is updated (if necessary) by this function. If add_nos is True, + this will also add an inverse switch for all boolean options. For + instance, for the boolean parameter "verbose", this will create --verbose + and --no-verbose. + ''' + + # Impl note: This function is kept separate from make_parser because it's + # already very long and I wanted to separate out as much as possible into + # its own call scope, to prevent even the possibility of suble mutation + # bugs. + if param.kind is param.POSITIONAL_ONLY: + raise PositionalArgError(param) + elif param.kind is param.VAR_KEYWORD: + raise KWArgError(param) + + # These are the kwargs for the add_argument function. + arg_spec = {} + is_option = False + + # Get the type and default from the annotation. + arg_type, description = _get_type_description(param.annotation) + + # Get the default value + default = param.default + + # If there is no explicit type, and the default is present and not None, + # infer the type from the default. + if arg_type is None and default not in {_empty, None}: + arg_type = type(default) + + # Add default. The presence of a default means this is an option, not an + # argument. + if default is not _empty: + arg_spec['default'] = default + is_option = True + + # Add the type + if arg_type is not None: + # Special case for bool: make it just a --switch + if arg_type is bool: + if not default or default is _empty: + arg_spec['action'] = 'store_true' + else: + arg_spec['action'] = 'store_false' + + # Switches are always options + is_option = True + + # Special case for file types: make it a string type, for filename + elif isinstance(default, IOBase): + arg_spec['type'] = str + + # TODO: special case for list type. + # - How to specificy type of list members? + # - param: [int] + # - param: int =[] + # - action='append' vs nargs='*' + + else: + arg_spec['type'] = arg_type + + # nargs: if the signature includes *args, collect them as trailing CLI + # arguments in a list. *args can't have a default value, so it can never be + # an option. + if param.kind is param.VAR_POSITIONAL: + # TODO: consider depluralizing metavar/name here. + arg_spec['nargs'] = '*' + + # Add description. + if description is not None: + arg_spec['help'] = description + + # Get the --flags + flags = [] + name = param.name + + if is_option: + # Add the first letter as a -short option. + for letter in name[0], name[0].swapcase(): + if letter not in used_char_args: + used_char_args.add(letter) + flags.append('-{}'.format(letter)) + break + + # If the parameter is a --long option, or is a -short option that + # somehow failed to get a flag, add it. + if len(name) > 1 or not flags: + flags.append('--{}'.format(name)) + + arg_spec['dest'] = name + else: + flags.append(name) + + parser.add_argument(*flags, **arg_spec) + + # Create the --no- version for boolean switches + if add_nos and arg_type is bool: + parser.add_argument( + '--no-{}'.format(name), + action='store_const', + dest=name, + const=default if default is not _empty else False) + + +def make_parser(func_sig, description, epilog, add_nos): + ''' + Given the signature of a function, create an ArgumentParser + ''' + parser = ArgumentParser(description=description, epilog=epilog) + + used_char_args = {'h'} + + # Arange the params so that single-character arguments are first. This + # esnures they don't have to get --long versions. sorted is stable, so the + # parameters will otherwise still be in relative order. + params = sorted( + func_sig.parameters.values(), + key=lambda param: len(param.name) > 1) + + for param in params: + _add_arguments(param, parser, used_char_args, add_nos) + + return parser + + +_DOCSTRING_SPLIT = compile_regex(r'\n\s*-{4,}\s*\n') + + +def parse_docstring(docstring): + ''' + Given a docstring, parse it into a description and epilog part + ''' + if docstring is None: + return '', '' + + parts = _DOCSTRING_SPLIT.split(docstring) + + if len(parts) == 1: + return docstring, '' + elif len(parts) == 2: + return parts[0], parts[1] + else: + raise TooManySplitsError() + + +def autoparse( + func=None, *, + description=None, + epilog=None, + add_nos=False, + parser=None): + ''' + This decorator converts a function that takes normal arguments into a + function which takes a single optional argument, argv, parses it using an + argparse.ArgumentParser, and calls the underlying function with the parsed + arguments. If it is not given, sys.argv[1:] is used. This is so that the + function can be used as a setuptools entry point, as well as a normal main + function. sys.argv[1:] is not evaluated until the function is called, to + allow injecting different arguments for testing. + + It uses the argument signature of the function to create an + ArgumentParser. Parameters without defaults become positional parameters, + while parameters *with* defaults become --options. Use annotations to set + the type of the parameter. + + The `desctiption` and `epilog` parameters corrospond to the same respective + argparse parameters. If no description is given, it defaults to the + decorated functions's docstring, if present. + + If add_nos is True, every boolean option (that is, every parameter with a + default of True/False or a type of bool) will have a --no- version created + as well, which inverts the option. For instance, the --verbose option will + have a --no-verbose counterpart. These are not mutually exclusive- + whichever one appears last in the argument list will have precedence. + + If a parser is given, it is used instead of one generated from the function + signature. In this case, no parser is created; instead, the given parser is + used to parse the argv argument. The parser's results' argument names must + match up with the parameter names of the decorated function. + + The decorated function is attached to the result as the `func` attribute, + and the parser is attached as the `parser` attribute. + ''' + + # If @autoparse(...) is used instead of @autoparse + if func is None: + return lambda f: autoparse( + f, description=description, + epilog=epilog, + add_nos=add_nos, + parser=parser) + + func_sig = signature(func) + + docstr_description, docstr_epilog = parse_docstring(getdoc(func)) + + if parser is None: + parser = make_parser( + func_sig, + description or docstr_description, + epilog or docstr_epilog, + add_nos) + + @wraps(func) + def autoparse_wrapper(argv=None): + if argv is None: + argv = sys.argv[1:] + + # Get empty argument binding, to fill with parsed arguments. This + # object does all the heavy lifting of turning named arguments into + # into correctly bound *args and **kwargs. + parsed_args = func_sig.bind_partial() + parsed_args.arguments.update(vars(parser.parse_args(argv))) + + return func(*parsed_args.args, **parsed_args.kwargs) + + # TODO: attach an updated __signature__ to autoparse_wrapper, just in case. + + # Attach the wrapped function and parser, and return the wrapper. + autoparse_wrapper.func = func + autoparse_wrapper.parser = parser + return autoparse_wrapper + + +@contextmanager +def smart_open(filename_or_file, *args, **kwargs): + ''' + This context manager allows you to open a filename, if you want to default + some already-existing file object, like sys.stdout, which shouldn't be + closed at the end of the context. If the filename argument is a str, bytes, + or int, the file object is created via a call to open with the given *args + and **kwargs, sent to the context, and closed at the end of the context, + just like "with open(filename) as f:". If it isn't one of the openable + types, the object simply sent to the context unchanged, and left unclosed + at the end of the context. Example: + + def work_with_file(name=sys.stdout): + with smart_open(name) as f: + # Works correctly if name is a str filename or sys.stdout + print("Some stuff", file=f) + # If it was a filename, f is closed at the end here. + ''' + if isinstance(filename_or_file, (str, bytes, int)): + with open(filename_or_file, *args, **kwargs) as file: + yield file + else: + yield filename_or_file diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/errors.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/errors.py new file mode 100644 index 000000000..257060739 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/autocommand/errors.py @@ -0,0 +1,23 @@ +# Copyright 2014-2016 Nathan West +# +# This file is part of autocommand. +# +# autocommand is free software: you can redistribute it and/or modify +# it under the terms of the GNU Lesser General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. +# +# autocommand is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU Lesser General Public License for more details. +# +# You should have received a copy of the GNU Lesser General Public License +# along with autocommand. If not, see . + + +class AutocommandError(Exception): + '''Base class for autocommand exceptions''' + pass + +# Individual modules will define errors specific to that module. diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/INSTALLER new file mode 100644 index 000000000..a1b589e38 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/LICENSE new file mode 100644 index 000000000..1bb5a4435 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/LICENSE @@ -0,0 +1,17 @@ +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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/METADATA new file mode 100644 index 000000000..db0a2dcdb --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/METADATA @@ -0,0 +1,46 @@ +Metadata-Version: 2.1 +Name: backports.tarfile +Version: 1.2.0 +Summary: Backport of CPython tarfile module +Author-email: "Jason R. Coombs" +Project-URL: Homepage, https://github.com/jaraco/backports.tarfile +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Requires-Python: >=3.8 +Description-Content-Type: text/x-rst +License-File: LICENSE +Provides-Extra: docs +Requires-Dist: sphinx >=3.5 ; extra == 'docs' +Requires-Dist: jaraco.packaging >=9.3 ; extra == 'docs' +Requires-Dist: rst.linker >=1.9 ; extra == 'docs' +Requires-Dist: furo ; extra == 'docs' +Requires-Dist: sphinx-lint ; extra == 'docs' +Provides-Extra: testing +Requires-Dist: pytest !=8.1.*,>=6 ; extra == 'testing' +Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'testing' +Requires-Dist: pytest-cov ; extra == 'testing' +Requires-Dist: pytest-enabler >=2.2 ; extra == 'testing' +Requires-Dist: jaraco.test ; extra == 'testing' +Requires-Dist: pytest !=8.0.* ; extra == 'testing' + +.. image:: https://img.shields.io/pypi/v/backports.tarfile.svg + :target: https://pypi.org/project/backports.tarfile + +.. image:: https://img.shields.io/pypi/pyversions/backports.tarfile.svg + +.. image:: https://github.com/jaraco/backports.tarfile/actions/workflows/main.yml/badge.svg + :target: https://github.com/jaraco/backports.tarfile/actions?query=workflow%3A%22tests%22 + :alt: tests + +.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json + :target: https://github.com/astral-sh/ruff + :alt: Ruff + +.. .. image:: https://readthedocs.org/projects/backportstarfile/badge/?version=latest +.. :target: https://backportstarfile.readthedocs.io/en/latest/?badge=latest + +.. image:: https://img.shields.io/badge/skeleton-2024-informational + :target: https://blog.jaraco.com/skeleton diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/RECORD new file mode 100644 index 000000000..1874a0e1b --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/RECORD @@ -0,0 +1,17 @@ +backports.tarfile-1.2.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +backports.tarfile-1.2.0.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 +backports.tarfile-1.2.0.dist-info/METADATA,sha256=ghXFTq132dxaEIolxr3HK1mZqm9iyUmaRANZQSr6WlE,2020 +backports.tarfile-1.2.0.dist-info/RECORD,, +backports.tarfile-1.2.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +backports.tarfile-1.2.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 +backports.tarfile-1.2.0.dist-info/top_level.txt,sha256=cGjaLMOoBR1FK0ApojtzWVmViTtJ7JGIK_HwXiEsvtU,10 +backports/__init__.py,sha256=iOEMwnlORWezdO8-2vxBIPSR37D7JGjluZ8f55vzxls,81 +backports/__pycache__/__init__.cpython-312.pyc,, +backports/tarfile/__init__.py,sha256=Pwf2qUIfB0SolJPCKcx3vz3UEu_aids4g4sAfxy94qg,108491 +backports/tarfile/__main__.py,sha256=Yw2oGT1afrz2eBskzdPYL8ReB_3liApmhFkN2EbDmc4,59 +backports/tarfile/__pycache__/__init__.cpython-312.pyc,, +backports/tarfile/__pycache__/__main__.cpython-312.pyc,, +backports/tarfile/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +backports/tarfile/compat/__pycache__/__init__.cpython-312.pyc,, +backports/tarfile/compat/__pycache__/py38.cpython-312.pyc,, +backports/tarfile/compat/py38.py,sha256=iYkyt_gvWjLzGUTJD9TuTfMMjOk-ersXZmRlvQYN2qE,568 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/REQUESTED b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/REQUESTED new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/WHEEL new file mode 100644 index 000000000..bab98d675 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.43.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/top_level.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/top_level.txt new file mode 100644 index 000000000..99d2be5b6 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports.tarfile-1.2.0.dist-info/top_level.txt @@ -0,0 +1 @@ +backports diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/__init__.py new file mode 100644 index 000000000..0d1f7edf5 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/__init__.py @@ -0,0 +1 @@ +__path__ = __import__('pkgutil').extend_path(__path__, __name__) # type: ignore diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f555abcef1c7ab61527ae3701cfe482242e0638e GIT binary patch literal 353 zcmX@j%ge<81jlwKW&{H1#~=<2us|7~O@NH)3``8E3@Hq&86l!s%rIpLI+ZDvc{LM+ zAH`J3sL6DTy&yZiv?MdfPm|>qSA2YCZb5!gNqqb*?$nBs)V!4Vg2a-HTO9FV8Ym28 zcN@_zW`VSDSuDer~FMVoqv>zHenfQGQlxa!IkiYjA+BUw%p|gyret79W(K zlwYD>Qd*KzVIx8YJR9xnEXyhp304e|gOCV)k literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__init__.py new file mode 100644 index 000000000..8c16881cb --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__init__.py @@ -0,0 +1,2937 @@ +#------------------------------------------------------------------- +# tarfile.py +#------------------------------------------------------------------- +# Copyright (C) 2002 Lars Gustaebel +# All rights reserved. +# +# Permission is hereby granted, free of charge, to any person +# obtaining a copy of this software and associated documentation +# files (the "Software"), to deal in the Software without +# restriction, including without limitation the rights to use, +# copy, modify, merge, publish, distribute, sublicense, and/or sell +# copies of the Software, and to permit persons to whom the +# Software is furnished to do so, subject to the following +# conditions: +# +# The above copyright notice and this permission notice shall be +# included in all copies or substantial portions of the Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, +# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES +# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND +# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT +# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR +# OTHER DEALINGS IN THE SOFTWARE. +# +"""Read from and write to tar format archives. +""" + +version = "0.9.0" +__author__ = "Lars Gust\u00e4bel (lars@gustaebel.de)" +__credits__ = "Gustavo Niemeyer, Niels Gust\u00e4bel, Richard Townsend." + +#--------- +# Imports +#--------- +from builtins import open as bltn_open +import sys +import os +import io +import shutil +import stat +import time +import struct +import copy +import re + +from .compat.py38 import removesuffix + +try: + import pwd +except ImportError: + pwd = None +try: + import grp +except ImportError: + grp = None + +# os.symlink on Windows prior to 6.0 raises NotImplementedError +# OSError (winerror=1314) will be raised if the caller does not hold the +# SeCreateSymbolicLinkPrivilege privilege +symlink_exception = (AttributeError, NotImplementedError, OSError) + +# from tarfile import * +__all__ = ["TarFile", "TarInfo", "is_tarfile", "TarError", "ReadError", + "CompressionError", "StreamError", "ExtractError", "HeaderError", + "ENCODING", "USTAR_FORMAT", "GNU_FORMAT", "PAX_FORMAT", + "DEFAULT_FORMAT", "open","fully_trusted_filter", "data_filter", + "tar_filter", "FilterError", "AbsoluteLinkError", + "OutsideDestinationError", "SpecialFileError", "AbsolutePathError", + "LinkOutsideDestinationError"] + + +#--------------------------------------------------------- +# tar constants +#--------------------------------------------------------- +NUL = b"\0" # the null character +BLOCKSIZE = 512 # length of processing blocks +RECORDSIZE = BLOCKSIZE * 20 # length of records +GNU_MAGIC = b"ustar \0" # magic gnu tar string +POSIX_MAGIC = b"ustar\x0000" # magic posix tar string + +LENGTH_NAME = 100 # maximum length of a filename +LENGTH_LINK = 100 # maximum length of a linkname +LENGTH_PREFIX = 155 # maximum length of the prefix field + +REGTYPE = b"0" # regular file +AREGTYPE = b"\0" # regular file +LNKTYPE = b"1" # link (inside tarfile) +SYMTYPE = b"2" # symbolic link +CHRTYPE = b"3" # character special device +BLKTYPE = b"4" # block special device +DIRTYPE = b"5" # directory +FIFOTYPE = b"6" # fifo special device +CONTTYPE = b"7" # contiguous file + +GNUTYPE_LONGNAME = b"L" # GNU tar longname +GNUTYPE_LONGLINK = b"K" # GNU tar longlink +GNUTYPE_SPARSE = b"S" # GNU tar sparse file + +XHDTYPE = b"x" # POSIX.1-2001 extended header +XGLTYPE = b"g" # POSIX.1-2001 global header +SOLARIS_XHDTYPE = b"X" # Solaris extended header + +USTAR_FORMAT = 0 # POSIX.1-1988 (ustar) format +GNU_FORMAT = 1 # GNU tar format +PAX_FORMAT = 2 # POSIX.1-2001 (pax) format +DEFAULT_FORMAT = PAX_FORMAT + +#--------------------------------------------------------- +# tarfile constants +#--------------------------------------------------------- +# File types that tarfile supports: +SUPPORTED_TYPES = (REGTYPE, AREGTYPE, LNKTYPE, + SYMTYPE, DIRTYPE, FIFOTYPE, + CONTTYPE, CHRTYPE, BLKTYPE, + GNUTYPE_LONGNAME, GNUTYPE_LONGLINK, + GNUTYPE_SPARSE) + +# File types that will be treated as a regular file. +REGULAR_TYPES = (REGTYPE, AREGTYPE, + CONTTYPE, GNUTYPE_SPARSE) + +# File types that are part of the GNU tar format. +GNU_TYPES = (GNUTYPE_LONGNAME, GNUTYPE_LONGLINK, + GNUTYPE_SPARSE) + +# Fields from a pax header that override a TarInfo attribute. +PAX_FIELDS = ("path", "linkpath", "size", "mtime", + "uid", "gid", "uname", "gname") + +# Fields from a pax header that are affected by hdrcharset. +PAX_NAME_FIELDS = {"path", "linkpath", "uname", "gname"} + +# Fields in a pax header that are numbers, all other fields +# are treated as strings. +PAX_NUMBER_FIELDS = { + "atime": float, + "ctime": float, + "mtime": float, + "uid": int, + "gid": int, + "size": int +} + +#--------------------------------------------------------- +# initialization +#--------------------------------------------------------- +if os.name == "nt": + ENCODING = "utf-8" +else: + ENCODING = sys.getfilesystemencoding() + +#--------------------------------------------------------- +# Some useful functions +#--------------------------------------------------------- + +def stn(s, length, encoding, errors): + """Convert a string to a null-terminated bytes object. + """ + if s is None: + raise ValueError("metadata cannot contain None") + s = s.encode(encoding, errors) + return s[:length] + (length - len(s)) * NUL + +def nts(s, encoding, errors): + """Convert a null-terminated bytes object to a string. + """ + p = s.find(b"\0") + if p != -1: + s = s[:p] + return s.decode(encoding, errors) + +def nti(s): + """Convert a number field to a python number. + """ + # There are two possible encodings for a number field, see + # itn() below. + if s[0] in (0o200, 0o377): + n = 0 + for i in range(len(s) - 1): + n <<= 8 + n += s[i + 1] + if s[0] == 0o377: + n = -(256 ** (len(s) - 1) - n) + else: + try: + s = nts(s, "ascii", "strict") + n = int(s.strip() or "0", 8) + except ValueError: + raise InvalidHeaderError("invalid header") + return n + +def itn(n, digits=8, format=DEFAULT_FORMAT): + """Convert a python number to a number field. + """ + # POSIX 1003.1-1988 requires numbers to be encoded as a string of + # octal digits followed by a null-byte, this allows values up to + # (8**(digits-1))-1. GNU tar allows storing numbers greater than + # that if necessary. A leading 0o200 or 0o377 byte indicate this + # particular encoding, the following digits-1 bytes are a big-endian + # base-256 representation. This allows values up to (256**(digits-1))-1. + # A 0o200 byte indicates a positive number, a 0o377 byte a negative + # number. + original_n = n + n = int(n) + if 0 <= n < 8 ** (digits - 1): + s = bytes("%0*o" % (digits - 1, n), "ascii") + NUL + elif format == GNU_FORMAT and -256 ** (digits - 1) <= n < 256 ** (digits - 1): + if n >= 0: + s = bytearray([0o200]) + else: + s = bytearray([0o377]) + n = 256 ** digits + n + + for i in range(digits - 1): + s.insert(1, n & 0o377) + n >>= 8 + else: + raise ValueError("overflow in number field") + + return s + +def calc_chksums(buf): + """Calculate the checksum for a member's header by summing up all + characters except for the chksum field which is treated as if + it was filled with spaces. According to the GNU tar sources, + some tars (Sun and NeXT) calculate chksum with signed char, + which will be different if there are chars in the buffer with + the high bit set. So we calculate two checksums, unsigned and + signed. + """ + unsigned_chksum = 256 + sum(struct.unpack_from("148B8x356B", buf)) + signed_chksum = 256 + sum(struct.unpack_from("148b8x356b", buf)) + return unsigned_chksum, signed_chksum + +def copyfileobj(src, dst, length=None, exception=OSError, bufsize=None): + """Copy length bytes from fileobj src to fileobj dst. + If length is None, copy the entire content. + """ + bufsize = bufsize or 16 * 1024 + if length == 0: + return + if length is None: + shutil.copyfileobj(src, dst, bufsize) + return + + blocks, remainder = divmod(length, bufsize) + for b in range(blocks): + buf = src.read(bufsize) + if len(buf) < bufsize: + raise exception("unexpected end of data") + dst.write(buf) + + if remainder != 0: + buf = src.read(remainder) + if len(buf) < remainder: + raise exception("unexpected end of data") + dst.write(buf) + return + +def _safe_print(s): + encoding = getattr(sys.stdout, 'encoding', None) + if encoding is not None: + s = s.encode(encoding, 'backslashreplace').decode(encoding) + print(s, end=' ') + + +class TarError(Exception): + """Base exception.""" + pass +class ExtractError(TarError): + """General exception for extract errors.""" + pass +class ReadError(TarError): + """Exception for unreadable tar archives.""" + pass +class CompressionError(TarError): + """Exception for unavailable compression methods.""" + pass +class StreamError(TarError): + """Exception for unsupported operations on stream-like TarFiles.""" + pass +class HeaderError(TarError): + """Base exception for header errors.""" + pass +class EmptyHeaderError(HeaderError): + """Exception for empty headers.""" + pass +class TruncatedHeaderError(HeaderError): + """Exception for truncated headers.""" + pass +class EOFHeaderError(HeaderError): + """Exception for end of file headers.""" + pass +class InvalidHeaderError(HeaderError): + """Exception for invalid headers.""" + pass +class SubsequentHeaderError(HeaderError): + """Exception for missing and invalid extended headers.""" + pass + +#--------------------------- +# internal stream interface +#--------------------------- +class _LowLevelFile: + """Low-level file object. Supports reading and writing. + It is used instead of a regular file object for streaming + access. + """ + + def __init__(self, name, mode): + mode = { + "r": os.O_RDONLY, + "w": os.O_WRONLY | os.O_CREAT | os.O_TRUNC, + }[mode] + if hasattr(os, "O_BINARY"): + mode |= os.O_BINARY + self.fd = os.open(name, mode, 0o666) + + def close(self): + os.close(self.fd) + + def read(self, size): + return os.read(self.fd, size) + + def write(self, s): + os.write(self.fd, s) + +class _Stream: + """Class that serves as an adapter between TarFile and + a stream-like object. The stream-like object only + needs to have a read() or write() method that works with bytes, + and the method is accessed blockwise. + Use of gzip or bzip2 compression is possible. + A stream-like object could be for example: sys.stdin.buffer, + sys.stdout.buffer, a socket, a tape device etc. + + _Stream is intended to be used only internally. + """ + + def __init__(self, name, mode, comptype, fileobj, bufsize, + compresslevel): + """Construct a _Stream object. + """ + self._extfileobj = True + if fileobj is None: + fileobj = _LowLevelFile(name, mode) + self._extfileobj = False + + if comptype == '*': + # Enable transparent compression detection for the + # stream interface + fileobj = _StreamProxy(fileobj) + comptype = fileobj.getcomptype() + + self.name = name or "" + self.mode = mode + self.comptype = comptype + self.fileobj = fileobj + self.bufsize = bufsize + self.buf = b"" + self.pos = 0 + self.closed = False + + try: + if comptype == "gz": + try: + import zlib + except ImportError: + raise CompressionError("zlib module is not available") from None + self.zlib = zlib + self.crc = zlib.crc32(b"") + if mode == "r": + self.exception = zlib.error + self._init_read_gz() + else: + self._init_write_gz(compresslevel) + + elif comptype == "bz2": + try: + import bz2 + except ImportError: + raise CompressionError("bz2 module is not available") from None + if mode == "r": + self.dbuf = b"" + self.cmp = bz2.BZ2Decompressor() + self.exception = OSError + else: + self.cmp = bz2.BZ2Compressor(compresslevel) + + elif comptype == "xz": + try: + import lzma + except ImportError: + raise CompressionError("lzma module is not available") from None + if mode == "r": + self.dbuf = b"" + self.cmp = lzma.LZMADecompressor() + self.exception = lzma.LZMAError + else: + self.cmp = lzma.LZMACompressor() + + elif comptype != "tar": + raise CompressionError("unknown compression type %r" % comptype) + + except: + if not self._extfileobj: + self.fileobj.close() + self.closed = True + raise + + def __del__(self): + if hasattr(self, "closed") and not self.closed: + self.close() + + def _init_write_gz(self, compresslevel): + """Initialize for writing with gzip compression. + """ + self.cmp = self.zlib.compressobj(compresslevel, + self.zlib.DEFLATED, + -self.zlib.MAX_WBITS, + self.zlib.DEF_MEM_LEVEL, + 0) + timestamp = struct.pack(" self.bufsize: + self.fileobj.write(self.buf[:self.bufsize]) + self.buf = self.buf[self.bufsize:] + + def close(self): + """Close the _Stream object. No operation should be + done on it afterwards. + """ + if self.closed: + return + + self.closed = True + try: + if self.mode == "w" and self.comptype != "tar": + self.buf += self.cmp.flush() + + if self.mode == "w" and self.buf: + self.fileobj.write(self.buf) + self.buf = b"" + if self.comptype == "gz": + self.fileobj.write(struct.pack("= 0: + blocks, remainder = divmod(pos - self.pos, self.bufsize) + for i in range(blocks): + self.read(self.bufsize) + self.read(remainder) + else: + raise StreamError("seeking backwards is not allowed") + return self.pos + + def read(self, size): + """Return the next size number of bytes from the stream.""" + assert size is not None + buf = self._read(size) + self.pos += len(buf) + return buf + + def _read(self, size): + """Return size bytes from the stream. + """ + if self.comptype == "tar": + return self.__read(size) + + c = len(self.dbuf) + t = [self.dbuf] + while c < size: + # Skip underlying buffer to avoid unaligned double buffering. + if self.buf: + buf = self.buf + self.buf = b"" + else: + buf = self.fileobj.read(self.bufsize) + if not buf: + break + try: + buf = self.cmp.decompress(buf) + except self.exception as e: + raise ReadError("invalid compressed data") from e + t.append(buf) + c += len(buf) + t = b"".join(t) + self.dbuf = t[size:] + return t[:size] + + def __read(self, size): + """Return size bytes from stream. If internal buffer is empty, + read another block from the stream. + """ + c = len(self.buf) + t = [self.buf] + while c < size: + buf = self.fileobj.read(self.bufsize) + if not buf: + break + t.append(buf) + c += len(buf) + t = b"".join(t) + self.buf = t[size:] + return t[:size] +# class _Stream + +class _StreamProxy(object): + """Small proxy class that enables transparent compression + detection for the Stream interface (mode 'r|*'). + """ + + def __init__(self, fileobj): + self.fileobj = fileobj + self.buf = self.fileobj.read(BLOCKSIZE) + + def read(self, size): + self.read = self.fileobj.read + return self.buf + + def getcomptype(self): + if self.buf.startswith(b"\x1f\x8b\x08"): + return "gz" + elif self.buf[0:3] == b"BZh" and self.buf[4:10] == b"1AY&SY": + return "bz2" + elif self.buf.startswith((b"\x5d\x00\x00\x80", b"\xfd7zXZ")): + return "xz" + else: + return "tar" + + def close(self): + self.fileobj.close() +# class StreamProxy + +#------------------------ +# Extraction file object +#------------------------ +class _FileInFile(object): + """A thin wrapper around an existing file object that + provides a part of its data as an individual file + object. + """ + + def __init__(self, fileobj, offset, size, name, blockinfo=None): + self.fileobj = fileobj + self.offset = offset + self.size = size + self.position = 0 + self.name = name + self.closed = False + + if blockinfo is None: + blockinfo = [(0, size)] + + # Construct a map with data and zero blocks. + self.map_index = 0 + self.map = [] + lastpos = 0 + realpos = self.offset + for offset, size in blockinfo: + if offset > lastpos: + self.map.append((False, lastpos, offset, None)) + self.map.append((True, offset, offset + size, realpos)) + realpos += size + lastpos = offset + size + if lastpos < self.size: + self.map.append((False, lastpos, self.size, None)) + + def flush(self): + pass + + @property + def mode(self): + return 'rb' + + def readable(self): + return True + + def writable(self): + return False + + def seekable(self): + return self.fileobj.seekable() + + def tell(self): + """Return the current file position. + """ + return self.position + + def seek(self, position, whence=io.SEEK_SET): + """Seek to a position in the file. + """ + if whence == io.SEEK_SET: + self.position = min(max(position, 0), self.size) + elif whence == io.SEEK_CUR: + if position < 0: + self.position = max(self.position + position, 0) + else: + self.position = min(self.position + position, self.size) + elif whence == io.SEEK_END: + self.position = max(min(self.size + position, self.size), 0) + else: + raise ValueError("Invalid argument") + return self.position + + def read(self, size=None): + """Read data from the file. + """ + if size is None: + size = self.size - self.position + else: + size = min(size, self.size - self.position) + + buf = b"" + while size > 0: + while True: + data, start, stop, offset = self.map[self.map_index] + if start <= self.position < stop: + break + else: + self.map_index += 1 + if self.map_index == len(self.map): + self.map_index = 0 + length = min(size, stop - self.position) + if data: + self.fileobj.seek(offset + (self.position - start)) + b = self.fileobj.read(length) + if len(b) != length: + raise ReadError("unexpected end of data") + buf += b + else: + buf += NUL * length + size -= length + self.position += length + return buf + + def readinto(self, b): + buf = self.read(len(b)) + b[:len(buf)] = buf + return len(buf) + + def close(self): + self.closed = True +#class _FileInFile + +class ExFileObject(io.BufferedReader): + + def __init__(self, tarfile, tarinfo): + fileobj = _FileInFile(tarfile.fileobj, tarinfo.offset_data, + tarinfo.size, tarinfo.name, tarinfo.sparse) + super().__init__(fileobj) +#class ExFileObject + + +#----------------------------- +# extraction filters (PEP 706) +#----------------------------- + +class FilterError(TarError): + pass + +class AbsolutePathError(FilterError): + def __init__(self, tarinfo): + self.tarinfo = tarinfo + super().__init__(f'member {tarinfo.name!r} has an absolute path') + +class OutsideDestinationError(FilterError): + def __init__(self, tarinfo, path): + self.tarinfo = tarinfo + self._path = path + super().__init__(f'{tarinfo.name!r} would be extracted to {path!r}, ' + + 'which is outside the destination') + +class SpecialFileError(FilterError): + def __init__(self, tarinfo): + self.tarinfo = tarinfo + super().__init__(f'{tarinfo.name!r} is a special file') + +class AbsoluteLinkError(FilterError): + def __init__(self, tarinfo): + self.tarinfo = tarinfo + super().__init__(f'{tarinfo.name!r} is a link to an absolute path') + +class LinkOutsideDestinationError(FilterError): + def __init__(self, tarinfo, path): + self.tarinfo = tarinfo + self._path = path + super().__init__(f'{tarinfo.name!r} would link to {path!r}, ' + + 'which is outside the destination') + +def _get_filtered_attrs(member, dest_path, for_data=True): + new_attrs = {} + name = member.name + dest_path = os.path.realpath(dest_path) + # Strip leading / (tar's directory separator) from filenames. + # Include os.sep (target OS directory separator) as well. + if name.startswith(('/', os.sep)): + name = new_attrs['name'] = member.path.lstrip('/' + os.sep) + if os.path.isabs(name): + # Path is absolute even after stripping. + # For example, 'C:/foo' on Windows. + raise AbsolutePathError(member) + # Ensure we stay in the destination + target_path = os.path.realpath(os.path.join(dest_path, name)) + if os.path.commonpath([target_path, dest_path]) != dest_path: + raise OutsideDestinationError(member, target_path) + # Limit permissions (no high bits, and go-w) + mode = member.mode + if mode is not None: + # Strip high bits & group/other write bits + mode = mode & 0o755 + if for_data: + # For data, handle permissions & file types + if member.isreg() or member.islnk(): + if not mode & 0o100: + # Clear executable bits if not executable by user + mode &= ~0o111 + # Ensure owner can read & write + mode |= 0o600 + elif member.isdir() or member.issym(): + # Ignore mode for directories & symlinks + mode = None + else: + # Reject special files + raise SpecialFileError(member) + if mode != member.mode: + new_attrs['mode'] = mode + if for_data: + # Ignore ownership for 'data' + if member.uid is not None: + new_attrs['uid'] = None + if member.gid is not None: + new_attrs['gid'] = None + if member.uname is not None: + new_attrs['uname'] = None + if member.gname is not None: + new_attrs['gname'] = None + # Check link destination for 'data' + if member.islnk() or member.issym(): + if os.path.isabs(member.linkname): + raise AbsoluteLinkError(member) + if member.issym(): + target_path = os.path.join(dest_path, + os.path.dirname(name), + member.linkname) + else: + target_path = os.path.join(dest_path, + member.linkname) + target_path = os.path.realpath(target_path) + if os.path.commonpath([target_path, dest_path]) != dest_path: + raise LinkOutsideDestinationError(member, target_path) + return new_attrs + +def fully_trusted_filter(member, dest_path): + return member + +def tar_filter(member, dest_path): + new_attrs = _get_filtered_attrs(member, dest_path, False) + if new_attrs: + return member.replace(**new_attrs, deep=False) + return member + +def data_filter(member, dest_path): + new_attrs = _get_filtered_attrs(member, dest_path, True) + if new_attrs: + return member.replace(**new_attrs, deep=False) + return member + +_NAMED_FILTERS = { + "fully_trusted": fully_trusted_filter, + "tar": tar_filter, + "data": data_filter, +} + +#------------------ +# Exported Classes +#------------------ + +# Sentinel for replace() defaults, meaning "don't change the attribute" +_KEEP = object() + +class TarInfo(object): + """Informational class which holds the details about an + archive member given by a tar header block. + TarInfo objects are returned by TarFile.getmember(), + TarFile.getmembers() and TarFile.gettarinfo() and are + usually created internally. + """ + + __slots__ = dict( + name = 'Name of the archive member.', + mode = 'Permission bits.', + uid = 'User ID of the user who originally stored this member.', + gid = 'Group ID of the user who originally stored this member.', + size = 'Size in bytes.', + mtime = 'Time of last modification.', + chksum = 'Header checksum.', + type = ('File type. type is usually one of these constants: ' + 'REGTYPE, AREGTYPE, LNKTYPE, SYMTYPE, DIRTYPE, FIFOTYPE, ' + 'CONTTYPE, CHRTYPE, BLKTYPE, GNUTYPE_SPARSE.'), + linkname = ('Name of the target file name, which is only present ' + 'in TarInfo objects of type LNKTYPE and SYMTYPE.'), + uname = 'User name.', + gname = 'Group name.', + devmajor = 'Device major number.', + devminor = 'Device minor number.', + offset = 'The tar header starts here.', + offset_data = "The file's data starts here.", + pax_headers = ('A dictionary containing key-value pairs of an ' + 'associated pax extended header.'), + sparse = 'Sparse member information.', + _tarfile = None, + _sparse_structs = None, + _link_target = None, + ) + + def __init__(self, name=""): + """Construct a TarInfo object. name is the optional name + of the member. + """ + self.name = name # member name + self.mode = 0o644 # file permissions + self.uid = 0 # user id + self.gid = 0 # group id + self.size = 0 # file size + self.mtime = 0 # modification time + self.chksum = 0 # header checksum + self.type = REGTYPE # member type + self.linkname = "" # link name + self.uname = "" # user name + self.gname = "" # group name + self.devmajor = 0 # device major number + self.devminor = 0 # device minor number + + self.offset = 0 # the tar header starts here + self.offset_data = 0 # the file's data starts here + + self.sparse = None # sparse member information + self.pax_headers = {} # pax header information + + @property + def tarfile(self): + import warnings + warnings.warn( + 'The undocumented "tarfile" attribute of TarInfo objects ' + + 'is deprecated and will be removed in Python 3.16', + DeprecationWarning, stacklevel=2) + return self._tarfile + + @tarfile.setter + def tarfile(self, tarfile): + import warnings + warnings.warn( + 'The undocumented "tarfile" attribute of TarInfo objects ' + + 'is deprecated and will be removed in Python 3.16', + DeprecationWarning, stacklevel=2) + self._tarfile = tarfile + + @property + def path(self): + 'In pax headers, "name" is called "path".' + return self.name + + @path.setter + def path(self, name): + self.name = name + + @property + def linkpath(self): + 'In pax headers, "linkname" is called "linkpath".' + return self.linkname + + @linkpath.setter + def linkpath(self, linkname): + self.linkname = linkname + + def __repr__(self): + return "<%s %r at %#x>" % (self.__class__.__name__,self.name,id(self)) + + def replace(self, *, + name=_KEEP, mtime=_KEEP, mode=_KEEP, linkname=_KEEP, + uid=_KEEP, gid=_KEEP, uname=_KEEP, gname=_KEEP, + deep=True, _KEEP=_KEEP): + """Return a deep copy of self with the given attributes replaced. + """ + if deep: + result = copy.deepcopy(self) + else: + result = copy.copy(self) + if name is not _KEEP: + result.name = name + if mtime is not _KEEP: + result.mtime = mtime + if mode is not _KEEP: + result.mode = mode + if linkname is not _KEEP: + result.linkname = linkname + if uid is not _KEEP: + result.uid = uid + if gid is not _KEEP: + result.gid = gid + if uname is not _KEEP: + result.uname = uname + if gname is not _KEEP: + result.gname = gname + return result + + def get_info(self): + """Return the TarInfo's attributes as a dictionary. + """ + if self.mode is None: + mode = None + else: + mode = self.mode & 0o7777 + info = { + "name": self.name, + "mode": mode, + "uid": self.uid, + "gid": self.gid, + "size": self.size, + "mtime": self.mtime, + "chksum": self.chksum, + "type": self.type, + "linkname": self.linkname, + "uname": self.uname, + "gname": self.gname, + "devmajor": self.devmajor, + "devminor": self.devminor + } + + if info["type"] == DIRTYPE and not info["name"].endswith("/"): + info["name"] += "/" + + return info + + def tobuf(self, format=DEFAULT_FORMAT, encoding=ENCODING, errors="surrogateescape"): + """Return a tar header as a string of 512 byte blocks. + """ + info = self.get_info() + for name, value in info.items(): + if value is None: + raise ValueError("%s may not be None" % name) + + if format == USTAR_FORMAT: + return self.create_ustar_header(info, encoding, errors) + elif format == GNU_FORMAT: + return self.create_gnu_header(info, encoding, errors) + elif format == PAX_FORMAT: + return self.create_pax_header(info, encoding) + else: + raise ValueError("invalid format") + + def create_ustar_header(self, info, encoding, errors): + """Return the object as a ustar header block. + """ + info["magic"] = POSIX_MAGIC + + if len(info["linkname"].encode(encoding, errors)) > LENGTH_LINK: + raise ValueError("linkname is too long") + + if len(info["name"].encode(encoding, errors)) > LENGTH_NAME: + info["prefix"], info["name"] = self._posix_split_name(info["name"], encoding, errors) + + return self._create_header(info, USTAR_FORMAT, encoding, errors) + + def create_gnu_header(self, info, encoding, errors): + """Return the object as a GNU header block sequence. + """ + info["magic"] = GNU_MAGIC + + buf = b"" + if len(info["linkname"].encode(encoding, errors)) > LENGTH_LINK: + buf += self._create_gnu_long_header(info["linkname"], GNUTYPE_LONGLINK, encoding, errors) + + if len(info["name"].encode(encoding, errors)) > LENGTH_NAME: + buf += self._create_gnu_long_header(info["name"], GNUTYPE_LONGNAME, encoding, errors) + + return buf + self._create_header(info, GNU_FORMAT, encoding, errors) + + def create_pax_header(self, info, encoding): + """Return the object as a ustar header block. If it cannot be + represented this way, prepend a pax extended header sequence + with supplement information. + """ + info["magic"] = POSIX_MAGIC + pax_headers = self.pax_headers.copy() + + # Test string fields for values that exceed the field length or cannot + # be represented in ASCII encoding. + for name, hname, length in ( + ("name", "path", LENGTH_NAME), ("linkname", "linkpath", LENGTH_LINK), + ("uname", "uname", 32), ("gname", "gname", 32)): + + if hname in pax_headers: + # The pax header has priority. + continue + + # Try to encode the string as ASCII. + try: + info[name].encode("ascii", "strict") + except UnicodeEncodeError: + pax_headers[hname] = info[name] + continue + + if len(info[name]) > length: + pax_headers[hname] = info[name] + + # Test number fields for values that exceed the field limit or values + # that like to be stored as float. + for name, digits in (("uid", 8), ("gid", 8), ("size", 12), ("mtime", 12)): + needs_pax = False + + val = info[name] + val_is_float = isinstance(val, float) + val_int = round(val) if val_is_float else val + if not 0 <= val_int < 8 ** (digits - 1): + # Avoid overflow. + info[name] = 0 + needs_pax = True + elif val_is_float: + # Put rounded value in ustar header, and full + # precision value in pax header. + info[name] = val_int + needs_pax = True + + # The existing pax header has priority. + if needs_pax and name not in pax_headers: + pax_headers[name] = str(val) + + # Create a pax extended header if necessary. + if pax_headers: + buf = self._create_pax_generic_header(pax_headers, XHDTYPE, encoding) + else: + buf = b"" + + return buf + self._create_header(info, USTAR_FORMAT, "ascii", "replace") + + @classmethod + def create_pax_global_header(cls, pax_headers): + """Return the object as a pax global header block sequence. + """ + return cls._create_pax_generic_header(pax_headers, XGLTYPE, "utf-8") + + def _posix_split_name(self, name, encoding, errors): + """Split a name longer than 100 chars into a prefix + and a name part. + """ + components = name.split("/") + for i in range(1, len(components)): + prefix = "/".join(components[:i]) + name = "/".join(components[i:]) + if len(prefix.encode(encoding, errors)) <= LENGTH_PREFIX and \ + len(name.encode(encoding, errors)) <= LENGTH_NAME: + break + else: + raise ValueError("name is too long") + + return prefix, name + + @staticmethod + def _create_header(info, format, encoding, errors): + """Return a header block. info is a dictionary with file + information, format must be one of the *_FORMAT constants. + """ + has_device_fields = info.get("type") in (CHRTYPE, BLKTYPE) + if has_device_fields: + devmajor = itn(info.get("devmajor", 0), 8, format) + devminor = itn(info.get("devminor", 0), 8, format) + else: + devmajor = stn("", 8, encoding, errors) + devminor = stn("", 8, encoding, errors) + + # None values in metadata should cause ValueError. + # itn()/stn() do this for all fields except type. + filetype = info.get("type", REGTYPE) + if filetype is None: + raise ValueError("TarInfo.type must not be None") + + parts = [ + stn(info.get("name", ""), 100, encoding, errors), + itn(info.get("mode", 0) & 0o7777, 8, format), + itn(info.get("uid", 0), 8, format), + itn(info.get("gid", 0), 8, format), + itn(info.get("size", 0), 12, format), + itn(info.get("mtime", 0), 12, format), + b" ", # checksum field + filetype, + stn(info.get("linkname", ""), 100, encoding, errors), + info.get("magic", POSIX_MAGIC), + stn(info.get("uname", ""), 32, encoding, errors), + stn(info.get("gname", ""), 32, encoding, errors), + devmajor, + devminor, + stn(info.get("prefix", ""), 155, encoding, errors) + ] + + buf = struct.pack("%ds" % BLOCKSIZE, b"".join(parts)) + chksum = calc_chksums(buf[-BLOCKSIZE:])[0] + buf = buf[:-364] + bytes("%06o\0" % chksum, "ascii") + buf[-357:] + return buf + + @staticmethod + def _create_payload(payload): + """Return the string payload filled with zero bytes + up to the next 512 byte border. + """ + blocks, remainder = divmod(len(payload), BLOCKSIZE) + if remainder > 0: + payload += (BLOCKSIZE - remainder) * NUL + return payload + + @classmethod + def _create_gnu_long_header(cls, name, type, encoding, errors): + """Return a GNUTYPE_LONGNAME or GNUTYPE_LONGLINK sequence + for name. + """ + name = name.encode(encoding, errors) + NUL + + info = {} + info["name"] = "././@LongLink" + info["type"] = type + info["size"] = len(name) + info["magic"] = GNU_MAGIC + + # create extended header + name blocks. + return cls._create_header(info, USTAR_FORMAT, encoding, errors) + \ + cls._create_payload(name) + + @classmethod + def _create_pax_generic_header(cls, pax_headers, type, encoding): + """Return a POSIX.1-2008 extended or global header sequence + that contains a list of keyword, value pairs. The values + must be strings. + """ + # Check if one of the fields contains surrogate characters and thereby + # forces hdrcharset=BINARY, see _proc_pax() for more information. + binary = False + for keyword, value in pax_headers.items(): + try: + value.encode("utf-8", "strict") + except UnicodeEncodeError: + binary = True + break + + records = b"" + if binary: + # Put the hdrcharset field at the beginning of the header. + records += b"21 hdrcharset=BINARY\n" + + for keyword, value in pax_headers.items(): + keyword = keyword.encode("utf-8") + if binary: + # Try to restore the original byte representation of 'value'. + # Needless to say, that the encoding must match the string. + value = value.encode(encoding, "surrogateescape") + else: + value = value.encode("utf-8") + + l = len(keyword) + len(value) + 3 # ' ' + '=' + '\n' + n = p = 0 + while True: + n = l + len(str(p)) + if n == p: + break + p = n + records += bytes(str(p), "ascii") + b" " + keyword + b"=" + value + b"\n" + + # We use a hardcoded "././@PaxHeader" name like star does + # instead of the one that POSIX recommends. + info = {} + info["name"] = "././@PaxHeader" + info["type"] = type + info["size"] = len(records) + info["magic"] = POSIX_MAGIC + + # Create pax header + record blocks. + return cls._create_header(info, USTAR_FORMAT, "ascii", "replace") + \ + cls._create_payload(records) + + @classmethod + def frombuf(cls, buf, encoding, errors): + """Construct a TarInfo object from a 512 byte bytes object. + """ + if len(buf) == 0: + raise EmptyHeaderError("empty header") + if len(buf) != BLOCKSIZE: + raise TruncatedHeaderError("truncated header") + if buf.count(NUL) == BLOCKSIZE: + raise EOFHeaderError("end of file header") + + chksum = nti(buf[148:156]) + if chksum not in calc_chksums(buf): + raise InvalidHeaderError("bad checksum") + + obj = cls() + obj.name = nts(buf[0:100], encoding, errors) + obj.mode = nti(buf[100:108]) + obj.uid = nti(buf[108:116]) + obj.gid = nti(buf[116:124]) + obj.size = nti(buf[124:136]) + obj.mtime = nti(buf[136:148]) + obj.chksum = chksum + obj.type = buf[156:157] + obj.linkname = nts(buf[157:257], encoding, errors) + obj.uname = nts(buf[265:297], encoding, errors) + obj.gname = nts(buf[297:329], encoding, errors) + obj.devmajor = nti(buf[329:337]) + obj.devminor = nti(buf[337:345]) + prefix = nts(buf[345:500], encoding, errors) + + # Old V7 tar format represents a directory as a regular + # file with a trailing slash. + if obj.type == AREGTYPE and obj.name.endswith("/"): + obj.type = DIRTYPE + + # The old GNU sparse format occupies some of the unused + # space in the buffer for up to 4 sparse structures. + # Save them for later processing in _proc_sparse(). + if obj.type == GNUTYPE_SPARSE: + pos = 386 + structs = [] + for i in range(4): + try: + offset = nti(buf[pos:pos + 12]) + numbytes = nti(buf[pos + 12:pos + 24]) + except ValueError: + break + structs.append((offset, numbytes)) + pos += 24 + isextended = bool(buf[482]) + origsize = nti(buf[483:495]) + obj._sparse_structs = (structs, isextended, origsize) + + # Remove redundant slashes from directories. + if obj.isdir(): + obj.name = obj.name.rstrip("/") + + # Reconstruct a ustar longname. + if prefix and obj.type not in GNU_TYPES: + obj.name = prefix + "/" + obj.name + return obj + + @classmethod + def fromtarfile(cls, tarfile): + """Return the next TarInfo object from TarFile object + tarfile. + """ + buf = tarfile.fileobj.read(BLOCKSIZE) + obj = cls.frombuf(buf, tarfile.encoding, tarfile.errors) + obj.offset = tarfile.fileobj.tell() - BLOCKSIZE + return obj._proc_member(tarfile) + + #-------------------------------------------------------------------------- + # The following are methods that are called depending on the type of a + # member. The entry point is _proc_member() which can be overridden in a + # subclass to add custom _proc_*() methods. A _proc_*() method MUST + # implement the following + # operations: + # 1. Set self.offset_data to the position where the data blocks begin, + # if there is data that follows. + # 2. Set tarfile.offset to the position where the next member's header will + # begin. + # 3. Return self or another valid TarInfo object. + def _proc_member(self, tarfile): + """Choose the right processing method depending on + the type and call it. + """ + if self.type in (GNUTYPE_LONGNAME, GNUTYPE_LONGLINK): + return self._proc_gnulong(tarfile) + elif self.type == GNUTYPE_SPARSE: + return self._proc_sparse(tarfile) + elif self.type in (XHDTYPE, XGLTYPE, SOLARIS_XHDTYPE): + return self._proc_pax(tarfile) + else: + return self._proc_builtin(tarfile) + + def _proc_builtin(self, tarfile): + """Process a builtin type or an unknown type which + will be treated as a regular file. + """ + self.offset_data = tarfile.fileobj.tell() + offset = self.offset_data + if self.isreg() or self.type not in SUPPORTED_TYPES: + # Skip the following data blocks. + offset += self._block(self.size) + tarfile.offset = offset + + # Patch the TarInfo object with saved global + # header information. + self._apply_pax_info(tarfile.pax_headers, tarfile.encoding, tarfile.errors) + + # Remove redundant slashes from directories. This is to be consistent + # with frombuf(). + if self.isdir(): + self.name = self.name.rstrip("/") + + return self + + def _proc_gnulong(self, tarfile): + """Process the blocks that hold a GNU longname + or longlink member. + """ + buf = tarfile.fileobj.read(self._block(self.size)) + + # Fetch the next header and process it. + try: + next = self.fromtarfile(tarfile) + except HeaderError as e: + raise SubsequentHeaderError(str(e)) from None + + # Patch the TarInfo object from the next header with + # the longname information. + next.offset = self.offset + if self.type == GNUTYPE_LONGNAME: + next.name = nts(buf, tarfile.encoding, tarfile.errors) + elif self.type == GNUTYPE_LONGLINK: + next.linkname = nts(buf, tarfile.encoding, tarfile.errors) + + # Remove redundant slashes from directories. This is to be consistent + # with frombuf(). + if next.isdir(): + next.name = removesuffix(next.name, "/") + + return next + + def _proc_sparse(self, tarfile): + """Process a GNU sparse header plus extra headers. + """ + # We already collected some sparse structures in frombuf(). + structs, isextended, origsize = self._sparse_structs + del self._sparse_structs + + # Collect sparse structures from extended header blocks. + while isextended: + buf = tarfile.fileobj.read(BLOCKSIZE) + pos = 0 + for i in range(21): + try: + offset = nti(buf[pos:pos + 12]) + numbytes = nti(buf[pos + 12:pos + 24]) + except ValueError: + break + if offset and numbytes: + structs.append((offset, numbytes)) + pos += 24 + isextended = bool(buf[504]) + self.sparse = structs + + self.offset_data = tarfile.fileobj.tell() + tarfile.offset = self.offset_data + self._block(self.size) + self.size = origsize + return self + + def _proc_pax(self, tarfile): + """Process an extended or global header as described in + POSIX.1-2008. + """ + # Read the header information. + buf = tarfile.fileobj.read(self._block(self.size)) + + # A pax header stores supplemental information for either + # the following file (extended) or all following files + # (global). + if self.type == XGLTYPE: + pax_headers = tarfile.pax_headers + else: + pax_headers = tarfile.pax_headers.copy() + + # Check if the pax header contains a hdrcharset field. This tells us + # the encoding of the path, linkpath, uname and gname fields. Normally, + # these fields are UTF-8 encoded but since POSIX.1-2008 tar + # implementations are allowed to store them as raw binary strings if + # the translation to UTF-8 fails. + match = re.search(br"\d+ hdrcharset=([^\n]+)\n", buf) + if match is not None: + pax_headers["hdrcharset"] = match.group(1).decode("utf-8") + + # For the time being, we don't care about anything other than "BINARY". + # The only other value that is currently allowed by the standard is + # "ISO-IR 10646 2000 UTF-8" in other words UTF-8. + hdrcharset = pax_headers.get("hdrcharset") + if hdrcharset == "BINARY": + encoding = tarfile.encoding + else: + encoding = "utf-8" + + # Parse pax header information. A record looks like that: + # "%d %s=%s\n" % (length, keyword, value). length is the size + # of the complete record including the length field itself and + # the newline. keyword and value are both UTF-8 encoded strings. + regex = re.compile(br"(\d+) ([^=]+)=") + pos = 0 + while match := regex.match(buf, pos): + length, keyword = match.groups() + length = int(length) + if length == 0: + raise InvalidHeaderError("invalid header") + value = buf[match.end(2) + 1:match.start(1) + length - 1] + + # Normally, we could just use "utf-8" as the encoding and "strict" + # as the error handler, but we better not take the risk. For + # example, GNU tar <= 1.23 is known to store filenames it cannot + # translate to UTF-8 as raw strings (unfortunately without a + # hdrcharset=BINARY header). + # We first try the strict standard encoding, and if that fails we + # fall back on the user's encoding and error handler. + keyword = self._decode_pax_field(keyword, "utf-8", "utf-8", + tarfile.errors) + if keyword in PAX_NAME_FIELDS: + value = self._decode_pax_field(value, encoding, tarfile.encoding, + tarfile.errors) + else: + value = self._decode_pax_field(value, "utf-8", "utf-8", + tarfile.errors) + + pax_headers[keyword] = value + pos += length + + # Fetch the next header. + try: + next = self.fromtarfile(tarfile) + except HeaderError as e: + raise SubsequentHeaderError(str(e)) from None + + # Process GNU sparse information. + if "GNU.sparse.map" in pax_headers: + # GNU extended sparse format version 0.1. + self._proc_gnusparse_01(next, pax_headers) + + elif "GNU.sparse.size" in pax_headers: + # GNU extended sparse format version 0.0. + self._proc_gnusparse_00(next, pax_headers, buf) + + elif pax_headers.get("GNU.sparse.major") == "1" and pax_headers.get("GNU.sparse.minor") == "0": + # GNU extended sparse format version 1.0. + self._proc_gnusparse_10(next, pax_headers, tarfile) + + if self.type in (XHDTYPE, SOLARIS_XHDTYPE): + # Patch the TarInfo object with the extended header info. + next._apply_pax_info(pax_headers, tarfile.encoding, tarfile.errors) + next.offset = self.offset + + if "size" in pax_headers: + # If the extended header replaces the size field, + # we need to recalculate the offset where the next + # header starts. + offset = next.offset_data + if next.isreg() or next.type not in SUPPORTED_TYPES: + offset += next._block(next.size) + tarfile.offset = offset + + return next + + def _proc_gnusparse_00(self, next, pax_headers, buf): + """Process a GNU tar extended sparse header, version 0.0. + """ + offsets = [] + for match in re.finditer(br"\d+ GNU.sparse.offset=(\d+)\n", buf): + offsets.append(int(match.group(1))) + numbytes = [] + for match in re.finditer(br"\d+ GNU.sparse.numbytes=(\d+)\n", buf): + numbytes.append(int(match.group(1))) + next.sparse = list(zip(offsets, numbytes)) + + def _proc_gnusparse_01(self, next, pax_headers): + """Process a GNU tar extended sparse header, version 0.1. + """ + sparse = [int(x) for x in pax_headers["GNU.sparse.map"].split(",")] + next.sparse = list(zip(sparse[::2], sparse[1::2])) + + def _proc_gnusparse_10(self, next, pax_headers, tarfile): + """Process a GNU tar extended sparse header, version 1.0. + """ + fields = None + sparse = [] + buf = tarfile.fileobj.read(BLOCKSIZE) + fields, buf = buf.split(b"\n", 1) + fields = int(fields) + while len(sparse) < fields * 2: + if b"\n" not in buf: + buf += tarfile.fileobj.read(BLOCKSIZE) + number, buf = buf.split(b"\n", 1) + sparse.append(int(number)) + next.offset_data = tarfile.fileobj.tell() + next.sparse = list(zip(sparse[::2], sparse[1::2])) + + def _apply_pax_info(self, pax_headers, encoding, errors): + """Replace fields with supplemental information from a previous + pax extended or global header. + """ + for keyword, value in pax_headers.items(): + if keyword == "GNU.sparse.name": + setattr(self, "path", value) + elif keyword == "GNU.sparse.size": + setattr(self, "size", int(value)) + elif keyword == "GNU.sparse.realsize": + setattr(self, "size", int(value)) + elif keyword in PAX_FIELDS: + if keyword in PAX_NUMBER_FIELDS: + try: + value = PAX_NUMBER_FIELDS[keyword](value) + except ValueError: + value = 0 + if keyword == "path": + value = value.rstrip("/") + setattr(self, keyword, value) + + self.pax_headers = pax_headers.copy() + + def _decode_pax_field(self, value, encoding, fallback_encoding, fallback_errors): + """Decode a single field from a pax record. + """ + try: + return value.decode(encoding, "strict") + except UnicodeDecodeError: + return value.decode(fallback_encoding, fallback_errors) + + def _block(self, count): + """Round up a byte count by BLOCKSIZE and return it, + e.g. _block(834) => 1024. + """ + blocks, remainder = divmod(count, BLOCKSIZE) + if remainder: + blocks += 1 + return blocks * BLOCKSIZE + + def isreg(self): + 'Return True if the Tarinfo object is a regular file.' + return self.type in REGULAR_TYPES + + def isfile(self): + 'Return True if the Tarinfo object is a regular file.' + return self.isreg() + + def isdir(self): + 'Return True if it is a directory.' + return self.type == DIRTYPE + + def issym(self): + 'Return True if it is a symbolic link.' + return self.type == SYMTYPE + + def islnk(self): + 'Return True if it is a hard link.' + return self.type == LNKTYPE + + def ischr(self): + 'Return True if it is a character device.' + return self.type == CHRTYPE + + def isblk(self): + 'Return True if it is a block device.' + return self.type == BLKTYPE + + def isfifo(self): + 'Return True if it is a FIFO.' + return self.type == FIFOTYPE + + def issparse(self): + return self.sparse is not None + + def isdev(self): + 'Return True if it is one of character device, block device or FIFO.' + return self.type in (CHRTYPE, BLKTYPE, FIFOTYPE) +# class TarInfo + +class TarFile(object): + """The TarFile Class provides an interface to tar archives. + """ + + debug = 0 # May be set from 0 (no msgs) to 3 (all msgs) + + dereference = False # If true, add content of linked file to the + # tar file, else the link. + + ignore_zeros = False # If true, skips empty or invalid blocks and + # continues processing. + + errorlevel = 1 # If 0, fatal errors only appear in debug + # messages (if debug >= 0). If > 0, errors + # are passed to the caller as exceptions. + + format = DEFAULT_FORMAT # The format to use when creating an archive. + + encoding = ENCODING # Encoding for 8-bit character strings. + + errors = None # Error handler for unicode conversion. + + tarinfo = TarInfo # The default TarInfo class to use. + + fileobject = ExFileObject # The file-object for extractfile(). + + extraction_filter = None # The default filter for extraction. + + def __init__(self, name=None, mode="r", fileobj=None, format=None, + tarinfo=None, dereference=None, ignore_zeros=None, encoding=None, + errors="surrogateescape", pax_headers=None, debug=None, + errorlevel=None, copybufsize=None, stream=False): + """Open an (uncompressed) tar archive 'name'. 'mode' is either 'r' to + read from an existing archive, 'a' to append data to an existing + file or 'w' to create a new file overwriting an existing one. 'mode' + defaults to 'r'. + If 'fileobj' is given, it is used for reading or writing data. If it + can be determined, 'mode' is overridden by 'fileobj's mode. + 'fileobj' is not closed, when TarFile is closed. + """ + modes = {"r": "rb", "a": "r+b", "w": "wb", "x": "xb"} + if mode not in modes: + raise ValueError("mode must be 'r', 'a', 'w' or 'x'") + self.mode = mode + self._mode = modes[mode] + + if not fileobj: + if self.mode == "a" and not os.path.exists(name): + # Create nonexistent files in append mode. + self.mode = "w" + self._mode = "wb" + fileobj = bltn_open(name, self._mode) + self._extfileobj = False + else: + if (name is None and hasattr(fileobj, "name") and + isinstance(fileobj.name, (str, bytes))): + name = fileobj.name + if hasattr(fileobj, "mode"): + self._mode = fileobj.mode + self._extfileobj = True + self.name = os.path.abspath(name) if name else None + self.fileobj = fileobj + + self.stream = stream + + # Init attributes. + if format is not None: + self.format = format + if tarinfo is not None: + self.tarinfo = tarinfo + if dereference is not None: + self.dereference = dereference + if ignore_zeros is not None: + self.ignore_zeros = ignore_zeros + if encoding is not None: + self.encoding = encoding + self.errors = errors + + if pax_headers is not None and self.format == PAX_FORMAT: + self.pax_headers = pax_headers + else: + self.pax_headers = {} + + if debug is not None: + self.debug = debug + if errorlevel is not None: + self.errorlevel = errorlevel + + # Init datastructures. + self.copybufsize = copybufsize + self.closed = False + self.members = [] # list of members as TarInfo objects + self._loaded = False # flag if all members have been read + self.offset = self.fileobj.tell() + # current position in the archive file + self.inodes = {} # dictionary caching the inodes of + # archive members already added + + try: + if self.mode == "r": + self.firstmember = None + self.firstmember = self.next() + + if self.mode == "a": + # Move to the end of the archive, + # before the first empty block. + while True: + self.fileobj.seek(self.offset) + try: + tarinfo = self.tarinfo.fromtarfile(self) + self.members.append(tarinfo) + except EOFHeaderError: + self.fileobj.seek(self.offset) + break + except HeaderError as e: + raise ReadError(str(e)) from None + + if self.mode in ("a", "w", "x"): + self._loaded = True + + if self.pax_headers: + buf = self.tarinfo.create_pax_global_header(self.pax_headers.copy()) + self.fileobj.write(buf) + self.offset += len(buf) + except: + if not self._extfileobj: + self.fileobj.close() + self.closed = True + raise + + #-------------------------------------------------------------------------- + # Below are the classmethods which act as alternate constructors to the + # TarFile class. The open() method is the only one that is needed for + # public use; it is the "super"-constructor and is able to select an + # adequate "sub"-constructor for a particular compression using the mapping + # from OPEN_METH. + # + # This concept allows one to subclass TarFile without losing the comfort of + # the super-constructor. A sub-constructor is registered and made available + # by adding it to the mapping in OPEN_METH. + + @classmethod + def open(cls, name=None, mode="r", fileobj=None, bufsize=RECORDSIZE, **kwargs): + r"""Open a tar archive for reading, writing or appending. Return + an appropriate TarFile class. + + mode: + 'r' or 'r:\*' open for reading with transparent compression + 'r:' open for reading exclusively uncompressed + 'r:gz' open for reading with gzip compression + 'r:bz2' open for reading with bzip2 compression + 'r:xz' open for reading with lzma compression + 'a' or 'a:' open for appending, creating the file if necessary + 'w' or 'w:' open for writing without compression + 'w:gz' open for writing with gzip compression + 'w:bz2' open for writing with bzip2 compression + 'w:xz' open for writing with lzma compression + + 'x' or 'x:' create a tarfile exclusively without compression, raise + an exception if the file is already created + 'x:gz' create a gzip compressed tarfile, raise an exception + if the file is already created + 'x:bz2' create a bzip2 compressed tarfile, raise an exception + if the file is already created + 'x:xz' create an lzma compressed tarfile, raise an exception + if the file is already created + + 'r|\*' open a stream of tar blocks with transparent compression + 'r|' open an uncompressed stream of tar blocks for reading + 'r|gz' open a gzip compressed stream of tar blocks + 'r|bz2' open a bzip2 compressed stream of tar blocks + 'r|xz' open an lzma compressed stream of tar blocks + 'w|' open an uncompressed stream for writing + 'w|gz' open a gzip compressed stream for writing + 'w|bz2' open a bzip2 compressed stream for writing + 'w|xz' open an lzma compressed stream for writing + """ + + if not name and not fileobj: + raise ValueError("nothing to open") + + if mode in ("r", "r:*"): + # Find out which *open() is appropriate for opening the file. + def not_compressed(comptype): + return cls.OPEN_METH[comptype] == 'taropen' + error_msgs = [] + for comptype in sorted(cls.OPEN_METH, key=not_compressed): + func = getattr(cls, cls.OPEN_METH[comptype]) + if fileobj is not None: + saved_pos = fileobj.tell() + try: + return func(name, "r", fileobj, **kwargs) + except (ReadError, CompressionError) as e: + error_msgs.append(f'- method {comptype}: {e!r}') + if fileobj is not None: + fileobj.seek(saved_pos) + continue + error_msgs_summary = '\n'.join(error_msgs) + raise ReadError(f"file could not be opened successfully:\n{error_msgs_summary}") + + elif ":" in mode: + filemode, comptype = mode.split(":", 1) + filemode = filemode or "r" + comptype = comptype or "tar" + + # Select the *open() function according to + # given compression. + if comptype in cls.OPEN_METH: + func = getattr(cls, cls.OPEN_METH[comptype]) + else: + raise CompressionError("unknown compression type %r" % comptype) + return func(name, filemode, fileobj, **kwargs) + + elif "|" in mode: + filemode, comptype = mode.split("|", 1) + filemode = filemode or "r" + comptype = comptype or "tar" + + if filemode not in ("r", "w"): + raise ValueError("mode must be 'r' or 'w'") + + compresslevel = kwargs.pop("compresslevel", 9) + stream = _Stream(name, filemode, comptype, fileobj, bufsize, + compresslevel) + try: + t = cls(name, filemode, stream, **kwargs) + except: + stream.close() + raise + t._extfileobj = False + return t + + elif mode in ("a", "w", "x"): + return cls.taropen(name, mode, fileobj, **kwargs) + + raise ValueError("undiscernible mode") + + @classmethod + def taropen(cls, name, mode="r", fileobj=None, **kwargs): + """Open uncompressed tar archive name for reading or writing. + """ + if mode not in ("r", "a", "w", "x"): + raise ValueError("mode must be 'r', 'a', 'w' or 'x'") + return cls(name, mode, fileobj, **kwargs) + + @classmethod + def gzopen(cls, name, mode="r", fileobj=None, compresslevel=9, **kwargs): + """Open gzip compressed tar archive name for reading or writing. + Appending is not allowed. + """ + if mode not in ("r", "w", "x"): + raise ValueError("mode must be 'r', 'w' or 'x'") + + try: + from gzip import GzipFile + except ImportError: + raise CompressionError("gzip module is not available") from None + + try: + fileobj = GzipFile(name, mode + "b", compresslevel, fileobj) + except OSError as e: + if fileobj is not None and mode == 'r': + raise ReadError("not a gzip file") from e + raise + + try: + t = cls.taropen(name, mode, fileobj, **kwargs) + except OSError as e: + fileobj.close() + if mode == 'r': + raise ReadError("not a gzip file") from e + raise + except: + fileobj.close() + raise + t._extfileobj = False + return t + + @classmethod + def bz2open(cls, name, mode="r", fileobj=None, compresslevel=9, **kwargs): + """Open bzip2 compressed tar archive name for reading or writing. + Appending is not allowed. + """ + if mode not in ("r", "w", "x"): + raise ValueError("mode must be 'r', 'w' or 'x'") + + try: + from bz2 import BZ2File + except ImportError: + raise CompressionError("bz2 module is not available") from None + + fileobj = BZ2File(fileobj or name, mode, compresslevel=compresslevel) + + try: + t = cls.taropen(name, mode, fileobj, **kwargs) + except (OSError, EOFError) as e: + fileobj.close() + if mode == 'r': + raise ReadError("not a bzip2 file") from e + raise + except: + fileobj.close() + raise + t._extfileobj = False + return t + + @classmethod + def xzopen(cls, name, mode="r", fileobj=None, preset=None, **kwargs): + """Open lzma compressed tar archive name for reading or writing. + Appending is not allowed. + """ + if mode not in ("r", "w", "x"): + raise ValueError("mode must be 'r', 'w' or 'x'") + + try: + from lzma import LZMAFile, LZMAError + except ImportError: + raise CompressionError("lzma module is not available") from None + + fileobj = LZMAFile(fileobj or name, mode, preset=preset) + + try: + t = cls.taropen(name, mode, fileobj, **kwargs) + except (LZMAError, EOFError) as e: + fileobj.close() + if mode == 'r': + raise ReadError("not an lzma file") from e + raise + except: + fileobj.close() + raise + t._extfileobj = False + return t + + # All *open() methods are registered here. + OPEN_METH = { + "tar": "taropen", # uncompressed tar + "gz": "gzopen", # gzip compressed tar + "bz2": "bz2open", # bzip2 compressed tar + "xz": "xzopen" # lzma compressed tar + } + + #-------------------------------------------------------------------------- + # The public methods which TarFile provides: + + def close(self): + """Close the TarFile. In write-mode, two finishing zero blocks are + appended to the archive. + """ + if self.closed: + return + + self.closed = True + try: + if self.mode in ("a", "w", "x"): + self.fileobj.write(NUL * (BLOCKSIZE * 2)) + self.offset += (BLOCKSIZE * 2) + # fill up the end with zero-blocks + # (like option -b20 for tar does) + blocks, remainder = divmod(self.offset, RECORDSIZE) + if remainder > 0: + self.fileobj.write(NUL * (RECORDSIZE - remainder)) + finally: + if not self._extfileobj: + self.fileobj.close() + + def getmember(self, name): + """Return a TarInfo object for member 'name'. If 'name' can not be + found in the archive, KeyError is raised. If a member occurs more + than once in the archive, its last occurrence is assumed to be the + most up-to-date version. + """ + tarinfo = self._getmember(name.rstrip('/')) + if tarinfo is None: + raise KeyError("filename %r not found" % name) + return tarinfo + + def getmembers(self): + """Return the members of the archive as a list of TarInfo objects. The + list has the same order as the members in the archive. + """ + self._check() + if not self._loaded: # if we want to obtain a list of + self._load() # all members, we first have to + # scan the whole archive. + return self.members + + def getnames(self): + """Return the members of the archive as a list of their names. It has + the same order as the list returned by getmembers(). + """ + return [tarinfo.name for tarinfo in self.getmembers()] + + def gettarinfo(self, name=None, arcname=None, fileobj=None): + """Create a TarInfo object from the result of os.stat or equivalent + on an existing file. The file is either named by 'name', or + specified as a file object 'fileobj' with a file descriptor. If + given, 'arcname' specifies an alternative name for the file in the + archive, otherwise, the name is taken from the 'name' attribute of + 'fileobj', or the 'name' argument. The name should be a text + string. + """ + self._check("awx") + + # When fileobj is given, replace name by + # fileobj's real name. + if fileobj is not None: + name = fileobj.name + + # Building the name of the member in the archive. + # Backward slashes are converted to forward slashes, + # Absolute paths are turned to relative paths. + if arcname is None: + arcname = name + drv, arcname = os.path.splitdrive(arcname) + arcname = arcname.replace(os.sep, "/") + arcname = arcname.lstrip("/") + + # Now, fill the TarInfo object with + # information specific for the file. + tarinfo = self.tarinfo() + tarinfo._tarfile = self # To be removed in 3.16. + + # Use os.stat or os.lstat, depending on if symlinks shall be resolved. + if fileobj is None: + if not self.dereference: + statres = os.lstat(name) + else: + statres = os.stat(name) + else: + statres = os.fstat(fileobj.fileno()) + linkname = "" + + stmd = statres.st_mode + if stat.S_ISREG(stmd): + inode = (statres.st_ino, statres.st_dev) + if not self.dereference and statres.st_nlink > 1 and \ + inode in self.inodes and arcname != self.inodes[inode]: + # Is it a hardlink to an already + # archived file? + type = LNKTYPE + linkname = self.inodes[inode] + else: + # The inode is added only if its valid. + # For win32 it is always 0. + type = REGTYPE + if inode[0]: + self.inodes[inode] = arcname + elif stat.S_ISDIR(stmd): + type = DIRTYPE + elif stat.S_ISFIFO(stmd): + type = FIFOTYPE + elif stat.S_ISLNK(stmd): + type = SYMTYPE + linkname = os.readlink(name) + elif stat.S_ISCHR(stmd): + type = CHRTYPE + elif stat.S_ISBLK(stmd): + type = BLKTYPE + else: + return None + + # Fill the TarInfo object with all + # information we can get. + tarinfo.name = arcname + tarinfo.mode = stmd + tarinfo.uid = statres.st_uid + tarinfo.gid = statres.st_gid + if type == REGTYPE: + tarinfo.size = statres.st_size + else: + tarinfo.size = 0 + tarinfo.mtime = statres.st_mtime + tarinfo.type = type + tarinfo.linkname = linkname + if pwd: + try: + tarinfo.uname = pwd.getpwuid(tarinfo.uid)[0] + except KeyError: + pass + if grp: + try: + tarinfo.gname = grp.getgrgid(tarinfo.gid)[0] + except KeyError: + pass + + if type in (CHRTYPE, BLKTYPE): + if hasattr(os, "major") and hasattr(os, "minor"): + tarinfo.devmajor = os.major(statres.st_rdev) + tarinfo.devminor = os.minor(statres.st_rdev) + return tarinfo + + def list(self, verbose=True, *, members=None): + """Print a table of contents to sys.stdout. If 'verbose' is False, only + the names of the members are printed. If it is True, an 'ls -l'-like + output is produced. 'members' is optional and must be a subset of the + list returned by getmembers(). + """ + # Convert tarinfo type to stat type. + type2mode = {REGTYPE: stat.S_IFREG, SYMTYPE: stat.S_IFLNK, + FIFOTYPE: stat.S_IFIFO, CHRTYPE: stat.S_IFCHR, + DIRTYPE: stat.S_IFDIR, BLKTYPE: stat.S_IFBLK} + self._check() + + if members is None: + members = self + for tarinfo in members: + if verbose: + if tarinfo.mode is None: + _safe_print("??????????") + else: + modetype = type2mode.get(tarinfo.type, 0) + _safe_print(stat.filemode(modetype | tarinfo.mode)) + _safe_print("%s/%s" % (tarinfo.uname or tarinfo.uid, + tarinfo.gname or tarinfo.gid)) + if tarinfo.ischr() or tarinfo.isblk(): + _safe_print("%10s" % + ("%d,%d" % (tarinfo.devmajor, tarinfo.devminor))) + else: + _safe_print("%10d" % tarinfo.size) + if tarinfo.mtime is None: + _safe_print("????-??-?? ??:??:??") + else: + _safe_print("%d-%02d-%02d %02d:%02d:%02d" \ + % time.localtime(tarinfo.mtime)[:6]) + + _safe_print(tarinfo.name + ("/" if tarinfo.isdir() else "")) + + if verbose: + if tarinfo.issym(): + _safe_print("-> " + tarinfo.linkname) + if tarinfo.islnk(): + _safe_print("link to " + tarinfo.linkname) + print() + + def add(self, name, arcname=None, recursive=True, *, filter=None): + """Add the file 'name' to the archive. 'name' may be any type of file + (directory, fifo, symbolic link, etc.). If given, 'arcname' + specifies an alternative name for the file in the archive. + Directories are added recursively by default. This can be avoided by + setting 'recursive' to False. 'filter' is a function + that expects a TarInfo object argument and returns the changed + TarInfo object, if it returns None the TarInfo object will be + excluded from the archive. + """ + self._check("awx") + + if arcname is None: + arcname = name + + # Skip if somebody tries to archive the archive... + if self.name is not None and os.path.abspath(name) == self.name: + self._dbg(2, "tarfile: Skipped %r" % name) + return + + self._dbg(1, name) + + # Create a TarInfo object from the file. + tarinfo = self.gettarinfo(name, arcname) + + if tarinfo is None: + self._dbg(1, "tarfile: Unsupported type %r" % name) + return + + # Change or exclude the TarInfo object. + if filter is not None: + tarinfo = filter(tarinfo) + if tarinfo is None: + self._dbg(2, "tarfile: Excluded %r" % name) + return + + # Append the tar header and data to the archive. + if tarinfo.isreg(): + with bltn_open(name, "rb") as f: + self.addfile(tarinfo, f) + + elif tarinfo.isdir(): + self.addfile(tarinfo) + if recursive: + for f in sorted(os.listdir(name)): + self.add(os.path.join(name, f), os.path.join(arcname, f), + recursive, filter=filter) + + else: + self.addfile(tarinfo) + + def addfile(self, tarinfo, fileobj=None): + """Add the TarInfo object 'tarinfo' to the archive. If 'tarinfo' represents + a non zero-size regular file, the 'fileobj' argument should be a binary file, + and tarinfo.size bytes are read from it and added to the archive. + You can create TarInfo objects directly, or by using gettarinfo(). + """ + self._check("awx") + + if fileobj is None and tarinfo.isreg() and tarinfo.size != 0: + raise ValueError("fileobj not provided for non zero-size regular file") + + tarinfo = copy.copy(tarinfo) + + buf = tarinfo.tobuf(self.format, self.encoding, self.errors) + self.fileobj.write(buf) + self.offset += len(buf) + bufsize=self.copybufsize + # If there's data to follow, append it. + if fileobj is not None: + copyfileobj(fileobj, self.fileobj, tarinfo.size, bufsize=bufsize) + blocks, remainder = divmod(tarinfo.size, BLOCKSIZE) + if remainder > 0: + self.fileobj.write(NUL * (BLOCKSIZE - remainder)) + blocks += 1 + self.offset += blocks * BLOCKSIZE + + self.members.append(tarinfo) + + def _get_filter_function(self, filter): + if filter is None: + filter = self.extraction_filter + if filter is None: + import warnings + warnings.warn( + 'Python 3.14 will, by default, filter extracted tar ' + + 'archives and reject files or modify their metadata. ' + + 'Use the filter argument to control this behavior.', + DeprecationWarning, stacklevel=3) + return fully_trusted_filter + if isinstance(filter, str): + raise TypeError( + 'String names are not supported for ' + + 'TarFile.extraction_filter. Use a function such as ' + + 'tarfile.data_filter directly.') + return filter + if callable(filter): + return filter + try: + return _NAMED_FILTERS[filter] + except KeyError: + raise ValueError(f"filter {filter!r} not found") from None + + def extractall(self, path=".", members=None, *, numeric_owner=False, + filter=None): + """Extract all members from the archive to the current working + directory and set owner, modification time and permissions on + directories afterwards. 'path' specifies a different directory + to extract to. 'members' is optional and must be a subset of the + list returned by getmembers(). If 'numeric_owner' is True, only + the numbers for user/group names are used and not the names. + + The 'filter' function will be called on each member just + before extraction. + It can return a changed TarInfo or None to skip the member. + String names of common filters are accepted. + """ + directories = [] + + filter_function = self._get_filter_function(filter) + if members is None: + members = self + + for member in members: + tarinfo = self._get_extract_tarinfo(member, filter_function, path) + if tarinfo is None: + continue + if tarinfo.isdir(): + # For directories, delay setting attributes until later, + # since permissions can interfere with extraction and + # extracting contents can reset mtime. + directories.append(tarinfo) + self._extract_one(tarinfo, path, set_attrs=not tarinfo.isdir(), + numeric_owner=numeric_owner) + + # Reverse sort directories. + directories.sort(key=lambda a: a.name, reverse=True) + + # Set correct owner, mtime and filemode on directories. + for tarinfo in directories: + dirpath = os.path.join(path, tarinfo.name) + try: + self.chown(tarinfo, dirpath, numeric_owner=numeric_owner) + self.utime(tarinfo, dirpath) + self.chmod(tarinfo, dirpath) + except ExtractError as e: + self._handle_nonfatal_error(e) + + def extract(self, member, path="", set_attrs=True, *, numeric_owner=False, + filter=None): + """Extract a member from the archive to the current working directory, + using its full name. Its file information is extracted as accurately + as possible. 'member' may be a filename or a TarInfo object. You can + specify a different directory using 'path'. File attributes (owner, + mtime, mode) are set unless 'set_attrs' is False. If 'numeric_owner' + is True, only the numbers for user/group names are used and not + the names. + + The 'filter' function will be called before extraction. + It can return a changed TarInfo or None to skip the member. + String names of common filters are accepted. + """ + filter_function = self._get_filter_function(filter) + tarinfo = self._get_extract_tarinfo(member, filter_function, path) + if tarinfo is not None: + self._extract_one(tarinfo, path, set_attrs, numeric_owner) + + def _get_extract_tarinfo(self, member, filter_function, path): + """Get filtered TarInfo (or None) from member, which might be a str""" + if isinstance(member, str): + tarinfo = self.getmember(member) + else: + tarinfo = member + + unfiltered = tarinfo + try: + tarinfo = filter_function(tarinfo, path) + except (OSError, FilterError) as e: + self._handle_fatal_error(e) + except ExtractError as e: + self._handle_nonfatal_error(e) + if tarinfo is None: + self._dbg(2, "tarfile: Excluded %r" % unfiltered.name) + return None + # Prepare the link target for makelink(). + if tarinfo.islnk(): + tarinfo = copy.copy(tarinfo) + tarinfo._link_target = os.path.join(path, tarinfo.linkname) + return tarinfo + + def _extract_one(self, tarinfo, path, set_attrs, numeric_owner): + """Extract from filtered tarinfo to disk""" + self._check("r") + + try: + self._extract_member(tarinfo, os.path.join(path, tarinfo.name), + set_attrs=set_attrs, + numeric_owner=numeric_owner) + except OSError as e: + self._handle_fatal_error(e) + except ExtractError as e: + self._handle_nonfatal_error(e) + + def _handle_nonfatal_error(self, e): + """Handle non-fatal error (ExtractError) according to errorlevel""" + if self.errorlevel > 1: + raise + else: + self._dbg(1, "tarfile: %s" % e) + + def _handle_fatal_error(self, e): + """Handle "fatal" error according to self.errorlevel""" + if self.errorlevel > 0: + raise + elif isinstance(e, OSError): + if e.filename is None: + self._dbg(1, "tarfile: %s" % e.strerror) + else: + self._dbg(1, "tarfile: %s %r" % (e.strerror, e.filename)) + else: + self._dbg(1, "tarfile: %s %s" % (type(e).__name__, e)) + + def extractfile(self, member): + """Extract a member from the archive as a file object. 'member' may be + a filename or a TarInfo object. If 'member' is a regular file or + a link, an io.BufferedReader object is returned. For all other + existing members, None is returned. If 'member' does not appear + in the archive, KeyError is raised. + """ + self._check("r") + + if isinstance(member, str): + tarinfo = self.getmember(member) + else: + tarinfo = member + + if tarinfo.isreg() or tarinfo.type not in SUPPORTED_TYPES: + # Members with unknown types are treated as regular files. + return self.fileobject(self, tarinfo) + + elif tarinfo.islnk() or tarinfo.issym(): + if isinstance(self.fileobj, _Stream): + # A small but ugly workaround for the case that someone tries + # to extract a (sym)link as a file-object from a non-seekable + # stream of tar blocks. + raise StreamError("cannot extract (sym)link as file object") + else: + # A (sym)link's file object is its target's file object. + return self.extractfile(self._find_link_target(tarinfo)) + else: + # If there's no data associated with the member (directory, chrdev, + # blkdev, etc.), return None instead of a file object. + return None + + def _extract_member(self, tarinfo, targetpath, set_attrs=True, + numeric_owner=False): + """Extract the TarInfo object tarinfo to a physical + file called targetpath. + """ + # Fetch the TarInfo object for the given name + # and build the destination pathname, replacing + # forward slashes to platform specific separators. + targetpath = targetpath.rstrip("/") + targetpath = targetpath.replace("/", os.sep) + + # Create all upper directories. + upperdirs = os.path.dirname(targetpath) + if upperdirs and not os.path.exists(upperdirs): + # Create directories that are not part of the archive with + # default permissions. + os.makedirs(upperdirs, exist_ok=True) + + if tarinfo.islnk() or tarinfo.issym(): + self._dbg(1, "%s -> %s" % (tarinfo.name, tarinfo.linkname)) + else: + self._dbg(1, tarinfo.name) + + if tarinfo.isreg(): + self.makefile(tarinfo, targetpath) + elif tarinfo.isdir(): + self.makedir(tarinfo, targetpath) + elif tarinfo.isfifo(): + self.makefifo(tarinfo, targetpath) + elif tarinfo.ischr() or tarinfo.isblk(): + self.makedev(tarinfo, targetpath) + elif tarinfo.islnk() or tarinfo.issym(): + self.makelink(tarinfo, targetpath) + elif tarinfo.type not in SUPPORTED_TYPES: + self.makeunknown(tarinfo, targetpath) + else: + self.makefile(tarinfo, targetpath) + + if set_attrs: + self.chown(tarinfo, targetpath, numeric_owner) + if not tarinfo.issym(): + self.chmod(tarinfo, targetpath) + self.utime(tarinfo, targetpath) + + #-------------------------------------------------------------------------- + # Below are the different file methods. They are called via + # _extract_member() when extract() is called. They can be replaced in a + # subclass to implement other functionality. + + def makedir(self, tarinfo, targetpath): + """Make a directory called targetpath. + """ + try: + if tarinfo.mode is None: + # Use the system's default mode + os.mkdir(targetpath) + else: + # Use a safe mode for the directory, the real mode is set + # later in _extract_member(). + os.mkdir(targetpath, 0o700) + except FileExistsError: + if not os.path.isdir(targetpath): + raise + + def makefile(self, tarinfo, targetpath): + """Make a file called targetpath. + """ + source = self.fileobj + source.seek(tarinfo.offset_data) + bufsize = self.copybufsize + with bltn_open(targetpath, "wb") as target: + if tarinfo.sparse is not None: + for offset, size in tarinfo.sparse: + target.seek(offset) + copyfileobj(source, target, size, ReadError, bufsize) + target.seek(tarinfo.size) + target.truncate() + else: + copyfileobj(source, target, tarinfo.size, ReadError, bufsize) + + def makeunknown(self, tarinfo, targetpath): + """Make a file from a TarInfo object with an unknown type + at targetpath. + """ + self.makefile(tarinfo, targetpath) + self._dbg(1, "tarfile: Unknown file type %r, " \ + "extracted as regular file." % tarinfo.type) + + def makefifo(self, tarinfo, targetpath): + """Make a fifo called targetpath. + """ + if hasattr(os, "mkfifo"): + os.mkfifo(targetpath) + else: + raise ExtractError("fifo not supported by system") + + def makedev(self, tarinfo, targetpath): + """Make a character or block device called targetpath. + """ + if not hasattr(os, "mknod") or not hasattr(os, "makedev"): + raise ExtractError("special devices not supported by system") + + mode = tarinfo.mode + if mode is None: + # Use mknod's default + mode = 0o600 + if tarinfo.isblk(): + mode |= stat.S_IFBLK + else: + mode |= stat.S_IFCHR + + os.mknod(targetpath, mode, + os.makedev(tarinfo.devmajor, tarinfo.devminor)) + + def makelink(self, tarinfo, targetpath): + """Make a (symbolic) link called targetpath. If it cannot be created + (platform limitation), we try to make a copy of the referenced file + instead of a link. + """ + try: + # For systems that support symbolic and hard links. + if tarinfo.issym(): + if os.path.lexists(targetpath): + # Avoid FileExistsError on following os.symlink. + os.unlink(targetpath) + os.symlink(tarinfo.linkname, targetpath) + else: + if os.path.exists(tarinfo._link_target): + os.link(tarinfo._link_target, targetpath) + else: + self._extract_member(self._find_link_target(tarinfo), + targetpath) + except symlink_exception: + try: + self._extract_member(self._find_link_target(tarinfo), + targetpath) + except KeyError: + raise ExtractError("unable to resolve link inside archive") from None + + def chown(self, tarinfo, targetpath, numeric_owner): + """Set owner of targetpath according to tarinfo. If numeric_owner + is True, use .gid/.uid instead of .gname/.uname. If numeric_owner + is False, fall back to .gid/.uid when the search based on name + fails. + """ + if hasattr(os, "geteuid") and os.geteuid() == 0: + # We have to be root to do so. + g = tarinfo.gid + u = tarinfo.uid + if not numeric_owner: + try: + if grp and tarinfo.gname: + g = grp.getgrnam(tarinfo.gname)[2] + except KeyError: + pass + try: + if pwd and tarinfo.uname: + u = pwd.getpwnam(tarinfo.uname)[2] + except KeyError: + pass + if g is None: + g = -1 + if u is None: + u = -1 + try: + if tarinfo.issym() and hasattr(os, "lchown"): + os.lchown(targetpath, u, g) + else: + os.chown(targetpath, u, g) + except (OSError, OverflowError) as e: + # OverflowError can be raised if an ID doesn't fit in 'id_t' + raise ExtractError("could not change owner") from e + + def chmod(self, tarinfo, targetpath): + """Set file permissions of targetpath according to tarinfo. + """ + if tarinfo.mode is None: + return + try: + os.chmod(targetpath, tarinfo.mode) + except OSError as e: + raise ExtractError("could not change mode") from e + + def utime(self, tarinfo, targetpath): + """Set modification time of targetpath according to tarinfo. + """ + mtime = tarinfo.mtime + if mtime is None: + return + if not hasattr(os, 'utime'): + return + try: + os.utime(targetpath, (mtime, mtime)) + except OSError as e: + raise ExtractError("could not change modification time") from e + + #-------------------------------------------------------------------------- + def next(self): + """Return the next member of the archive as a TarInfo object, when + TarFile is opened for reading. Return None if there is no more + available. + """ + self._check("ra") + if self.firstmember is not None: + m = self.firstmember + self.firstmember = None + return m + + # Advance the file pointer. + if self.offset != self.fileobj.tell(): + if self.offset == 0: + return None + self.fileobj.seek(self.offset - 1) + if not self.fileobj.read(1): + raise ReadError("unexpected end of data") + + # Read the next block. + tarinfo = None + while True: + try: + tarinfo = self.tarinfo.fromtarfile(self) + except EOFHeaderError as e: + if self.ignore_zeros: + self._dbg(2, "0x%X: %s" % (self.offset, e)) + self.offset += BLOCKSIZE + continue + except InvalidHeaderError as e: + if self.ignore_zeros: + self._dbg(2, "0x%X: %s" % (self.offset, e)) + self.offset += BLOCKSIZE + continue + elif self.offset == 0: + raise ReadError(str(e)) from None + except EmptyHeaderError: + if self.offset == 0: + raise ReadError("empty file") from None + except TruncatedHeaderError as e: + if self.offset == 0: + raise ReadError(str(e)) from None + except SubsequentHeaderError as e: + raise ReadError(str(e)) from None + except Exception as e: + try: + import zlib + if isinstance(e, zlib.error): + raise ReadError(f'zlib error: {e}') from None + else: + raise e + except ImportError: + raise e + break + + if tarinfo is not None: + # if streaming the file we do not want to cache the tarinfo + if not self.stream: + self.members.append(tarinfo) + else: + self._loaded = True + + return tarinfo + + #-------------------------------------------------------------------------- + # Little helper methods: + + def _getmember(self, name, tarinfo=None, normalize=False): + """Find an archive member by name from bottom to top. + If tarinfo is given, it is used as the starting point. + """ + # Ensure that all members have been loaded. + members = self.getmembers() + + # Limit the member search list up to tarinfo. + skipping = False + if tarinfo is not None: + try: + index = members.index(tarinfo) + except ValueError: + # The given starting point might be a (modified) copy. + # We'll later skip members until we find an equivalent. + skipping = True + else: + # Happy fast path + members = members[:index] + + if normalize: + name = os.path.normpath(name) + + for member in reversed(members): + if skipping: + if tarinfo.offset == member.offset: + skipping = False + continue + if normalize: + member_name = os.path.normpath(member.name) + else: + member_name = member.name + + if name == member_name: + return member + + if skipping: + # Starting point was not found + raise ValueError(tarinfo) + + def _load(self): + """Read through the entire archive file and look for readable + members. This should not run if the file is set to stream. + """ + if not self.stream: + while self.next() is not None: + pass + self._loaded = True + + def _check(self, mode=None): + """Check if TarFile is still open, and if the operation's mode + corresponds to TarFile's mode. + """ + if self.closed: + raise OSError("%s is closed" % self.__class__.__name__) + if mode is not None and self.mode not in mode: + raise OSError("bad operation for mode %r" % self.mode) + + def _find_link_target(self, tarinfo): + """Find the target member of a symlink or hardlink member in the + archive. + """ + if tarinfo.issym(): + # Always search the entire archive. + linkname = "/".join(filter(None, (os.path.dirname(tarinfo.name), tarinfo.linkname))) + limit = None + else: + # Search the archive before the link, because a hard link is + # just a reference to an already archived file. + linkname = tarinfo.linkname + limit = tarinfo + + member = self._getmember(linkname, tarinfo=limit, normalize=True) + if member is None: + raise KeyError("linkname %r not found" % linkname) + return member + + def __iter__(self): + """Provide an iterator object. + """ + if self._loaded: + yield from self.members + return + + # Yield items using TarFile's next() method. + # When all members have been read, set TarFile as _loaded. + index = 0 + # Fix for SF #1100429: Under rare circumstances it can + # happen that getmembers() is called during iteration, + # which will have already exhausted the next() method. + if self.firstmember is not None: + tarinfo = self.next() + index += 1 + yield tarinfo + + while True: + if index < len(self.members): + tarinfo = self.members[index] + elif not self._loaded: + tarinfo = self.next() + if not tarinfo: + self._loaded = True + return + else: + return + index += 1 + yield tarinfo + + def _dbg(self, level, msg): + """Write debugging output to sys.stderr. + """ + if level <= self.debug: + print(msg, file=sys.stderr) + + def __enter__(self): + self._check() + return self + + def __exit__(self, type, value, traceback): + if type is None: + self.close() + else: + # An exception occurred. We must not call close() because + # it would try to write end-of-archive blocks and padding. + if not self._extfileobj: + self.fileobj.close() + self.closed = True + +#-------------------- +# exported functions +#-------------------- + +def is_tarfile(name): + """Return True if name points to a tar archive that we + are able to handle, else return False. + + 'name' should be a string, file, or file-like object. + """ + try: + if hasattr(name, "read"): + pos = name.tell() + t = open(fileobj=name) + name.seek(pos) + else: + t = open(name) + t.close() + return True + except TarError: + return False + +open = TarFile.open + + +def main(): + import argparse + + description = 'A simple command-line interface for tarfile module.' + parser = argparse.ArgumentParser(description=description) + parser.add_argument('-v', '--verbose', action='store_true', default=False, + help='Verbose output') + parser.add_argument('--filter', metavar='', + choices=_NAMED_FILTERS, + help='Filter for extraction') + + group = parser.add_mutually_exclusive_group(required=True) + group.add_argument('-l', '--list', metavar='', + help='Show listing of a tarfile') + group.add_argument('-e', '--extract', nargs='+', + metavar=('', ''), + help='Extract tarfile into target dir') + group.add_argument('-c', '--create', nargs='+', + metavar=('', ''), + help='Create tarfile from sources') + group.add_argument('-t', '--test', metavar='', + help='Test if a tarfile is valid') + + args = parser.parse_args() + + if args.filter and args.extract is None: + parser.exit(1, '--filter is only valid for extraction\n') + + if args.test is not None: + src = args.test + if is_tarfile(src): + with open(src, 'r') as tar: + tar.getmembers() + print(tar.getmembers(), file=sys.stderr) + if args.verbose: + print('{!r} is a tar archive.'.format(src)) + else: + parser.exit(1, '{!r} is not a tar archive.\n'.format(src)) + + elif args.list is not None: + src = args.list + if is_tarfile(src): + with TarFile.open(src, 'r:*') as tf: + tf.list(verbose=args.verbose) + else: + parser.exit(1, '{!r} is not a tar archive.\n'.format(src)) + + elif args.extract is not None: + if len(args.extract) == 1: + src = args.extract[0] + curdir = os.curdir + elif len(args.extract) == 2: + src, curdir = args.extract + else: + parser.exit(1, parser.format_help()) + + if is_tarfile(src): + with TarFile.open(src, 'r:*') as tf: + tf.extractall(path=curdir, filter=args.filter) + if args.verbose: + if curdir == '.': + msg = '{!r} file is extracted.'.format(src) + else: + msg = ('{!r} file is extracted ' + 'into {!r} directory.').format(src, curdir) + print(msg) + else: + parser.exit(1, '{!r} is not a tar archive.\n'.format(src)) + + elif args.create is not None: + tar_name = args.create.pop(0) + _, ext = os.path.splitext(tar_name) + compressions = { + # gz + '.gz': 'gz', + '.tgz': 'gz', + # xz + '.xz': 'xz', + '.txz': 'xz', + # bz2 + '.bz2': 'bz2', + '.tbz': 'bz2', + '.tbz2': 'bz2', + '.tb2': 'bz2', + } + tar_mode = 'w:' + compressions[ext] if ext in compressions else 'w' + tar_files = args.create + + with TarFile.open(tar_name, tar_mode) as tf: + for file_name in tar_files: + tf.add(file_name) + + if args.verbose: + print('{!r} file created.'.format(tar_name)) + +if __name__ == '__main__': + main() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__main__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__main__.py new file mode 100644 index 000000000..daf550908 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__main__.py @@ -0,0 +1,5 @@ +from . import main + + +if __name__ == '__main__': + main() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..23edacbedf76d1505443ea3c35dca07eb77c21b2 GIT binary patch literal 121298 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__pycache__/__main__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/__pycache__/__main__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..da4f5f8b8a6d468dd703ccd7b066814c9c04c7e4 GIT binary patch literal 337 zcmX|7Jxjzu5S`5i3F0+&ia)>zmqjfVD?PCAIJC1_Hn*dRx5DFTV^Y(O)35WHgTqYAO5u^|{?px4ZaLRdLdX}a Yw=3YUJ>GxNjZZ_=1pO%pi6FG5~kQ~&?~ literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/compat/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/compat/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/compat/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/backports/tarfile/compat/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..131e65e5bb92a8125cc6e8ad86217d487b3dc55c GIT binary patch literal 246 zcmZ9GO-jW;497b@AIO6q#6=s_t-O^AE-b}&fMME3J34KKnN;jS#4~sX_iyu#;R&R> zu1pbJ_=hCFe32Z|bd!kopQc^n*W&(bI+n_NGA5_0_(;N$WYaP;zd=hKf^ql?cVijo z32TmUy(_bV8vLc(s~de!6*2I@6s&QO|Bo)cFY>c0G0GS1v$bdJXnWNQ|AqX*0#5-b?(Rch zr@+Nt7}qTJ#^x1Ib#Sd0@HB>zq*Abc}`b$gzut+vF8e%P!o1U@)8GdDkp$n6Ke&hI!rP zggDGtYXBfZjUx11Lg5l_(z5MfqeQB%$>Af}#Ra$N#VD?l2KI5%IN%Jy!{)$kpjk{SMWkBzUq}a9ijon*6Zz zeyRKLAbJNF?yB9~PP7~E>(l+%^f^D8fZ;1kCAdj`cOkf*-wN`PD^g=Bc678A5~E)g zux`RL6c_O1;HPvFTH<$-%XF+Nit+ +Project-URL: Source, https://github.com/python/importlib_metadata +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: Apache Software License +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Requires-Python: >=3.8 +Description-Content-Type: text/x-rst +License-File: LICENSE +Requires-Dist: zipp >=0.5 +Requires-Dist: typing-extensions >=3.6.4 ; python_version < "3.8" +Provides-Extra: doc +Requires-Dist: sphinx >=3.5 ; extra == 'doc' +Requires-Dist: jaraco.packaging >=9.3 ; extra == 'doc' +Requires-Dist: rst.linker >=1.9 ; extra == 'doc' +Requires-Dist: furo ; extra == 'doc' +Requires-Dist: sphinx-lint ; extra == 'doc' +Requires-Dist: jaraco.tidelift >=1.4 ; extra == 'doc' +Provides-Extra: perf +Requires-Dist: ipython ; extra == 'perf' +Provides-Extra: test +Requires-Dist: pytest !=8.1.*,>=6 ; extra == 'test' +Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'test' +Requires-Dist: pytest-cov ; extra == 'test' +Requires-Dist: pytest-mypy ; extra == 'test' +Requires-Dist: pytest-enabler >=2.2 ; extra == 'test' +Requires-Dist: pytest-ruff >=0.2.1 ; extra == 'test' +Requires-Dist: packaging ; extra == 'test' +Requires-Dist: pyfakefs ; extra == 'test' +Requires-Dist: flufl.flake8 ; extra == 'test' +Requires-Dist: pytest-perf >=0.9.2 ; extra == 'test' +Requires-Dist: jaraco.test >=5.4 ; extra == 'test' +Requires-Dist: importlib-resources >=1.3 ; (python_version < "3.9") and extra == 'test' + +.. image:: https://img.shields.io/pypi/v/importlib_metadata.svg + :target: https://pypi.org/project/importlib_metadata + +.. image:: https://img.shields.io/pypi/pyversions/importlib_metadata.svg + +.. image:: https://github.com/python/importlib_metadata/actions/workflows/main.yml/badge.svg + :target: https://github.com/python/importlib_metadata/actions?query=workflow%3A%22tests%22 + :alt: tests + +.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json + :target: https://github.com/astral-sh/ruff + :alt: Ruff + +.. image:: https://readthedocs.org/projects/importlib-metadata/badge/?version=latest + :target: https://importlib-metadata.readthedocs.io/en/latest/?badge=latest + +.. image:: https://img.shields.io/badge/skeleton-2024-informational + :target: https://blog.jaraco.com/skeleton + +.. image:: https://tidelift.com/badges/package/pypi/importlib-metadata + :target: https://tidelift.com/subscription/pkg/pypi-importlib-metadata?utm_source=pypi-importlib-metadata&utm_medium=readme + +Library to access the metadata for a Python package. + +This package supplies third-party access to the functionality of +`importlib.metadata `_ +including improvements added to subsequent Python versions. + + +Compatibility +============= + +New features are introduced in this third-party library and later merged +into CPython. The following table indicates which versions of this library +were contributed to different versions in the standard library: + +.. list-table:: + :header-rows: 1 + + * - importlib_metadata + - stdlib + * - 7.0 + - 3.13 + * - 6.5 + - 3.12 + * - 4.13 + - 3.11 + * - 4.6 + - 3.10 + * - 1.4 + - 3.8 + + +Usage +===== + +See the `online documentation `_ +for usage details. + +`Finder authors +`_ can +also add support for custom package installers. See the above documentation +for details. + + +Caveats +======= + +This project primarily supports third-party packages installed by PyPA +tools (or other conforming packages). It does not support: + +- Packages in the stdlib. +- Packages installed without metadata. + +Project details +=============== + + * Project home: https://github.com/python/importlib_metadata + * Report bugs at: https://github.com/python/importlib_metadata/issues + * Code hosting: https://github.com/python/importlib_metadata + * Documentation: https://importlib-metadata.readthedocs.io/ + +For Enterprise +============== + +Available as part of the Tidelift Subscription. + +This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. + +`Learn more `_. diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/RECORD new file mode 100644 index 000000000..17296a8e8 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/RECORD @@ -0,0 +1,32 @@ +importlib_metadata-8.0.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +importlib_metadata-8.0.0.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358 +importlib_metadata-8.0.0.dist-info/METADATA,sha256=anuQ7_7h4J1bSEzfcjIBakPi2cyVQ7y7jklLHsBeH1k,4648 +importlib_metadata-8.0.0.dist-info/RECORD,, +importlib_metadata-8.0.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +importlib_metadata-8.0.0.dist-info/WHEEL,sha256=mguMlWGMX-VHnMpKOjjQidIo1ssRlCFu4a4mBpz1s2M,91 +importlib_metadata-8.0.0.dist-info/top_level.txt,sha256=CO3fD9yylANiXkrMo4qHLV_mqXL2sC5JFKgt1yWAT-A,19 +importlib_metadata/__init__.py,sha256=tZNB-23h8Bixi9uCrQqj9Yf0aeC--Josdy3IZRIQeB0,33798 +importlib_metadata/__pycache__/__init__.cpython-312.pyc,, +importlib_metadata/__pycache__/_adapters.cpython-312.pyc,, +importlib_metadata/__pycache__/_collections.cpython-312.pyc,, +importlib_metadata/__pycache__/_compat.cpython-312.pyc,, +importlib_metadata/__pycache__/_functools.cpython-312.pyc,, +importlib_metadata/__pycache__/_itertools.cpython-312.pyc,, +importlib_metadata/__pycache__/_meta.cpython-312.pyc,, +importlib_metadata/__pycache__/_text.cpython-312.pyc,, +importlib_metadata/__pycache__/diagnose.cpython-312.pyc,, +importlib_metadata/_adapters.py,sha256=rIhWTwBvYA1bV7i-5FfVX38qEXDTXFeS5cb5xJtP3ks,2317 +importlib_metadata/_collections.py,sha256=CJ0OTCHIjWA0ZIVS4voORAsn2R4R2cQBEtPsZEJpASY,743 +importlib_metadata/_compat.py,sha256=73QKrN9KNoaZzhbX5yPCCZa-FaALwXe8TPlDR72JgBU,1314 +importlib_metadata/_functools.py,sha256=PsY2-4rrKX4RVeRC1oGp1lB1pmC9eKN88_f-bD9uOoA,2895 +importlib_metadata/_itertools.py,sha256=cvr_2v8BRbxcIl5x5ldfqdHjhI8Yi8s8yk50G_nm6jQ,2068 +importlib_metadata/_meta.py,sha256=nxZ7C8GVlcBFAKWyVOn_dn7ot_twBcbm1NmvjIetBHI,1801 +importlib_metadata/_text.py,sha256=HCsFksZpJLeTP3NEk_ngrAeXVRRtTrtyh9eOABoRP4A,2166 +importlib_metadata/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +importlib_metadata/compat/__pycache__/__init__.cpython-312.pyc,, +importlib_metadata/compat/__pycache__/py311.cpython-312.pyc,, +importlib_metadata/compat/__pycache__/py39.cpython-312.pyc,, +importlib_metadata/compat/py311.py,sha256=uqm-K-uohyj1042TH4a9Er_I5o7667DvulcD-gC_fSA,608 +importlib_metadata/compat/py39.py,sha256=cPkMv6-0ilK-0Jw_Tkn0xYbOKJZc4WJKQHow0c2T44w,1102 +importlib_metadata/diagnose.py,sha256=nkSRMiowlmkhLYhKhvCg9glmt_11Cox-EmLzEbqYTa8,379 +importlib_metadata/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/REQUESTED b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/REQUESTED new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/WHEEL new file mode 100644 index 000000000..edf4ec7c7 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (70.1.1) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/top_level.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/top_level.txt new file mode 100644 index 000000000..bbb07547a --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata-8.0.0.dist-info/top_level.txt @@ -0,0 +1 @@ +importlib_metadata diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__init__.py new file mode 100644 index 000000000..ed4813551 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__init__.py @@ -0,0 +1,1083 @@ +from __future__ import annotations + +import os +import re +import abc +import sys +import json +import zipp +import email +import types +import inspect +import pathlib +import operator +import textwrap +import functools +import itertools +import posixpath +import collections + +from . import _meta +from .compat import py39, py311 +from ._collections import FreezableDefaultDict, Pair +from ._compat import ( + NullFinder, + install, +) +from ._functools import method_cache, pass_none +from ._itertools import always_iterable, unique_everseen +from ._meta import PackageMetadata, SimplePath + +from contextlib import suppress +from importlib import import_module +from importlib.abc import MetaPathFinder +from itertools import starmap +from typing import Any, Iterable, List, Mapping, Match, Optional, Set, cast + +__all__ = [ + 'Distribution', + 'DistributionFinder', + 'PackageMetadata', + 'PackageNotFoundError', + 'distribution', + 'distributions', + 'entry_points', + 'files', + 'metadata', + 'packages_distributions', + 'requires', + 'version', +] + + +class PackageNotFoundError(ModuleNotFoundError): + """The package was not found.""" + + def __str__(self) -> str: + return f"No package metadata was found for {self.name}" + + @property + def name(self) -> str: # type: ignore[override] + (name,) = self.args + return name + + +class Sectioned: + """ + A simple entry point config parser for performance + + >>> for item in Sectioned.read(Sectioned._sample): + ... print(item) + Pair(name='sec1', value='# comments ignored') + Pair(name='sec1', value='a = 1') + Pair(name='sec1', value='b = 2') + Pair(name='sec2', value='a = 2') + + >>> res = Sectioned.section_pairs(Sectioned._sample) + >>> item = next(res) + >>> item.name + 'sec1' + >>> item.value + Pair(name='a', value='1') + >>> item = next(res) + >>> item.value + Pair(name='b', value='2') + >>> item = next(res) + >>> item.name + 'sec2' + >>> item.value + Pair(name='a', value='2') + >>> list(res) + [] + """ + + _sample = textwrap.dedent( + """ + [sec1] + # comments ignored + a = 1 + b = 2 + + [sec2] + a = 2 + """ + ).lstrip() + + @classmethod + def section_pairs(cls, text): + return ( + section._replace(value=Pair.parse(section.value)) + for section in cls.read(text, filter_=cls.valid) + if section.name is not None + ) + + @staticmethod + def read(text, filter_=None): + lines = filter(filter_, map(str.strip, text.splitlines())) + name = None + for value in lines: + section_match = value.startswith('[') and value.endswith(']') + if section_match: + name = value.strip('[]') + continue + yield Pair(name, value) + + @staticmethod + def valid(line: str): + return line and not line.startswith('#') + + +class EntryPoint: + """An entry point as defined by Python packaging conventions. + + See `the packaging docs on entry points + `_ + for more information. + + >>> ep = EntryPoint( + ... name=None, group=None, value='package.module:attr [extra1, extra2]') + >>> ep.module + 'package.module' + >>> ep.attr + 'attr' + >>> ep.extras + ['extra1', 'extra2'] + """ + + pattern = re.compile( + r'(?P[\w.]+)\s*' + r'(:\s*(?P[\w.]+)\s*)?' + r'((?P\[.*\])\s*)?$' + ) + """ + A regular expression describing the syntax for an entry point, + which might look like: + + - module + - package.module + - package.module:attribute + - package.module:object.attribute + - package.module:attr [extra1, extra2] + + Other combinations are possible as well. + + The expression is lenient about whitespace around the ':', + following the attr, and following any extras. + """ + + name: str + value: str + group: str + + dist: Optional[Distribution] = None + + def __init__(self, name: str, value: str, group: str) -> None: + vars(self).update(name=name, value=value, group=group) + + def load(self) -> Any: + """Load the entry point from its definition. If only a module + is indicated by the value, return that module. Otherwise, + return the named object. + """ + match = cast(Match, self.pattern.match(self.value)) + module = import_module(match.group('module')) + attrs = filter(None, (match.group('attr') or '').split('.')) + return functools.reduce(getattr, attrs, module) + + @property + def module(self) -> str: + match = self.pattern.match(self.value) + assert match is not None + return match.group('module') + + @property + def attr(self) -> str: + match = self.pattern.match(self.value) + assert match is not None + return match.group('attr') + + @property + def extras(self) -> List[str]: + match = self.pattern.match(self.value) + assert match is not None + return re.findall(r'\w+', match.group('extras') or '') + + def _for(self, dist): + vars(self).update(dist=dist) + return self + + def matches(self, **params): + """ + EntryPoint matches the given parameters. + + >>> ep = EntryPoint(group='foo', name='bar', value='bing:bong [extra1, extra2]') + >>> ep.matches(group='foo') + True + >>> ep.matches(name='bar', value='bing:bong [extra1, extra2]') + True + >>> ep.matches(group='foo', name='other') + False + >>> ep.matches() + True + >>> ep.matches(extras=['extra1', 'extra2']) + True + >>> ep.matches(module='bing') + True + >>> ep.matches(attr='bong') + True + """ + attrs = (getattr(self, param) for param in params) + return all(map(operator.eq, params.values(), attrs)) + + def _key(self): + return self.name, self.value, self.group + + def __lt__(self, other): + return self._key() < other._key() + + def __eq__(self, other): + return self._key() == other._key() + + def __setattr__(self, name, value): + raise AttributeError("EntryPoint objects are immutable.") + + def __repr__(self): + return ( + f'EntryPoint(name={self.name!r}, value={self.value!r}, ' + f'group={self.group!r})' + ) + + def __hash__(self) -> int: + return hash(self._key()) + + +class EntryPoints(tuple): + """ + An immutable collection of selectable EntryPoint objects. + """ + + __slots__ = () + + def __getitem__(self, name: str) -> EntryPoint: # type: ignore[override] + """ + Get the EntryPoint in self matching name. + """ + try: + return next(iter(self.select(name=name))) + except StopIteration: + raise KeyError(name) + + def __repr__(self): + """ + Repr with classname and tuple constructor to + signal that we deviate from regular tuple behavior. + """ + return '%s(%r)' % (self.__class__.__name__, tuple(self)) + + def select(self, **params) -> EntryPoints: + """ + Select entry points from self that match the + given parameters (typically group and/or name). + """ + return EntryPoints(ep for ep in self if py39.ep_matches(ep, **params)) + + @property + def names(self) -> Set[str]: + """ + Return the set of all names of all entry points. + """ + return {ep.name for ep in self} + + @property + def groups(self) -> Set[str]: + """ + Return the set of all groups of all entry points. + """ + return {ep.group for ep in self} + + @classmethod + def _from_text_for(cls, text, dist): + return cls(ep._for(dist) for ep in cls._from_text(text)) + + @staticmethod + def _from_text(text): + return ( + EntryPoint(name=item.value.name, value=item.value.value, group=item.name) + for item in Sectioned.section_pairs(text or '') + ) + + +class PackagePath(pathlib.PurePosixPath): + """A reference to a path in a package""" + + hash: Optional[FileHash] + size: int + dist: Distribution + + def read_text(self, encoding: str = 'utf-8') -> str: # type: ignore[override] + return self.locate().read_text(encoding=encoding) + + def read_binary(self) -> bytes: + return self.locate().read_bytes() + + def locate(self) -> SimplePath: + """Return a path-like object for this path""" + return self.dist.locate_file(self) + + +class FileHash: + def __init__(self, spec: str) -> None: + self.mode, _, self.value = spec.partition('=') + + def __repr__(self) -> str: + return f'' + + +class Distribution(metaclass=abc.ABCMeta): + """ + An abstract Python distribution package. + + Custom providers may derive from this class and define + the abstract methods to provide a concrete implementation + for their environment. Some providers may opt to override + the default implementation of some properties to bypass + the file-reading mechanism. + """ + + @abc.abstractmethod + def read_text(self, filename) -> Optional[str]: + """Attempt to load metadata file given by the name. + + Python distribution metadata is organized by blobs of text + typically represented as "files" in the metadata directory + (e.g. package-1.0.dist-info). These files include things + like: + + - METADATA: The distribution metadata including fields + like Name and Version and Description. + - entry_points.txt: A series of entry points as defined in + `the entry points spec `_. + - RECORD: A record of files according to + `this recording spec `_. + + A package may provide any set of files, including those + not listed here or none at all. + + :param filename: The name of the file in the distribution info. + :return: The text if found, otherwise None. + """ + + @abc.abstractmethod + def locate_file(self, path: str | os.PathLike[str]) -> SimplePath: + """ + Given a path to a file in this distribution, return a SimplePath + to it. + """ + + @classmethod + def from_name(cls, name: str) -> Distribution: + """Return the Distribution for the given package name. + + :param name: The name of the distribution package to search for. + :return: The Distribution instance (or subclass thereof) for the named + package, if found. + :raises PackageNotFoundError: When the named package's distribution + metadata cannot be found. + :raises ValueError: When an invalid value is supplied for name. + """ + if not name: + raise ValueError("A distribution name is required.") + try: + return next(iter(cls.discover(name=name))) + except StopIteration: + raise PackageNotFoundError(name) + + @classmethod + def discover( + cls, *, context: Optional[DistributionFinder.Context] = None, **kwargs + ) -> Iterable[Distribution]: + """Return an iterable of Distribution objects for all packages. + + Pass a ``context`` or pass keyword arguments for constructing + a context. + + :context: A ``DistributionFinder.Context`` object. + :return: Iterable of Distribution objects for packages matching + the context. + """ + if context and kwargs: + raise ValueError("cannot accept context and kwargs") + context = context or DistributionFinder.Context(**kwargs) + return itertools.chain.from_iterable( + resolver(context) for resolver in cls._discover_resolvers() + ) + + @staticmethod + def at(path: str | os.PathLike[str]) -> Distribution: + """Return a Distribution for the indicated metadata path. + + :param path: a string or path-like object + :return: a concrete Distribution instance for the path + """ + return PathDistribution(pathlib.Path(path)) + + @staticmethod + def _discover_resolvers(): + """Search the meta_path for resolvers (MetadataPathFinders).""" + declared = ( + getattr(finder, 'find_distributions', None) for finder in sys.meta_path + ) + return filter(None, declared) + + @property + def metadata(self) -> _meta.PackageMetadata: + """Return the parsed metadata for this Distribution. + + The returned object will have keys that name the various bits of + metadata per the + `Core metadata specifications `_. + + Custom providers may provide the METADATA file or override this + property. + """ + # deferred for performance (python/cpython#109829) + from . import _adapters + + opt_text = ( + self.read_text('METADATA') + or self.read_text('PKG-INFO') + # This last clause is here to support old egg-info files. Its + # effect is to just end up using the PathDistribution's self._path + # (which points to the egg-info file) attribute unchanged. + or self.read_text('') + ) + text = cast(str, opt_text) + return _adapters.Message(email.message_from_string(text)) + + @property + def name(self) -> str: + """Return the 'Name' metadata for the distribution package.""" + return self.metadata['Name'] + + @property + def _normalized_name(self): + """Return a normalized version of the name.""" + return Prepared.normalize(self.name) + + @property + def version(self) -> str: + """Return the 'Version' metadata for the distribution package.""" + return self.metadata['Version'] + + @property + def entry_points(self) -> EntryPoints: + """ + Return EntryPoints for this distribution. + + Custom providers may provide the ``entry_points.txt`` file + or override this property. + """ + return EntryPoints._from_text_for(self.read_text('entry_points.txt'), self) + + @property + def files(self) -> Optional[List[PackagePath]]: + """Files in this distribution. + + :return: List of PackagePath for this distribution or None + + Result is `None` if the metadata file that enumerates files + (i.e. RECORD for dist-info, or installed-files.txt or + SOURCES.txt for egg-info) is missing. + Result may be empty if the metadata exists but is empty. + + Custom providers are recommended to provide a "RECORD" file (in + ``read_text``) or override this property to allow for callers to be + able to resolve filenames provided by the package. + """ + + def make_file(name, hash=None, size_str=None): + result = PackagePath(name) + result.hash = FileHash(hash) if hash else None + result.size = int(size_str) if size_str else None + result.dist = self + return result + + @pass_none + def make_files(lines): + # Delay csv import, since Distribution.files is not as widely used + # as other parts of importlib.metadata + import csv + + return starmap(make_file, csv.reader(lines)) + + @pass_none + def skip_missing_files(package_paths): + return list(filter(lambda path: path.locate().exists(), package_paths)) + + return skip_missing_files( + make_files( + self._read_files_distinfo() + or self._read_files_egginfo_installed() + or self._read_files_egginfo_sources() + ) + ) + + def _read_files_distinfo(self): + """ + Read the lines of RECORD. + """ + text = self.read_text('RECORD') + return text and text.splitlines() + + def _read_files_egginfo_installed(self): + """ + Read installed-files.txt and return lines in a similar + CSV-parsable format as RECORD: each file must be placed + relative to the site-packages directory and must also be + quoted (since file names can contain literal commas). + + This file is written when the package is installed by pip, + but it might not be written for other installation methods. + Assume the file is accurate if it exists. + """ + text = self.read_text('installed-files.txt') + # Prepend the .egg-info/ subdir to the lines in this file. + # But this subdir is only available from PathDistribution's + # self._path. + subdir = getattr(self, '_path', None) + if not text or not subdir: + return + + paths = ( + py311.relative_fix((subdir / name).resolve()) + .relative_to(self.locate_file('').resolve(), walk_up=True) + .as_posix() + for name in text.splitlines() + ) + return map('"{}"'.format, paths) + + def _read_files_egginfo_sources(self): + """ + Read SOURCES.txt and return lines in a similar CSV-parsable + format as RECORD: each file name must be quoted (since it + might contain literal commas). + + Note that SOURCES.txt is not a reliable source for what + files are installed by a package. This file is generated + for a source archive, and the files that are present + there (e.g. setup.py) may not correctly reflect the files + that are present after the package has been installed. + """ + text = self.read_text('SOURCES.txt') + return text and map('"{}"'.format, text.splitlines()) + + @property + def requires(self) -> Optional[List[str]]: + """Generated requirements specified for this Distribution""" + reqs = self._read_dist_info_reqs() or self._read_egg_info_reqs() + return reqs and list(reqs) + + def _read_dist_info_reqs(self): + return self.metadata.get_all('Requires-Dist') + + def _read_egg_info_reqs(self): + source = self.read_text('requires.txt') + return pass_none(self._deps_from_requires_text)(source) + + @classmethod + def _deps_from_requires_text(cls, source): + return cls._convert_egg_info_reqs_to_simple_reqs(Sectioned.read(source)) + + @staticmethod + def _convert_egg_info_reqs_to_simple_reqs(sections): + """ + Historically, setuptools would solicit and store 'extra' + requirements, including those with environment markers, + in separate sections. More modern tools expect each + dependency to be defined separately, with any relevant + extras and environment markers attached directly to that + requirement. This method converts the former to the + latter. See _test_deps_from_requires_text for an example. + """ + + def make_condition(name): + return name and f'extra == "{name}"' + + def quoted_marker(section): + section = section or '' + extra, sep, markers = section.partition(':') + if extra and markers: + markers = f'({markers})' + conditions = list(filter(None, [markers, make_condition(extra)])) + return '; ' + ' and '.join(conditions) if conditions else '' + + def url_req_space(req): + """ + PEP 508 requires a space between the url_spec and the quoted_marker. + Ref python/importlib_metadata#357. + """ + # '@' is uniquely indicative of a url_req. + return ' ' * ('@' in req) + + for section in sections: + space = url_req_space(section.value) + yield section.value + space + quoted_marker(section.name) + + @property + def origin(self): + return self._load_json('direct_url.json') + + def _load_json(self, filename): + return pass_none(json.loads)( + self.read_text(filename), + object_hook=lambda data: types.SimpleNamespace(**data), + ) + + +class DistributionFinder(MetaPathFinder): + """ + A MetaPathFinder capable of discovering installed distributions. + + Custom providers should implement this interface in order to + supply metadata. + """ + + class Context: + """ + Keyword arguments presented by the caller to + ``distributions()`` or ``Distribution.discover()`` + to narrow the scope of a search for distributions + in all DistributionFinders. + + Each DistributionFinder may expect any parameters + and should attempt to honor the canonical + parameters defined below when appropriate. + + This mechanism gives a custom provider a means to + solicit additional details from the caller beyond + "name" and "path" when searching distributions. + For example, imagine a provider that exposes suites + of packages in either a "public" or "private" ``realm``. + A caller may wish to query only for distributions in + a particular realm and could call + ``distributions(realm="private")`` to signal to the + custom provider to only include distributions from that + realm. + """ + + name = None + """ + Specific name for which a distribution finder should match. + A name of ``None`` matches all distributions. + """ + + def __init__(self, **kwargs): + vars(self).update(kwargs) + + @property + def path(self) -> List[str]: + """ + The sequence of directory path that a distribution finder + should search. + + Typically refers to Python installed package paths such as + "site-packages" directories and defaults to ``sys.path``. + """ + return vars(self).get('path', sys.path) + + @abc.abstractmethod + def find_distributions(self, context=Context()) -> Iterable[Distribution]: + """ + Find distributions. + + Return an iterable of all Distribution instances capable of + loading the metadata for packages matching the ``context``, + a DistributionFinder.Context instance. + """ + + +class FastPath: + """ + Micro-optimized class for searching a root for children. + + Root is a path on the file system that may contain metadata + directories either as natural directories or within a zip file. + + >>> FastPath('').children() + ['...'] + + FastPath objects are cached and recycled for any given root. + + >>> FastPath('foobar') is FastPath('foobar') + True + """ + + @functools.lru_cache() # type: ignore + def __new__(cls, root): + return super().__new__(cls) + + def __init__(self, root): + self.root = root + + def joinpath(self, child): + return pathlib.Path(self.root, child) + + def children(self): + with suppress(Exception): + return os.listdir(self.root or '.') + with suppress(Exception): + return self.zip_children() + return [] + + def zip_children(self): + zip_path = zipp.Path(self.root) + names = zip_path.root.namelist() + self.joinpath = zip_path.joinpath + + return dict.fromkeys(child.split(posixpath.sep, 1)[0] for child in names) + + def search(self, name): + return self.lookup(self.mtime).search(name) + + @property + def mtime(self): + with suppress(OSError): + return os.stat(self.root).st_mtime + self.lookup.cache_clear() + + @method_cache + def lookup(self, mtime): + return Lookup(self) + + +class Lookup: + """ + A micro-optimized class for searching a (fast) path for metadata. + """ + + def __init__(self, path: FastPath): + """ + Calculate all of the children representing metadata. + + From the children in the path, calculate early all of the + children that appear to represent metadata (infos) or legacy + metadata (eggs). + """ + + base = os.path.basename(path.root).lower() + base_is_egg = base.endswith(".egg") + self.infos = FreezableDefaultDict(list) + self.eggs = FreezableDefaultDict(list) + + for child in path.children(): + low = child.lower() + if low.endswith((".dist-info", ".egg-info")): + # rpartition is faster than splitext and suitable for this purpose. + name = low.rpartition(".")[0].partition("-")[0] + normalized = Prepared.normalize(name) + self.infos[normalized].append(path.joinpath(child)) + elif base_is_egg and low == "egg-info": + name = base.rpartition(".")[0].partition("-")[0] + legacy_normalized = Prepared.legacy_normalize(name) + self.eggs[legacy_normalized].append(path.joinpath(child)) + + self.infos.freeze() + self.eggs.freeze() + + def search(self, prepared: Prepared): + """ + Yield all infos and eggs matching the Prepared query. + """ + infos = ( + self.infos[prepared.normalized] + if prepared + else itertools.chain.from_iterable(self.infos.values()) + ) + eggs = ( + self.eggs[prepared.legacy_normalized] + if prepared + else itertools.chain.from_iterable(self.eggs.values()) + ) + return itertools.chain(infos, eggs) + + +class Prepared: + """ + A prepared search query for metadata on a possibly-named package. + + Pre-calculates the normalization to prevent repeated operations. + + >>> none = Prepared(None) + >>> none.normalized + >>> none.legacy_normalized + >>> bool(none) + False + >>> sample = Prepared('Sample__Pkg-name.foo') + >>> sample.normalized + 'sample_pkg_name_foo' + >>> sample.legacy_normalized + 'sample__pkg_name.foo' + >>> bool(sample) + True + """ + + normalized = None + legacy_normalized = None + + def __init__(self, name: Optional[str]): + self.name = name + if name is None: + return + self.normalized = self.normalize(name) + self.legacy_normalized = self.legacy_normalize(name) + + @staticmethod + def normalize(name): + """ + PEP 503 normalization plus dashes as underscores. + """ + return re.sub(r"[-_.]+", "-", name).lower().replace('-', '_') + + @staticmethod + def legacy_normalize(name): + """ + Normalize the package name as found in the convention in + older packaging tools versions and specs. + """ + return name.lower().replace('-', '_') + + def __bool__(self): + return bool(self.name) + + +@install +class MetadataPathFinder(NullFinder, DistributionFinder): + """A degenerate finder for distribution packages on the file system. + + This finder supplies only a find_distributions() method for versions + of Python that do not have a PathFinder find_distributions(). + """ + + @classmethod + def find_distributions( + cls, context=DistributionFinder.Context() + ) -> Iterable[PathDistribution]: + """ + Find distributions. + + Return an iterable of all Distribution instances capable of + loading the metadata for packages matching ``context.name`` + (or all names if ``None`` indicated) along the paths in the list + of directories ``context.path``. + """ + found = cls._search_paths(context.name, context.path) + return map(PathDistribution, found) + + @classmethod + def _search_paths(cls, name, paths): + """Find metadata directories in paths heuristically.""" + prepared = Prepared(name) + return itertools.chain.from_iterable( + path.search(prepared) for path in map(FastPath, paths) + ) + + @classmethod + def invalidate_caches(cls) -> None: + FastPath.__new__.cache_clear() + + +class PathDistribution(Distribution): + def __init__(self, path: SimplePath) -> None: + """Construct a distribution. + + :param path: SimplePath indicating the metadata directory. + """ + self._path = path + + def read_text(self, filename: str | os.PathLike[str]) -> Optional[str]: + with suppress( + FileNotFoundError, + IsADirectoryError, + KeyError, + NotADirectoryError, + PermissionError, + ): + return self._path.joinpath(filename).read_text(encoding='utf-8') + + return None + + read_text.__doc__ = Distribution.read_text.__doc__ + + def locate_file(self, path: str | os.PathLike[str]) -> SimplePath: + return self._path.parent / path + + @property + def _normalized_name(self): + """ + Performance optimization: where possible, resolve the + normalized name from the file system path. + """ + stem = os.path.basename(str(self._path)) + return ( + pass_none(Prepared.normalize)(self._name_from_stem(stem)) + or super()._normalized_name + ) + + @staticmethod + def _name_from_stem(stem): + """ + >>> PathDistribution._name_from_stem('foo-3.0.egg-info') + 'foo' + >>> PathDistribution._name_from_stem('CherryPy-3.0.dist-info') + 'CherryPy' + >>> PathDistribution._name_from_stem('face.egg-info') + 'face' + >>> PathDistribution._name_from_stem('foo.bar') + """ + filename, ext = os.path.splitext(stem) + if ext not in ('.dist-info', '.egg-info'): + return + name, sep, rest = filename.partition('-') + return name + + +def distribution(distribution_name: str) -> Distribution: + """Get the ``Distribution`` instance for the named package. + + :param distribution_name: The name of the distribution package as a string. + :return: A ``Distribution`` instance (or subclass thereof). + """ + return Distribution.from_name(distribution_name) + + +def distributions(**kwargs) -> Iterable[Distribution]: + """Get all ``Distribution`` instances in the current environment. + + :return: An iterable of ``Distribution`` instances. + """ + return Distribution.discover(**kwargs) + + +def metadata(distribution_name: str) -> _meta.PackageMetadata: + """Get the metadata for the named package. + + :param distribution_name: The name of the distribution package to query. + :return: A PackageMetadata containing the parsed metadata. + """ + return Distribution.from_name(distribution_name).metadata + + +def version(distribution_name: str) -> str: + """Get the version string for the named package. + + :param distribution_name: The name of the distribution package to query. + :return: The version string for the package as defined in the package's + "Version" metadata key. + """ + return distribution(distribution_name).version + + +_unique = functools.partial( + unique_everseen, + key=py39.normalized_name, +) +""" +Wrapper for ``distributions`` to return unique distributions by name. +""" + + +def entry_points(**params) -> EntryPoints: + """Return EntryPoint objects for all installed packages. + + Pass selection parameters (group or name) to filter the + result to entry points matching those properties (see + EntryPoints.select()). + + :return: EntryPoints for all installed packages. + """ + eps = itertools.chain.from_iterable( + dist.entry_points for dist in _unique(distributions()) + ) + return EntryPoints(eps).select(**params) + + +def files(distribution_name: str) -> Optional[List[PackagePath]]: + """Return a list of files for the named package. + + :param distribution_name: The name of the distribution package to query. + :return: List of files composing the distribution. + """ + return distribution(distribution_name).files + + +def requires(distribution_name: str) -> Optional[List[str]]: + """ + Return a list of requirements for the named package. + + :return: An iterable of requirements, suitable for + packaging.requirement.Requirement. + """ + return distribution(distribution_name).requires + + +def packages_distributions() -> Mapping[str, List[str]]: + """ + Return a mapping of top-level packages to their + distributions. + + >>> import collections.abc + >>> pkgs = packages_distributions() + >>> all(isinstance(dist, collections.abc.Sequence) for dist in pkgs.values()) + True + """ + pkg_to_dist = collections.defaultdict(list) + for dist in distributions(): + for pkg in _top_level_declared(dist) or _top_level_inferred(dist): + pkg_to_dist[pkg].append(dist.metadata['Name']) + return dict(pkg_to_dist) + + +def _top_level_declared(dist): + return (dist.read_text('top_level.txt') or '').split() + + +def _topmost(name: PackagePath) -> Optional[str]: + """ + Return the top-most parent as long as there is a parent. + """ + top, *rest = name.parts + return top if rest else None + + +def _get_toplevel_name(name: PackagePath) -> str: + """ + Infer a possibly importable module name from a name presumed on + sys.path. + + >>> _get_toplevel_name(PackagePath('foo.py')) + 'foo' + >>> _get_toplevel_name(PackagePath('foo')) + 'foo' + >>> _get_toplevel_name(PackagePath('foo.pyc')) + 'foo' + >>> _get_toplevel_name(PackagePath('foo/__init__.py')) + 'foo' + >>> _get_toplevel_name(PackagePath('foo.pth')) + 'foo.pth' + >>> _get_toplevel_name(PackagePath('foo.dist-info')) + 'foo.dist-info' + """ + return _topmost(name) or ( + # python/typeshed#10328 + inspect.getmodulename(name) # type: ignore + or str(name) + ) + + +def _top_level_inferred(dist): + opt_names = set(map(_get_toplevel_name, always_iterable(dist.files))) + + def importable_name(name): + return '.' not in name + + return filter(importable_name, opt_names) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..50014323807d59e6ec0c2f32727da50c4444f189 GIT binary patch literal 53275 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 QYNI;{MEgKS8;^td59QWJb^rhX literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_functools.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_functools.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6def528e2555a3111a37dd2fd1b957dfe8f7da62 GIT binary patch literal 3534 zcmai1O>7&-6`tjvWs8Q~$bkaKNvAFhlBmdaq^b&pNKNWCMNn7?svtppp@zFdaqZom z?aWXT1*(t%1Gai7oI{`-jUojS7y)|Ey_a6(I6z>ghXBnbHx+DwHmANfv;0vkxC?Op z-pqS%-uvF0$G@FDdxpUG*Uwn%%}GN3fs?_PNeBH)FgPGS@tu%dx4m=S@pFFWwsSq> zXK$11*^X1me~SlJy}>!0;W!Jw{yWgzA$ObuvhQp=>byg=154(+F@7Rldyw{jaPB&H zNi*X+wbj1YG(|)*BVMo=4oY*i6{~=O_*eUuo2O%7MCCc7)D&T zgirZ)5(ZwN!wyw!lPk(%!=@ekTq;jUUQHx#2HV`Hi4+<{+EK!#?oi;}45ZSaUl_t! zpGvOVGDhi48&0a-Q2cjo9)pZj$CZ^8>V-@xdaZL6`z5opR;!^w3@=5O>6O9ipf}W4 zt>)HT$0$B;rq?Pf9yVv`CJWoVa-2ExKxz#&R`e&!^rd4=kZ$i_k6Wvv#tc+S^(|M- z8M9im`jqGG+We5x6q0VEwM*eYP`o1 za4DFSHh7C|1|VrG00%TUI24=@-VB4A>3-21!OO7Z+a6E!h?&J!pbX%^yWms~SR6uY zmMUS5q3}8)=7!Axc~*2RG;M}$)f((8fXCcVi*kh(m)wTJ`Xvd%7}qm znF|`7{2?#6AOdQ5bPPz16W#JX>@ zE#`xRzyv;rxMCPbTY+xT_4Q^u_OuY8stxl%xw5`KYlO2Dsav8Q`oLt9TP}+~qh-Gh z))G$`jDpLr;8x5YDAF)8-T|SFjyX_jl!oT4r1rcTa)y>3|Vk$0a+TjRZum&2B`(qCEPIRdE6iKgHl%+{>3lb`1CmOL1 zNHEzn47k5E(%J%knVw|#h;6H2hcC~K!Z8i{RDn5AZ#)H+Ll!lBW|GPhou9Q@)Ke{% zjjR!`rzerQG_lNEU9YmX4j>w<)E5*3Y&@4zlwf?7rgGz~G~fmp6A*f;?X@hD6kzRD z$l@k<1HRxn2q4bA7A7eBU??83SO=a$3?UGVjX;UiL2H~-7Aj#FwzN)`T-OsmuR+!c z;Qi2m>zXGbS8^{%xN;X37k|1iS7p_RM*<96P0=r86|hkqBoQFvd!$?oRYXnd)F4Vi z9zm{S#uoU-Fy9Yw!a{nZt#r@~JVUIR!`|?bhW9uRzaPS{|9faY$Q=BiCw#xqB@fc4 zdN-RP`}uD6LCSA8r;(fax@5m_qcE6_`flz4mJaYaP)BrgT_=FY|0Cy*&Kmi|S*_%H zdEEiC^v+x}_k9~Cy;F+A<+SWg)ax+>O}$<@)yv@{)ypxtp?ZazTc$5I1iZ_2YpUK^ zno&x}?)PmBz`=3sztItk+%%1>^;_QcKCdfm^7bL-U_K^3BY}FK0>*XG$Lz z{*rq%vv9Zg__@pX!$;4}-#z>HiK%9LuVetUQOJrm%SiIUtPI*QpWSD~^kl7l4G=Q&njGyGM>*&yZ&?eSUuF zqxZhN{PM%gFF(4xw0G^_xqQC%&vWGY(%!GX$jy8``OMy`xzDlqKr#61{{osjV1TEW zxcg)f4N%}ZSl|wd-d(2)7_Ve@{%nHqT})1RZLA#vT~a20*<4TIO$?wwwUr~*rV*3^ zbQKE=a~NOM1WI3B*L+(;zD=M;tj9nvo8?hD9qlTYaBs7h-p_qL?S5Q%IPD%5-J>iizF>S<$;cTLmdE%| zFnbYZ7B~pK0d7tYMM?_G@4-)%paC)eI!_8ycj~w5_uhV#ztGQQ@>lv+El3JQPy#suSoGLa;`t|rsGWao0%zR H+Fay+vi#IC literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_itertools.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_itertools.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..87ca1401024572e2ac49b6860a8b3501e200b471 GIT binary patch literal 2458 zcmbtWUu+ab7@xV_D|hYTm48x&lF=g9ZH`_F^}z;eiu{ezkd{P&kh{IxIc{NZ_net) zZ)KaD#s{<{)?kDu!-EeHV#0%OKJnsqihxtVXi z|KD%s>vwC{_97VHexsK*#t`~VZki(!E>?HI;xaOjfh|v`--L|C@bm~r_+U|DtV~FHw546_b|PQFsK$7mch6Y{w_qk$k|S* zCSCDxeON@pEds8d=DPjsp&Oy>esuadgcj5Y@)S?K5!%7XQ$NR-A&`sxDsr)hfNx94 zhueG$Q7`I6<}k+>`vVQpE*b`r1;-Y;Y4dDW>+xeI zG9294S|nU zaV(z6&QaTNSjH?@940_2Tc$!cbfIUm()ECAwBq{7M!vE#dg(q(g1ZtWoWt}xdQ?Xb zVA9}to=7#{4KsAP$@ zgolb9GVzYP04NUeItv#@$czMIJ7P)v1YcW2A#wuEqIpzPP9TX$y#``Oie$vepB*74 zCr!|#34>BGo9K3f26ZNm#Gfewt}>sP=7ig z)8IfZ*O@6=t_Zi~PS^ZMp=aBdT%EZI?eBAmL5q6T5^0h*ZJoJLAA<;56NC!}adV@6E3y`k)OYH!SU2tX)X{8e4ZeHu&YlwZhHU z?hNgf^x36@i{9L7Tw#ifk*fHHal^RA#g@QX k9RAZlU<>14&`Ya5NxW@k2YO}r+NP^}9->`%E0gDc0h&6OtN;K2 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_meta.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_meta.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..54ec379d0f66f54c117956f329229032bfe1b322 GIT binary patch literal 3682 zcmb_f&2!U66ko}*EjdmCB!Q%)t#B#SQxX^GbV>^?v?(nNgbbuTh-NghwIK?U)~w_d z`$VTXaOi;>cWxQ}gx-7Uv4>{VVVaq6=`CP-;neq5vMnb-DeW@6eSZ7iz7OsG-sYFV z!2*Ht^H0{2mM3Hre{@DRW~BCQVD1u|*pf>;$&e)EWmh(2m@{t1Qw&AO6yUQ)*2@_= zFK^^M)lfan(7b|C@CJ+luV@q{A`@D$v-hQVcVkc{UlKdFO6)vU?q?F|kdUe%)l$;o zrd%%ki7I6&8nAqyg;wY=KbVEz>Ktbwt1-8%Mwv5yGg4-pS{SM4Ldva>@kqJg1n~P( z9Zf7Z%Fj3J^c#yu*{^+&L@HaM++~&>$>w}54kV^ZJW1_)z}zL27?MpO`vF^8Rg8>X zv}KqTd(h6noVAB+1?C*hYs4PbNavru3-Zj~Pj)s`nzwh``Bfz?*=DiFR#O%lSd7?O z%0h!$j@pHkWT2TXk43|CR_(fVjb5aoWm}R(B zKvn(ekCi3n(Te5Lo0W@AsO>VXg+b+uD|1t`%%(ASZsx3cnN?X>2^&yi$8syvUCwo? zm3lK=V*c^zqsJXXxONSjJZL@T%o?rc*XJRjE7)ldP&q3!A;kjQQkCN z>YHY3-?qf2lZ7G#-IjrTPuf694f*uwOPKG5CB6qpS>~fKMG8dc1!$z}d<-Q;)2uN+ zv>ZPGzmq%t_Ev{LpYKC54&>ju&RnO>KFtd)yr_UmfTa2#^X8FUCSiZ^(~J^`9;fdS#>!;YrRwF45ZT< z+3pyG_+0`3C31^w<;cWjT-=xR%u8sUcEsNX$uk{Ipemx>EwX;<^nY{{xC~c^`#QMLS1h+d1KkP&R&%V7+WL1+xTITpodtnY zb(^}^a6@NG=-E0PwCV0Pv*P?eqfYN&op#)_BzP=q?;yMoRxs)lU3X{n^H(m-PSu!K z2h6UzR9|G=)7hdPE>XR6<9CF&{j4g>0rOj<+m8!MG45VyWjV@mQK=~7_+eS$ufckh z2|~_~Ag5FTeL#$#gHIztvETp{kZ%p1OM1suuv!o|sGQ?(b=3Gl;38#~`83h*^cJDN zLzNGrrPz5$v>a4BqMP#zJ5}H7s*ZFw#r|~_I@`iC^m|*6##?ulV+Tn_I`+iaZ7Kqx ziz&j+#R%X4ud8WB1=IAH-EffyIK0uY+<1lW#qjncc>{@#q=*DB8OJXXsddikl!s0J zF3JRgAUq1p;ls!w8G!%6Js_*(cjdsQa%@wnY$``KvV$AtsjZBhom?N?7tf_bV&2g9 zKF)%?ogulQEg85i6}U(_EhOv8X@HB|P-0$6%uDOBd1*tNMDtSDyd=yY%b9F3kpZ_= zfGv8mN4P33stCFU@pcD-3=FCLEzs2KKr%Aj&acHUgw${GQlL4zfNzEF3m^|~iXy%e z3>97z@HQ|sculA<7oe{XM};fUC0#mag-fj&aktLsp5r^7sL z+MV(ei%w!xNxL|BSa_Lz*)n#X8!Gi{%y#^1ed%eOTDBR|n_+7-<+dyR6tn8RGhQ{d zg4nRy3~A6B+wMn*&-_1*a`Yw~xS+3wvFP(Y2Y|vSK+u{@VG;|(@x9<&rvgnEVtD=l z^b&aH$j6`@qgxugqpV1zqgp|;0e%!Mjv+Y?1YealtC=SM2t}um;Bn=m&YvMSgXAod zZTKa8Bf*`6^FUU~BfuhcOO>+|>tja|swOtHkv3q>#B+oKwGJn!b@(A--=T-fff#2* zrn?Y>7aP#<0fRXrO(e4*%7x8393HNKfa6i*IVAX~;3^Ug3I1uv5np3y7A->Ht_Z$A zp{MG}80tUa7r+9KR)CjiDI=~nfsN@JpzOsygmQJ!Y%np?toOh Wv-E_(^yDjPR4UyW|BJvR()b(0S|+{# literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_text.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/__pycache__/_text.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a4a124746faf8f23aca18ca64fd316ff2db9e961 GIT binary patch literal 3935 zcmcInO>7%Q6rQzXXOkv%Y54!0gd%%MV)G{fg$7#MLJKXZ0in8-)ns>4J6Z3VnRWgn zdWb|LK!5pRRd{gK}UuACC@f3W|g=V+J&+{h^&^N{TeL8Nl~*&F=1=P zq@9=}#TGjWGKI?&({>7EtDOd^pCQAV-8!ci+iV@$?R=Z+X`9oR>MImG>~_#}+8y?` zIjy+;44Kf1nL%Q72JHtu$L97EOma5eLP$G>vX@%Wre#-hSC;+q7^l(~W%m@d946%> zbcmPO7?*UUCVlFZN0nX;chznUNSCL>i zIaWSZ@`pV!&V(J~x+lh851ckVAx}mO;V#1yK~0lw%u3lG_iD7lCaKTC9bg?QxexPM zPEEoo_tBvmcm#9pvdw%>p+dRCE8O+N1F4`F4S9YE{0fGnKgLi-9Oaro7>IaU&i(`9 z>320y&Ps?opnrXpM%h z+d%|f)%F2Rt_REwZ@wa)W_>k>5Bs|#mx`?rMod<*(-Z(|iI`g-Lfi}wM)E#dQ}J$Y zJtqW#nQNLf^vve4+YHP=jKBH}^*{;{p|e?uSVF{nh`-hSAQs3B8Nn2~t~B!7jJB0_ z6y_Zyi`vmeEl4@uI2VhFpha?LI7orhL8RcqlwNtGQ1U9gz#KkNI5PR1@bH*r;lSW? z{YO2UhqXid51Pk3@YaG~^F2spP9eWmbIL=7>LjFi_x}97_Z1*_^8PBbM%gJC4M9<> z`kv>=f;q-r+Y^Oyr3%RaMwxIiFo+ITFnvDZ=c|)J+B6;CG^ehK_{@i0PXOH2n?Rf< z-(|Yqnwp<_eda7bKYDKTgUZEB@3P*zibP#CKH*3PiGXX8h&B}4K-4)D+o6uoPi=&b zT?f&A2a0PzTs4Hb|A3IcvVmOeIs~{jkXt)HeQx@L*^8OJWxem}LVxf-KzI2D=-BlP z@_PLmx$%I3n>`Gt2cWV*{52f}R^#abnnq~^)>7TBe%uDcO^L~pz{irIi4OQkG@;?S z>!yin0N2&zv|;D7Xx#Q*^?lK^tiB1!S5M zXQ%YE+PJtK8dEnk?Kzs^7$_wL@fU9V+WGPM+1FqFHq#5C`ssnso?d)<>BvfE_p-iw z3leUH;g|(u2d6a-XAGjz(57zQ@42_dkil$&m zh(@@nASr7@@vJCzflbqX1>WcnoNXLM92u2}Vi7$~$NlnwfCvCrwUBBxuXFopZ~Yzt_)}jpGKRwO0t$Wb!6zZCf^Ya{NZQ7#LBOZ?Vb%0=$SKSD`P&}=2+IIQ z_lCg)x};0&!Yh4Wd4+F)O_FjwkV*t=9To7Xp_LisQ84j4-bdC4HM04n2YW+E1eEqk zN#!!BrDOj`J!q20#@;YXc78^BM3U~mvzw}zh4x71=TkrTIKM{+7JT&-O`&xr^FKX( z>pt{I9kSxHJlToO0K2%7l$IkIvxW+y<}OKS?5Xu6x5PVLg1^j6aoBbeoA)93g)Jf*Jien z7}Z)ref%R*C$3aZ9ysf~%^WXecb$*AHw14XSm`W&eB;Ur_t`*Nt}nSa`5IS_>L@M( zFLbISDGb(}xU1HAG+VuT&5?m(SF*|+$y6s+oQKkJ?_hmgI6*t+LSdBKX3FzD_u zld0NkssG~V)9(;FpX6c@L@J@7o=A&U~);z48^!qT=}+L~c+#H3ag zh9JZ_yy>x%H<4|^0WEG_enj`_g@f|M!}GsQUV1WlY3GxjrTxj-XXUxg#TRELez)Gz zZtp*w-R^vQ{n5Rj%;$7YYc4*pzqAqR&U^b)wP&T;b9(g{vqD3&j5OMGKk6vpeq?%R zW$QZ90My~u7!C!T?g;MCaE5Ul#`QP|^Z?sTOxcxby=hINfLf_tD}#zn(TT(bypLP8x)?ksX?ZkUyaG5@wF_d2;ROtU;y^OF+w88&A!1FKFS5 L#X}S5Oq%Kq5IYZg literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_adapters.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_adapters.py new file mode 100644 index 000000000..6223263ed --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_adapters.py @@ -0,0 +1,83 @@ +import re +import textwrap +import email.message + +from ._text import FoldedCase + + +class Message(email.message.Message): + multiple_use_keys = set( + map( + FoldedCase, + [ + 'Classifier', + 'Obsoletes-Dist', + 'Platform', + 'Project-URL', + 'Provides-Dist', + 'Provides-Extra', + 'Requires-Dist', + 'Requires-External', + 'Supported-Platform', + 'Dynamic', + ], + ) + ) + """ + Keys that may be indicated multiple times per PEP 566. + """ + + def __new__(cls, orig: email.message.Message): + res = super().__new__(cls) + vars(res).update(vars(orig)) + return res + + def __init__(self, *args, **kwargs): + self._headers = self._repair_headers() + + # suppress spurious error from mypy + def __iter__(self): + return super().__iter__() + + def __getitem__(self, item): + """ + Override parent behavior to typical dict behavior. + + ``email.message.Message`` will emit None values for missing + keys. Typical mappings, including this ``Message``, will raise + a key error for missing keys. + + Ref python/importlib_metadata#371. + """ + res = super().__getitem__(item) + if res is None: + raise KeyError(item) + return res + + def _repair_headers(self): + def redent(value): + "Correct for RFC822 indentation" + if not value or '\n' not in value: + return value + return textwrap.dedent(' ' * 8 + value) + + headers = [(key, redent(value)) for key, value in vars(self)['_headers']] + if self._payload: + headers.append(('Description', self.get_payload())) + return headers + + @property + def json(self): + """ + Convert PackageMetadata to a JSON-compatible format + per PEP 0566. + """ + + def transform(key): + value = self.get_all(key) if key in self.multiple_use_keys else self[key] + if key == 'Keywords': + value = re.split(r'\s+', value) + tk = key.lower().replace('-', '_') + return tk, value + + return dict(map(transform, map(FoldedCase, self))) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_collections.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_collections.py new file mode 100644 index 000000000..cf0954e1a --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_collections.py @@ -0,0 +1,30 @@ +import collections + + +# from jaraco.collections 3.3 +class FreezableDefaultDict(collections.defaultdict): + """ + Often it is desirable to prevent the mutation of + a default dict after its initial construction, such + as to prevent mutation during iteration. + + >>> dd = FreezableDefaultDict(list) + >>> dd[0].append('1') + >>> dd.freeze() + >>> dd[1] + [] + >>> len(dd) + 1 + """ + + def __missing__(self, key): + return getattr(self, '_frozen', super().__missing__)(key) + + def freeze(self): + self._frozen = lambda key: self.default_factory() + + +class Pair(collections.namedtuple('Pair', 'name value')): + @classmethod + def parse(cls, text): + return cls(*map(str.strip, text.split("=", 1))) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_compat.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_compat.py new file mode 100644 index 000000000..df312b1cb --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_compat.py @@ -0,0 +1,57 @@ +import sys +import platform + + +__all__ = ['install', 'NullFinder'] + + +def install(cls): + """ + Class decorator for installation on sys.meta_path. + + Adds the backport DistributionFinder to sys.meta_path and + attempts to disable the finder functionality of the stdlib + DistributionFinder. + """ + sys.meta_path.append(cls()) + disable_stdlib_finder() + return cls + + +def disable_stdlib_finder(): + """ + Give the backport primacy for discovering path-based distributions + by monkey-patching the stdlib O_O. + + See #91 for more background for rationale on this sketchy + behavior. + """ + + def matches(finder): + return getattr( + finder, '__module__', None + ) == '_frozen_importlib_external' and hasattr(finder, 'find_distributions') + + for finder in filter(matches, sys.meta_path): # pragma: nocover + del finder.find_distributions + + +class NullFinder: + """ + A "Finder" (aka "MetaPathFinder") that never finds any modules, + but may find distributions. + """ + + @staticmethod + def find_spec(*args, **kwargs): + return None + + +def pypy_partial(val): + """ + Adjust for variable stacklevel on partial under PyPy. + + Workaround for #327. + """ + is_pypy = platform.python_implementation() == 'PyPy' + return val + is_pypy diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_functools.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_functools.py new file mode 100644 index 000000000..71f66bd03 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_functools.py @@ -0,0 +1,104 @@ +import types +import functools + + +# from jaraco.functools 3.3 +def method_cache(method, cache_wrapper=None): + """ + Wrap lru_cache to support storing the cache data in the object instances. + + Abstracts the common paradigm where the method explicitly saves an + underscore-prefixed protected property on first call and returns that + subsequently. + + >>> class MyClass: + ... calls = 0 + ... + ... @method_cache + ... def method(self, value): + ... self.calls += 1 + ... return value + + >>> a = MyClass() + >>> a.method(3) + 3 + >>> for x in range(75): + ... res = a.method(x) + >>> a.calls + 75 + + Note that the apparent behavior will be exactly like that of lru_cache + except that the cache is stored on each instance, so values in one + instance will not flush values from another, and when an instance is + deleted, so are the cached values for that instance. + + >>> b = MyClass() + >>> for x in range(35): + ... res = b.method(x) + >>> b.calls + 35 + >>> a.method(0) + 0 + >>> a.calls + 75 + + Note that if method had been decorated with ``functools.lru_cache()``, + a.calls would have been 76 (due to the cached value of 0 having been + flushed by the 'b' instance). + + Clear the cache with ``.cache_clear()`` + + >>> a.method.cache_clear() + + Same for a method that hasn't yet been called. + + >>> c = MyClass() + >>> c.method.cache_clear() + + Another cache wrapper may be supplied: + + >>> cache = functools.lru_cache(maxsize=2) + >>> MyClass.method2 = method_cache(lambda self: 3, cache_wrapper=cache) + >>> a = MyClass() + >>> a.method2() + 3 + + Caution - do not subsequently wrap the method with another decorator, such + as ``@property``, which changes the semantics of the function. + + See also + http://code.activestate.com/recipes/577452-a-memoize-decorator-for-instance-methods/ + for another implementation and additional justification. + """ + cache_wrapper = cache_wrapper or functools.lru_cache() + + def wrapper(self, *args, **kwargs): + # it's the first call, replace the method with a cached, bound method + bound_method = types.MethodType(method, self) + cached_method = cache_wrapper(bound_method) + setattr(self, method.__name__, cached_method) + return cached_method(*args, **kwargs) + + # Support cache clear even before cache has been created. + wrapper.cache_clear = lambda: None + + return wrapper + + +# From jaraco.functools 3.3 +def pass_none(func): + """ + Wrap func so it's not called if its first param is None + + >>> print_text = pass_none(print) + >>> print_text('text') + text + >>> print_text(None) + """ + + @functools.wraps(func) + def wrapper(param, *args, **kwargs): + if param is not None: + return func(param, *args, **kwargs) + + return wrapper diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_itertools.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_itertools.py new file mode 100644 index 000000000..d4ca9b914 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_itertools.py @@ -0,0 +1,73 @@ +from itertools import filterfalse + + +def unique_everseen(iterable, key=None): + "List unique elements, preserving order. Remember all elements ever seen." + # unique_everseen('AAAABBBCCDAABBB') --> A B C D + # unique_everseen('ABBCcAD', str.lower) --> A B C D + seen = set() + seen_add = seen.add + if key is None: + for element in filterfalse(seen.__contains__, iterable): + seen_add(element) + yield element + else: + for element in iterable: + k = key(element) + if k not in seen: + seen_add(k) + yield element + + +# copied from more_itertools 8.8 +def always_iterable(obj, base_type=(str, bytes)): + """If *obj* is iterable, return an iterator over its items:: + + >>> obj = (1, 2, 3) + >>> list(always_iterable(obj)) + [1, 2, 3] + + If *obj* is not iterable, return a one-item iterable containing *obj*:: + + >>> obj = 1 + >>> list(always_iterable(obj)) + [1] + + If *obj* is ``None``, return an empty iterable: + + >>> obj = None + >>> list(always_iterable(None)) + [] + + By default, binary and text strings are not considered iterable:: + + >>> obj = 'foo' + >>> list(always_iterable(obj)) + ['foo'] + + If *base_type* is set, objects for which ``isinstance(obj, base_type)`` + returns ``True`` won't be considered iterable. + + >>> obj = {'a': 1} + >>> list(always_iterable(obj)) # Iterate over the dict's keys + ['a'] + >>> list(always_iterable(obj, base_type=dict)) # Treat dicts as a unit + [{'a': 1}] + + Set *base_type* to ``None`` to avoid any special handling and treat objects + Python considers iterable as iterable: + + >>> obj = 'foo' + >>> list(always_iterable(obj, base_type=None)) + ['f', 'o', 'o'] + """ + if obj is None: + return iter(()) + + if (base_type is not None) and isinstance(obj, base_type): + return iter((obj,)) + + try: + return iter(obj) + except TypeError: + return iter((obj,)) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_meta.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_meta.py new file mode 100644 index 000000000..1927d0f62 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_meta.py @@ -0,0 +1,67 @@ +from __future__ import annotations + +import os +from typing import Protocol +from typing import Any, Dict, Iterator, List, Optional, TypeVar, Union, overload + + +_T = TypeVar("_T") + + +class PackageMetadata(Protocol): + def __len__(self) -> int: ... # pragma: no cover + + def __contains__(self, item: str) -> bool: ... # pragma: no cover + + def __getitem__(self, key: str) -> str: ... # pragma: no cover + + def __iter__(self) -> Iterator[str]: ... # pragma: no cover + + @overload + def get( + self, name: str, failobj: None = None + ) -> Optional[str]: ... # pragma: no cover + + @overload + def get(self, name: str, failobj: _T) -> Union[str, _T]: ... # pragma: no cover + + # overload per python/importlib_metadata#435 + @overload + def get_all( + self, name: str, failobj: None = None + ) -> Optional[List[Any]]: ... # pragma: no cover + + @overload + def get_all(self, name: str, failobj: _T) -> Union[List[Any], _T]: + """ + Return all values associated with a possibly multi-valued key. + """ + + @property + def json(self) -> Dict[str, Union[str, List[str]]]: + """ + A JSON-compatible form of the metadata. + """ + + +class SimplePath(Protocol): + """ + A minimal subset of pathlib.Path required by Distribution. + """ + + def joinpath( + self, other: Union[str, os.PathLike[str]] + ) -> SimplePath: ... # pragma: no cover + + def __truediv__( + self, other: Union[str, os.PathLike[str]] + ) -> SimplePath: ... # pragma: no cover + + @property + def parent(self) -> SimplePath: ... # pragma: no cover + + def read_text(self, encoding=None) -> str: ... # pragma: no cover + + def read_bytes(self) -> bytes: ... # pragma: no cover + + def exists(self) -> bool: ... # pragma: no cover diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_text.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_text.py new file mode 100644 index 000000000..c88cfbb23 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/_text.py @@ -0,0 +1,99 @@ +import re + +from ._functools import method_cache + + +# from jaraco.text 3.5 +class FoldedCase(str): + """ + A case insensitive string class; behaves just like str + except compares equal when the only variation is case. + + >>> s = FoldedCase('hello world') + + >>> s == 'Hello World' + True + + >>> 'Hello World' == s + True + + >>> s != 'Hello World' + False + + >>> s.index('O') + 4 + + >>> s.split('O') + ['hell', ' w', 'rld'] + + >>> sorted(map(FoldedCase, ['GAMMA', 'alpha', 'Beta'])) + ['alpha', 'Beta', 'GAMMA'] + + Sequence membership is straightforward. + + >>> "Hello World" in [s] + True + >>> s in ["Hello World"] + True + + You may test for set inclusion, but candidate and elements + must both be folded. + + >>> FoldedCase("Hello World") in {s} + True + >>> s in {FoldedCase("Hello World")} + True + + String inclusion works as long as the FoldedCase object + is on the right. + + >>> "hello" in FoldedCase("Hello World") + True + + But not if the FoldedCase object is on the left: + + >>> FoldedCase('hello') in 'Hello World' + False + + In that case, use in_: + + >>> FoldedCase('hello').in_('Hello World') + True + + >>> FoldedCase('hello') > FoldedCase('Hello') + False + """ + + def __lt__(self, other): + return self.lower() < other.lower() + + def __gt__(self, other): + return self.lower() > other.lower() + + def __eq__(self, other): + return self.lower() == other.lower() + + def __ne__(self, other): + return self.lower() != other.lower() + + def __hash__(self): + return hash(self.lower()) + + def __contains__(self, other): + return super().lower().__contains__(other.lower()) + + def in_(self, other): + "Does self appear in other?" + return self in FoldedCase(other) + + # cache lower since it's likely to be called frequently. + @method_cache + def lower(self): + return super().lower() + + def index(self, sub): + return self.lower().index(sub.lower()) + + def split(self, splitter=' ', maxsplit=0): + pattern = re.compile(re.escape(splitter), re.I) + return pattern.split(self, maxsplit) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..a6950385efac71c24862b91b365dc915aeb8398c GIT binary patch literal 247 zcmZ9GL23d)5Jjgo0SU}OTsTGIHe{tj77;NAXv&!)(@FPK(_Issi|83VgZpf9jGQ32 zbCn(fF8okcuZsVnzVrMpOZqxu-Or!CUF&p{F8i#@#%g)U!XRy@-gDkT&5i&qZQ-R` z1%9VeBFtY`lO0AiVVEDYwvw6i@#1cC%Oy{bA<+XXgLE|9k)c zzdy&vM-j*$ztP4u525GourF}VWbZPl4a5+`5|#TJmvMIX%3h}Zvd_Gms2p&wnIR5h z2a5SEK+`@C$|GIO0`LS~%U@PlA$;IWK~IXVf4Q37&B=@!*0i5RIXO&Zq5=1dr_2-`@irJ8Doao09f6xIe> z7?W@l&VBsJ>|BOm6`_ogDy_BFsAdFWVroTINMXAf=o*!+N)mr|Stq=d#e5MF-l6SS zazg8MUbCE$7y#%BC&Ca$O>0`xD(_ex8KI(&$XY|x8YD5?WB|*()^V?Xt7 z_wIgq@4}r6_b%PJw0Z8~2Tx9X`eb76(Sf-=a6(0_4>{$fIopl7Nhg+pi{y*6%?%6- zFM3&RGB4w5eU0dGP-);O=p$g}VHpA&q})A%K0Ngj;oSU-5mY$*Y>Ye}Bb!&Bj?F&` z=JfY-(%op~QfrnqC=dq4N917{^|R~cQ<$KmoA zEaN=a(eH=XQ9nywyMfV;Tk4yx(XKEV-L$aEwfjjbBC4yjFf3kObhN|D0J4vSL~X?q z$rtnqcyJ6%3ASAyW4w(HZlgonXmlGD{uwFYGrK3z@%NrhPCcHS+MN1pa^{x3QTX-y I8-)z-HN>1qtpET3 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/__pycache__/py39.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/compat/__pycache__/py39.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..aaeb6a58c379a8a77acadd3f1a665ee34994fa17 GIT binary patch literal 1690 zcmZ`(U1%It6ux(6c6N62Gbz^A2&vO-AS|^RZJ?ymR+c0+K~0xNn`EKvPIhjylkUtN z?%YkXON3Hx3xR6+8Z+l1tbciGwx?>jbP@s>yUq zEu9>su5WQ?+9^A{YLu-iVaB|}OGdWJOVl&^`v%PZzH`Z^BD1s{w!Jr%9nKGq3=h6N zI`&p5XS`~tUG}*{J*)gw5=K(kI^+bLInx!P4wJ(kXVolqJRT}G?1U;Kyu!R97D0DO zgIR{LeGk}Olt7DU7No;8j#7w=V@04y2-@=j#%K}GCYrnZGjD0ii%2x?fj9|h z0S7wxpxM^O`dMzrMEf4>=2(=b&^Ve$3-T12$7!{8EolIaP>(Xhvs_|;;96y;2Hk|d zT?e(Owb_Nh;3bP2HuZYB;WIkt*u*Fl@=Y&d=S7r4p)ZQdR5&}0LoLgQZ!uzrir5|t zl`)vo@v!5tXV{+Mjnl|5W0Zx6iK4>9-U(rRhHwjvLd^xiwz!oBAc0Y28HlbL#?Gf^ ziMqtJ%4ETOx0+>imK1ql4v%L~k5QX6q|u>E`73mqa+6m$WsX%g`}U-=Gi~}2eER!d zKVt?CC#QX@c*B|j?*M+i&nYbjW`2%%Hf5&c`jm0-$~W^eixDg#O8>b&zZ&X$MKs#P zjzO;NFoG;PXI<}E(|Z2-rKR&vB!l*`_R16e_?CWhT|arhce&@G z`i-*LePN^f>Z7ASbgg#%IJcg;x~WfWXcP6gaM%fS2zslf9o;#fX_Hr5G4N0#{sFwk z!A78J`#WF)uhRb@)|MSW<$Zhy{|CF7XRs?_hyXDpK%=+|hX}OMvvE-UeB?IK{k;3L zpUojeE49lJ@+K&|VKG|q>B9T80Iu{K~~Y|biINEn-ev;DNpjtiv<*tgsuG7H3=g)7Hi6gx@c z=bPb9fZ}Bs!8Kq43~Fo?z|i>-`?z+ywyvj^E&*H9QVmcju=`j$SyxfVo40FA-Cy*6 z-h1!NR|8)TEMNJ0a%FN;Kf9%0To>QSqhr7}w2^v3cgGG2yir#Z lcoHwYT1R4D9(Xvoa$!4?>n|noC Optional[str]: + """ + Honor name normalization for distributions that don't provide ``_normalized_name``. + """ + try: + return dist._normalized_name + except AttributeError: + from .. import Prepared # -> delay to prevent circular imports. + + return Prepared.normalize(getattr(dist, "name", None) or dist.metadata['Name']) + + +def ep_matches(ep: EntryPoint, **params) -> bool: + """ + Workaround for ``EntryPoint`` objects without the ``matches`` method. + """ + try: + return ep.matches(**params) + except AttributeError: + from .. import EntryPoint # -> delay to prevent circular imports. + + # Reconstruct the EntryPoint object to make sure it is compatible. + return EntryPoint(ep.name, ep.value, ep.group).matches(**params) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/diagnose.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/diagnose.py new file mode 100644 index 000000000..e405471ac --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/diagnose.py @@ -0,0 +1,21 @@ +import sys + +from . import Distribution + + +def inspect(path): + print("Inspecting", path) + dists = list(Distribution.discover(path=[path])) + if not dists: + return + print("Found", len(dists), "packages:", end=' ') + print(', '.join(dist.name for dist in dists)) + + +def run(): + for path in sys.path: + inspect(path) + + +if __name__ == '__main__': + run() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/py.typed b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/importlib_metadata/py.typed new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/INSTALLER new file mode 100644 index 000000000..a1b589e38 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/LICENSE new file mode 100644 index 000000000..1bb5a4435 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/LICENSE @@ -0,0 +1,17 @@ +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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/METADATA new file mode 100644 index 000000000..9a2097a54 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/METADATA @@ -0,0 +1,591 @@ +Metadata-Version: 2.1 +Name: inflect +Version: 7.3.1 +Summary: Correctly generate plurals, singular nouns, ordinals, indefinite articles +Author-email: Paul Dyson +Maintainer-email: "Jason R. Coombs" +Project-URL: Source, https://github.com/jaraco/inflect +Keywords: plural,inflect,participle +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Natural Language :: English +Classifier: Operating System :: OS Independent +Classifier: Topic :: Software Development :: Libraries :: Python Modules +Classifier: Topic :: Text Processing :: Linguistic +Requires-Python: >=3.8 +Description-Content-Type: text/x-rst +License-File: LICENSE +Requires-Dist: more-itertools >=8.5.0 +Requires-Dist: typeguard >=4.0.1 +Requires-Dist: typing-extensions ; python_version < "3.9" +Provides-Extra: doc +Requires-Dist: sphinx >=3.5 ; extra == 'doc' +Requires-Dist: jaraco.packaging >=9.3 ; extra == 'doc' +Requires-Dist: rst.linker >=1.9 ; extra == 'doc' +Requires-Dist: furo ; extra == 'doc' +Requires-Dist: sphinx-lint ; extra == 'doc' +Requires-Dist: jaraco.tidelift >=1.4 ; extra == 'doc' +Provides-Extra: test +Requires-Dist: pytest !=8.1.*,>=6 ; extra == 'test' +Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'test' +Requires-Dist: pytest-cov ; extra == 'test' +Requires-Dist: pytest-mypy ; extra == 'test' +Requires-Dist: pytest-enabler >=2.2 ; extra == 'test' +Requires-Dist: pytest-ruff >=0.2.1 ; extra == 'test' +Requires-Dist: pygments ; extra == 'test' + +.. image:: https://img.shields.io/pypi/v/inflect.svg + :target: https://pypi.org/project/inflect + +.. image:: https://img.shields.io/pypi/pyversions/inflect.svg + +.. image:: https://github.com/jaraco/inflect/actions/workflows/main.yml/badge.svg + :target: https://github.com/jaraco/inflect/actions?query=workflow%3A%22tests%22 + :alt: tests + +.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json + :target: https://github.com/astral-sh/ruff + :alt: Ruff + +.. image:: https://readthedocs.org/projects/inflect/badge/?version=latest + :target: https://inflect.readthedocs.io/en/latest/?badge=latest + +.. image:: https://img.shields.io/badge/skeleton-2024-informational + :target: https://blog.jaraco.com/skeleton + +.. image:: https://tidelift.com/badges/package/pypi/inflect + :target: https://tidelift.com/subscription/pkg/pypi-inflect?utm_source=pypi-inflect&utm_medium=readme + +NAME +==== + +inflect.py - Correctly generate plurals, singular nouns, ordinals, indefinite articles; convert numbers to words. + +SYNOPSIS +======== + +.. code-block:: python + + import inflect + + p = inflect.engine() + + # METHODS: + + # plural plural_noun plural_verb plural_adj singular_noun no num + # compare compare_nouns compare_nouns compare_adjs + # a an + # present_participle + # ordinal number_to_words + # join + # inflect classical gender + # defnoun defverb defadj defa defan + + + # UNCONDITIONALLY FORM THE PLURAL + + print("The plural of ", word, " is ", p.plural(word)) + + + # CONDITIONALLY FORM THE PLURAL + + print("I saw", cat_count, p.plural("cat", cat_count)) + + + # FORM PLURALS FOR SPECIFIC PARTS OF SPEECH + + print( + p.plural_noun("I", N1), + p.plural_verb("saw", N1), + p.plural_adj("my", N2), + p.plural_noun("saw", N2), + ) + + + # FORM THE SINGULAR OF PLURAL NOUNS + + print("The singular of ", word, " is ", p.singular_noun(word)) + + # SELECT THE GENDER OF SINGULAR PRONOUNS + + print(p.singular_noun("they")) # 'it' + p.gender("feminine") + print(p.singular_noun("they")) # 'she' + + + # DEAL WITH "0/1/N" -> "no/1/N" TRANSLATION: + + print("There ", p.plural_verb("was", errors), p.no(" error", errors)) + + + # USE DEFAULT COUNTS: + + print( + p.num(N1, ""), + p.plural("I"), + p.plural_verb(" saw"), + p.num(N2), + p.plural_noun(" saw"), + ) + print("There ", p.num(errors, ""), p.plural_verb("was"), p.no(" error")) + + + # COMPARE TWO WORDS "NUMBER-INSENSITIVELY": + + if p.compare(word1, word2): + print("same") + if p.compare_nouns(word1, word2): + print("same noun") + if p.compare_verbs(word1, word2): + print("same verb") + if p.compare_adjs(word1, word2): + print("same adj.") + + + # ADD CORRECT "a" OR "an" FOR A GIVEN WORD: + + print("Did you want ", p.a(thing), " or ", p.an(idea)) + + + # CONVERT NUMERALS INTO ORDINALS (i.e. 1->1st, 2->2nd, 3->3rd, etc.) + + print("It was", p.ordinal(position), " from the left\n") + + # CONVERT NUMERALS TO WORDS (i.e. 1->"one", 101->"one hundred and one", etc.) + # RETURNS A SINGLE STRING... + + words = p.number_to_words(1234) + # "one thousand, two hundred and thirty-four" + words = p.number_to_words(p.ordinal(1234)) + # "one thousand, two hundred and thirty-fourth" + + + # GET BACK A LIST OF STRINGS, ONE FOR EACH "CHUNK"... + + words = p.number_to_words(1234, wantlist=True) + # ("one thousand","two hundred and thirty-four") + + + # OPTIONAL PARAMETERS CHANGE TRANSLATION: + + words = p.number_to_words(12345, group=1) + # "one, two, three, four, five" + + words = p.number_to_words(12345, group=2) + # "twelve, thirty-four, five" + + words = p.number_to_words(12345, group=3) + # "one twenty-three, forty-five" + + words = p.number_to_words(1234, andword="") + # "one thousand, two hundred thirty-four" + + words = p.number_to_words(1234, andword=", plus") + # "one thousand, two hundred, plus thirty-four" + # TODO: I get no comma before plus: check perl + + words = p.number_to_words(555_1202, group=1, zero="oh") + # "five, five, five, one, two, oh, two" + + words = p.number_to_words(555_1202, group=1, one="unity") + # "five, five, five, unity, two, oh, two" + + words = p.number_to_words(123.456, group=1, decimal="mark") + # "one two three mark four five six" + # TODO: DOCBUG: perl gives commas here as do I + + # LITERAL STYLE ONLY NAMES NUMBERS LESS THAN A CERTAIN THRESHOLD... + + words = p.number_to_words(9, threshold=10) # "nine" + words = p.number_to_words(10, threshold=10) # "ten" + words = p.number_to_words(11, threshold=10) # "11" + words = p.number_to_words(1000, threshold=10) # "1,000" + + # JOIN WORDS INTO A LIST: + + mylist = p.join(("apple", "banana", "carrot")) + # "apple, banana, and carrot" + + mylist = p.join(("apple", "banana")) + # "apple and banana" + + mylist = p.join(("apple", "banana", "carrot"), final_sep="") + # "apple, banana and carrot" + + + # REQUIRE "CLASSICAL" PLURALS (EG: "focus"->"foci", "cherub"->"cherubim") + + p.classical() # USE ALL CLASSICAL PLURALS + + p.classical(all=True) # USE ALL CLASSICAL PLURALS + p.classical(all=False) # SWITCH OFF CLASSICAL MODE + + p.classical(zero=True) # "no error" INSTEAD OF "no errors" + p.classical(zero=False) # "no errors" INSTEAD OF "no error" + + p.classical(herd=True) # "2 buffalo" INSTEAD OF "2 buffalos" + p.classical(herd=False) # "2 buffalos" INSTEAD OF "2 buffalo" + + p.classical(persons=True) # "2 chairpersons" INSTEAD OF "2 chairpeople" + p.classical(persons=False) # "2 chairpeople" INSTEAD OF "2 chairpersons" + + p.classical(ancient=True) # "2 formulae" INSTEAD OF "2 formulas" + p.classical(ancient=False) # "2 formulas" INSTEAD OF "2 formulae" + + + # INTERPOLATE "plural()", "plural_noun()", "plural_verb()", "plural_adj()", "singular_noun()", + # a()", "an()", "num()" AND "ordinal()" WITHIN STRINGS: + + print(p.inflect("The plural of {0} is plural('{0}')".format(word))) + print(p.inflect("The singular of {0} is singular_noun('{0}')".format(word))) + print(p.inflect("I saw {0} plural('cat',{0})".format(cat_count))) + print( + p.inflect( + "plural('I',{0}) " + "plural_verb('saw',{0}) " + "plural('a',{1}) " + "plural_noun('saw',{1})".format(N1, N2) + ) + ) + print( + p.inflect( + "num({0}, False)plural('I') " + "plural_verb('saw') " + "num({1}, False)plural('a') " + "plural_noun('saw')".format(N1, N2) + ) + ) + print(p.inflect("I saw num({0}) plural('cat')\nnum()".format(cat_count))) + print(p.inflect("There plural_verb('was',{0}) no('error',{0})".format(errors))) + print(p.inflect("There num({0}, False)plural_verb('was') no('error')".format(errors))) + print(p.inflect("Did you want a('{0}') or an('{1}')".format(thing, idea))) + print(p.inflect("It was ordinal('{0}') from the left".format(position))) + + + # ADD USER-DEFINED INFLECTIONS (OVERRIDING INBUILT RULES): + + p.defnoun("VAX", "VAXen") # SINGULAR => PLURAL + + p.defverb( + "will", # 1ST PERSON SINGULAR + "shall", # 1ST PERSON PLURAL + "will", # 2ND PERSON SINGULAR + "will", # 2ND PERSON PLURAL + "will", # 3RD PERSON SINGULAR + "will", # 3RD PERSON PLURAL + ) + + p.defadj("hir", "their") # SINGULAR => PLURAL + + p.defa("h") # "AY HALWAYS SEZ 'HAITCH'!" + + p.defan("horrendous.*") # "AN HORRENDOUS AFFECTATION" + + +DESCRIPTION +=========== + +The methods of the class ``engine`` in module ``inflect.py`` provide plural +inflections, singular noun inflections, "a"/"an" selection for English words, +and manipulation of numbers as words. + +Plural forms of all nouns, most verbs, and some adjectives are +provided. Where appropriate, "classical" variants (for example: "brother" -> +"brethren", "dogma" -> "dogmata", etc.) are also provided. + +Single forms of nouns are also provided. The gender of singular pronouns +can be chosen (for example "they" -> "it" or "she" or "he" or "they"). + +Pronunciation-based "a"/"an" selection is provided for all English +words, and most initialisms. + +It is also possible to inflect numerals (1,2,3) to ordinals (1st, 2nd, 3rd) +and to English words ("one", "two", "three"). + +In generating these inflections, ``inflect.py`` follows the Oxford +English Dictionary and the guidelines in Fowler's Modern English +Usage, preferring the former where the two disagree. + +The module is built around standard British spelling, but is designed +to cope with common American variants as well. Slang, jargon, and +other English dialects are *not* explicitly catered for. + +Where two or more inflected forms exist for a single word (typically a +"classical" form and a "modern" form), ``inflect.py`` prefers the +more common form (typically the "modern" one), unless "classical" +processing has been specified +(see `MODERN VS CLASSICAL INFLECTIONS`). + +FORMING PLURALS AND SINGULARS +============================= + +Inflecting Plurals and Singulars +-------------------------------- + +All of the ``plural...`` plural inflection methods take the word to be +inflected as their first argument and return the corresponding inflection. +Note that all such methods expect the *singular* form of the word. The +results of passing a plural form are undefined (and unlikely to be correct). +Similarly, the ``si...`` singular inflection method expects the *plural* +form of the word. + +The ``plural...`` methods also take an optional second argument, +which indicates the grammatical "number" of the word (or of another word +with which the word being inflected must agree). If the "number" argument is +supplied and is not ``1`` (or ``"one"`` or ``"a"``, or some other adjective that +implies the singular), the plural form of the word is returned. If the +"number" argument *does* indicate singularity, the (uninflected) word +itself is returned. If the number argument is omitted, the plural form +is returned unconditionally. + +The ``si...`` method takes a second argument in a similar fashion. If it is +some form of the number ``1``, or is omitted, the singular form is returned. +Otherwise the plural is returned unaltered. + + +The various methods of ``inflect.engine`` are: + + + +``plural_noun(word, count=None)`` + + The method ``plural_noun()`` takes a *singular* English noun or + pronoun and returns its plural. Pronouns in the nominative ("I" -> + "we") and accusative ("me" -> "us") cases are handled, as are + possessive pronouns ("mine" -> "ours"). + + +``plural_verb(word, count=None)`` + + The method ``plural_verb()`` takes the *singular* form of a + conjugated verb (that is, one which is already in the correct "person" + and "mood") and returns the corresponding plural conjugation. + + +``plural_adj(word, count=None)`` + + The method ``plural_adj()`` takes the *singular* form of + certain types of adjectives and returns the corresponding plural form. + Adjectives that are correctly handled include: "numerical" adjectives + ("a" -> "some"), demonstrative adjectives ("this" -> "these", "that" -> + "those"), and possessives ("my" -> "our", "cat's" -> "cats'", "child's" + -> "childrens'", etc.) + + +``plural(word, count=None)`` + + The method ``plural()`` takes a *singular* English noun, + pronoun, verb, or adjective and returns its plural form. Where a word + has more than one inflection depending on its part of speech (for + example, the noun "thought" inflects to "thoughts", the verb "thought" + to "thought"), the (singular) noun sense is preferred to the (singular) + verb sense. + + Hence ``plural("knife")`` will return "knives" ("knife" having been treated + as a singular noun), whereas ``plural("knifes")`` will return "knife" + ("knifes" having been treated as a 3rd person singular verb). + + The inherent ambiguity of such cases suggests that, + where the part of speech is known, ``plural_noun``, ``plural_verb``, and + ``plural_adj`` should be used in preference to ``plural``. + + +``singular_noun(word, count=None)`` + + The method ``singular_noun()`` takes a *plural* English noun or + pronoun and returns its singular. Pronouns in the nominative ("we" -> + "I") and accusative ("us" -> "me") cases are handled, as are + possessive pronouns ("ours" -> "mine"). When third person + singular pronouns are returned they take the neuter gender by default + ("they" -> "it"), not ("they"-> "she") nor ("they" -> "he"). This can be + changed with ``gender()``. + +Note that all these methods ignore any whitespace surrounding the +word being inflected, but preserve that whitespace when the result is +returned. For example, ``plural(" cat ")`` returns " cats ". + + +``gender(genderletter)`` + + The third person plural pronoun takes the same form for the female, male and + neuter (e.g. "they"). The singular however, depends upon gender (e.g. "she", + "he", "it" and "they" -- "they" being the gender neutral form.) By default + ``singular_noun`` returns the neuter form, however, the gender can be selected with + the ``gender`` method. Pass the first letter of the gender to + ``gender`` to return the f(eminine), m(asculine), n(euter) or t(hey) + form of the singular. e.g. + gender('f') followed by singular_noun('themselves') returns 'herself'. + +Numbered plurals +---------------- + +The ``plural...`` methods return only the inflected word, not the count that +was used to inflect it. Thus, in order to produce "I saw 3 ducks", it +is necessary to use: + +.. code-block:: python + + print("I saw", N, p.plural_noun(animal, N)) + +Since the usual purpose of producing a plural is to make it agree with +a preceding count, inflect.py provides a method +(``no(word, count)``) which, given a word and a(n optional) count, returns the +count followed by the correctly inflected word. Hence the previous +example can be rewritten: + +.. code-block:: python + + print("I saw ", p.no(animal, N)) + +In addition, if the count is zero (or some other term which implies +zero, such as ``"zero"``, ``"nil"``, etc.) the count is replaced by the +word "no". Hence, if ``N`` had the value zero, the previous example +would print (the somewhat more elegant):: + + I saw no animals + +rather than:: + + I saw 0 animals + +Note that the name of the method is a pun: the method +returns either a number (a *No.*) or a ``"no"``, in front of the +inflected word. + + +Reducing the number of counts required +-------------------------------------- + +In some contexts, the need to supply an explicit count to the various +``plural...`` methods makes for tiresome repetition. For example: + +.. code-block:: python + + print( + plural_adj("This", errors), + plural_noun(" error", errors), + plural_verb(" was", errors), + " fatal.", + ) + +inflect.py therefore provides a method +(``num(count=None, show=None)``) which may be used to set a persistent "default number" +value. If such a value is set, it is subsequently used whenever an +optional second "number" argument is omitted. The default value thus set +can subsequently be removed by calling ``num()`` with no arguments. +Hence we could rewrite the previous example: + +.. code-block:: python + + p.num(errors) + print(p.plural_adj("This"), p.plural_noun(" error"), p.plural_verb(" was"), "fatal.") + p.num() + +Normally, ``num()`` returns its first argument, so that it may also +be "inlined" in contexts like: + +.. code-block:: python + + print(p.num(errors), p.plural_noun(" error"), p.plural_verb(" was"), " detected.") + if severity > 1: + print( + p.plural_adj("This"), p.plural_noun(" error"), p.plural_verb(" was"), "fatal." + ) + +However, in certain contexts (see `INTERPOLATING INFLECTIONS IN STRINGS`) +it is preferable that ``num()`` return an empty string. Hence ``num()`` +provides an optional second argument. If that argument is supplied (that is, if +it is defined) and evaluates to false, ``num`` returns an empty string +instead of its first argument. For example: + +.. code-block:: python + + print(p.num(errors, 0), p.no("error"), p.plural_verb(" was"), " detected.") + if severity > 1: + print( + p.plural_adj("This"), p.plural_noun(" error"), p.plural_verb(" was"), "fatal." + ) + + + +Number-insensitive equality +--------------------------- + +inflect.py also provides a solution to the problem +of comparing words of differing plurality through the methods +``compare(word1, word2)``, ``compare_nouns(word1, word2)``, +``compare_verbs(word1, word2)``, and ``compare_adjs(word1, word2)``. +Each of these methods takes two strings, and compares them +using the corresponding plural-inflection method (``plural()``, ``plural_noun()``, +``plural_verb()``, and ``plural_adj()`` respectively). + +The comparison returns true if: + +- the strings are equal, or +- one string is equal to a plural form of the other, or +- the strings are two different plural forms of the one word. + + +Hence all of the following return true: + +.. code-block:: python + + p.compare("index", "index") # RETURNS "eq" + p.compare("index", "indexes") # RETURNS "s:p" + p.compare("index", "indices") # RETURNS "s:p" + p.compare("indexes", "index") # RETURNS "p:s" + p.compare("indices", "index") # RETURNS "p:s" + p.compare("indices", "indexes") # RETURNS "p:p" + p.compare("indexes", "indices") # RETURNS "p:p" + p.compare("indices", "indices") # RETURNS "eq" + +As indicated by the comments in the previous example, the actual value +returned by the various ``compare`` methods encodes which of the +three equality rules succeeded: "eq" is returned if the strings were +identical, "s:p" if the strings were singular and plural respectively, +"p:s" for plural and singular, and "p:p" for two distinct plurals. +Inequality is indicated by returning an empty string. + +It should be noted that two distinct singular words which happen to take +the same plural form are *not* considered equal, nor are cases where +one (singular) word's plural is the other (plural) word's singular. +Hence all of the following return false: + +.. code-block:: python + + p.compare("base", "basis") # ALTHOUGH BOTH -> "bases" + p.compare("syrinx", "syringe") # ALTHOUGH BOTH -> "syringes" + p.compare("she", "he") # ALTHOUGH BOTH -> "they" + + p.compare("opus", "operas") # ALTHOUGH "opus" -> "opera" -> "operas" + p.compare("taxi", "taxes") # ALTHOUGH "taxi" -> "taxis" -> "taxes" + +Note too that, although the comparison is "number-insensitive" it is *not* +case-insensitive (that is, ``plural("time","Times")`` returns false. To obtain +both number and case insensitivity, use the ``lower()`` method on both strings +(that is, ``plural("time".lower(), "Times".lower())`` returns true). + +Related Functionality +===================== + +Shout out to these libraries that provide related functionality: + +* `WordSet `_ + parses identifiers like variable names into sets of words suitable for re-assembling + in another form. + +* `word2number `_ converts words to + a number. + + +For Enterprise +============== + +Available as part of the Tidelift Subscription. + +This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. + +`Learn more `_. diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/RECORD new file mode 100644 index 000000000..15ab8eefd --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/RECORD @@ -0,0 +1,13 @@ +inflect-7.3.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +inflect-7.3.1.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 +inflect-7.3.1.dist-info/METADATA,sha256=ZgMNY0WAZRs-U8wZiV2SMfjSKqBrMngXyDMs_CAwMwg,21079 +inflect-7.3.1.dist-info/RECORD,, +inflect-7.3.1.dist-info/WHEEL,sha256=y4mX-SOX4fYIkonsAGA5N0Oy-8_gI4FXw5HNI1xqvWg,91 +inflect-7.3.1.dist-info/top_level.txt,sha256=m52ujdp10CqT6jh1XQxZT6kEntcnv-7Tl7UiGNTzWZA,8 +inflect/__init__.py,sha256=Jxy1HJXZiZ85kHeLAhkmvz6EMTdFqBe-duvt34R6IOc,103796 +inflect/__pycache__/__init__.cpython-312.pyc,, +inflect/compat/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +inflect/compat/__pycache__/__init__.cpython-312.pyc,, +inflect/compat/__pycache__/py38.cpython-312.pyc,, +inflect/compat/py38.py,sha256=oObVfVnWX9_OpnOuEJn1mFbJxVhwyR5epbiTNXDDaso,160 +inflect/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/WHEEL new file mode 100644 index 000000000..564c6724e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (70.2.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/top_level.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/top_level.txt new file mode 100644 index 000000000..0fd75fab3 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect-7.3.1.dist-info/top_level.txt @@ -0,0 +1 @@ +inflect diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/__init__.py new file mode 100644 index 000000000..3eec27f4c --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/__init__.py @@ -0,0 +1,3986 @@ +""" +inflect: english language inflection + - correctly generate plurals, ordinals, indefinite articles + - convert numbers to words + +Copyright (C) 2010 Paul Dyson + +Based upon the Perl module +`Lingua::EN::Inflect `_. + +methods: + classical inflect + plural plural_noun plural_verb plural_adj singular_noun no num a an + compare compare_nouns compare_verbs compare_adjs + present_participle + ordinal + number_to_words + join + defnoun defverb defadj defa defan + +INFLECTIONS: + classical inflect + plural plural_noun plural_verb plural_adj singular_noun compare + no num a an present_participle + +PLURALS: + classical inflect + plural plural_noun plural_verb plural_adj singular_noun no num + compare compare_nouns compare_verbs compare_adjs + +COMPARISONS: + classical + compare compare_nouns compare_verbs compare_adjs + +ARTICLES: + classical inflect num a an + +NUMERICAL: + ordinal number_to_words + +USER_DEFINED: + defnoun defverb defadj defa defan + +Exceptions: + UnknownClassicalModeError + BadNumValueError + BadChunkingOptionError + NumOutOfRangeError + BadUserDefinedPatternError + BadRcFileError + BadGenderError + +""" + +from __future__ import annotations + +import ast +import collections +import contextlib +import functools +import itertools +import re +from numbers import Number +from typing import ( + TYPE_CHECKING, + Any, + Callable, + Dict, + Iterable, + List, + Literal, + Match, + Optional, + Sequence, + Tuple, + Union, + cast, +) + +from more_itertools import windowed_complete +from typeguard import typechecked + +from .compat.py38 import Annotated + + +class UnknownClassicalModeError(Exception): + pass + + +class BadNumValueError(Exception): + pass + + +class BadChunkingOptionError(Exception): + pass + + +class NumOutOfRangeError(Exception): + pass + + +class BadUserDefinedPatternError(Exception): + pass + + +class BadRcFileError(Exception): + pass + + +class BadGenderError(Exception): + pass + + +def enclose(s: str) -> str: + return f"(?:{s})" + + +def joinstem(cutpoint: Optional[int] = 0, words: Optional[Iterable[str]] = None) -> str: + """ + Join stem of each word in words into a string for regex. + + Each word is truncated at cutpoint. + + Cutpoint is usually negative indicating the number of letters to remove + from the end of each word. + + >>> joinstem(-2, ["ephemeris", "iris", ".*itis"]) + '(?:ephemer|ir|.*it)' + + >>> joinstem(None, ["ephemeris"]) + '(?:ephemeris)' + + >>> joinstem(5, None) + '(?:)' + """ + return enclose("|".join(w[:cutpoint] for w in words or [])) + + +def bysize(words: Iterable[str]) -> Dict[int, set]: + """ + From a list of words, return a dict of sets sorted by word length. + + >>> words = ['ant', 'cat', 'dog', 'pig', 'frog', 'goat', 'horse', 'elephant'] + >>> ret = bysize(words) + >>> sorted(ret[3]) + ['ant', 'cat', 'dog', 'pig'] + >>> ret[5] + {'horse'} + """ + res: Dict[int, set] = collections.defaultdict(set) + for w in words: + res[len(w)].add(w) + return res + + +def make_pl_si_lists( + lst: Iterable[str], + plending: str, + siendingsize: Optional[int], + dojoinstem: bool = True, +): + """ + given a list of singular words: lst + + an ending to append to make the plural: plending + + the number of characters to remove from the singular + before appending plending: siendingsize + + a flag whether to create a joinstem: dojoinstem + + return: + a list of pluralised words: si_list (called si because this is what you need to + look for to make the singular) + + the pluralised words as a dict of sets sorted by word length: si_bysize + the singular words as a dict of sets sorted by word length: pl_bysize + if dojoinstem is True: a regular expression that matches any of the stems: stem + """ + if siendingsize is not None: + siendingsize = -siendingsize + si_list = [w[:siendingsize] + plending for w in lst] + pl_bysize = bysize(lst) + si_bysize = bysize(si_list) + if dojoinstem: + stem = joinstem(siendingsize, lst) + return si_list, si_bysize, pl_bysize, stem + else: + return si_list, si_bysize, pl_bysize + + +# 1. PLURALS + +pl_sb_irregular_s = { + "corpus": "corpuses|corpora", + "opus": "opuses|opera", + "genus": "genera", + "mythos": "mythoi", + "penis": "penises|penes", + "testis": "testes", + "atlas": "atlases|atlantes", + "yes": "yeses", +} + +pl_sb_irregular = { + "child": "children", + "chili": "chilis|chilies", + "brother": "brothers|brethren", + "infinity": "infinities|infinity", + "loaf": "loaves", + "lore": "lores|lore", + "hoof": "hoofs|hooves", + "beef": "beefs|beeves", + "thief": "thiefs|thieves", + "money": "monies", + "mongoose": "mongooses", + "ox": "oxen", + "cow": "cows|kine", + "graffito": "graffiti", + "octopus": "octopuses|octopodes", + "genie": "genies|genii", + "ganglion": "ganglions|ganglia", + "trilby": "trilbys", + "turf": "turfs|turves", + "numen": "numina", + "atman": "atmas", + "occiput": "occiputs|occipita", + "sabretooth": "sabretooths", + "sabertooth": "sabertooths", + "lowlife": "lowlifes", + "flatfoot": "flatfoots", + "tenderfoot": "tenderfoots", + "romany": "romanies", + "jerry": "jerries", + "mary": "maries", + "talouse": "talouses", + "rom": "roma", + "carmen": "carmina", +} + +pl_sb_irregular.update(pl_sb_irregular_s) +# pl_sb_irregular_keys = enclose('|'.join(pl_sb_irregular.keys())) + +pl_sb_irregular_caps = { + "Romany": "Romanies", + "Jerry": "Jerrys", + "Mary": "Marys", + "Rom": "Roma", +} + +pl_sb_irregular_compound = {"prima donna": "prima donnas|prime donne"} + +si_sb_irregular = {v: k for (k, v) in pl_sb_irregular.items()} +for k in list(si_sb_irregular): + if "|" in k: + k1, k2 = k.split("|") + si_sb_irregular[k1] = si_sb_irregular[k2] = si_sb_irregular[k] + del si_sb_irregular[k] +si_sb_irregular_caps = {v: k for (k, v) in pl_sb_irregular_caps.items()} +si_sb_irregular_compound = {v: k for (k, v) in pl_sb_irregular_compound.items()} +for k in list(si_sb_irregular_compound): + if "|" in k: + k1, k2 = k.split("|") + si_sb_irregular_compound[k1] = si_sb_irregular_compound[k2] = ( + si_sb_irregular_compound[k] + ) + del si_sb_irregular_compound[k] + +# si_sb_irregular_keys = enclose('|'.join(si_sb_irregular.keys())) + +# Z's that don't double + +pl_sb_z_zes_list = ("quartz", "topaz") +pl_sb_z_zes_bysize = bysize(pl_sb_z_zes_list) + +pl_sb_ze_zes_list = ("snooze",) +pl_sb_ze_zes_bysize = bysize(pl_sb_ze_zes_list) + + +# CLASSICAL "..is" -> "..ides" + +pl_sb_C_is_ides_complete = [ + # GENERAL WORDS... + "ephemeris", + "iris", + "clitoris", + "chrysalis", + "epididymis", +] + +pl_sb_C_is_ides_endings = [ + # INFLAMATIONS... + "itis" +] + +pl_sb_C_is_ides = joinstem( + -2, pl_sb_C_is_ides_complete + [f".*{w}" for w in pl_sb_C_is_ides_endings] +) + +pl_sb_C_is_ides_list = pl_sb_C_is_ides_complete + pl_sb_C_is_ides_endings + +( + si_sb_C_is_ides_list, + si_sb_C_is_ides_bysize, + pl_sb_C_is_ides_bysize, +) = make_pl_si_lists(pl_sb_C_is_ides_list, "ides", 2, dojoinstem=False) + + +# CLASSICAL "..a" -> "..ata" + +pl_sb_C_a_ata_list = ( + "anathema", + "bema", + "carcinoma", + "charisma", + "diploma", + "dogma", + "drama", + "edema", + "enema", + "enigma", + "lemma", + "lymphoma", + "magma", + "melisma", + "miasma", + "oedema", + "sarcoma", + "schema", + "soma", + "stigma", + "stoma", + "trauma", + "gumma", + "pragma", +) + +( + si_sb_C_a_ata_list, + si_sb_C_a_ata_bysize, + pl_sb_C_a_ata_bysize, + pl_sb_C_a_ata, +) = make_pl_si_lists(pl_sb_C_a_ata_list, "ata", 1) + +# UNCONDITIONAL "..a" -> "..ae" + +pl_sb_U_a_ae_list = ( + "alumna", + "alga", + "vertebra", + "persona", + "vita", +) +( + si_sb_U_a_ae_list, + si_sb_U_a_ae_bysize, + pl_sb_U_a_ae_bysize, + pl_sb_U_a_ae, +) = make_pl_si_lists(pl_sb_U_a_ae_list, "e", None) + +# CLASSICAL "..a" -> "..ae" + +pl_sb_C_a_ae_list = ( + "amoeba", + "antenna", + "formula", + "hyperbola", + "medusa", + "nebula", + "parabola", + "abscissa", + "hydra", + "nova", + "lacuna", + "aurora", + "umbra", + "flora", + "fauna", +) +( + si_sb_C_a_ae_list, + si_sb_C_a_ae_bysize, + pl_sb_C_a_ae_bysize, + pl_sb_C_a_ae, +) = make_pl_si_lists(pl_sb_C_a_ae_list, "e", None) + + +# CLASSICAL "..en" -> "..ina" + +pl_sb_C_en_ina_list = ("stamen", "foramen", "lumen") + +( + si_sb_C_en_ina_list, + si_sb_C_en_ina_bysize, + pl_sb_C_en_ina_bysize, + pl_sb_C_en_ina, +) = make_pl_si_lists(pl_sb_C_en_ina_list, "ina", 2) + + +# UNCONDITIONAL "..um" -> "..a" + +pl_sb_U_um_a_list = ( + "bacterium", + "agendum", + "desideratum", + "erratum", + "stratum", + "datum", + "ovum", + "extremum", + "candelabrum", +) +( + si_sb_U_um_a_list, + si_sb_U_um_a_bysize, + pl_sb_U_um_a_bysize, + pl_sb_U_um_a, +) = make_pl_si_lists(pl_sb_U_um_a_list, "a", 2) + +# CLASSICAL "..um" -> "..a" + +pl_sb_C_um_a_list = ( + "maximum", + "minimum", + "momentum", + "optimum", + "quantum", + "cranium", + "curriculum", + "dictum", + "phylum", + "aquarium", + "compendium", + "emporium", + "encomium", + "gymnasium", + "honorarium", + "interregnum", + "lustrum", + "memorandum", + "millennium", + "rostrum", + "spectrum", + "speculum", + "stadium", + "trapezium", + "ultimatum", + "medium", + "vacuum", + "velum", + "consortium", + "arboretum", +) + +( + si_sb_C_um_a_list, + si_sb_C_um_a_bysize, + pl_sb_C_um_a_bysize, + pl_sb_C_um_a, +) = make_pl_si_lists(pl_sb_C_um_a_list, "a", 2) + + +# UNCONDITIONAL "..us" -> "i" + +pl_sb_U_us_i_list = ( + "alumnus", + "alveolus", + "bacillus", + "bronchus", + "locus", + "nucleus", + "stimulus", + "meniscus", + "sarcophagus", +) +( + si_sb_U_us_i_list, + si_sb_U_us_i_bysize, + pl_sb_U_us_i_bysize, + pl_sb_U_us_i, +) = make_pl_si_lists(pl_sb_U_us_i_list, "i", 2) + +# CLASSICAL "..us" -> "..i" + +pl_sb_C_us_i_list = ( + "focus", + "radius", + "genius", + "incubus", + "succubus", + "nimbus", + "fungus", + "nucleolus", + "stylus", + "torus", + "umbilicus", + "uterus", + "hippopotamus", + "cactus", +) + +( + si_sb_C_us_i_list, + si_sb_C_us_i_bysize, + pl_sb_C_us_i_bysize, + pl_sb_C_us_i, +) = make_pl_si_lists(pl_sb_C_us_i_list, "i", 2) + + +# CLASSICAL "..us" -> "..us" (ASSIMILATED 4TH DECLENSION LATIN NOUNS) + +pl_sb_C_us_us = ( + "status", + "apparatus", + "prospectus", + "sinus", + "hiatus", + "impetus", + "plexus", +) +pl_sb_C_us_us_bysize = bysize(pl_sb_C_us_us) + +# UNCONDITIONAL "..on" -> "a" + +pl_sb_U_on_a_list = ( + "criterion", + "perihelion", + "aphelion", + "phenomenon", + "prolegomenon", + "noumenon", + "organon", + "asyndeton", + "hyperbaton", +) +( + si_sb_U_on_a_list, + si_sb_U_on_a_bysize, + pl_sb_U_on_a_bysize, + pl_sb_U_on_a, +) = make_pl_si_lists(pl_sb_U_on_a_list, "a", 2) + +# CLASSICAL "..on" -> "..a" + +pl_sb_C_on_a_list = ("oxymoron",) + +( + si_sb_C_on_a_list, + si_sb_C_on_a_bysize, + pl_sb_C_on_a_bysize, + pl_sb_C_on_a, +) = make_pl_si_lists(pl_sb_C_on_a_list, "a", 2) + + +# CLASSICAL "..o" -> "..i" (BUT NORMALLY -> "..os") + +pl_sb_C_o_i = [ + "solo", + "soprano", + "basso", + "alto", + "contralto", + "tempo", + "piano", + "virtuoso", +] # list not tuple so can concat for pl_sb_U_o_os + +pl_sb_C_o_i_bysize = bysize(pl_sb_C_o_i) +si_sb_C_o_i_bysize = bysize([f"{w[:-1]}i" for w in pl_sb_C_o_i]) + +pl_sb_C_o_i_stems = joinstem(-1, pl_sb_C_o_i) + +# ALWAYS "..o" -> "..os" + +pl_sb_U_o_os_complete = {"ado", "ISO", "NATO", "NCO", "NGO", "oto"} +si_sb_U_o_os_complete = {f"{w}s" for w in pl_sb_U_o_os_complete} + + +pl_sb_U_o_os_endings = [ + "aficionado", + "aggro", + "albino", + "allegro", + "ammo", + "Antananarivo", + "archipelago", + "armadillo", + "auto", + "avocado", + "Bamako", + "Barquisimeto", + "bimbo", + "bingo", + "Biro", + "bolero", + "Bolzano", + "bongo", + "Boto", + "burro", + "Cairo", + "canto", + "cappuccino", + "casino", + "cello", + "Chicago", + "Chimango", + "cilantro", + "cochito", + "coco", + "Colombo", + "Colorado", + "commando", + "concertino", + "contango", + "credo", + "crescendo", + "cyano", + "demo", + "ditto", + "Draco", + "dynamo", + "embryo", + "Esperanto", + "espresso", + "euro", + "falsetto", + "Faro", + "fiasco", + "Filipino", + "flamenco", + "furioso", + "generalissimo", + "Gestapo", + "ghetto", + "gigolo", + "gizmo", + "Greensboro", + "gringo", + "Guaiabero", + "guano", + "gumbo", + "gyro", + "hairdo", + "hippo", + "Idaho", + "impetigo", + "inferno", + "info", + "intermezzo", + "intertrigo", + "Iquico", + "jumbo", + "junto", + "Kakapo", + "kilo", + "Kinkimavo", + "Kokako", + "Kosovo", + "Lesotho", + "libero", + "libido", + "libretto", + "lido", + "Lilo", + "limbo", + "limo", + "lineno", + "lingo", + "lino", + "livedo", + "loco", + "logo", + "lumbago", + "macho", + "macro", + "mafioso", + "magneto", + "magnifico", + "Majuro", + "Malabo", + "manifesto", + "Maputo", + "Maracaibo", + "medico", + "memo", + "metro", + "Mexico", + "micro", + "Milano", + "Monaco", + "mono", + "Montenegro", + "Morocco", + "Muqdisho", + "myo", + "neutrino", + "Ningbo", + "octavo", + "oregano", + "Orinoco", + "Orlando", + "Oslo", + "panto", + "Paramaribo", + "Pardusco", + "pedalo", + "photo", + "pimento", + "pinto", + "pleco", + "Pluto", + "pogo", + "polo", + "poncho", + "Porto-Novo", + "Porto", + "pro", + "psycho", + "pueblo", + "quarto", + "Quito", + "repo", + "rhino", + "risotto", + "rococo", + "rondo", + "Sacramento", + "saddo", + "sago", + "salvo", + "Santiago", + "Sapporo", + "Sarajevo", + "scherzando", + "scherzo", + "silo", + "sirocco", + "sombrero", + "staccato", + "sterno", + "stucco", + "stylo", + "sumo", + "Taiko", + "techno", + "terrazzo", + "testudo", + "timpano", + "tiro", + "tobacco", + "Togo", + "Tokyo", + "torero", + "Torino", + "Toronto", + "torso", + "tremolo", + "typo", + "tyro", + "ufo", + "UNESCO", + "vaquero", + "vermicello", + "verso", + "vibrato", + "violoncello", + "Virgo", + "weirdo", + "WHO", + "WTO", + "Yamoussoukro", + "yo-yo", + "zero", + "Zibo", +] + pl_sb_C_o_i + +pl_sb_U_o_os_bysize = bysize(pl_sb_U_o_os_endings) +si_sb_U_o_os_bysize = bysize([f"{w}s" for w in pl_sb_U_o_os_endings]) + + +# UNCONDITIONAL "..ch" -> "..chs" + +pl_sb_U_ch_chs_list = ("czech", "eunuch", "stomach") + +( + si_sb_U_ch_chs_list, + si_sb_U_ch_chs_bysize, + pl_sb_U_ch_chs_bysize, + pl_sb_U_ch_chs, +) = make_pl_si_lists(pl_sb_U_ch_chs_list, "s", None) + + +# UNCONDITIONAL "..[ei]x" -> "..ices" + +pl_sb_U_ex_ices_list = ("codex", "murex", "silex") +( + si_sb_U_ex_ices_list, + si_sb_U_ex_ices_bysize, + pl_sb_U_ex_ices_bysize, + pl_sb_U_ex_ices, +) = make_pl_si_lists(pl_sb_U_ex_ices_list, "ices", 2) + +pl_sb_U_ix_ices_list = ("radix", "helix") +( + si_sb_U_ix_ices_list, + si_sb_U_ix_ices_bysize, + pl_sb_U_ix_ices_bysize, + pl_sb_U_ix_ices, +) = make_pl_si_lists(pl_sb_U_ix_ices_list, "ices", 2) + +# CLASSICAL "..[ei]x" -> "..ices" + +pl_sb_C_ex_ices_list = ( + "vortex", + "vertex", + "cortex", + "latex", + "pontifex", + "apex", + "index", + "simplex", +) + +( + si_sb_C_ex_ices_list, + si_sb_C_ex_ices_bysize, + pl_sb_C_ex_ices_bysize, + pl_sb_C_ex_ices, +) = make_pl_si_lists(pl_sb_C_ex_ices_list, "ices", 2) + + +pl_sb_C_ix_ices_list = ("appendix",) + +( + si_sb_C_ix_ices_list, + si_sb_C_ix_ices_bysize, + pl_sb_C_ix_ices_bysize, + pl_sb_C_ix_ices, +) = make_pl_si_lists(pl_sb_C_ix_ices_list, "ices", 2) + + +# ARABIC: ".." -> "..i" + +pl_sb_C_i_list = ("afrit", "afreet", "efreet") + +(si_sb_C_i_list, si_sb_C_i_bysize, pl_sb_C_i_bysize, pl_sb_C_i) = make_pl_si_lists( + pl_sb_C_i_list, "i", None +) + + +# HEBREW: ".." -> "..im" + +pl_sb_C_im_list = ("goy", "seraph", "cherub") + +(si_sb_C_im_list, si_sb_C_im_bysize, pl_sb_C_im_bysize, pl_sb_C_im) = make_pl_si_lists( + pl_sb_C_im_list, "im", None +) + + +# UNCONDITIONAL "..man" -> "..mans" + +pl_sb_U_man_mans_list = """ + ataman caiman cayman ceriman + desman dolman farman harman hetman + human leman ottoman shaman talisman +""".split() +pl_sb_U_man_mans_caps_list = """ + Alabaman Bahaman Burman German + Hiroshiman Liman Nakayaman Norman Oklahoman + Panaman Roman Selman Sonaman Tacoman Yakiman + Yokohaman Yuman +""".split() + +( + si_sb_U_man_mans_list, + si_sb_U_man_mans_bysize, + pl_sb_U_man_mans_bysize, +) = make_pl_si_lists(pl_sb_U_man_mans_list, "s", None, dojoinstem=False) +( + si_sb_U_man_mans_caps_list, + si_sb_U_man_mans_caps_bysize, + pl_sb_U_man_mans_caps_bysize, +) = make_pl_si_lists(pl_sb_U_man_mans_caps_list, "s", None, dojoinstem=False) + +# UNCONDITIONAL "..louse" -> "..lice" +pl_sb_U_louse_lice_list = ("booklouse", "grapelouse", "louse", "woodlouse") + +( + si_sb_U_louse_lice_list, + si_sb_U_louse_lice_bysize, + pl_sb_U_louse_lice_bysize, +) = make_pl_si_lists(pl_sb_U_louse_lice_list, "lice", 5, dojoinstem=False) + +pl_sb_uninflected_s_complete = [ + # PAIRS OR GROUPS SUBSUMED TO A SINGULAR... + "breeches", + "britches", + "pajamas", + "pyjamas", + "clippers", + "gallows", + "hijinks", + "headquarters", + "pliers", + "scissors", + "testes", + "herpes", + "pincers", + "shears", + "proceedings", + "trousers", + # UNASSIMILATED LATIN 4th DECLENSION + "cantus", + "coitus", + "nexus", + # RECENT IMPORTS... + "contretemps", + "corps", + "debris", + "siemens", + # DISEASES + "mumps", + # MISCELLANEOUS OTHERS... + "diabetes", + "jackanapes", + "series", + "species", + "subspecies", + "rabies", + "chassis", + "innings", + "news", + "mews", + "haggis", +] + +pl_sb_uninflected_s_endings = [ + # RECENT IMPORTS... + "ois", + # DISEASES + "measles", +] + +pl_sb_uninflected_s = pl_sb_uninflected_s_complete + [ + f".*{w}" for w in pl_sb_uninflected_s_endings +] + +pl_sb_uninflected_herd = ( + # DON'T INFLECT IN CLASSICAL MODE, OTHERWISE NORMAL INFLECTION + "wildebeest", + "swine", + "eland", + "bison", + "buffalo", + "cattle", + "elk", + "rhinoceros", + "zucchini", + "caribou", + "dace", + "grouse", + "guinea fowl", + "guinea-fowl", + "haddock", + "hake", + "halibut", + "herring", + "mackerel", + "pickerel", + "pike", + "roe", + "seed", + "shad", + "snipe", + "teal", + "turbot", + "water fowl", + "water-fowl", +) + +pl_sb_uninflected_complete = [ + # SOME FISH AND HERD ANIMALS + "tuna", + "salmon", + "mackerel", + "trout", + "bream", + "sea-bass", + "sea bass", + "carp", + "cod", + "flounder", + "whiting", + "moose", + # OTHER ODDITIES + "graffiti", + "djinn", + "samuri", + "offspring", + "pence", + "quid", + "hertz", +] + pl_sb_uninflected_s_complete +# SOME WORDS ENDING IN ...s (OFTEN PAIRS TAKEN AS A WHOLE) + +pl_sb_uninflected_caps = [ + # ALL NATIONALS ENDING IN -ese + "Portuguese", + "Amoyese", + "Borghese", + "Congoese", + "Faroese", + "Foochowese", + "Genevese", + "Genoese", + "Gilbertese", + "Hottentotese", + "Kiplingese", + "Kongoese", + "Lucchese", + "Maltese", + "Nankingese", + "Niasese", + "Pekingese", + "Piedmontese", + "Pistoiese", + "Sarawakese", + "Shavese", + "Vermontese", + "Wenchowese", + "Yengeese", +] + + +pl_sb_uninflected_endings = [ + # UNCOUNTABLE NOUNS + "butter", + "cash", + "furniture", + "information", + # SOME FISH AND HERD ANIMALS + "fish", + "deer", + "sheep", + # ALL NATIONALS ENDING IN -ese + "nese", + "rese", + "lese", + "mese", + # DISEASES + "pox", + # OTHER ODDITIES + "craft", +] + pl_sb_uninflected_s_endings +# SOME WORDS ENDING IN ...s (OFTEN PAIRS TAKEN AS A WHOLE) + + +pl_sb_uninflected_bysize = bysize(pl_sb_uninflected_endings) + + +# SINGULAR WORDS ENDING IN ...s (ALL INFLECT WITH ...es) + +pl_sb_singular_s_complete = [ + "acropolis", + "aegis", + "alias", + "asbestos", + "bathos", + "bias", + "bronchitis", + "bursitis", + "caddis", + "cannabis", + "canvas", + "chaos", + "cosmos", + "dais", + "digitalis", + "epidermis", + "ethos", + "eyas", + "gas", + "glottis", + "hubris", + "ibis", + "lens", + "mantis", + "marquis", + "metropolis", + "pathos", + "pelvis", + "polis", + "rhinoceros", + "sassafras", + "trellis", +] + pl_sb_C_is_ides_complete + + +pl_sb_singular_s_endings = ["ss", "us"] + pl_sb_C_is_ides_endings + +pl_sb_singular_s_bysize = bysize(pl_sb_singular_s_endings) + +si_sb_singular_s_complete = [f"{w}es" for w in pl_sb_singular_s_complete] +si_sb_singular_s_endings = [f"{w}es" for w in pl_sb_singular_s_endings] +si_sb_singular_s_bysize = bysize(si_sb_singular_s_endings) + +pl_sb_singular_s_es = ["[A-Z].*es"] + +pl_sb_singular_s = enclose( + "|".join( + pl_sb_singular_s_complete + + [f".*{w}" for w in pl_sb_singular_s_endings] + + pl_sb_singular_s_es + ) +) + + +# PLURALS ENDING IN uses -> use + + +si_sb_ois_oi_case = ("Bolshois", "Hanois") + +si_sb_uses_use_case = ("Betelgeuses", "Duses", "Meuses", "Syracuses", "Toulouses") + +si_sb_uses_use = ( + "abuses", + "applauses", + "blouses", + "carouses", + "causes", + "chartreuses", + "clauses", + "contuses", + "douses", + "excuses", + "fuses", + "grouses", + "hypotenuses", + "masseuses", + "menopauses", + "misuses", + "muses", + "overuses", + "pauses", + "peruses", + "profuses", + "recluses", + "reuses", + "ruses", + "souses", + "spouses", + "suffuses", + "transfuses", + "uses", +) + +si_sb_ies_ie_case = ( + "Addies", + "Aggies", + "Allies", + "Amies", + "Angies", + "Annies", + "Annmaries", + "Archies", + "Arties", + "Aussies", + "Barbies", + "Barries", + "Basies", + "Bennies", + "Bernies", + "Berties", + "Bessies", + "Betties", + "Billies", + "Blondies", + "Bobbies", + "Bonnies", + "Bowies", + "Brandies", + "Bries", + "Brownies", + "Callies", + "Carnegies", + "Carries", + "Cassies", + "Charlies", + "Cheries", + "Christies", + "Connies", + "Curies", + "Dannies", + "Debbies", + "Dixies", + "Dollies", + "Donnies", + "Drambuies", + "Eddies", + "Effies", + "Ellies", + "Elsies", + "Eries", + "Ernies", + "Essies", + "Eugenies", + "Fannies", + "Flossies", + "Frankies", + "Freddies", + "Gillespies", + "Goldies", + "Gracies", + "Guthries", + "Hallies", + "Hatties", + "Hetties", + "Hollies", + "Jackies", + "Jamies", + "Janies", + "Jannies", + "Jeanies", + "Jeannies", + "Jennies", + "Jessies", + "Jimmies", + "Jodies", + "Johnies", + "Johnnies", + "Josies", + "Julies", + "Kalgoorlies", + "Kathies", + "Katies", + "Kellies", + "Kewpies", + "Kristies", + "Laramies", + "Lassies", + "Lauries", + "Leslies", + "Lessies", + "Lillies", + "Lizzies", + "Lonnies", + "Lories", + "Lorries", + "Lotties", + "Louies", + "Mackenzies", + "Maggies", + "Maisies", + "Mamies", + "Marcies", + "Margies", + "Maries", + "Marjories", + "Matties", + "McKenzies", + "Melanies", + "Mickies", + "Millies", + "Minnies", + "Mollies", + "Mounties", + "Nannies", + "Natalies", + "Nellies", + "Netties", + "Ollies", + "Ozzies", + "Pearlies", + "Pottawatomies", + "Reggies", + "Richies", + "Rickies", + "Robbies", + "Ronnies", + "Rosalies", + "Rosemaries", + "Rosies", + "Roxies", + "Rushdies", + "Ruthies", + "Sadies", + "Sallies", + "Sammies", + "Scotties", + "Selassies", + "Sherries", + "Sophies", + "Stacies", + "Stefanies", + "Stephanies", + "Stevies", + "Susies", + "Sylvies", + "Tammies", + "Terries", + "Tessies", + "Tommies", + "Tracies", + "Trekkies", + "Valaries", + "Valeries", + "Valkyries", + "Vickies", + "Virgies", + "Willies", + "Winnies", + "Wylies", + "Yorkies", +) + +si_sb_ies_ie = ( + "aeries", + "baggies", + "belies", + "biggies", + "birdies", + "bogies", + "bonnies", + "boogies", + "bookies", + "bourgeoisies", + "brownies", + "budgies", + "caddies", + "calories", + "camaraderies", + "cockamamies", + "collies", + "cookies", + "coolies", + "cooties", + "coteries", + "crappies", + "curies", + "cutesies", + "dogies", + "eyries", + "floozies", + "footsies", + "freebies", + "genies", + "goalies", + "groupies", + "hies", + "jalousies", + "junkies", + "kiddies", + "laddies", + "lassies", + "lies", + "lingeries", + "magpies", + "menageries", + "mommies", + "movies", + "neckties", + "newbies", + "nighties", + "oldies", + "organdies", + "overlies", + "pies", + "pinkies", + "pixies", + "potpies", + "prairies", + "quickies", + "reveries", + "rookies", + "rotisseries", + "softies", + "sorties", + "species", + "stymies", + "sweeties", + "ties", + "underlies", + "unties", + "veggies", + "vies", + "yuppies", + "zombies", +) + + +si_sb_oes_oe_case = ( + "Chloes", + "Crusoes", + "Defoes", + "Faeroes", + "Ivanhoes", + "Joes", + "McEnroes", + "Moes", + "Monroes", + "Noes", + "Poes", + "Roscoes", + "Tahoes", + "Tippecanoes", + "Zoes", +) + +si_sb_oes_oe = ( + "aloes", + "backhoes", + "canoes", + "does", + "floes", + "foes", + "hoes", + "mistletoes", + "oboes", + "pekoes", + "roes", + "sloes", + "throes", + "tiptoes", + "toes", + "woes", +) + +si_sb_z_zes = ("quartzes", "topazes") + +si_sb_zzes_zz = ("buzzes", "fizzes", "frizzes", "razzes") + +si_sb_ches_che_case = ( + "Andromaches", + "Apaches", + "Blanches", + "Comanches", + "Nietzsches", + "Porsches", + "Roches", +) + +si_sb_ches_che = ( + "aches", + "avalanches", + "backaches", + "bellyaches", + "caches", + "cloches", + "creches", + "douches", + "earaches", + "fiches", + "headaches", + "heartaches", + "microfiches", + "niches", + "pastiches", + "psyches", + "quiches", + "stomachaches", + "toothaches", + "tranches", +) + +si_sb_xes_xe = ("annexes", "axes", "deluxes", "pickaxes") + +si_sb_sses_sse_case = ("Hesses", "Jesses", "Larousses", "Matisses") +si_sb_sses_sse = ( + "bouillabaisses", + "crevasses", + "demitasses", + "impasses", + "mousses", + "posses", +) + +si_sb_ves_ve_case = ( + # *[nwl]ives -> [nwl]live + "Clives", + "Palmolives", +) +si_sb_ves_ve = ( + # *[^d]eaves -> eave + "interweaves", + "weaves", + # *[nwl]ives -> [nwl]live + "olives", + # *[eoa]lves -> [eoa]lve + "bivalves", + "dissolves", + "resolves", + "salves", + "twelves", + "valves", +) + + +plverb_special_s = enclose( + "|".join( + [pl_sb_singular_s] + + pl_sb_uninflected_s + + list(pl_sb_irregular_s) + + ["(.*[csx])is", "(.*)ceps", "[A-Z].*s"] + ) +) + +_pl_sb_postfix_adj_defn = ( + ("general", enclose(r"(?!major|lieutenant|brigadier|adjutant|.*star)\S+")), + ("martial", enclose("court")), + ("force", enclose("pound")), +) + +pl_sb_postfix_adj: Iterable[str] = ( + enclose(val + f"(?=(?:-|\\s+){key})") for key, val in _pl_sb_postfix_adj_defn +) + +pl_sb_postfix_adj_stems = f"({'|'.join(pl_sb_postfix_adj)})(.*)" + + +# PLURAL WORDS ENDING IS es GO TO SINGULAR is + +si_sb_es_is = ( + "amanuenses", + "amniocenteses", + "analyses", + "antitheses", + "apotheoses", + "arterioscleroses", + "atheroscleroses", + "axes", + # 'bases', # bases -> basis + "catalyses", + "catharses", + "chasses", + "cirrhoses", + "cocces", + "crises", + "diagnoses", + "dialyses", + "diereses", + "electrolyses", + "emphases", + "exegeses", + "geneses", + "halitoses", + "hydrolyses", + "hypnoses", + "hypotheses", + "hystereses", + "metamorphoses", + "metastases", + "misdiagnoses", + "mitoses", + "mononucleoses", + "narcoses", + "necroses", + "nemeses", + "neuroses", + "oases", + "osmoses", + "osteoporoses", + "paralyses", + "parentheses", + "parthenogeneses", + "periphrases", + "photosyntheses", + "probosces", + "prognoses", + "prophylaxes", + "prostheses", + "preces", + "psoriases", + "psychoanalyses", + "psychokineses", + "psychoses", + "scleroses", + "scolioses", + "sepses", + "silicoses", + "symbioses", + "synopses", + "syntheses", + "taxes", + "telekineses", + "theses", + "thromboses", + "tuberculoses", + "urinalyses", +) + +pl_prep_list = """ + about above across after among around at athwart before behind + below beneath beside besides between betwixt beyond but by + during except for from in into near of off on onto out over + since till to under until unto upon with""".split() + +pl_prep_list_da = pl_prep_list + ["de", "du", "da"] + +pl_prep_bysize = bysize(pl_prep_list_da) + +pl_prep = enclose("|".join(pl_prep_list_da)) + +pl_sb_prep_dual_compound = rf"(.*?)((?:-|\s+)(?:{pl_prep})(?:-|\s+))a(?:-|\s+)(.*)" + + +singular_pronoun_genders = { + "neuter", + "feminine", + "masculine", + "gender-neutral", + "feminine or masculine", + "masculine or feminine", +} + +pl_pron_nom = { + # NOMINATIVE REFLEXIVE + "i": "we", + "myself": "ourselves", + "you": "you", + "yourself": "yourselves", + "she": "they", + "herself": "themselves", + "he": "they", + "himself": "themselves", + "it": "they", + "itself": "themselves", + "they": "they", + "themself": "themselves", + # POSSESSIVE + "mine": "ours", + "yours": "yours", + "hers": "theirs", + "his": "theirs", + "its": "theirs", + "theirs": "theirs", +} + +si_pron: Dict[str, Dict[str, Union[str, Dict[str, str]]]] = { + "nom": {v: k for (k, v) in pl_pron_nom.items()} +} +si_pron["nom"]["we"] = "I" + + +pl_pron_acc = { + # ACCUSATIVE REFLEXIVE + "me": "us", + "myself": "ourselves", + "you": "you", + "yourself": "yourselves", + "her": "them", + "herself": "themselves", + "him": "them", + "himself": "themselves", + "it": "them", + "itself": "themselves", + "them": "them", + "themself": "themselves", +} + +pl_pron_acc_keys = enclose("|".join(pl_pron_acc)) +pl_pron_acc_keys_bysize = bysize(pl_pron_acc) + +si_pron["acc"] = {v: k for (k, v) in pl_pron_acc.items()} + +for _thecase, _plur, _gend, _sing in ( + ("nom", "they", "neuter", "it"), + ("nom", "they", "feminine", "she"), + ("nom", "they", "masculine", "he"), + ("nom", "they", "gender-neutral", "they"), + ("nom", "they", "feminine or masculine", "she or he"), + ("nom", "they", "masculine or feminine", "he or she"), + ("nom", "themselves", "neuter", "itself"), + ("nom", "themselves", "feminine", "herself"), + ("nom", "themselves", "masculine", "himself"), + ("nom", "themselves", "gender-neutral", "themself"), + ("nom", "themselves", "feminine or masculine", "herself or himself"), + ("nom", "themselves", "masculine or feminine", "himself or herself"), + ("nom", "theirs", "neuter", "its"), + ("nom", "theirs", "feminine", "hers"), + ("nom", "theirs", "masculine", "his"), + ("nom", "theirs", "gender-neutral", "theirs"), + ("nom", "theirs", "feminine or masculine", "hers or his"), + ("nom", "theirs", "masculine or feminine", "his or hers"), + ("acc", "them", "neuter", "it"), + ("acc", "them", "feminine", "her"), + ("acc", "them", "masculine", "him"), + ("acc", "them", "gender-neutral", "them"), + ("acc", "them", "feminine or masculine", "her or him"), + ("acc", "them", "masculine or feminine", "him or her"), + ("acc", "themselves", "neuter", "itself"), + ("acc", "themselves", "feminine", "herself"), + ("acc", "themselves", "masculine", "himself"), + ("acc", "themselves", "gender-neutral", "themself"), + ("acc", "themselves", "feminine or masculine", "herself or himself"), + ("acc", "themselves", "masculine or feminine", "himself or herself"), +): + try: + si_pron[_thecase][_plur][_gend] = _sing # type: ignore + except TypeError: + si_pron[_thecase][_plur] = {} + si_pron[_thecase][_plur][_gend] = _sing # type: ignore + + +si_pron_acc_keys = enclose("|".join(si_pron["acc"])) +si_pron_acc_keys_bysize = bysize(si_pron["acc"]) + + +def get_si_pron(thecase, word, gender) -> str: + try: + sing = si_pron[thecase][word] + except KeyError: + raise # not a pronoun + try: + return sing[gender] # has several types due to gender + except TypeError: + return cast(str, sing) # answer independent of gender + + +# These dictionaries group verbs by first, second and third person +# conjugations. + +plverb_irregular_pres = { + "am": "are", + "are": "are", + "is": "are", + "was": "were", + "were": "were", + "have": "have", + "has": "have", + "do": "do", + "does": "do", +} + +plverb_ambiguous_pres = { + "act": "act", + "acts": "act", + "blame": "blame", + "blames": "blame", + "can": "can", + "must": "must", + "fly": "fly", + "flies": "fly", + "copy": "copy", + "copies": "copy", + "drink": "drink", + "drinks": "drink", + "fight": "fight", + "fights": "fight", + "fire": "fire", + "fires": "fire", + "like": "like", + "likes": "like", + "look": "look", + "looks": "look", + "make": "make", + "makes": "make", + "reach": "reach", + "reaches": "reach", + "run": "run", + "runs": "run", + "sink": "sink", + "sinks": "sink", + "sleep": "sleep", + "sleeps": "sleep", + "view": "view", + "views": "view", +} + +plverb_ambiguous_pres_keys = re.compile( + rf"^({enclose('|'.join(plverb_ambiguous_pres))})((\s.*)?)$", re.IGNORECASE +) + + +plverb_irregular_non_pres = ( + "did", + "had", + "ate", + "made", + "put", + "spent", + "fought", + "sank", + "gave", + "sought", + "shall", + "could", + "ought", + "should", +) + +plverb_ambiguous_non_pres = re.compile( + r"^((?:thought|saw|bent|will|might|cut))((\s.*)?)$", re.IGNORECASE +) + +# "..oes" -> "..oe" (the rest are "..oes" -> "o") + +pl_v_oes_oe = ("canoes", "floes", "oboes", "roes", "throes", "woes") +pl_v_oes_oe_endings_size4 = ("hoes", "toes") +pl_v_oes_oe_endings_size5 = ("shoes",) + + +pl_count_zero = ("0", "no", "zero", "nil") + + +pl_count_one = ("1", "a", "an", "one", "each", "every", "this", "that") + +pl_adj_special = {"a": "some", "an": "some", "this": "these", "that": "those"} + +pl_adj_special_keys = re.compile( + rf"^({enclose('|'.join(pl_adj_special))})$", re.IGNORECASE +) + +pl_adj_poss = { + "my": "our", + "your": "your", + "its": "their", + "her": "their", + "his": "their", + "their": "their", +} + +pl_adj_poss_keys = re.compile(rf"^({enclose('|'.join(pl_adj_poss))})$", re.IGNORECASE) + + +# 2. INDEFINITE ARTICLES + +# THIS PATTERN MATCHES STRINGS OF CAPITALS STARTING WITH A "VOWEL-SOUND" +# CONSONANT FOLLOWED BY ANOTHER CONSONANT, AND WHICH ARE NOT LIKELY +# TO BE REAL WORDS (OH, ALL RIGHT THEN, IT'S JUST MAGIC!) + +A_abbrev = re.compile( + r""" +^(?! FJO | [HLMNS]Y. | RY[EO] | SQU + | ( F[LR]? | [HL] | MN? | N | RH? | S[CHKLMNPTVW]? | X(YL)?) [AEIOU]) +[FHLMNRSX][A-Z] +""", + re.VERBOSE, +) + +# THIS PATTERN CODES THE BEGINNINGS OF ALL ENGLISH WORDS BEGINING WITH A +# 'y' FOLLOWED BY A CONSONANT. ANY OTHER Y-CONSONANT PREFIX THEREFORE +# IMPLIES AN ABBREVIATION. + +A_y_cons = re.compile(r"^(y(b[lor]|cl[ea]|fere|gg|p[ios]|rou|tt))", re.IGNORECASE) + +# EXCEPTIONS TO EXCEPTIONS + +A_explicit_a = re.compile(r"^((?:unabomber|unanimous|US))", re.IGNORECASE) + +A_explicit_an = re.compile( + r"^((?:euler|hour(?!i)|heir|honest|hono[ur]|mpeg))", re.IGNORECASE +) + +A_ordinal_an = re.compile(r"^([aefhilmnorsx]-?th)", re.IGNORECASE) + +A_ordinal_a = re.compile(r"^([bcdgjkpqtuvwyz]-?th)", re.IGNORECASE) + + +# NUMERICAL INFLECTIONS + +nth = { + 0: "th", + 1: "st", + 2: "nd", + 3: "rd", + 4: "th", + 5: "th", + 6: "th", + 7: "th", + 8: "th", + 9: "th", + 11: "th", + 12: "th", + 13: "th", +} +nth_suff = set(nth.values()) + +ordinal = dict( + ty="tieth", + one="first", + two="second", + three="third", + five="fifth", + eight="eighth", + nine="ninth", + twelve="twelfth", +) + +ordinal_suff = re.compile(rf"({'|'.join(ordinal)})\Z") + + +# NUMBERS + +unit = ["", "one", "two", "three", "four", "five", "six", "seven", "eight", "nine"] +teen = [ + "ten", + "eleven", + "twelve", + "thirteen", + "fourteen", + "fifteen", + "sixteen", + "seventeen", + "eighteen", + "nineteen", +] +ten = [ + "", + "", + "twenty", + "thirty", + "forty", + "fifty", + "sixty", + "seventy", + "eighty", + "ninety", +] +mill = [ + " ", + " thousand", + " million", + " billion", + " trillion", + " quadrillion", + " quintillion", + " sextillion", + " septillion", + " octillion", + " nonillion", + " decillion", +] + + +# SUPPORT CLASSICAL PLURALIZATIONS + +def_classical = dict( + all=False, zero=False, herd=False, names=True, persons=False, ancient=False +) + +all_classical = {k: True for k in def_classical} +no_classical = {k: False for k in def_classical} + + +# Maps strings to built-in constant types +string_to_constant = {"True": True, "False": False, "None": None} + + +# Pre-compiled regular expression objects +DOLLAR_DIGITS = re.compile(r"\$(\d+)") +FUNCTION_CALL = re.compile(r"((\w+)\([^)]*\)*)", re.IGNORECASE) +PARTITION_WORD = re.compile(r"\A(\s*)(.+?)(\s*)\Z") +PL_SB_POSTFIX_ADJ_STEMS_RE = re.compile( + rf"^(?:{pl_sb_postfix_adj_stems})$", re.IGNORECASE +) +PL_SB_PREP_DUAL_COMPOUND_RE = re.compile( + rf"^(?:{pl_sb_prep_dual_compound})$", re.IGNORECASE +) +DENOMINATOR = re.compile(r"(?P.+)( (per|a) .+)") +PLVERB_SPECIAL_S_RE = re.compile(rf"^({plverb_special_s})$") +WHITESPACE = re.compile(r"\s") +ENDS_WITH_S = re.compile(r"^(.*[^s])s$", re.IGNORECASE) +ENDS_WITH_APOSTROPHE_S = re.compile(r"^(.*)'s?$") +INDEFINITE_ARTICLE_TEST = re.compile(r"\A(\s*)(?:an?\s+)?(.+?)(\s*)\Z", re.IGNORECASE) +SPECIAL_AN = re.compile(r"^[aefhilmnorsx]$", re.IGNORECASE) +SPECIAL_A = re.compile(r"^[bcdgjkpqtuvwyz]$", re.IGNORECASE) +SPECIAL_ABBREV_AN = re.compile(r"^[aefhilmnorsx][.-]", re.IGNORECASE) +SPECIAL_ABBREV_A = re.compile(r"^[a-z][.-]", re.IGNORECASE) +CONSONANTS = re.compile(r"^[^aeiouy]", re.IGNORECASE) +ARTICLE_SPECIAL_EU = re.compile(r"^e[uw]", re.IGNORECASE) +ARTICLE_SPECIAL_ONCE = re.compile(r"^onc?e\b", re.IGNORECASE) +ARTICLE_SPECIAL_ONETIME = re.compile(r"^onetime\b", re.IGNORECASE) +ARTICLE_SPECIAL_UNIT = re.compile(r"^uni([^nmd]|mo)", re.IGNORECASE) +ARTICLE_SPECIAL_UBA = re.compile(r"^u[bcfghjkqrst][aeiou]", re.IGNORECASE) +ARTICLE_SPECIAL_UKR = re.compile(r"^ukr", re.IGNORECASE) +SPECIAL_CAPITALS = re.compile(r"^U[NK][AIEO]?") +VOWELS = re.compile(r"^[aeiou]", re.IGNORECASE) + +DIGIT_GROUP = re.compile(r"(\d)") +TWO_DIGITS = re.compile(r"(\d)(\d)") +THREE_DIGITS = re.compile(r"(\d)(\d)(\d)") +THREE_DIGITS_WORD = re.compile(r"(\d)(\d)(\d)(?=\D*\Z)") +TWO_DIGITS_WORD = re.compile(r"(\d)(\d)(?=\D*\Z)") +ONE_DIGIT_WORD = re.compile(r"(\d)(?=\D*\Z)") + +FOUR_DIGIT_COMMA = re.compile(r"(\d)(\d{3}(?:,|\Z))") +NON_DIGIT = re.compile(r"\D") +WHITESPACES_COMMA = re.compile(r"\s+,") +COMMA_WORD = re.compile(r", (\S+)\s+\Z") +WHITESPACES = re.compile(r"\s+") + + +PRESENT_PARTICIPLE_REPLACEMENTS = ( + (re.compile(r"ie$"), r"y"), + ( + re.compile(r"ue$"), + r"u", + ), # TODO: isn't ue$ -> u encompassed in the following rule? + (re.compile(r"([auy])e$"), r"\g<1>"), + (re.compile(r"ski$"), r"ski"), + (re.compile(r"[^b]i$"), r""), + (re.compile(r"^(are|were)$"), r"be"), + (re.compile(r"^(had)$"), r"hav"), + (re.compile(r"^(hoe)$"), r"\g<1>"), + (re.compile(r"([^e])e$"), r"\g<1>"), + (re.compile(r"er$"), r"er"), + (re.compile(r"([^aeiou][aeiouy]([bdgmnprst]))$"), r"\g<1>\g<2>"), +) + +DIGIT = re.compile(r"\d") + + +class Words(str): + lowered: str + split_: List[str] + first: str + last: str + + def __init__(self, orig) -> None: + self.lowered = self.lower() + self.split_ = self.split() + self.first = self.split_[0] + self.last = self.split_[-1] + + +Falsish = Any # ideally, falsish would only validate on bool(value) is False + + +_STATIC_TYPE_CHECKING = TYPE_CHECKING +# ^-- Workaround for typeguard AST manipulation: +# https://github.com/agronholm/typeguard/issues/353#issuecomment-1556306554 + +if _STATIC_TYPE_CHECKING: # pragma: no cover + Word = Annotated[str, "String with at least 1 character"] +else: + + class _WordMeta(type): # Too dynamic to be supported by mypy... + def __instancecheck__(self, instance: Any) -> bool: + return isinstance(instance, str) and len(instance) >= 1 + + class Word(metaclass=_WordMeta): # type: ignore[no-redef] + """String with at least 1 character""" + + +class engine: + def __init__(self) -> None: + self.classical_dict = def_classical.copy() + self.persistent_count: Optional[int] = None + self.mill_count = 0 + self.pl_sb_user_defined: List[Optional[Word]] = [] + self.pl_v_user_defined: List[Optional[Word]] = [] + self.pl_adj_user_defined: List[Optional[Word]] = [] + self.si_sb_user_defined: List[Optional[Word]] = [] + self.A_a_user_defined: List[Optional[Word]] = [] + self.thegender = "neuter" + self.__number_args: Optional[Dict[str, str]] = None + + @property + def _number_args(self): + return cast(Dict[str, str], self.__number_args) + + @_number_args.setter + def _number_args(self, val): + self.__number_args = val + + @typechecked + def defnoun(self, singular: Optional[Word], plural: Optional[Word]) -> int: + """ + Set the noun plural of singular to plural. + + """ + self.checkpat(singular) + self.checkpatplural(plural) + self.pl_sb_user_defined.extend((singular, plural)) + self.si_sb_user_defined.extend((plural, singular)) + return 1 + + @typechecked + def defverb( + self, + s1: Optional[Word], + p1: Optional[Word], + s2: Optional[Word], + p2: Optional[Word], + s3: Optional[Word], + p3: Optional[Word], + ) -> int: + """ + Set the verb plurals for s1, s2 and s3 to p1, p2 and p3 respectively. + + Where 1, 2 and 3 represent the 1st, 2nd and 3rd person forms of the verb. + + """ + self.checkpat(s1) + self.checkpat(s2) + self.checkpat(s3) + self.checkpatplural(p1) + self.checkpatplural(p2) + self.checkpatplural(p3) + self.pl_v_user_defined.extend((s1, p1, s2, p2, s3, p3)) + return 1 + + @typechecked + def defadj(self, singular: Optional[Word], plural: Optional[Word]) -> int: + """ + Set the adjective plural of singular to plural. + + """ + self.checkpat(singular) + self.checkpatplural(plural) + self.pl_adj_user_defined.extend((singular, plural)) + return 1 + + @typechecked + def defa(self, pattern: Optional[Word]) -> int: + """ + Define the indefinite article as 'a' for words matching pattern. + + """ + self.checkpat(pattern) + self.A_a_user_defined.extend((pattern, "a")) + return 1 + + @typechecked + def defan(self, pattern: Optional[Word]) -> int: + """ + Define the indefinite article as 'an' for words matching pattern. + + """ + self.checkpat(pattern) + self.A_a_user_defined.extend((pattern, "an")) + return 1 + + def checkpat(self, pattern: Optional[Word]) -> None: + """ + check for errors in a regex pattern + """ + if pattern is None: + return + try: + re.match(pattern, "") + except re.error as err: + raise BadUserDefinedPatternError(pattern) from err + + def checkpatplural(self, pattern: Optional[Word]) -> None: + """ + check for errors in a regex replace pattern + """ + return + + @typechecked + def ud_match(self, word: Word, wordlist: Sequence[Optional[Word]]) -> Optional[str]: + for i in range(len(wordlist) - 2, -2, -2): # backwards through even elements + mo = re.search(rf"^{wordlist[i]}$", word, re.IGNORECASE) + if mo: + if wordlist[i + 1] is None: + return None + pl = DOLLAR_DIGITS.sub( + r"\\1", cast(Word, wordlist[i + 1]) + ) # change $n to \n for expand + return mo.expand(pl) + return None + + def classical(self, **kwargs) -> None: + """ + turn classical mode on and off for various categories + + turn on all classical modes: + classical() + classical(all=True) + + turn on or off specific claassical modes: + e.g. + classical(herd=True) + classical(names=False) + + By default all classical modes are off except names. + + unknown value in args or key in kwargs raises + exception: UnknownClasicalModeError + + """ + if not kwargs: + self.classical_dict = all_classical.copy() + return + if "all" in kwargs: + if kwargs["all"]: + self.classical_dict = all_classical.copy() + else: + self.classical_dict = no_classical.copy() + + for k, v in kwargs.items(): + if k in def_classical: + self.classical_dict[k] = v + else: + raise UnknownClassicalModeError + + def num( + self, count: Optional[int] = None, show: Optional[int] = None + ) -> str: # (;$count,$show) + """ + Set the number to be used in other method calls. + + Returns count. + + Set show to False to return '' instead. + + """ + if count is not None: + try: + self.persistent_count = int(count) + except ValueError as err: + raise BadNumValueError from err + if (show is None) or show: + return str(count) + else: + self.persistent_count = None + return "" + + def gender(self, gender: str) -> None: + """ + set the gender for the singular of plural pronouns + + can be one of: + 'neuter' ('they' -> 'it') + 'feminine' ('they' -> 'she') + 'masculine' ('they' -> 'he') + 'gender-neutral' ('they' -> 'they') + 'feminine or masculine' ('they' -> 'she or he') + 'masculine or feminine' ('they' -> 'he or she') + """ + if gender in singular_pronoun_genders: + self.thegender = gender + else: + raise BadGenderError + + def _get_value_from_ast(self, obj): + """ + Return the value of the ast object. + """ + if isinstance(obj, ast.Num): + return obj.n + elif isinstance(obj, ast.Str): + return obj.s + elif isinstance(obj, ast.List): + return [self._get_value_from_ast(e) for e in obj.elts] + elif isinstance(obj, ast.Tuple): + return tuple([self._get_value_from_ast(e) for e in obj.elts]) + + # None, True and False are NameConstants in Py3.4 and above. + elif isinstance(obj, ast.NameConstant): + return obj.value + + # Probably passed a variable name. + # Or passed a single word without wrapping it in quotes as an argument + # ex: p.inflect("I plural(see)") instead of p.inflect("I plural('see')") + raise NameError(f"name '{obj.id}' is not defined") + + def _string_to_substitute( + self, mo: Match, methods_dict: Dict[str, Callable] + ) -> str: + """ + Return the string to be substituted for the match. + """ + matched_text, f_name = mo.groups() + # matched_text is the complete match string. e.g. plural_noun(cat) + # f_name is the function name. e.g. plural_noun + + # Return matched_text if function name is not in methods_dict + if f_name not in methods_dict: + return matched_text + + # Parse the matched text + a_tree = ast.parse(matched_text) + + # get the args and kwargs from ast objects + args_list = [ + self._get_value_from_ast(a) + for a in a_tree.body[0].value.args # type: ignore[attr-defined] + ] + kwargs_list = { + kw.arg: self._get_value_from_ast(kw.value) + for kw in a_tree.body[0].value.keywords # type: ignore[attr-defined] + } + + # Call the corresponding function + return methods_dict[f_name](*args_list, **kwargs_list) + + # 0. PERFORM GENERAL INFLECTIONS IN A STRING + + @typechecked + def inflect(self, text: Word) -> str: + """ + Perform inflections in a string. + + e.g. inflect('The plural of cat is plural(cat)') returns + 'The plural of cat is cats' + + can use plural, plural_noun, plural_verb, plural_adj, + singular_noun, a, an, no, ordinal, number_to_words, + and prespart + + """ + save_persistent_count = self.persistent_count + + # Dictionary of allowed methods + methods_dict: Dict[str, Callable] = { + "plural": self.plural, + "plural_adj": self.plural_adj, + "plural_noun": self.plural_noun, + "plural_verb": self.plural_verb, + "singular_noun": self.singular_noun, + "a": self.a, + "an": self.a, + "no": self.no, + "ordinal": self.ordinal, + "number_to_words": self.number_to_words, + "present_participle": self.present_participle, + "num": self.num, + } + + # Regular expression to find Python's function call syntax + output = FUNCTION_CALL.sub( + lambda mo: self._string_to_substitute(mo, methods_dict), text + ) + self.persistent_count = save_persistent_count + return output + + # ## PLURAL SUBROUTINES + + def postprocess(self, orig: str, inflected) -> str: + inflected = str(inflected) + if "|" in inflected: + word_options = inflected.split("|") + # When two parts of a noun need to be pluralized + if len(word_options[0].split(" ")) == len(word_options[1].split(" ")): + result = inflected.split("|")[self.classical_dict["all"]].split(" ") + # When only the last part of the noun needs to be pluralized + else: + result = inflected.split(" ") + for index, word in enumerate(result): + if "|" in word: + result[index] = word.split("|")[self.classical_dict["all"]] + else: + result = inflected.split(" ") + + # Try to fix word wise capitalization + for index, word in enumerate(orig.split(" ")): + if word == "I": + # Is this the only word for exceptions like this + # Where the original is fully capitalized + # without 'meaning' capitalization? + # Also this fails to handle a capitalizaion in context + continue + if word.capitalize() == word: + result[index] = result[index].capitalize() + if word == word.upper(): + result[index] = result[index].upper() + return " ".join(result) + + def partition_word(self, text: str) -> Tuple[str, str, str]: + mo = PARTITION_WORD.search(text) + if mo: + return mo.group(1), mo.group(2), mo.group(3) + else: + return "", "", "" + + @typechecked + def plural(self, text: Word, count: Optional[Union[str, int, Any]] = None) -> str: + """ + Return the plural of text. + + If count supplied, then return text if count is one of: + 1, a, an, one, each, every, this, that + + otherwise return the plural. + + Whitespace at the start and end is preserved. + + """ + pre, word, post = self.partition_word(text) + if not word: + return text + plural = self.postprocess( + word, + self._pl_special_adjective(word, count) + or self._pl_special_verb(word, count) + or self._plnoun(word, count), + ) + return f"{pre}{plural}{post}" + + @typechecked + def plural_noun( + self, text: Word, count: Optional[Union[str, int, Any]] = None + ) -> str: + """ + Return the plural of text, where text is a noun. + + If count supplied, then return text if count is one of: + 1, a, an, one, each, every, this, that + + otherwise return the plural. + + Whitespace at the start and end is preserved. + + """ + pre, word, post = self.partition_word(text) + if not word: + return text + plural = self.postprocess(word, self._plnoun(word, count)) + return f"{pre}{plural}{post}" + + @typechecked + def plural_verb( + self, text: Word, count: Optional[Union[str, int, Any]] = None + ) -> str: + """ + Return the plural of text, where text is a verb. + + If count supplied, then return text if count is one of: + 1, a, an, one, each, every, this, that + + otherwise return the plural. + + Whitespace at the start and end is preserved. + + """ + pre, word, post = self.partition_word(text) + if not word: + return text + plural = self.postprocess( + word, + self._pl_special_verb(word, count) or self._pl_general_verb(word, count), + ) + return f"{pre}{plural}{post}" + + @typechecked + def plural_adj( + self, text: Word, count: Optional[Union[str, int, Any]] = None + ) -> str: + """ + Return the plural of text, where text is an adjective. + + If count supplied, then return text if count is one of: + 1, a, an, one, each, every, this, that + + otherwise return the plural. + + Whitespace at the start and end is preserved. + + """ + pre, word, post = self.partition_word(text) + if not word: + return text + plural = self.postprocess(word, self._pl_special_adjective(word, count) or word) + return f"{pre}{plural}{post}" + + @typechecked + def compare(self, word1: Word, word2: Word) -> Union[str, bool]: + """ + compare word1 and word2 for equality regardless of plurality + + return values: + eq - the strings are equal + p:s - word1 is the plural of word2 + s:p - word2 is the plural of word1 + p:p - word1 and word2 are two different plural forms of the one word + False - otherwise + + >>> compare = engine().compare + >>> compare("egg", "eggs") + 's:p' + >>> compare('egg', 'egg') + 'eq' + + Words should not be empty. + + >>> compare('egg', '') + Traceback (most recent call last): + ... + typeguard.TypeCheckError:...is not an instance of inflect.Word + """ + norms = self.plural_noun, self.plural_verb, self.plural_adj + results = (self._plequal(word1, word2, norm) for norm in norms) + return next(filter(None, results), False) + + @typechecked + def compare_nouns(self, word1: Word, word2: Word) -> Union[str, bool]: + """ + compare word1 and word2 for equality regardless of plurality + word1 and word2 are to be treated as nouns + + return values: + eq - the strings are equal + p:s - word1 is the plural of word2 + s:p - word2 is the plural of word1 + p:p - word1 and word2 are two different plural forms of the one word + False - otherwise + + """ + return self._plequal(word1, word2, self.plural_noun) + + @typechecked + def compare_verbs(self, word1: Word, word2: Word) -> Union[str, bool]: + """ + compare word1 and word2 for equality regardless of plurality + word1 and word2 are to be treated as verbs + + return values: + eq - the strings are equal + p:s - word1 is the plural of word2 + s:p - word2 is the plural of word1 + p:p - word1 and word2 are two different plural forms of the one word + False - otherwise + + """ + return self._plequal(word1, word2, self.plural_verb) + + @typechecked + def compare_adjs(self, word1: Word, word2: Word) -> Union[str, bool]: + """ + compare word1 and word2 for equality regardless of plurality + word1 and word2 are to be treated as adjectives + + return values: + eq - the strings are equal + p:s - word1 is the plural of word2 + s:p - word2 is the plural of word1 + p:p - word1 and word2 are two different plural forms of the one word + False - otherwise + + """ + return self._plequal(word1, word2, self.plural_adj) + + @typechecked + def singular_noun( + self, + text: Word, + count: Optional[Union[int, str, Any]] = None, + gender: Optional[str] = None, + ) -> Union[str, Literal[False]]: + """ + Return the singular of text, where text is a plural noun. + + If count supplied, then return the singular if count is one of: + 1, a, an, one, each, every, this, that or if count is None + + otherwise return text unchanged. + + Whitespace at the start and end is preserved. + + >>> p = engine() + >>> p.singular_noun('horses') + 'horse' + >>> p.singular_noun('knights') + 'knight' + + Returns False when a singular noun is passed. + + >>> p.singular_noun('horse') + False + >>> p.singular_noun('knight') + False + >>> p.singular_noun('soldier') + False + + """ + pre, word, post = self.partition_word(text) + if not word: + return text + sing = self._sinoun(word, count=count, gender=gender) + if sing is not False: + plural = self.postprocess(word, sing) + return f"{pre}{plural}{post}" + return False + + def _plequal(self, word1: str, word2: str, pl) -> Union[str, bool]: # noqa: C901 + classval = self.classical_dict.copy() + self.classical_dict = all_classical.copy() + if word1 == word2: + return "eq" + if word1 == pl(word2): + return "p:s" + if pl(word1) == word2: + return "s:p" + self.classical_dict = no_classical.copy() + if word1 == pl(word2): + return "p:s" + if pl(word1) == word2: + return "s:p" + self.classical_dict = classval.copy() + + if pl == self.plural or pl == self.plural_noun: + if self._pl_check_plurals_N(word1, word2): + return "p:p" + if self._pl_check_plurals_N(word2, word1): + return "p:p" + if pl == self.plural or pl == self.plural_adj: + if self._pl_check_plurals_adj(word1, word2): + return "p:p" + return False + + def _pl_reg_plurals(self, pair: str, stems: str, end1: str, end2: str) -> bool: + pattern = rf"({stems})({end1}\|\1{end2}|{end2}\|\1{end1})" + return bool(re.search(pattern, pair)) + + def _pl_check_plurals_N(self, word1: str, word2: str) -> bool: + stem_endings = ( + (pl_sb_C_a_ata, "as", "ata"), + (pl_sb_C_is_ides, "is", "ides"), + (pl_sb_C_a_ae, "s", "e"), + (pl_sb_C_en_ina, "ens", "ina"), + (pl_sb_C_um_a, "ums", "a"), + (pl_sb_C_us_i, "uses", "i"), + (pl_sb_C_on_a, "ons", "a"), + (pl_sb_C_o_i_stems, "os", "i"), + (pl_sb_C_ex_ices, "exes", "ices"), + (pl_sb_C_ix_ices, "ixes", "ices"), + (pl_sb_C_i, "s", "i"), + (pl_sb_C_im, "s", "im"), + (".*eau", "s", "x"), + (".*ieu", "s", "x"), + (".*tri", "xes", "ces"), + (".{2,}[yia]n", "xes", "ges"), + ) + + words = map(Words, (word1, word2)) + pair = "|".join(word.last for word in words) + + return ( + pair in pl_sb_irregular_s.values() + or pair in pl_sb_irregular.values() + or pair in pl_sb_irregular_caps.values() + or any( + self._pl_reg_plurals(pair, stems, end1, end2) + for stems, end1, end2 in stem_endings + ) + ) + + def _pl_check_plurals_adj(self, word1: str, word2: str) -> bool: + word1a = word1[: word1.rfind("'")] if word1.endswith(("'s", "'")) else "" + word2a = word2[: word2.rfind("'")] if word2.endswith(("'s", "'")) else "" + + return ( + bool(word1a) + and bool(word2a) + and ( + self._pl_check_plurals_N(word1a, word2a) + or self._pl_check_plurals_N(word2a, word1a) + ) + ) + + def get_count(self, count: Optional[Union[str, int]] = None) -> Union[str, int]: + if count is None and self.persistent_count is not None: + count = self.persistent_count + + if count is not None: + count = ( + 1 + if ( + (str(count) in pl_count_one) + or ( + self.classical_dict["zero"] + and str(count).lower() in pl_count_zero + ) + ) + else 2 + ) + else: + count = "" + return count + + # @profile + def _plnoun( # noqa: C901 + self, word: str, count: Optional[Union[str, int]] = None + ) -> str: + count = self.get_count(count) + + # DEFAULT TO PLURAL + + if count == 1: + return word + + # HANDLE USER-DEFINED NOUNS + + value = self.ud_match(word, self.pl_sb_user_defined) + if value is not None: + return value + + # HANDLE EMPTY WORD, SINGULAR COUNT AND UNINFLECTED PLURALS + + if word == "": + return word + + word = Words(word) + + if word.last.lower() in pl_sb_uninflected_complete: + if len(word.split_) >= 3: + return self._handle_long_compounds(word, count=2) or word + return word + + if word in pl_sb_uninflected_caps: + return word + + for k, v in pl_sb_uninflected_bysize.items(): + if word.lowered[-k:] in v: + return word + + if self.classical_dict["herd"] and word.last.lower() in pl_sb_uninflected_herd: + return word + + # HANDLE COMPOUNDS ("Governor General", "mother-in-law", "aide-de-camp", ETC.) + + mo = PL_SB_POSTFIX_ADJ_STEMS_RE.search(word) + if mo and mo.group(2) != "": + return f"{self._plnoun(mo.group(1), 2)}{mo.group(2)}" + + if " a " in word.lowered or "-a-" in word.lowered: + mo = PL_SB_PREP_DUAL_COMPOUND_RE.search(word) + if mo and mo.group(2) != "" and mo.group(3) != "": + return ( + f"{self._plnoun(mo.group(1), 2)}" + f"{mo.group(2)}" + f"{self._plnoun(mo.group(3))}" + ) + + if len(word.split_) >= 3: + handled_words = self._handle_long_compounds(word, count=2) + if handled_words is not None: + return handled_words + + # only pluralize denominators in units + mo = DENOMINATOR.search(word.lowered) + if mo: + index = len(mo.group("denominator")) + return f"{self._plnoun(word[:index])}{word[index:]}" + + # handle units given in degrees (only accept if + # there is no more than one word following) + # degree Celsius => degrees Celsius but degree + # fahrenheit hour => degree fahrenheit hours + if len(word.split_) >= 2 and word.split_[-2] == "degree": + return " ".join([self._plnoun(word.first)] + word.split_[1:]) + + with contextlib.suppress(ValueError): + return self._handle_prepositional_phrase( + word.lowered, + functools.partial(self._plnoun, count=2), + '-', + ) + + # HANDLE PRONOUNS + + for k, v in pl_pron_acc_keys_bysize.items(): + if word.lowered[-k:] in v: # ends with accusative pronoun + for pk, pv in pl_prep_bysize.items(): + if word.lowered[:pk] in pv: # starts with a prep + if word.lowered.split() == [ + word.lowered[:pk], + word.lowered[-k:], + ]: + # only whitespace in between + return word.lowered[:-k] + pl_pron_acc[word.lowered[-k:]] + + try: + return pl_pron_nom[word.lowered] + except KeyError: + pass + + try: + return pl_pron_acc[word.lowered] + except KeyError: + pass + + # HANDLE ISOLATED IRREGULAR PLURALS + + if word.last in pl_sb_irregular_caps: + llen = len(word.last) + return f"{word[:-llen]}{pl_sb_irregular_caps[word.last]}" + + lowered_last = word.last.lower() + if lowered_last in pl_sb_irregular: + llen = len(lowered_last) + return f"{word[:-llen]}{pl_sb_irregular[lowered_last]}" + + dash_split = word.lowered.split('-') + if (" ".join(dash_split[-2:])).lower() in pl_sb_irregular_compound: + llen = len( + " ".join(dash_split[-2:]) + ) # TODO: what if 2 spaces between these words? + return ( + f"{word[:-llen]}" + f"{pl_sb_irregular_compound[(' '.join(dash_split[-2:])).lower()]}" + ) + + if word.lowered[-3:] == "quy": + return f"{word[:-1]}ies" + + if word.lowered[-6:] == "person": + if self.classical_dict["persons"]: + return f"{word}s" + else: + return f"{word[:-4]}ople" + + # HANDLE FAMILIES OF IRREGULAR PLURALS + + if word.lowered[-3:] == "man": + for k, v in pl_sb_U_man_mans_bysize.items(): + if word.lowered[-k:] in v: + return f"{word}s" + for k, v in pl_sb_U_man_mans_caps_bysize.items(): + if word[-k:] in v: + return f"{word}s" + return f"{word[:-3]}men" + if word.lowered[-5:] == "mouse": + return f"{word[:-5]}mice" + if word.lowered[-5:] == "louse": + v = pl_sb_U_louse_lice_bysize.get(len(word)) + if v and word.lowered in v: + return f"{word[:-5]}lice" + return f"{word}s" + if word.lowered[-5:] == "goose": + return f"{word[:-5]}geese" + if word.lowered[-5:] == "tooth": + return f"{word[:-5]}teeth" + if word.lowered[-4:] == "foot": + return f"{word[:-4]}feet" + if word.lowered[-4:] == "taco": + return f"{word[:-5]}tacos" + + if word.lowered == "die": + return "dice" + + # HANDLE UNASSIMILATED IMPORTS + + if word.lowered[-4:] == "ceps": + return word + if word.lowered[-4:] == "zoon": + return f"{word[:-2]}a" + if word.lowered[-3:] in ("cis", "sis", "xis"): + return f"{word[:-2]}es" + + for lastlet, d, numend, post in ( + ("h", pl_sb_U_ch_chs_bysize, None, "s"), + ("x", pl_sb_U_ex_ices_bysize, -2, "ices"), + ("x", pl_sb_U_ix_ices_bysize, -2, "ices"), + ("m", pl_sb_U_um_a_bysize, -2, "a"), + ("s", pl_sb_U_us_i_bysize, -2, "i"), + ("n", pl_sb_U_on_a_bysize, -2, "a"), + ("a", pl_sb_U_a_ae_bysize, None, "e"), + ): + if word.lowered[-1] == lastlet: # this test to add speed + for k, v in d.items(): + if word.lowered[-k:] in v: + return word[:numend] + post + + # HANDLE INCOMPLETELY ASSIMILATED IMPORTS + + if self.classical_dict["ancient"]: + if word.lowered[-4:] == "trix": + return f"{word[:-1]}ces" + if word.lowered[-3:] in ("eau", "ieu"): + return f"{word}x" + if word.lowered[-3:] in ("ynx", "inx", "anx") and len(word) > 4: + return f"{word[:-1]}ges" + + for lastlet, d, numend, post in ( + ("n", pl_sb_C_en_ina_bysize, -2, "ina"), + ("x", pl_sb_C_ex_ices_bysize, -2, "ices"), + ("x", pl_sb_C_ix_ices_bysize, -2, "ices"), + ("m", pl_sb_C_um_a_bysize, -2, "a"), + ("s", pl_sb_C_us_i_bysize, -2, "i"), + ("s", pl_sb_C_us_us_bysize, None, ""), + ("a", pl_sb_C_a_ae_bysize, None, "e"), + ("a", pl_sb_C_a_ata_bysize, None, "ta"), + ("s", pl_sb_C_is_ides_bysize, -1, "des"), + ("o", pl_sb_C_o_i_bysize, -1, "i"), + ("n", pl_sb_C_on_a_bysize, -2, "a"), + ): + if word.lowered[-1] == lastlet: # this test to add speed + for k, v in d.items(): + if word.lowered[-k:] in v: + return word[:numend] + post + + for d, numend, post in ( + (pl_sb_C_i_bysize, None, "i"), + (pl_sb_C_im_bysize, None, "im"), + ): + for k, v in d.items(): + if word.lowered[-k:] in v: + return word[:numend] + post + + # HANDLE SINGULAR NOUNS ENDING IN ...s OR OTHER SILIBANTS + + if lowered_last in pl_sb_singular_s_complete: + return f"{word}es" + + for k, v in pl_sb_singular_s_bysize.items(): + if word.lowered[-k:] in v: + return f"{word}es" + + if word.lowered[-2:] == "es" and word[0] == word[0].upper(): + return f"{word}es" + + if word.lowered[-1] == "z": + for k, v in pl_sb_z_zes_bysize.items(): + if word.lowered[-k:] in v: + return f"{word}es" + + if word.lowered[-2:-1] != "z": + return f"{word}zes" + + if word.lowered[-2:] == "ze": + for k, v in pl_sb_ze_zes_bysize.items(): + if word.lowered[-k:] in v: + return f"{word}s" + + if word.lowered[-2:] in ("ch", "sh", "zz", "ss") or word.lowered[-1] == "x": + return f"{word}es" + + # HANDLE ...f -> ...ves + + if word.lowered[-3:] in ("elf", "alf", "olf"): + return f"{word[:-1]}ves" + if word.lowered[-3:] == "eaf" and word.lowered[-4:-3] != "d": + return f"{word[:-1]}ves" + if word.lowered[-4:] in ("nife", "life", "wife"): + return f"{word[:-2]}ves" + if word.lowered[-3:] == "arf": + return f"{word[:-1]}ves" + + # HANDLE ...y + + if word.lowered[-1] == "y": + if word.lowered[-2:-1] in "aeiou" or len(word) == 1: + return f"{word}s" + + if self.classical_dict["names"]: + if word.lowered[-1] == "y" and word[0] == word[0].upper(): + return f"{word}s" + + return f"{word[:-1]}ies" + + # HANDLE ...o + + if lowered_last in pl_sb_U_o_os_complete: + return f"{word}s" + + for k, v in pl_sb_U_o_os_bysize.items(): + if word.lowered[-k:] in v: + return f"{word}s" + + if word.lowered[-2:] in ("ao", "eo", "io", "oo", "uo"): + return f"{word}s" + + if word.lowered[-1] == "o": + return f"{word}es" + + # OTHERWISE JUST ADD ...s + + return f"{word}s" + + @classmethod + def _handle_prepositional_phrase(cls, phrase, transform, sep): + """ + Given a word or phrase possibly separated by sep, parse out + the prepositional phrase and apply the transform to the word + preceding the prepositional phrase. + + Raise ValueError if the pivot is not found or if at least two + separators are not found. + + >>> engine._handle_prepositional_phrase("man-of-war", str.upper, '-') + 'MAN-of-war' + >>> engine._handle_prepositional_phrase("man of war", str.upper, ' ') + 'MAN of war' + """ + parts = phrase.split(sep) + if len(parts) < 3: + raise ValueError("Cannot handle words with fewer than two separators") + + pivot = cls._find_pivot(parts, pl_prep_list_da) + + transformed = transform(parts[pivot - 1]) or parts[pivot - 1] + return " ".join( + parts[: pivot - 1] + [sep.join([transformed, parts[pivot], ''])] + ) + " ".join(parts[(pivot + 1) :]) + + def _handle_long_compounds(self, word: Words, count: int) -> Union[str, None]: + """ + Handles the plural and singular for compound `Words` that + have three or more words, based on the given count. + + >>> engine()._handle_long_compounds(Words("pair of scissors"), 2) + 'pairs of scissors' + >>> engine()._handle_long_compounds(Words("men beyond hills"), 1) + 'man beyond hills' + """ + inflection = self._sinoun if count == 1 else self._plnoun + solutions = ( # type: ignore + " ".join( + itertools.chain( + leader, + [inflection(cand, count), prep], # type: ignore + trailer, + ) + ) + for leader, (cand, prep), trailer in windowed_complete(word.split_, 2) + if prep in pl_prep_list_da # type: ignore + ) + return next(solutions, None) + + @staticmethod + def _find_pivot(words, candidates): + pivots = ( + index for index in range(1, len(words) - 1) if words[index] in candidates + ) + try: + return next(pivots) + except StopIteration: + raise ValueError("No pivot found") from None + + def _pl_special_verb( # noqa: C901 + self, word: str, count: Optional[Union[str, int]] = None + ) -> Union[str, bool]: + if self.classical_dict["zero"] and str(count).lower() in pl_count_zero: + return False + count = self.get_count(count) + + if count == 1: + return word + + # HANDLE USER-DEFINED VERBS + + value = self.ud_match(word, self.pl_v_user_defined) + if value is not None: + return value + + # HANDLE IRREGULAR PRESENT TENSE (SIMPLE AND COMPOUND) + + try: + words = Words(word) + except IndexError: + return False # word is '' + + if words.first in plverb_irregular_pres: + return f"{plverb_irregular_pres[words.first]}{words[len(words.first) :]}" + + # HANDLE IRREGULAR FUTURE, PRETERITE AND PERFECT TENSES + + if words.first in plverb_irregular_non_pres: + return word + + # HANDLE PRESENT NEGATIONS (SIMPLE AND COMPOUND) + + if words.first.endswith("n't") and words.first[:-3] in plverb_irregular_pres: + return ( + f"{plverb_irregular_pres[words.first[:-3]]}n't" + f"{words[len(words.first) :]}" + ) + + if words.first.endswith("n't"): + return word + + # HANDLE SPECIAL CASES + + mo = PLVERB_SPECIAL_S_RE.search(word) + if mo: + return False + if WHITESPACE.search(word): + return False + + if words.lowered == "quizzes": + return "quiz" + + # HANDLE STANDARD 3RD PERSON (CHOP THE ...(e)s OFF SINGLE WORDS) + + if ( + words.lowered[-4:] in ("ches", "shes", "zzes", "sses") + or words.lowered[-3:] == "xes" + ): + return words[:-2] + + if words.lowered[-3:] == "ies" and len(words) > 3: + return words.lowered[:-3] + "y" + + if ( + words.last.lower() in pl_v_oes_oe + or words.lowered[-4:] in pl_v_oes_oe_endings_size4 + or words.lowered[-5:] in pl_v_oes_oe_endings_size5 + ): + return words[:-1] + + if words.lowered.endswith("oes") and len(words) > 3: + return words.lowered[:-2] + + mo = ENDS_WITH_S.search(words) + if mo: + return mo.group(1) + + # OTHERWISE, A REGULAR VERB (HANDLE ELSEWHERE) + + return False + + def _pl_general_verb( + self, word: str, count: Optional[Union[str, int]] = None + ) -> str: + count = self.get_count(count) + + if count == 1: + return word + + # HANDLE AMBIGUOUS PRESENT TENSES (SIMPLE AND COMPOUND) + + mo = plverb_ambiguous_pres_keys.search(word) + if mo: + return f"{plverb_ambiguous_pres[mo.group(1).lower()]}{mo.group(2)}" + + # HANDLE AMBIGUOUS PRETERITE AND PERFECT TENSES + + mo = plverb_ambiguous_non_pres.search(word) + if mo: + return word + + # OTHERWISE, 1st OR 2ND PERSON IS UNINFLECTED + + return word + + def _pl_special_adjective( + self, word: str, count: Optional[Union[str, int]] = None + ) -> Union[str, bool]: + count = self.get_count(count) + + if count == 1: + return word + + # HANDLE USER-DEFINED ADJECTIVES + + value = self.ud_match(word, self.pl_adj_user_defined) + if value is not None: + return value + + # HANDLE KNOWN CASES + + mo = pl_adj_special_keys.search(word) + if mo: + return pl_adj_special[mo.group(1).lower()] + + # HANDLE POSSESSIVES + + mo = pl_adj_poss_keys.search(word) + if mo: + return pl_adj_poss[mo.group(1).lower()] + + mo = ENDS_WITH_APOSTROPHE_S.search(word) + if mo: + pl = self.plural_noun(mo.group(1)) + trailing_s = "" if pl[-1] == "s" else "s" + return f"{pl}'{trailing_s}" + + # OTHERWISE, NO IDEA + + return False + + # @profile + def _sinoun( # noqa: C901 + self, + word: str, + count: Optional[Union[str, int]] = None, + gender: Optional[str] = None, + ) -> Union[str, bool]: + count = self.get_count(count) + + # DEFAULT TO PLURAL + + if count == 2: + return word + + # SET THE GENDER + + try: + if gender is None: + gender = self.thegender + elif gender not in singular_pronoun_genders: + raise BadGenderError + except (TypeError, IndexError) as err: + raise BadGenderError from err + + # HANDLE USER-DEFINED NOUNS + + value = self.ud_match(word, self.si_sb_user_defined) + if value is not None: + return value + + # HANDLE EMPTY WORD, SINGULAR COUNT AND UNINFLECTED PLURALS + + if word == "": + return word + + if word in si_sb_ois_oi_case: + return word[:-1] + + words = Words(word) + + if words.last.lower() in pl_sb_uninflected_complete: + if len(words.split_) >= 3: + return self._handle_long_compounds(words, count=1) or word + return word + + if word in pl_sb_uninflected_caps: + return word + + for k, v in pl_sb_uninflected_bysize.items(): + if words.lowered[-k:] in v: + return word + + if self.classical_dict["herd"] and words.last.lower() in pl_sb_uninflected_herd: + return word + + if words.last.lower() in pl_sb_C_us_us: + return word if self.classical_dict["ancient"] else False + + # HANDLE COMPOUNDS ("Governor General", "mother-in-law", "aide-de-camp", ETC.) + + mo = PL_SB_POSTFIX_ADJ_STEMS_RE.search(word) + if mo and mo.group(2) != "": + return f"{self._sinoun(mo.group(1), 1, gender=gender)}{mo.group(2)}" + + with contextlib.suppress(ValueError): + return self._handle_prepositional_phrase( + words.lowered, + functools.partial(self._sinoun, count=1, gender=gender), + ' ', + ) + + with contextlib.suppress(ValueError): + return self._handle_prepositional_phrase( + words.lowered, + functools.partial(self._sinoun, count=1, gender=gender), + '-', + ) + + # HANDLE PRONOUNS + + for k, v in si_pron_acc_keys_bysize.items(): + if words.lowered[-k:] in v: # ends with accusative pronoun + for pk, pv in pl_prep_bysize.items(): + if words.lowered[:pk] in pv: # starts with a prep + if words.lowered.split() == [ + words.lowered[:pk], + words.lowered[-k:], + ]: + # only whitespace in between + return words.lowered[:-k] + get_si_pron( + "acc", words.lowered[-k:], gender + ) + + try: + return get_si_pron("nom", words.lowered, gender) + except KeyError: + pass + + try: + return get_si_pron("acc", words.lowered, gender) + except KeyError: + pass + + # HANDLE ISOLATED IRREGULAR PLURALS + + if words.last in si_sb_irregular_caps: + llen = len(words.last) + return f"{word[:-llen]}{si_sb_irregular_caps[words.last]}" + + if words.last.lower() in si_sb_irregular: + llen = len(words.last.lower()) + return f"{word[:-llen]}{si_sb_irregular[words.last.lower()]}" + + dash_split = words.lowered.split("-") + if (" ".join(dash_split[-2:])).lower() in si_sb_irregular_compound: + llen = len( + " ".join(dash_split[-2:]) + ) # TODO: what if 2 spaces between these words? + return "{}{}".format( + word[:-llen], + si_sb_irregular_compound[(" ".join(dash_split[-2:])).lower()], + ) + + if words.lowered[-5:] == "quies": + return word[:-3] + "y" + + if words.lowered[-7:] == "persons": + return word[:-1] + if words.lowered[-6:] == "people": + return word[:-4] + "rson" + + # HANDLE FAMILIES OF IRREGULAR PLURALS + + if words.lowered[-4:] == "mans": + for k, v in si_sb_U_man_mans_bysize.items(): + if words.lowered[-k:] in v: + return word[:-1] + for k, v in si_sb_U_man_mans_caps_bysize.items(): + if word[-k:] in v: + return word[:-1] + if words.lowered[-3:] == "men": + return word[:-3] + "man" + if words.lowered[-4:] == "mice": + return word[:-4] + "mouse" + if words.lowered[-4:] == "lice": + v = si_sb_U_louse_lice_bysize.get(len(word)) + if v and words.lowered in v: + return word[:-4] + "louse" + if words.lowered[-5:] == "geese": + return word[:-5] + "goose" + if words.lowered[-5:] == "teeth": + return word[:-5] + "tooth" + if words.lowered[-4:] == "feet": + return word[:-4] + "foot" + + if words.lowered == "dice": + return "die" + + # HANDLE UNASSIMILATED IMPORTS + + if words.lowered[-4:] == "ceps": + return word + if words.lowered[-3:] == "zoa": + return word[:-1] + "on" + + for lastlet, d, unass_numend, post in ( + ("s", si_sb_U_ch_chs_bysize, -1, ""), + ("s", si_sb_U_ex_ices_bysize, -4, "ex"), + ("s", si_sb_U_ix_ices_bysize, -4, "ix"), + ("a", si_sb_U_um_a_bysize, -1, "um"), + ("i", si_sb_U_us_i_bysize, -1, "us"), + ("a", si_sb_U_on_a_bysize, -1, "on"), + ("e", si_sb_U_a_ae_bysize, -1, ""), + ): + if words.lowered[-1] == lastlet: # this test to add speed + for k, v in d.items(): + if words.lowered[-k:] in v: + return word[:unass_numend] + post + + # HANDLE INCOMPLETELY ASSIMILATED IMPORTS + + if self.classical_dict["ancient"]: + if words.lowered[-6:] == "trices": + return word[:-3] + "x" + if words.lowered[-4:] in ("eaux", "ieux"): + return word[:-1] + if words.lowered[-5:] in ("ynges", "inges", "anges") and len(word) > 6: + return word[:-3] + "x" + + for lastlet, d, class_numend, post in ( + ("a", si_sb_C_en_ina_bysize, -3, "en"), + ("s", si_sb_C_ex_ices_bysize, -4, "ex"), + ("s", si_sb_C_ix_ices_bysize, -4, "ix"), + ("a", si_sb_C_um_a_bysize, -1, "um"), + ("i", si_sb_C_us_i_bysize, -1, "us"), + ("s", pl_sb_C_us_us_bysize, None, ""), + ("e", si_sb_C_a_ae_bysize, -1, ""), + ("a", si_sb_C_a_ata_bysize, -2, ""), + ("s", si_sb_C_is_ides_bysize, -3, "s"), + ("i", si_sb_C_o_i_bysize, -1, "o"), + ("a", si_sb_C_on_a_bysize, -1, "on"), + ("m", si_sb_C_im_bysize, -2, ""), + ("i", si_sb_C_i_bysize, -1, ""), + ): + if words.lowered[-1] == lastlet: # this test to add speed + for k, v in d.items(): + if words.lowered[-k:] in v: + return word[:class_numend] + post + + # HANDLE PLURLS ENDING IN uses -> use + + if ( + words.lowered[-6:] == "houses" + or word in si_sb_uses_use_case + or words.last.lower() in si_sb_uses_use + ): + return word[:-1] + + # HANDLE PLURLS ENDING IN ies -> ie + + if word in si_sb_ies_ie_case or words.last.lower() in si_sb_ies_ie: + return word[:-1] + + # HANDLE PLURLS ENDING IN oes -> oe + + if ( + words.lowered[-5:] == "shoes" + or word in si_sb_oes_oe_case + or words.last.lower() in si_sb_oes_oe + ): + return word[:-1] + + # HANDLE SINGULAR NOUNS ENDING IN ...s OR OTHER SILIBANTS + + if word in si_sb_sses_sse_case or words.last.lower() in si_sb_sses_sse: + return word[:-1] + + if words.last.lower() in si_sb_singular_s_complete: + return word[:-2] + + for k, v in si_sb_singular_s_bysize.items(): + if words.lowered[-k:] in v: + return word[:-2] + + if words.lowered[-4:] == "eses" and word[0] == word[0].upper(): + return word[:-2] + + if words.last.lower() in si_sb_z_zes: + return word[:-2] + + if words.last.lower() in si_sb_zzes_zz: + return word[:-2] + + if words.lowered[-4:] == "zzes": + return word[:-3] + + if word in si_sb_ches_che_case or words.last.lower() in si_sb_ches_che: + return word[:-1] + + if words.lowered[-4:] in ("ches", "shes"): + return word[:-2] + + if words.last.lower() in si_sb_xes_xe: + return word[:-1] + + if words.lowered[-3:] == "xes": + return word[:-2] + + # HANDLE ...f -> ...ves + + if word in si_sb_ves_ve_case or words.last.lower() in si_sb_ves_ve: + return word[:-1] + + if words.lowered[-3:] == "ves": + if words.lowered[-5:-3] in ("el", "al", "ol"): + return word[:-3] + "f" + if words.lowered[-5:-3] == "ea" and word[-6:-5] != "d": + return word[:-3] + "f" + if words.lowered[-5:-3] in ("ni", "li", "wi"): + return word[:-3] + "fe" + if words.lowered[-5:-3] == "ar": + return word[:-3] + "f" + + # HANDLE ...y + + if words.lowered[-2:] == "ys": + if len(words.lowered) > 2 and words.lowered[-3] in "aeiou": + return word[:-1] + + if self.classical_dict["names"]: + if words.lowered[-2:] == "ys" and word[0] == word[0].upper(): + return word[:-1] + + if words.lowered[-3:] == "ies": + return word[:-3] + "y" + + # HANDLE ...o + + if words.lowered[-2:] == "os": + if words.last.lower() in si_sb_U_o_os_complete: + return word[:-1] + + for k, v in si_sb_U_o_os_bysize.items(): + if words.lowered[-k:] in v: + return word[:-1] + + if words.lowered[-3:] in ("aos", "eos", "ios", "oos", "uos"): + return word[:-1] + + if words.lowered[-3:] == "oes": + return word[:-2] + + # UNASSIMILATED IMPORTS FINAL RULE + + if word in si_sb_es_is: + return word[:-2] + "is" + + # OTHERWISE JUST REMOVE ...s + + if words.lowered[-1] == "s": + return word[:-1] + + # COULD NOT FIND SINGULAR + + return False + + # ADJECTIVES + + @typechecked + def a(self, text: Word, count: Optional[Union[int, str, Any]] = 1) -> str: + """ + Return the appropriate indefinite article followed by text. + + The indefinite article is either 'a' or 'an'. + + If count is not one, then return count followed by text + instead of 'a' or 'an'. + + Whitespace at the start and end is preserved. + + """ + mo = INDEFINITE_ARTICLE_TEST.search(text) + if mo: + word = mo.group(2) + if not word: + return text + pre = mo.group(1) + post = mo.group(3) + result = self._indef_article(word, count) + return f"{pre}{result}{post}" + return "" + + an = a + + _indef_article_cases = ( + # HANDLE ORDINAL FORMS + (A_ordinal_a, "a"), + (A_ordinal_an, "an"), + # HANDLE SPECIAL CASES + (A_explicit_an, "an"), + (SPECIAL_AN, "an"), + (SPECIAL_A, "a"), + # HANDLE ABBREVIATIONS + (A_abbrev, "an"), + (SPECIAL_ABBREV_AN, "an"), + (SPECIAL_ABBREV_A, "a"), + # HANDLE CONSONANTS + (CONSONANTS, "a"), + # HANDLE SPECIAL VOWEL-FORMS + (ARTICLE_SPECIAL_EU, "a"), + (ARTICLE_SPECIAL_ONCE, "a"), + (ARTICLE_SPECIAL_ONETIME, "a"), + (ARTICLE_SPECIAL_UNIT, "a"), + (ARTICLE_SPECIAL_UBA, "a"), + (ARTICLE_SPECIAL_UKR, "a"), + (A_explicit_a, "a"), + # HANDLE SPECIAL CAPITALS + (SPECIAL_CAPITALS, "a"), + # HANDLE VOWELS + (VOWELS, "an"), + # HANDLE y... + # (BEFORE CERTAIN CONSONANTS IMPLIES (UNNATURALIZED) "i.." SOUND) + (A_y_cons, "an"), + ) + + def _indef_article(self, word: str, count: Union[int, str, Any]) -> str: + mycount = self.get_count(count) + + if mycount != 1: + return f"{count} {word}" + + # HANDLE USER-DEFINED VARIANTS + + value = self.ud_match(word, self.A_a_user_defined) + if value is not None: + return f"{value} {word}" + + matches = ( + f'{article} {word}' + for regexen, article in self._indef_article_cases + if regexen.search(word) + ) + + # OTHERWISE, GUESS "a" + fallback = f'a {word}' + return next(matches, fallback) + + # 2. TRANSLATE ZERO-QUANTIFIED $word TO "no plural($word)" + + @typechecked + def no(self, text: Word, count: Optional[Union[int, str]] = None) -> str: + """ + If count is 0, no, zero or nil, return 'no' followed by the plural + of text. + + If count is one of: + 1, a, an, one, each, every, this, that + return count followed by text. + + Otherwise return count follow by the plural of text. + + In the return value count is always followed by a space. + + Whitespace at the start and end is preserved. + + """ + if count is None and self.persistent_count is not None: + count = self.persistent_count + + if count is None: + count = 0 + mo = PARTITION_WORD.search(text) + if mo: + pre = mo.group(1) + word = mo.group(2) + post = mo.group(3) + else: + pre = "" + word = "" + post = "" + + if str(count).lower() in pl_count_zero: + count = 'no' + return f"{pre}{count} {self.plural(word, count)}{post}" + + # PARTICIPLES + + @typechecked + def present_participle(self, word: Word) -> str: + """ + Return the present participle for word. + + word is the 3rd person singular verb. + + """ + plv = self.plural_verb(word, 2) + ans = plv + + for regexen, repl in PRESENT_PARTICIPLE_REPLACEMENTS: + ans, num = regexen.subn(repl, plv) + if num: + return f"{ans}ing" + return f"{ans}ing" + + # NUMERICAL INFLECTIONS + + @typechecked + def ordinal(self, num: Union[Number, Word]) -> str: + """ + Return the ordinal of num. + + >>> ordinal = engine().ordinal + >>> ordinal(1) + '1st' + >>> ordinal('one') + 'first' + """ + if DIGIT.match(str(num)): + if isinstance(num, (float, int)) and int(num) == num: + n = int(num) + else: + if "." in str(num): + try: + # numbers after decimal, + # so only need last one for ordinal + n = int(str(num)[-1]) + + except ValueError: # ends with '.', so need to use whole string + n = int(str(num)[:-1]) + else: + n = int(num) # type: ignore + try: + post = nth[n % 100] + except KeyError: + post = nth[n % 10] + return f"{num}{post}" + else: + return self._sub_ord(num) + + def millfn(self, ind: int = 0) -> str: + if ind > len(mill) - 1: + raise NumOutOfRangeError + return mill[ind] + + def unitfn(self, units: int, mindex: int = 0) -> str: + return f"{unit[units]}{self.millfn(mindex)}" + + def tenfn(self, tens, units, mindex=0) -> str: + if tens != 1: + tens_part = ten[tens] + if tens and units: + hyphen = "-" + else: + hyphen = "" + unit_part = unit[units] + mill_part = self.millfn(mindex) + return f"{tens_part}{hyphen}{unit_part}{mill_part}" + return f"{teen[units]}{mill[mindex]}" + + def hundfn(self, hundreds: int, tens: int, units: int, mindex: int) -> str: + if hundreds: + andword = f" {self._number_args['andword']} " if tens or units else "" + # use unit not unitfn as simpler + return ( + f"{unit[hundreds]} hundred{andword}" + f"{self.tenfn(tens, units)}{self.millfn(mindex)}, " + ) + if tens or units: + return f"{self.tenfn(tens, units)}{self.millfn(mindex)}, " + return "" + + def group1sub(self, mo: Match) -> str: + units = int(mo.group(1)) + if units == 1: + return f" {self._number_args['one']}, " + elif units: + return f"{unit[units]}, " + else: + return f" {self._number_args['zero']}, " + + def group1bsub(self, mo: Match) -> str: + units = int(mo.group(1)) + if units: + return f"{unit[units]}, " + else: + return f" {self._number_args['zero']}, " + + def group2sub(self, mo: Match) -> str: + tens = int(mo.group(1)) + units = int(mo.group(2)) + if tens: + return f"{self.tenfn(tens, units)}, " + if units: + return f" {self._number_args['zero']} {unit[units]}, " + return f" {self._number_args['zero']} {self._number_args['zero']}, " + + def group3sub(self, mo: Match) -> str: + hundreds = int(mo.group(1)) + tens = int(mo.group(2)) + units = int(mo.group(3)) + if hundreds == 1: + hunword = f" {self._number_args['one']}" + elif hundreds: + hunword = str(unit[hundreds]) + else: + hunword = f" {self._number_args['zero']}" + if tens: + tenword = self.tenfn(tens, units) + elif units: + tenword = f" {self._number_args['zero']} {unit[units]}" + else: + tenword = f" {self._number_args['zero']} {self._number_args['zero']}" + return f"{hunword} {tenword}, " + + def hundsub(self, mo: Match) -> str: + ret = self.hundfn( + int(mo.group(1)), int(mo.group(2)), int(mo.group(3)), self.mill_count + ) + self.mill_count += 1 + return ret + + def tensub(self, mo: Match) -> str: + return f"{self.tenfn(int(mo.group(1)), int(mo.group(2)), self.mill_count)}, " + + def unitsub(self, mo: Match) -> str: + return f"{self.unitfn(int(mo.group(1)), self.mill_count)}, " + + def enword(self, num: str, group: int) -> str: + # import pdb + # pdb.set_trace() + + if group == 1: + num = DIGIT_GROUP.sub(self.group1sub, num) + elif group == 2: + num = TWO_DIGITS.sub(self.group2sub, num) + num = DIGIT_GROUP.sub(self.group1bsub, num, 1) + elif group == 3: + num = THREE_DIGITS.sub(self.group3sub, num) + num = TWO_DIGITS.sub(self.group2sub, num, 1) + num = DIGIT_GROUP.sub(self.group1sub, num, 1) + elif int(num) == 0: + num = self._number_args["zero"] + elif int(num) == 1: + num = self._number_args["one"] + else: + num = num.lstrip().lstrip("0") + self.mill_count = 0 + # surely there's a better way to do the next bit + mo = THREE_DIGITS_WORD.search(num) + while mo: + num = THREE_DIGITS_WORD.sub(self.hundsub, num, 1) + mo = THREE_DIGITS_WORD.search(num) + num = TWO_DIGITS_WORD.sub(self.tensub, num, 1) + num = ONE_DIGIT_WORD.sub(self.unitsub, num, 1) + return num + + @staticmethod + def _sub_ord(val): + new = ordinal_suff.sub(lambda match: ordinal[match.group(1)], val) + return new + "th" * (new == val) + + @classmethod + def _chunk_num(cls, num, decimal, group): + if decimal: + max_split = -1 if group != 0 else 1 + chunks = num.split(".", max_split) + else: + chunks = [num] + return cls._remove_last_blank(chunks) + + @staticmethod + def _remove_last_blank(chunks): + """ + Remove the last item from chunks if it's a blank string. + + Return the resultant chunks and whether the last item was removed. + """ + removed = chunks[-1] == "" + result = chunks[:-1] if removed else chunks + return result, removed + + @staticmethod + def _get_sign(num): + return {'+': 'plus', '-': 'minus'}.get(num.lstrip()[0], '') + + @typechecked + def number_to_words( # noqa: C901 + self, + num: Union[Number, Word], + wantlist: bool = False, + group: int = 0, + comma: Union[Falsish, str] = ",", + andword: str = "and", + zero: str = "zero", + one: str = "one", + decimal: Union[Falsish, str] = "point", + threshold: Optional[int] = None, + ) -> Union[str, List[str]]: + """ + Return a number in words. + + group = 1, 2 or 3 to group numbers before turning into words + comma: define comma + + andword: + word for 'and'. Can be set to ''. + e.g. "one hundred and one" vs "one hundred one" + + zero: word for '0' + one: word for '1' + decimal: word for decimal point + threshold: numbers above threshold not turned into words + + parameters not remembered from last call. Departure from Perl version. + """ + self._number_args = {"andword": andword, "zero": zero, "one": one} + num = str(num) + + # Handle "stylistic" conversions (up to a given threshold)... + if threshold is not None and float(num) > threshold: + spnum = num.split(".", 1) + while comma: + (spnum[0], n) = FOUR_DIGIT_COMMA.subn(r"\1,\2", spnum[0]) + if n == 0: + break + try: + return f"{spnum[0]}.{spnum[1]}" + except IndexError: + return str(spnum[0]) + + if group < 0 or group > 3: + raise BadChunkingOptionError + + sign = self._get_sign(num) + + if num in nth_suff: + num = zero + + myord = num[-2:] in nth_suff + if myord: + num = num[:-2] + + chunks, finalpoint = self._chunk_num(num, decimal, group) + + loopstart = chunks[0] == "" + first: bool | None = not loopstart + + def _handle_chunk(chunk): + nonlocal first + + # remove all non numeric \D + chunk = NON_DIGIT.sub("", chunk) + if chunk == "": + chunk = "0" + + if group == 0 and not first: + chunk = self.enword(chunk, 1) + else: + chunk = self.enword(chunk, group) + + if chunk[-2:] == ", ": + chunk = chunk[:-2] + chunk = WHITESPACES_COMMA.sub(",", chunk) + + if group == 0 and first: + chunk = COMMA_WORD.sub(f" {andword} \\1", chunk) + chunk = WHITESPACES.sub(" ", chunk) + # chunk = re.sub(r"(\A\s|\s\Z)", self.blankfn, chunk) + chunk = chunk.strip() + if first: + first = None + return chunk + + chunks[loopstart:] = map(_handle_chunk, chunks[loopstart:]) + + numchunks = [] + if first != 0: + numchunks = chunks[0].split(f"{comma} ") + + if myord and numchunks: + numchunks[-1] = self._sub_ord(numchunks[-1]) + + for chunk in chunks[1:]: + numchunks.append(decimal) + numchunks.extend(chunk.split(f"{comma} ")) + + if finalpoint: + numchunks.append(decimal) + + if wantlist: + return [sign] * bool(sign) + numchunks + + signout = f"{sign} " if sign else "" + valout = ( + ', '.join(numchunks) + if group + else ''.join(self._render(numchunks, decimal, comma)) + ) + return signout + valout + + @staticmethod + def _render(chunks, decimal, comma): + first_item = chunks.pop(0) + yield first_item + first = decimal is None or not first_item.endswith(decimal) + for nc in chunks: + if nc == decimal: + first = False + elif first: + yield comma + yield f" {nc}" + + @typechecked + def join( + self, + words: Optional[Sequence[Word]], + sep: Optional[str] = None, + sep_spaced: bool = True, + final_sep: Optional[str] = None, + conj: str = "and", + conj_spaced: bool = True, + ) -> str: + """ + Join words into a list. + + e.g. join(['ant', 'bee', 'fly']) returns 'ant, bee, and fly' + + options: + conj: replacement for 'and' + sep: separator. default ',', unless ',' is in the list then ';' + final_sep: final separator. default ',', unless ',' is in the list then ';' + conj_spaced: boolean. Should conj have spaces around it + + """ + if not words: + return "" + if len(words) == 1: + return words[0] + + if conj_spaced: + if conj == "": + conj = " " + else: + conj = f" {conj} " + + if len(words) == 2: + return f"{words[0]}{conj}{words[1]}" + + if sep is None: + if "," in "".join(words): + sep = ";" + else: + sep = "," + if final_sep is None: + final_sep = sep + + final_sep = f"{final_sep}{conj}" + + if sep_spaced: + sep += " " + + return f"{sep.join(words[0:-1])}{final_sep}{words[-1]}" diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d5431e889a6ee7219c0bf074a41058f233ba762e GIT binary patch literal 113113 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%0AoJypPTM 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/compat/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/compat/__init__.py new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/compat/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/compat/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..566ea5c2f03f346768a312bbf17c21aacd8a42b4 GIT binary patch literal 236 zcmX@j%ge<81jlwKW`O9&AOanHW&w&!XQ*V*Wb|9fP{ah}eFmxd)vceApPQ8XTbOm!FafVR^c^#Rugl<(KG}l$PWdWhUn6>%mz$nMwKul_eSZ zdB%E%M*78>C8@dviOJcC=|J7ZsU@WaCHeU|#rpAOsd*{+Mf#a}X*obU^po>*3ldB8 sBOwXC`svWa@Waor^}6o=S&&uw1CZ{S>a46uz?k!m&=$*O}0H2 z+C-rINOd9GuxS#hp3Whj?W}??CRV5=V;;#I2V`-}`w$BrNHO78X;Z^Mbgbd$H_b`| zLa}m}^$Y(R+F-dIS (3, 9): + from typing import Annotated +else: # pragma: no cover + from typing_extensions import Annotated # noqa: F401 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/py.typed b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/inflect/py.typed new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/INSTALLER new file mode 100644 index 000000000..a1b589e38 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/LICENSE new file mode 100644 index 000000000..1bb5a4435 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/LICENSE @@ -0,0 +1,17 @@ +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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/METADATA new file mode 100644 index 000000000..fe6ca5ad8 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/METADATA @@ -0,0 +1,85 @@ +Metadata-Version: 2.1 +Name: jaraco.collections +Version: 5.1.0 +Summary: Collection objects similar to those in stdlib by jaraco +Author-email: "Jason R. Coombs" +Project-URL: Source, https://github.com/jaraco/jaraco.collections +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Requires-Python: >=3.8 +Description-Content-Type: text/x-rst +License-File: LICENSE +Requires-Dist: jaraco.text +Provides-Extra: check +Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'check' +Requires-Dist: pytest-ruff >=0.2.1 ; (sys_platform != "cygwin") and extra == 'check' +Provides-Extra: cover +Requires-Dist: pytest-cov ; extra == 'cover' +Provides-Extra: doc +Requires-Dist: sphinx >=3.5 ; extra == 'doc' +Requires-Dist: jaraco.packaging >=9.3 ; extra == 'doc' +Requires-Dist: rst.linker >=1.9 ; extra == 'doc' +Requires-Dist: furo ; extra == 'doc' +Requires-Dist: sphinx-lint ; extra == 'doc' +Requires-Dist: jaraco.tidelift >=1.4 ; extra == 'doc' +Provides-Extra: enabler +Requires-Dist: pytest-enabler >=2.2 ; extra == 'enabler' +Provides-Extra: test +Requires-Dist: pytest !=8.1.*,>=6 ; extra == 'test' +Provides-Extra: type +Requires-Dist: pytest-mypy ; extra == 'type' + +.. image:: https://img.shields.io/pypi/v/jaraco.collections.svg + :target: https://pypi.org/project/jaraco.collections + +.. image:: https://img.shields.io/pypi/pyversions/jaraco.collections.svg + +.. image:: https://github.com/jaraco/jaraco.collections/actions/workflows/main.yml/badge.svg + :target: https://github.com/jaraco/jaraco.collections/actions?query=workflow%3A%22tests%22 + :alt: tests + +.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json + :target: https://github.com/astral-sh/ruff + :alt: Ruff + +.. image:: https://readthedocs.org/projects/jaracocollections/badge/?version=latest + :target: https://jaracocollections.readthedocs.io/en/latest/?badge=latest + +.. image:: https://img.shields.io/badge/skeleton-2024-informational + :target: https://blog.jaraco.com/skeleton + +.. image:: https://tidelift.com/badges/package/pypi/jaraco.collections + :target: https://tidelift.com/subscription/pkg/pypi-jaraco.collections?utm_source=pypi-jaraco.collections&utm_medium=readme + +Models and classes to supplement the stdlib 'collections' module. + +See the docs, linked above, for descriptions and usage examples. + +Highlights include: + +- RangeMap: A mapping that accepts a range of values for keys. +- Projection: A subset over an existing mapping. +- KeyTransformingDict: Generalized mapping with keys transformed by a function. +- FoldedCaseKeyedDict: A dict whose string keys are case-insensitive. +- BijectiveMap: A map where keys map to values and values back to their keys. +- ItemsAsAttributes: A mapping mix-in exposing items as attributes. +- IdentityOverrideMap: A map whose keys map by default to themselves unless overridden. +- FrozenDict: A hashable, immutable map. +- Enumeration: An object whose keys are enumerated. +- Everything: A container that contains all things. +- Least, Greatest: Objects that are always less than or greater than any other. +- pop_all: Return all items from the mutable sequence and remove them from that sequence. +- DictStack: A stack of dicts, great for sharing scopes. +- WeightedLookup: A specialized RangeMap for selecting an item by weights. + +For Enterprise +============== + +Available as part of the Tidelift Subscription. + +This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. + +`Learn more `_. diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/RECORD new file mode 100644 index 000000000..228d92681 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/RECORD @@ -0,0 +1,10 @@ +jaraco.collections-5.1.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +jaraco.collections-5.1.0.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 +jaraco.collections-5.1.0.dist-info/METADATA,sha256=IMUaliNsA5X1Ox9MXUWOagch5R4Wwb_3M7erp29dBtg,3933 +jaraco.collections-5.1.0.dist-info/RECORD,, +jaraco.collections-5.1.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +jaraco.collections-5.1.0.dist-info/WHEEL,sha256=Mdi9PDNwEZptOjTlUcAth7XJDFtKrHYaQMPulZeBCiQ,91 +jaraco.collections-5.1.0.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7 +jaraco/collections/__init__.py,sha256=Pc1-SqjWm81ad1P0-GttpkwO_LWlnaY6gUq8gcKh2v0,26640 +jaraco/collections/__pycache__/__init__.cpython-312.pyc,, +jaraco/collections/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/REQUESTED b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/REQUESTED new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/WHEEL new file mode 100644 index 000000000..50e1e84e4 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: setuptools (73.0.1) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/top_level.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/top_level.txt new file mode 100644 index 000000000..f6205a5f1 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.collections-5.1.0.dist-info/top_level.txt @@ -0,0 +1 @@ +jaraco diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/INSTALLER new file mode 100644 index 000000000..a1b589e38 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/LICENSE new file mode 100644 index 000000000..1bb5a4435 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/LICENSE @@ -0,0 +1,17 @@ +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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/METADATA new file mode 100644 index 000000000..a36f7c5e8 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/METADATA @@ -0,0 +1,75 @@ +Metadata-Version: 2.1 +Name: jaraco.context +Version: 5.3.0 +Summary: Useful decorators and context managers +Home-page: https://github.com/jaraco/jaraco.context +Author: Jason R. Coombs +Author-email: jaraco@jaraco.com +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Requires-Python: >=3.8 +License-File: LICENSE +Requires-Dist: backports.tarfile ; python_version < "3.12" +Provides-Extra: docs +Requires-Dist: sphinx >=3.5 ; extra == 'docs' +Requires-Dist: jaraco.packaging >=9.3 ; extra == 'docs' +Requires-Dist: rst.linker >=1.9 ; extra == 'docs' +Requires-Dist: furo ; extra == 'docs' +Requires-Dist: sphinx-lint ; extra == 'docs' +Requires-Dist: jaraco.tidelift >=1.4 ; extra == 'docs' +Provides-Extra: testing +Requires-Dist: pytest !=8.1.1,>=6 ; extra == 'testing' +Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'testing' +Requires-Dist: pytest-cov ; extra == 'testing' +Requires-Dist: pytest-mypy ; extra == 'testing' +Requires-Dist: pytest-enabler >=2.2 ; extra == 'testing' +Requires-Dist: pytest-ruff >=0.2.1 ; extra == 'testing' +Requires-Dist: portend ; extra == 'testing' + +.. image:: https://img.shields.io/pypi/v/jaraco.context.svg + :target: https://pypi.org/project/jaraco.context + +.. image:: https://img.shields.io/pypi/pyversions/jaraco.context.svg + +.. image:: https://github.com/jaraco/jaraco.context/actions/workflows/main.yml/badge.svg + :target: https://github.com/jaraco/jaraco.context/actions?query=workflow%3A%22tests%22 + :alt: tests + +.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json + :target: https://github.com/astral-sh/ruff + :alt: Ruff + +.. image:: https://readthedocs.org/projects/jaracocontext/badge/?version=latest + :target: https://jaracocontext.readthedocs.io/en/latest/?badge=latest + +.. image:: https://img.shields.io/badge/skeleton-2024-informational + :target: https://blog.jaraco.com/skeleton + +.. image:: https://tidelift.com/badges/package/pypi/jaraco.context + :target: https://tidelift.com/subscription/pkg/pypi-jaraco.context?utm_source=pypi-jaraco.context&utm_medium=readme + + +Highlights +========== + +See the docs linked from the badge above for the full details, but here are some features that may be of interest. + +- ``ExceptionTrap`` provides a general-purpose wrapper for trapping exceptions and then acting on the outcome. Includes ``passes`` and ``raises`` decorators to replace the result of a wrapped function by a boolean indicating the outcome of the exception trap. See `this keyring commit `_ for an example of it in production. +- ``suppress`` simply enables ``contextlib.suppress`` as a decorator. +- ``on_interrupt`` is a decorator used by CLI entry points to affect the handling of a ``KeyboardInterrupt``. Inspired by `Lucretiel/autocommand#18 `_. +- ``pushd`` is similar to pytest's ``monkeypatch.chdir`` or path's `default context `_, changes the current working directory for the duration of the context. +- ``tarball`` will download a tarball, extract it, change directory, yield, then clean up after. Convenient when working with web assets. +- ``null`` is there for those times when one code branch needs a context and the other doesn't; this null context provides symmetry across those branches. + + +For Enterprise +============== + +Available as part of the Tidelift Subscription. + +This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. + +`Learn more `_. diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/RECORD new file mode 100644 index 000000000..290c09b99 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/RECORD @@ -0,0 +1,8 @@ +jaraco.context-5.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +jaraco.context-5.3.0.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 +jaraco.context-5.3.0.dist-info/METADATA,sha256=xDtguJej0tN9iEXCUvxEJh2a7xceIRVBEakBLSr__tY,4020 +jaraco.context-5.3.0.dist-info/RECORD,, +jaraco.context-5.3.0.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 +jaraco.context-5.3.0.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7 +jaraco/__pycache__/context.cpython-312.pyc,, +jaraco/context.py,sha256=REoLIxDkO5MfEYowt_WoupNCRoxBS5v7YX2PbW8lIcs,9552 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/WHEEL new file mode 100644 index 000000000..bab98d675 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.43.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/top_level.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/top_level.txt new file mode 100644 index 000000000..f6205a5f1 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.context-5.3.0.dist-info/top_level.txt @@ -0,0 +1 @@ +jaraco diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/INSTALLER new file mode 100644 index 000000000..a1b589e38 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/LICENSE new file mode 100644 index 000000000..1bb5a4435 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/LICENSE @@ -0,0 +1,17 @@ +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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/METADATA new file mode 100644 index 000000000..c865140ab --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/METADATA @@ -0,0 +1,64 @@ +Metadata-Version: 2.1 +Name: jaraco.functools +Version: 4.0.1 +Summary: Functools like those found in stdlib +Author-email: "Jason R. Coombs" +Project-URL: Homepage, https://github.com/jaraco/jaraco.functools +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Requires-Python: >=3.8 +Description-Content-Type: text/x-rst +License-File: LICENSE +Requires-Dist: more-itertools +Provides-Extra: docs +Requires-Dist: sphinx >=3.5 ; extra == 'docs' +Requires-Dist: sphinx <7.2.5 ; extra == 'docs' +Requires-Dist: jaraco.packaging >=9.3 ; extra == 'docs' +Requires-Dist: rst.linker >=1.9 ; extra == 'docs' +Requires-Dist: furo ; extra == 'docs' +Requires-Dist: sphinx-lint ; extra == 'docs' +Requires-Dist: jaraco.tidelift >=1.4 ; extra == 'docs' +Provides-Extra: testing +Requires-Dist: pytest >=6 ; extra == 'testing' +Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'testing' +Requires-Dist: pytest-cov ; extra == 'testing' +Requires-Dist: pytest-enabler >=2.2 ; extra == 'testing' +Requires-Dist: pytest-ruff >=0.2.1 ; extra == 'testing' +Requires-Dist: jaraco.classes ; extra == 'testing' +Requires-Dist: pytest-mypy ; (platform_python_implementation != "PyPy") and extra == 'testing' + +.. image:: https://img.shields.io/pypi/v/jaraco.functools.svg + :target: https://pypi.org/project/jaraco.functools + +.. image:: https://img.shields.io/pypi/pyversions/jaraco.functools.svg + +.. image:: https://github.com/jaraco/jaraco.functools/actions/workflows/main.yml/badge.svg + :target: https://github.com/jaraco/jaraco.functools/actions?query=workflow%3A%22tests%22 + :alt: tests + +.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json + :target: https://github.com/astral-sh/ruff + :alt: Ruff + +.. image:: https://readthedocs.org/projects/jaracofunctools/badge/?version=latest + :target: https://jaracofunctools.readthedocs.io/en/latest/?badge=latest + +.. image:: https://img.shields.io/badge/skeleton-2024-informational + :target: https://blog.jaraco.com/skeleton + +.. image:: https://tidelift.com/badges/package/pypi/jaraco.functools + :target: https://tidelift.com/subscription/pkg/pypi-jaraco.functools?utm_source=pypi-jaraco.functools&utm_medium=readme + +Additional functools in the spirit of stdlib's functools. + +For Enterprise +============== + +Available as part of the Tidelift Subscription. + +This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. + +`Learn more `_. diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/RECORD new file mode 100644 index 000000000..cf552f0f4 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/RECORD @@ -0,0 +1,10 @@ +jaraco.functools-4.0.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +jaraco.functools-4.0.1.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 +jaraco.functools-4.0.1.dist-info/METADATA,sha256=i4aUaQDX-jjdEQK5wevhegyx8JyLfin2HyvaSk3FHso,2891 +jaraco.functools-4.0.1.dist-info/RECORD,, +jaraco.functools-4.0.1.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 +jaraco.functools-4.0.1.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7 +jaraco/functools/__init__.py,sha256=hEAJaS2uSZRuF_JY4CxCHIYh79ZpxaPp9OiHyr9EJ1w,16642 +jaraco/functools/__init__.pyi,sha256=gk3dsgHzo5F_U74HzAvpNivFAPCkPJ1b2-yCd62dfnw,3878 +jaraco/functools/__pycache__/__init__.cpython-312.pyc,, +jaraco/functools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/WHEEL new file mode 100644 index 000000000..bab98d675 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.43.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/top_level.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/top_level.txt new file mode 100644 index 000000000..f6205a5f1 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.functools-4.0.1.dist-info/top_level.txt @@ -0,0 +1 @@ +jaraco diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/INSTALLER new file mode 100644 index 000000000..a1b589e38 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/LICENSE new file mode 100644 index 000000000..1bb5a4435 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/LICENSE @@ -0,0 +1,17 @@ +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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/METADATA new file mode 100644 index 000000000..0258a380f --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/METADATA @@ -0,0 +1,95 @@ +Metadata-Version: 2.1 +Name: jaraco.text +Version: 3.12.1 +Summary: Module for text manipulation +Author-email: "Jason R. Coombs" +Project-URL: Homepage, https://github.com/jaraco/jaraco.text +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3 :: Only +Requires-Python: >=3.8 +Description-Content-Type: text/x-rst +License-File: LICENSE +Requires-Dist: jaraco.functools +Requires-Dist: jaraco.context >=4.1 +Requires-Dist: autocommand +Requires-Dist: inflect +Requires-Dist: more-itertools +Requires-Dist: importlib-resources ; python_version < "3.9" +Provides-Extra: doc +Requires-Dist: sphinx >=3.5 ; extra == 'doc' +Requires-Dist: jaraco.packaging >=9.3 ; extra == 'doc' +Requires-Dist: rst.linker >=1.9 ; extra == 'doc' +Requires-Dist: furo ; extra == 'doc' +Requires-Dist: sphinx-lint ; extra == 'doc' +Requires-Dist: jaraco.tidelift >=1.4 ; extra == 'doc' +Provides-Extra: test +Requires-Dist: pytest !=8.1.*,>=6 ; extra == 'test' +Requires-Dist: pytest-checkdocs >=2.4 ; extra == 'test' +Requires-Dist: pytest-cov ; extra == 'test' +Requires-Dist: pytest-mypy ; extra == 'test' +Requires-Dist: pytest-enabler >=2.2 ; extra == 'test' +Requires-Dist: pytest-ruff >=0.2.1 ; extra == 'test' +Requires-Dist: pathlib2 ; (python_version < "3.10") and extra == 'test' + +.. image:: https://img.shields.io/pypi/v/jaraco.text.svg + :target: https://pypi.org/project/jaraco.text + +.. image:: https://img.shields.io/pypi/pyversions/jaraco.text.svg + +.. image:: https://github.com/jaraco/jaraco.text/actions/workflows/main.yml/badge.svg + :target: https://github.com/jaraco/jaraco.text/actions?query=workflow%3A%22tests%22 + :alt: tests + +.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v2.json + :target: https://github.com/astral-sh/ruff + :alt: Ruff + +.. image:: https://readthedocs.org/projects/jaracotext/badge/?version=latest + :target: https://jaracotext.readthedocs.io/en/latest/?badge=latest + +.. image:: https://img.shields.io/badge/skeleton-2024-informational + :target: https://blog.jaraco.com/skeleton + +.. image:: https://tidelift.com/badges/package/pypi/jaraco.text + :target: https://tidelift.com/subscription/pkg/pypi-jaraco.text?utm_source=pypi-jaraco.text&utm_medium=readme + + +This package provides handy routines for dealing with text, such as +wrapping, substitution, trimming, stripping, prefix and suffix removal, +line continuation, indentation, comment processing, identifier processing, +values parsing, case insensitive comparison, and more. See the docs +(linked in the badge above) for the detailed documentation and examples. + +Layouts +======= + +One of the features of this package is the layouts module, which +provides a simple example of translating keystrokes from one keyboard +layout to another:: + + echo qwerty | python -m jaraco.text.to-dvorak + ',.pyf + echo "',.pyf" | python -m jaraco.text.to-qwerty + qwerty + +Newline Reporting +================= + +Need to know what newlines appear in a file? + +:: + + $ python -m jaraco.text.show-newlines README.rst + newline is '\n' + +For Enterprise +============== + +Available as part of the Tidelift Subscription. + +This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use. + +`Learn more `_. diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/RECORD new file mode 100644 index 000000000..cb901f61e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/RECORD @@ -0,0 +1,20 @@ +jaraco.text-3.12.1.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +jaraco.text-3.12.1.dist-info/LICENSE,sha256=htoPAa6uRjSKPD1GUZXcHOzN55956HdppkuNoEsqR0E,1023 +jaraco.text-3.12.1.dist-info/METADATA,sha256=AzWdm6ViMfDOPoQMfLWn2zgBQSGJScyqeN29TcuWXVI,3658 +jaraco.text-3.12.1.dist-info/RECORD,, +jaraco.text-3.12.1.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +jaraco.text-3.12.1.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92 +jaraco.text-3.12.1.dist-info/top_level.txt,sha256=0JnN3LfXH4LIRfXL-QFOGCJzQWZO3ELx4R1d_louoQM,7 +jaraco/text/Lorem ipsum.txt,sha256=N_7c_79zxOufBY9HZ3yzMgOkNv-TkOTTio4BydrSjgs,1335 +jaraco/text/__init__.py,sha256=Y2YUqXR_orUoDaY4SkPRe6ZZhb5HUHB_Ah9RCNsVyho,16250 +jaraco/text/__pycache__/__init__.cpython-312.pyc,, +jaraco/text/__pycache__/layouts.cpython-312.pyc,, +jaraco/text/__pycache__/show-newlines.cpython-312.pyc,, +jaraco/text/__pycache__/strip-prefix.cpython-312.pyc,, +jaraco/text/__pycache__/to-dvorak.cpython-312.pyc,, +jaraco/text/__pycache__/to-qwerty.cpython-312.pyc,, +jaraco/text/layouts.py,sha256=HTC8aSTLZ7uXipyOXapRMC158juecjK6RVwitfmZ9_w,643 +jaraco/text/show-newlines.py,sha256=WGQa65e8lyhb92LUOLqVn6KaCtoeVgVws6WtSRmLk6w,904 +jaraco/text/strip-prefix.py,sha256=NfVXV8JVNo6nqcuYASfMV7_y4Eo8zMQqlCOGvAnRIVw,412 +jaraco/text/to-dvorak.py,sha256=1SNcbSsvISpXXg-LnybIHHY-RUFOQr36zcHkY1pWFqw,119 +jaraco/text/to-qwerty.py,sha256=s4UMQUnPwFn_dB5uZC27BurHOQcYondBfzIpVL5pEzw,119 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/REQUESTED b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/REQUESTED new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/WHEEL new file mode 100644 index 000000000..bab98d675 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/WHEEL @@ -0,0 +1,5 @@ +Wheel-Version: 1.0 +Generator: bdist_wheel (0.43.0) +Root-Is-Purelib: true +Tag: py3-none-any + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/top_level.txt b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/top_level.txt new file mode 100644 index 000000000..f6205a5f1 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco.text-3.12.1.dist-info/top_level.txt @@ -0,0 +1 @@ +jaraco diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/__pycache__/context.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/__pycache__/context.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d18cd6930dadb74bf5fe0598066bf39997b3b965 GIT binary patch literal 14373 zcmcIrd2Afld7oov58gK=>flfpcP(mZ9lm5qHZ94r9E)}>Ifm&t>*3CjTxz+ynVA(2 zt!i3jYcg>nDTyN{brUvl8>w;-yFpO{35qBNf&v8!(sUqttP~F7KkENzQHEXBX!`r! z9D9&boNI`E^X9$peeaw1zWWXTqq4G$!}W`wCdm>=D`B*W+V%sYhaWe~+Kt13dwD5B3DvJ=7Co_p+XHcCYBEz+FsM z4psG3@thVMT(RQN zwbh}GR%2h`e0CkJ_b+d~vZdmQl`Nrwaf%K5psU)?L&Lg9b>FGf&ZW^5jk3P1oJFRMV?eKvIV~?kM(`Kic1v?~^ zWM|Z?B@?}!nNf2fo!S}QzN6DfnA*0C5SK{f; zcsgZjBW5%+YDsLd^lDJlgr7kS|KHpvSv7`H?gzp)P0B%vkOAgyc3m8bNSVAi^wgLQ5#f6oc3^s3*b`ws4um=gyZ^Zjlu z$D6cw?0Ple!ovpf^p}6m@s9kicA*Db+*G7q~vTSTIPvl zVknb_5NGuyBp|A5U&?BR>Gh(yR8!bWGX~K=p{WJ>0+T~dOQ9Wg(;ksK<@R*eZ1+%` zy?}Kn4r3mW$S}kp+G9mV7`Wg3{v8616#bd$3} z8dj#=g^8LYW_tu{pr|nt>adoIr`1HNe{Xx%?AvyC!OJ>|40eX}9bt}YBMHMa@`!EX zyT<}iyiBxz%;Ls;QL}$+Ow@C?L5T&(_N03UE#D9{6dHVl#`2>X_9{}PhrmdB0}3nH zs~B2J8PcqPu4R%+T(hL1-r_P$X&+c+zLhIB?t=_I<)k*Hc_&dY)|tVYAs6PZ|F zLO0AWR>Nb)uC768%88=e@dKFDUR+N}d zheyY?<7fOE3a0lKWiD7Z8(4j{vHARy=bpUMxOuK|^Gtlc@wO|CJLVd9ymrqUz4MJ- zR~iq`H6H%=Ewhgwn{Rw#vg~>pCk2>}?0MU_YEke@8?IJ0oJmcku2gNBtJ*YkbiOJw zDPFB?IP-<6FU)MbaPaNQ9g7?vI?TV;y8umlWa`ND*xNe}O&)o>;-Qa4>Ughe)my<; z?+2^SR8Cc%9sFgm?c)%&+r$3%dXNiMdtILzcj6UJcQx<7oxj|2=l&+{=QXSLmx(_Q zS5SRd6WZS_llIpK-mDIw<;|w%{oBMhw~1&kQpvPZ@HqITZdA_0=nvvvdJO`i^n$Vx zTxIhGDEU)Dj*EFfIqoPI5xZ~joga`(L9D}=LozbSgbAbRAJT?;HQi<&K4#Di?uO~) z@3P_$DhBP^IJX$&n%16w`rOl38n?_fZkaJIbj>$LpYI;;8b2{{a-qC-{Kygjxi}T> zMFt04#xFgH3S4%6f-6$^g~rJl1NG_|oV@aO-xO~pD1VJ%OuqLMa~hhgq(Z1v0o|#OqSl`s!bC=g+?%yEqNc}t0+SYGv5l+IS_fvV4HyAfpA2zwm?*D3-aD4Q`iO;oOE!wz=7?c zQ8w}-NfyDt^~CFYPQ9tCl2q9JHo(jq^9p9 z#9v0`CBgRF1a8Wg;}Tqse}(@V4{t?4iW$Ci(JHS`5*;wz>g2JyJRS^`D6(UOJXcxNsLtt(gn~k^7y!I6@m_ns$-q* z7Do3Z({Uwf>~q;SW)7#9HL5Bw8IPd&gxQdHYMZ8gv$gFr{<+$AXzR+B3wOM}`3>pE z9qi#}8yA{Ze?0^xU)l08^|Inas@-5!2KA{C2ExAzb&33op}WMFq^;6-f_I7Er-nhOhC^VK_MgFEzX0D?vjdBP79t*Kdf070k` zs69;uy;6LrUpI7OPA4LAw!tMp??Tt3)GebJ=dOh%Y3KDSuA=cu`I@=%HPfGab=7N| zFSX8>-!tpGht0Z-O*@HAuVMIS35!+UB*nvmXw8jasnzwgED7&Gb%p;TjhYrP{Vb`k*mR$h5Ck%0zS#VSjN>hpD#OCHhtGC2j^>U8$WzCRC9LIY^ZH|%Uq}pGA7l{ zJaO^xYubFr9`^Jzk;S!;OQ{ZW=oFAksgC4Qs$)=}8h2pc)BC#a;xBWduC3zbkkr*G zU9JjJy(vWPtx{Jwba_*NTDD4Ey8@SQ51@Tn(gys+FHHd5?@HL*f-^bQr%Em4#gJNN zm+DsoYVg&N%fIl%ghBGmORgNRdf_Fse3{Y!mCp>_A$STYS&^T3{1M^{vN+_ekvGx@ zpN6~y(izaH2KE|tRg?Q{1}Y5G2$)H;0~l@}FwM;F&d$Dcy0aG%2KE+Fh7+T-kL3d` zHqWhxe%5hBe6-h_Wbl@gFyIjn_+cA(Z09n1iX};A7Cn`Q@5DkK^1<}|SZ@6QiVyzp zx4->ux5bZH{Gi1@Oc^4CRzfd+BV!N=@Z1smwSU$KlrX?aUh2CzXmd1j`jyY~m zTDJm2N+v_{M|#Q=nA&Bu>QA9Rho3={Ah*-PNtL$5>@Ad-3T~Y|Bg}}?56${kU#+S; z8=sEP#NV#EZT!%C<#lK7ow|3nx#L27zI?~5&(`wGIC>*-^Z;i0Ec!N|hD37FNlrjZ zqV8%*o}&~*XzgbU;Mz;Vr$ogaL@K18IA5ZoV>Bngnp6 zqJ!x~islcu8%QG(<020*tRn|#Cjz__K|69Qe?U^eoro<>Hw<==mX+oK;~iJ&0gVXa z*#g?V^rnTzT>m0iffX+i``wPh&MvOvYF1sTZk?-cov&^ie~7Y*EelmmU#|Lfu=;H9 zm%-JaOa<8eQ-iVzryF_>*XXnj|Vl6KNllJ#b4?*kNOKT z>cO!Yww3z_wD@ruF0jMnnRG!U)jLXAHHXm;Q|L-57juNvosrETR;TP!!Yl~Gmc>x6 zEU_dWn*?f}(rkHQWVV8gh)YY94T923n3gcm59ct6V0bLJZCkIdq~Ze>KTO9We#2Bj zc_d)@ksm@(t*^!E7G#|Qs&*okMb4HX*SOl_VyHopIzQ0-S*7P)}be0F4^y6)_u>7z5@*{ZFR;ydNF3l-I89-ex5x@_jb z+2*ZpS9DyhYx<^se)!z*`RC3(cR`%5>zE9@v$pMA^Ncy^zZ$H&5?nVITsIxRu;rJ* z?M!|?t_JFl3IB&wd}^!%A*X8|2=ZU=YU|n~Ufvl({qi2^0V(ivK7e{00NzE;7Z{vh z>P6)b_e%1<$Vy`13L$(BpK`#}-d)I;B$KY52Dc?lr58yNXl1ybDe_2}kDFZ6d-TT%J49^&h6aGD*@9~;19fve2YE?GmPnT9DBt!hdVGu!4K z(GodFLusA7A=OTl*nFiKlz%}!Cpn5d#*ikbG^8m!Nr}o&>Pm)*MjC3C<$=&k@6Y7G zB>}Gv9zH?#$QT_$s)bTKaXn223`>>Hu=7G&cE+M?`Brf79c+{;ClKc`@1894K=j?% ze5|mkNR{SjX%N9xD5r|iYCvkxVyluKx(w2=}LLqTzT7k`Nmn_#^sTk zlYiisOdvYXXEH!Q;T(hlAUI7F4Bz!{ZR1{RPiucn%ai zm*aSv!y!5yPgiPHYT3&?j+=#^Y8)VQJvF11kt(b5;0R^F;LaYy-Y6GA6Wfa}k0G33 z8r!Cr-~i%P#YA!~jsryn%&EBuusdK^cjuH8!{fMZ&P7))VhLzxa5DAf6 zBmF!H-9cT)@iis2h@6$^&x3_GY?rsn+esSfcw*;4jMf5t?Zx;C zPC4^>qT5E<4^;RqKut|=d~}N-dkbG^3&Y%?Ywn%b_dJt%oS#O1&%38 z36msKsyBa7&0fYEo~LESeW0~KV!gY&DECJa#q@X`lc*eAp?ofWl+(AP8TJ&XEDqBf z@a24lmh96{psUb_vw|_i90@ZP8*B22!pmf$Zad{ym}wm67Fsq<`o3Cii+G_oMRi6H zxk_}baMUJ3C(Uw^*M|uQ0XboRC>F!&AbgCCHJ8rnbbJKpB?@{mZFT)*`SMA6e`-tBC#^^YVA$yYrLy!vxgl+q(H?jNf!CWtkDO7N$tpnP0Wr1pEQ3lXrN(5y&+ zVD^sH6whw>0oGc~r0^IH9KHrxe8quQwHbU4nGkim7SWe5q$NRs3OQNOBiqhgli_~`taJ#g5{>lW5-nmq90k%j7} z$*Ses0lBbcqXU&fr|Tx~Phx`0ksuOW(hTfvmN5u~mpWGxUc0@VUZV!+#<{E2^=A*9 zKYZ@+SDu>6K(8>4bs>N~sgEJo*3g?f^85~lCLi7c~W9;J_d1v%) zZ}Ov~DN`9Kz(|IQ*=st_FOrmSfhCFBAhxn6Lb}t#?&Ne%#d7Jk^8g#AB!`tz9GxkN zq){@}{SG3+K^G+wRIQJ}h8-K@w$t5qCGwPn+X<`pl>~v%8&IQT$f$|=6;z=s4leL6 z((kP#;3KHKBo^|;l(Z6OTyogiIWj6ZL|T3@gd-*KIWHJLy8M`^)(&`W`zGk*Pcqq$ z_zM!xKJo$dGw8E?w63=CA;R%8HytO&{A_v}w*pDwYOZgfi4m`V6E&u_p7oA${PymTHLOH4z8&R^b_}`! zXMGD-R)3~-s&%?yKD7QLK@7DniCkGLGBKf6+mx1arQI4KuB49! z@kz%PuBPG4$*GgmyIvXj!KuGLHF`PfC>GT9*F*O~J#h8t^LY^e(q>=QKD6AlYGmvhM+D3DNI{tj@O2vy*&|B)? zp@Q60Mg{W@Y{f#_Y}rOJvoHqiK9{ zELuUbUUVWe_C2=mT{4}?l5K&>EJzl(V0PG;H-wJyD+pZgcR|CS(?;#Mk70H>^0+n{ zLtZ_ty9S6l=sJ1o>Gt+#7%XvK0UT@VhR*w2yoCNT6@N#?cd01ZjPFw$755P}5MTieuEFgYYE7+avi zr|c`s8`Ud^HY$G{v98XKB0;c{uc!*Fzp3zxyp;}LE;;L*6HebGh*U+wL>cIA%Wvym<1BfwwvzT&Sp9sH{En^wiVShu*5(c(rcr^s()J0oIa{#{Nf2f`2k|Y=Y%t8W1m|`-1z9YG5DBcPO+B+{TfY+J`U;Jv;$fn$2^F$* zHBxYClOV0W7KCwIf`N+Ix|RU3AoL-}SS>!=m2>p1@nblqq>lsXJ0Se;M(V~I_upHd zUIz1w?YsN*4TNLWvVLHsguVVcy7hmyr`w9#4f;@o9p4{Q^uv_9VGutihz;Z|^kwPa zM&K3@XR;JG^RD%2dSu@%BW&UHeiW8yj2imWRI9Q-R(3x!*C|=S4(u&IHXCOFx{tsr z923g2MplSYiWDFk?2~5wUK&(Q#bzqjQ_+RODhJK<~#Np)t2${f(btqf_$BW1GQ^SP5jQq9p0=9jcd+7bMBdITs7a~K%us{ zDG#u&?LxyFK>~2;M(x_B8h+EqTT(oK=Z74X*L%evADkS!QoUiWdc(}aS2o=@x9Ps? Z92&1Twepd(yRXzo=jx*$ad=={|Nm_esYw6; literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/__init__.py new file mode 100644 index 000000000..0d501cf9e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/__init__.py @@ -0,0 +1,1091 @@ +from __future__ import annotations + +import collections.abc +import copy +import functools +import itertools +import operator +import random +import re +from collections.abc import Container, Iterable, Mapping +from typing import TYPE_CHECKING, Any, Callable, Dict, TypeVar, Union, overload + +import jaraco.text + +if TYPE_CHECKING: + from _operator import _SupportsComparison + + from _typeshed import SupportsKeysAndGetItem + from typing_extensions import Self + + _RangeMapKT = TypeVar('_RangeMapKT', bound=_SupportsComparison) +else: + # _SupportsComparison doesn't exist at runtime, + # but _RangeMapKT is used in RangeMap's superclass' type parameters + _RangeMapKT = TypeVar('_RangeMapKT') + +_T = TypeVar('_T') +_VT = TypeVar('_VT') + +_Matchable = Union[Callable, Container, Iterable, re.Pattern] + + +def _dispatch(obj: _Matchable) -> Callable: + # can't rely on singledispatch for Union[Container, Iterable] + # due to ambiguity + # (https://peps.python.org/pep-0443/#abstract-base-classes). + if isinstance(obj, re.Pattern): + return obj.fullmatch + # mypy issue: https://github.com/python/mypy/issues/11071 + if not isinstance(obj, Callable): # type: ignore[arg-type] + if not isinstance(obj, Container): + obj = set(obj) # type: ignore[arg-type] + obj = obj.__contains__ + return obj # type: ignore[return-value] + + +class Projection(collections.abc.Mapping): + """ + Project a set of keys over a mapping + + >>> sample = {'a': 1, 'b': 2, 'c': 3} + >>> prj = Projection(['a', 'c', 'd'], sample) + >>> dict(prj) + {'a': 1, 'c': 3} + + Projection also accepts an iterable or callable or pattern. + + >>> iter_prj = Projection(iter('acd'), sample) + >>> call_prj = Projection(lambda k: ord(k) in (97, 99, 100), sample) + >>> pat_prj = Projection(re.compile(r'[acd]'), sample) + >>> prj == iter_prj == call_prj == pat_prj + True + + Keys should only appear if they were specified and exist in the space. + Order is retained. + + >>> list(prj) + ['a', 'c'] + + Attempting to access a key not in the projection + results in a KeyError. + + >>> prj['b'] + Traceback (most recent call last): + ... + KeyError: 'b' + + Use the projection to update another dict. + + >>> target = {'a': 2, 'b': 2} + >>> target.update(prj) + >>> target + {'a': 1, 'b': 2, 'c': 3} + + Projection keeps a reference to the original dict, so + modifying the original dict may modify the Projection. + + >>> del sample['a'] + >>> dict(prj) + {'c': 3} + """ + + def __init__(self, keys: _Matchable, space: Mapping): + self._match = _dispatch(keys) + self._space = space + + def __getitem__(self, key): + if not self._match(key): + raise KeyError(key) + return self._space[key] + + def _keys_resolved(self): + return filter(self._match, self._space) + + def __iter__(self): + return self._keys_resolved() + + def __len__(self): + return len(tuple(self._keys_resolved())) + + +class Mask(Projection): + """ + The inverse of a :class:`Projection`, masking out keys. + + >>> sample = {'a': 1, 'b': 2, 'c': 3} + >>> msk = Mask(['a', 'c', 'd'], sample) + >>> dict(msk) + {'b': 2} + """ + + def __init__(self, *args, **kwargs): + super().__init__(*args, **kwargs) + # self._match = compose(operator.not_, self._match) + self._match = lambda key, orig=self._match: not orig(key) + + +def dict_map(function, dictionary): + """ + Return a new dict with function applied to values of dictionary. + + >>> dict_map(lambda x: x+1, dict(a=1, b=2)) + {'a': 2, 'b': 3} + """ + return dict((key, function(value)) for key, value in dictionary.items()) + + +class RangeMap(Dict[_RangeMapKT, _VT]): + """ + A dictionary-like object that uses the keys as bounds for a range. + Inclusion of the value for that range is determined by the + key_match_comparator, which defaults to less-than-or-equal. + A value is returned for a key if it is the first key that matches in + the sorted list of keys. + + One may supply keyword parameters to be passed to the sort function used + to sort keys (i.e. key, reverse) as sort_params. + + Create a map that maps 1-3 -> 'a', 4-6 -> 'b' + + >>> r = RangeMap({3: 'a', 6: 'b'}) # boy, that was easy + >>> r[1], r[2], r[3], r[4], r[5], r[6] + ('a', 'a', 'a', 'b', 'b', 'b') + + Even float values should work so long as the comparison operator + supports it. + + >>> r[4.5] + 'b' + + Notice that the way rangemap is defined, it must be open-ended + on one side. + + >>> r[0] + 'a' + >>> r[-1] + 'a' + + One can close the open-end of the RangeMap by using undefined_value + + >>> r = RangeMap({0: RangeMap.undefined_value, 3: 'a', 6: 'b'}) + >>> r[0] + Traceback (most recent call last): + ... + KeyError: 0 + + One can get the first or last elements in the range by using RangeMap.Item + + >>> last_item = RangeMap.Item(-1) + >>> r[last_item] + 'b' + + .last_item is a shortcut for Item(-1) + + >>> r[RangeMap.last_item] + 'b' + + Sometimes it's useful to find the bounds for a RangeMap + + >>> r.bounds() + (0, 6) + + RangeMap supports .get(key, default) + + >>> r.get(0, 'not found') + 'not found' + + >>> r.get(7, 'not found') + 'not found' + + One often wishes to define the ranges by their left-most values, + which requires use of sort params and a key_match_comparator. + + >>> r = RangeMap({1: 'a', 4: 'b'}, + ... sort_params=dict(reverse=True), + ... key_match_comparator=operator.ge) + >>> r[1], r[2], r[3], r[4], r[5], r[6] + ('a', 'a', 'a', 'b', 'b', 'b') + + That wasn't nearly as easy as before, so an alternate constructor + is provided: + + >>> r = RangeMap.left({1: 'a', 4: 'b', 7: RangeMap.undefined_value}) + >>> r[1], r[2], r[3], r[4], r[5], r[6] + ('a', 'a', 'a', 'b', 'b', 'b') + + """ + + def __init__( + self, + source: ( + SupportsKeysAndGetItem[_RangeMapKT, _VT] | Iterable[tuple[_RangeMapKT, _VT]] + ), + sort_params: Mapping[str, Any] = {}, + key_match_comparator: Callable[[_RangeMapKT, _RangeMapKT], bool] = operator.le, + ): + dict.__init__(self, source) + self.sort_params = sort_params + self.match = key_match_comparator + + @classmethod + def left( + cls, + source: ( + SupportsKeysAndGetItem[_RangeMapKT, _VT] | Iterable[tuple[_RangeMapKT, _VT]] + ), + ) -> Self: + return cls( + source, sort_params=dict(reverse=True), key_match_comparator=operator.ge + ) + + def __getitem__(self, item: _RangeMapKT) -> _VT: + sorted_keys = sorted(self.keys(), **self.sort_params) + if isinstance(item, RangeMap.Item): + result = self.__getitem__(sorted_keys[item]) + else: + key = self._find_first_match_(sorted_keys, item) + result = dict.__getitem__(self, key) + if result is RangeMap.undefined_value: + raise KeyError(key) + return result + + @overload # type: ignore[override] # Signature simplified over dict and Mapping + def get(self, key: _RangeMapKT, default: _T) -> _VT | _T: ... + @overload + def get(self, key: _RangeMapKT, default: None = None) -> _VT | None: ... + def get(self, key: _RangeMapKT, default: _T | None = None) -> _VT | _T | None: + """ + Return the value for key if key is in the dictionary, else default. + If default is not given, it defaults to None, so that this method + never raises a KeyError. + """ + try: + return self[key] + except KeyError: + return default + + def _find_first_match_( + self, keys: Iterable[_RangeMapKT], item: _RangeMapKT + ) -> _RangeMapKT: + is_match = functools.partial(self.match, item) + matches = filter(is_match, keys) + try: + return next(matches) + except StopIteration: + raise KeyError(item) from None + + def bounds(self) -> tuple[_RangeMapKT, _RangeMapKT]: + sorted_keys = sorted(self.keys(), **self.sort_params) + return (sorted_keys[RangeMap.first_item], sorted_keys[RangeMap.last_item]) + + # some special values for the RangeMap + undefined_value = type('RangeValueUndefined', (), {})() + + class Item(int): + """RangeMap Item""" + + first_item = Item(0) + last_item = Item(-1) + + +def __identity(x): + return x + + +def sorted_items(d, key=__identity, reverse=False): + """ + Return the items of the dictionary sorted by the keys. + + >>> sample = dict(foo=20, bar=42, baz=10) + >>> tuple(sorted_items(sample)) + (('bar', 42), ('baz', 10), ('foo', 20)) + + >>> reverse_string = lambda s: ''.join(reversed(s)) + >>> tuple(sorted_items(sample, key=reverse_string)) + (('foo', 20), ('bar', 42), ('baz', 10)) + + >>> tuple(sorted_items(sample, reverse=True)) + (('foo', 20), ('baz', 10), ('bar', 42)) + """ + + # wrap the key func so it operates on the first element of each item + def pairkey_key(item): + return key(item[0]) + + return sorted(d.items(), key=pairkey_key, reverse=reverse) + + +class KeyTransformingDict(dict): + """ + A dict subclass that transforms the keys before they're used. + Subclasses may override the default transform_key to customize behavior. + """ + + @staticmethod + def transform_key(key): # pragma: nocover + return key + + def __init__(self, *args, **kargs): + super().__init__() + # build a dictionary using the default constructs + d = dict(*args, **kargs) + # build this dictionary using transformed keys. + for item in d.items(): + self.__setitem__(*item) + + def __setitem__(self, key, val): + key = self.transform_key(key) + super().__setitem__(key, val) + + def __getitem__(self, key): + key = self.transform_key(key) + return super().__getitem__(key) + + def __contains__(self, key): + key = self.transform_key(key) + return super().__contains__(key) + + def __delitem__(self, key): + key = self.transform_key(key) + return super().__delitem__(key) + + def get(self, key, *args, **kwargs): + key = self.transform_key(key) + return super().get(key, *args, **kwargs) + + def setdefault(self, key, *args, **kwargs): + key = self.transform_key(key) + return super().setdefault(key, *args, **kwargs) + + def pop(self, key, *args, **kwargs): + key = self.transform_key(key) + return super().pop(key, *args, **kwargs) + + def matching_key_for(self, key): + """ + Given a key, return the actual key stored in self that matches. + Raise KeyError if the key isn't found. + """ + try: + return next(e_key for e_key in self.keys() if e_key == key) + except StopIteration as err: + raise KeyError(key) from err + + +class FoldedCaseKeyedDict(KeyTransformingDict): + """ + A case-insensitive dictionary (keys are compared as insensitive + if they are strings). + + >>> d = FoldedCaseKeyedDict() + >>> d['heLlo'] = 'world' + >>> list(d.keys()) == ['heLlo'] + True + >>> list(d.values()) == ['world'] + True + >>> d['hello'] == 'world' + True + >>> 'hello' in d + True + >>> 'HELLO' in d + True + >>> print(repr(FoldedCaseKeyedDict({'heLlo': 'world'}))) + {'heLlo': 'world'} + >>> d = FoldedCaseKeyedDict({'heLlo': 'world'}) + >>> print(d['hello']) + world + >>> print(d['Hello']) + world + >>> list(d.keys()) + ['heLlo'] + >>> d = FoldedCaseKeyedDict({'heLlo': 'world', 'Hello': 'world'}) + >>> list(d.values()) + ['world'] + >>> key, = d.keys() + >>> key in ['heLlo', 'Hello'] + True + >>> del d['HELLO'] + >>> d + {} + + get should work + + >>> d['Sumthin'] = 'else' + >>> d.get('SUMTHIN') + 'else' + >>> d.get('OTHER', 'thing') + 'thing' + >>> del d['sumthin'] + + setdefault should also work + + >>> d['This'] = 'that' + >>> print(d.setdefault('this', 'other')) + that + >>> len(d) + 1 + >>> print(d['this']) + that + >>> print(d.setdefault('That', 'other')) + other + >>> print(d['THAT']) + other + + Make it pop! + + >>> print(d.pop('THAT')) + other + + To retrieve the key in its originally-supplied form, use matching_key_for + + >>> print(d.matching_key_for('this')) + This + + >>> d.matching_key_for('missing') + Traceback (most recent call last): + ... + KeyError: 'missing' + """ + + @staticmethod + def transform_key(key): + return jaraco.text.FoldedCase(key) + + +class DictAdapter: + """ + Provide a getitem interface for attributes of an object. + + Let's say you want to get at the string.lowercase property in a formatted + string. It's easy with DictAdapter. + + >>> import string + >>> print("lowercase is %(ascii_lowercase)s" % DictAdapter(string)) + lowercase is abcdefghijklmnopqrstuvwxyz + """ + + def __init__(self, wrapped_ob): + self.object = wrapped_ob + + def __getitem__(self, name): + return getattr(self.object, name) + + +class ItemsAsAttributes: + """ + Mix-in class to enable a mapping object to provide items as + attributes. + + >>> C = type('C', (dict, ItemsAsAttributes), dict()) + >>> i = C() + >>> i['foo'] = 'bar' + >>> i.foo + 'bar' + + Natural attribute access takes precedence + + >>> i.foo = 'henry' + >>> i.foo + 'henry' + + But as you might expect, the mapping functionality is preserved. + + >>> i['foo'] + 'bar' + + A normal attribute error should be raised if an attribute is + requested that doesn't exist. + + >>> i.missing + Traceback (most recent call last): + ... + AttributeError: 'C' object has no attribute 'missing' + + It also works on dicts that customize __getitem__ + + >>> missing_func = lambda self, key: 'missing item' + >>> C = type( + ... 'C', + ... (dict, ItemsAsAttributes), + ... dict(__missing__ = missing_func), + ... ) + >>> i = C() + >>> i.missing + 'missing item' + >>> i.foo + 'missing item' + """ + + def __getattr__(self, key): + try: + return getattr(super(), key) + except AttributeError as e: + # attempt to get the value from the mapping (return self[key]) + # but be careful not to lose the original exception context. + noval = object() + + def _safe_getitem(cont, key, missing_result): + try: + return cont[key] + except KeyError: + return missing_result + + result = _safe_getitem(self, key, noval) + if result is not noval: + return result + # raise the original exception, but use the original class + # name, not 'super'. + (message,) = e.args + message = message.replace('super', self.__class__.__name__, 1) + e.args = (message,) + raise + + +def invert_map(map): + """ + Given a dictionary, return another dictionary with keys and values + switched. If any of the values resolve to the same key, raises + a ValueError. + + >>> numbers = dict(a=1, b=2, c=3) + >>> letters = invert_map(numbers) + >>> letters[1] + 'a' + >>> numbers['d'] = 3 + >>> invert_map(numbers) + Traceback (most recent call last): + ... + ValueError: Key conflict in inverted mapping + """ + res = dict((v, k) for k, v in map.items()) + if not len(res) == len(map): + raise ValueError('Key conflict in inverted mapping') + return res + + +class IdentityOverrideMap(dict): + """ + A dictionary that by default maps each key to itself, but otherwise + acts like a normal dictionary. + + >>> d = IdentityOverrideMap() + >>> d[42] + 42 + >>> d['speed'] = 'speedo' + >>> print(d['speed']) + speedo + """ + + def __missing__(self, key): + return key + + +class DictStack(list, collections.abc.MutableMapping): + """ + A stack of dictionaries that behaves as a view on those dictionaries, + giving preference to the last. + + >>> stack = DictStack([dict(a=1, c=2), dict(b=2, a=2)]) + >>> stack['a'] + 2 + >>> stack['b'] + 2 + >>> stack['c'] + 2 + >>> len(stack) + 3 + >>> stack.push(dict(a=3)) + >>> stack['a'] + 3 + >>> stack['a'] = 4 + >>> set(stack.keys()) == set(['a', 'b', 'c']) + True + >>> set(stack.items()) == set([('a', 4), ('b', 2), ('c', 2)]) + True + >>> dict(**stack) == dict(stack) == dict(a=4, c=2, b=2) + True + >>> d = stack.pop() + >>> stack['a'] + 2 + >>> d = stack.pop() + >>> stack['a'] + 1 + >>> stack.get('b', None) + >>> 'c' in stack + True + >>> del stack['c'] + >>> dict(stack) + {'a': 1} + """ + + def __iter__(self): + dicts = list.__iter__(self) + return iter(set(itertools.chain.from_iterable(c.keys() for c in dicts))) + + def __getitem__(self, key): + for scope in reversed(tuple(list.__iter__(self))): + if key in scope: + return scope[key] + raise KeyError(key) + + push = list.append + + def __contains__(self, other): + return collections.abc.Mapping.__contains__(self, other) + + def __len__(self): + return len(list(iter(self))) + + def __setitem__(self, key, item): + last = list.__getitem__(self, -1) + return last.__setitem__(key, item) + + def __delitem__(self, key): + last = list.__getitem__(self, -1) + return last.__delitem__(key) + + # workaround for mypy confusion + def pop(self, *args, **kwargs): + return list.pop(self, *args, **kwargs) + + +class BijectiveMap(dict): + """ + A Bijective Map (two-way mapping). + + Implemented as a simple dictionary of 2x the size, mapping values back + to keys. + + Note, this implementation may be incomplete. If there's not a test for + your use case below, it's likely to fail, so please test and send pull + requests or patches for additional functionality needed. + + + >>> m = BijectiveMap() + >>> m['a'] = 'b' + >>> m == {'a': 'b', 'b': 'a'} + True + >>> print(m['b']) + a + + >>> m['c'] = 'd' + >>> len(m) + 2 + + Some weird things happen if you map an item to itself or overwrite a + single key of a pair, so it's disallowed. + + >>> m['e'] = 'e' + Traceback (most recent call last): + ValueError: Key cannot map to itself + + >>> m['d'] = 'e' + Traceback (most recent call last): + ValueError: Key/Value pairs may not overlap + + >>> m['e'] = 'd' + Traceback (most recent call last): + ValueError: Key/Value pairs may not overlap + + >>> print(m.pop('d')) + c + + >>> 'c' in m + False + + >>> m = BijectiveMap(dict(a='b')) + >>> len(m) + 1 + >>> print(m['b']) + a + + >>> m = BijectiveMap() + >>> m.update(a='b') + >>> m['b'] + 'a' + + >>> del m['b'] + >>> len(m) + 0 + >>> 'a' in m + False + """ + + def __init__(self, *args, **kwargs): + super().__init__() + self.update(*args, **kwargs) + + def __setitem__(self, item, value): + if item == value: + raise ValueError("Key cannot map to itself") + overlap = ( + item in self + and self[item] != value + or value in self + and self[value] != item + ) + if overlap: + raise ValueError("Key/Value pairs may not overlap") + super().__setitem__(item, value) + super().__setitem__(value, item) + + def __delitem__(self, item): + self.pop(item) + + def __len__(self): + return super().__len__() // 2 + + def pop(self, key, *args, **kwargs): + mirror = self[key] + super().__delitem__(mirror) + return super().pop(key, *args, **kwargs) + + def update(self, *args, **kwargs): + # build a dictionary using the default constructs + d = dict(*args, **kwargs) + # build this dictionary using transformed keys. + for item in d.items(): + self.__setitem__(*item) + + +class FrozenDict(collections.abc.Mapping, collections.abc.Hashable): + """ + An immutable mapping. + + >>> a = FrozenDict(a=1, b=2) + >>> b = FrozenDict(a=1, b=2) + >>> a == b + True + + >>> a == dict(a=1, b=2) + True + >>> dict(a=1, b=2) == a + True + >>> 'a' in a + True + >>> type(hash(a)) is type(0) + True + >>> set(iter(a)) == {'a', 'b'} + True + >>> len(a) + 2 + >>> a['a'] == a.get('a') == 1 + True + + >>> a['c'] = 3 + Traceback (most recent call last): + ... + TypeError: 'FrozenDict' object does not support item assignment + + >>> a.update(y=3) + Traceback (most recent call last): + ... + AttributeError: 'FrozenDict' object has no attribute 'update' + + Copies should compare equal + + >>> copy.copy(a) == a + True + + Copies should be the same type + + >>> isinstance(copy.copy(a), FrozenDict) + True + + FrozenDict supplies .copy(), even though + collections.abc.Mapping doesn't demand it. + + >>> a.copy() == a + True + >>> a.copy() is not a + True + """ + + __slots__ = ['__data'] + + def __new__(cls, *args, **kwargs): + self = super().__new__(cls) + self.__data = dict(*args, **kwargs) + return self + + # Container + def __contains__(self, key): + return key in self.__data + + # Hashable + def __hash__(self): + return hash(tuple(sorted(self.__data.items()))) + + # Mapping + def __iter__(self): + return iter(self.__data) + + def __len__(self): + return len(self.__data) + + def __getitem__(self, key): + return self.__data[key] + + # override get for efficiency provided by dict + def get(self, *args, **kwargs): + return self.__data.get(*args, **kwargs) + + # override eq to recognize underlying implementation + def __eq__(self, other): + if isinstance(other, FrozenDict): + other = other.__data + return self.__data.__eq__(other) + + def copy(self): + "Return a shallow copy of self" + return copy.copy(self) + + +class Enumeration(ItemsAsAttributes, BijectiveMap): + """ + A convenient way to provide enumerated values + + >>> e = Enumeration('a b c') + >>> e['a'] + 0 + + >>> e.a + 0 + + >>> e[1] + 'b' + + >>> set(e.names) == set('abc') + True + + >>> set(e.codes) == set(range(3)) + True + + >>> e.get('d') is None + True + + Codes need not start with 0 + + >>> e = Enumeration('a b c', range(1, 4)) + >>> e['a'] + 1 + + >>> e[3] + 'c' + """ + + def __init__(self, names, codes=None): + if isinstance(names, str): + names = names.split() + if codes is None: + codes = itertools.count() + super().__init__(zip(names, codes)) + + @property + def names(self): + return (key for key in self if isinstance(key, str)) + + @property + def codes(self): + return (self[name] for name in self.names) + + +class Everything: + """ + A collection "containing" every possible thing. + + >>> 'foo' in Everything() + True + + >>> import random + >>> random.randint(1, 999) in Everything() + True + + >>> random.choice([None, 'foo', 42, ('a', 'b', 'c')]) in Everything() + True + """ + + def __contains__(self, other): + return True + + +class InstrumentedDict(collections.UserDict): + """ + Instrument an existing dictionary with additional + functionality, but always reference and mutate + the original dictionary. + + >>> orig = {'a': 1, 'b': 2} + >>> inst = InstrumentedDict(orig) + >>> inst['a'] + 1 + >>> inst['c'] = 3 + >>> orig['c'] + 3 + >>> inst.keys() == orig.keys() + True + """ + + def __init__(self, data): + super().__init__() + self.data = data + + +class Least: + """ + A value that is always lesser than any other + + >>> least = Least() + >>> 3 < least + False + >>> 3 > least + True + >>> least < 3 + True + >>> least <= 3 + True + >>> least > 3 + False + >>> 'x' > least + True + >>> None > least + True + """ + + def __le__(self, other): + return True + + __lt__ = __le__ + + def __ge__(self, other): + return False + + __gt__ = __ge__ + + +class Greatest: + """ + A value that is always greater than any other + + >>> greatest = Greatest() + >>> 3 < greatest + True + >>> 3 > greatest + False + >>> greatest < 3 + False + >>> greatest > 3 + True + >>> greatest >= 3 + True + >>> 'x' > greatest + False + >>> None > greatest + False + """ + + def __ge__(self, other): + return True + + __gt__ = __ge__ + + def __le__(self, other): + return False + + __lt__ = __le__ + + +def pop_all(items): + """ + Clear items in place and return a copy of items. + + >>> items = [1, 2, 3] + >>> popped = pop_all(items) + >>> popped is items + False + >>> popped + [1, 2, 3] + >>> items + [] + """ + result, items[:] = items[:], [] + return result + + +class FreezableDefaultDict(collections.defaultdict): + """ + Often it is desirable to prevent the mutation of + a default dict after its initial construction, such + as to prevent mutation during iteration. + + >>> dd = FreezableDefaultDict(list) + >>> dd[0].append('1') + >>> dd.freeze() + >>> dd[1] + [] + >>> len(dd) + 1 + """ + + def __missing__(self, key): + return getattr(self, '_frozen', super().__missing__)(key) + + def freeze(self): + self._frozen = lambda key: self.default_factory() + + +class Accumulator: + def __init__(self, initial=0): + self.val = initial + + def __call__(self, val): + self.val += val + return self.val + + +class WeightedLookup(RangeMap): + """ + Given parameters suitable for a dict representing keys + and a weighted proportion, return a RangeMap representing + spans of values proportial to the weights: + + >>> even = WeightedLookup(a=1, b=1) + + [0, 1) -> a + [1, 2) -> b + + >>> lk = WeightedLookup(a=1, b=2) + + [0, 1) -> a + [1, 3) -> b + + >>> lk[.5] + 'a' + >>> lk[1.5] + 'b' + + Adds ``.random()`` to select a random weighted value: + + >>> lk.random() in ['a', 'b'] + True + + >>> choices = [lk.random() for x in range(1000)] + + Statistically speaking, choices should be .5 a:b + >>> ratio = choices.count('a') / choices.count('b') + >>> .4 < ratio < .6 + True + """ + + def __init__(self, *args, **kwargs): + raw = dict(*args, **kwargs) + + # allocate keys by weight + indexes = map(Accumulator(), raw.values()) + super().__init__(zip(indexes, raw.keys()), key_match_comparator=operator.lt) + + def random(self): + lower, upper = self.bounds() + selector = random.random() * upper + return self[selector] diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e3318a07b6a44ce32100fa726d430d63a0712d52 GIT binary patch literal 39859 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 Jh94mj{}11()gu4^ literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/py.typed b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/collections/py.typed new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/context.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/context.py new file mode 100644 index 000000000..61b27135d --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/context.py @@ -0,0 +1,361 @@ +from __future__ import annotations + +import contextlib +import functools +import operator +import os +import shutil +import subprocess +import sys +import tempfile +import urllib.request +import warnings +from typing import Iterator + + +if sys.version_info < (3, 12): + from backports import tarfile +else: + import tarfile + + +@contextlib.contextmanager +def pushd(dir: str | os.PathLike) -> Iterator[str | os.PathLike]: + """ + >>> tmp_path = getfixture('tmp_path') + >>> with pushd(tmp_path): + ... assert os.getcwd() == os.fspath(tmp_path) + >>> assert os.getcwd() != os.fspath(tmp_path) + """ + + orig = os.getcwd() + os.chdir(dir) + try: + yield dir + finally: + os.chdir(orig) + + +@contextlib.contextmanager +def tarball( + url, target_dir: str | os.PathLike | None = None +) -> Iterator[str | os.PathLike]: + """ + Get a tarball, extract it, yield, then clean up. + + >>> import urllib.request + >>> url = getfixture('tarfile_served') + >>> target = getfixture('tmp_path') / 'out' + >>> tb = tarball(url, target_dir=target) + >>> import pathlib + >>> with tb as extracted: + ... contents = pathlib.Path(extracted, 'contents.txt').read_text(encoding='utf-8') + >>> assert not os.path.exists(extracted) + """ + if target_dir is None: + target_dir = os.path.basename(url).replace('.tar.gz', '').replace('.tgz', '') + # In the tar command, use --strip-components=1 to strip the first path and + # then + # use -C to cause the files to be extracted to {target_dir}. This ensures + # that we always know where the files were extracted. + os.mkdir(target_dir) + try: + req = urllib.request.urlopen(url) + with tarfile.open(fileobj=req, mode='r|*') as tf: + tf.extractall(path=target_dir, filter=strip_first_component) + yield target_dir + finally: + shutil.rmtree(target_dir) + + +def strip_first_component( + member: tarfile.TarInfo, + path, +) -> tarfile.TarInfo: + _, member.name = member.name.split('/', 1) + return member + + +def _compose(*cmgrs): + """ + Compose any number of dependent context managers into a single one. + + The last, innermost context manager may take arbitrary arguments, but + each successive context manager should accept the result from the + previous as a single parameter. + + Like :func:`jaraco.functools.compose`, behavior works from right to + left, so the context manager should be indicated from outermost to + innermost. + + Example, to create a context manager to change to a temporary + directory: + + >>> temp_dir_as_cwd = _compose(pushd, temp_dir) + >>> with temp_dir_as_cwd() as dir: + ... assert os.path.samefile(os.getcwd(), dir) + """ + + def compose_two(inner, outer): + def composed(*args, **kwargs): + with inner(*args, **kwargs) as saved, outer(saved) as res: + yield res + + return contextlib.contextmanager(composed) + + return functools.reduce(compose_two, reversed(cmgrs)) + + +tarball_cwd = _compose(pushd, tarball) + + +@contextlib.contextmanager +def tarball_context(*args, **kwargs): + warnings.warn( + "tarball_context is deprecated. Use tarball or tarball_cwd instead.", + DeprecationWarning, + stacklevel=2, + ) + pushd_ctx = kwargs.pop('pushd', pushd) + with tarball(*args, **kwargs) as tball, pushd_ctx(tball) as dir: + yield dir + + +def infer_compression(url): + """ + Given a URL or filename, infer the compression code for tar. + + >>> infer_compression('http://foo/bar.tar.gz') + 'z' + >>> infer_compression('http://foo/bar.tgz') + 'z' + >>> infer_compression('file.bz') + 'j' + >>> infer_compression('file.xz') + 'J' + """ + warnings.warn( + "infer_compression is deprecated with no replacement", + DeprecationWarning, + stacklevel=2, + ) + # cheat and just assume it's the last two characters + compression_indicator = url[-2:] + mapping = dict(gz='z', bz='j', xz='J') + # Assume 'z' (gzip) if no match + return mapping.get(compression_indicator, 'z') + + +@contextlib.contextmanager +def temp_dir(remover=shutil.rmtree): + """ + Create a temporary directory context. Pass a custom remover + to override the removal behavior. + + >>> import pathlib + >>> with temp_dir() as the_dir: + ... assert os.path.isdir(the_dir) + ... _ = pathlib.Path(the_dir).joinpath('somefile').write_text('contents', encoding='utf-8') + >>> assert not os.path.exists(the_dir) + """ + temp_dir = tempfile.mkdtemp() + try: + yield temp_dir + finally: + remover(temp_dir) + + +@contextlib.contextmanager +def repo_context(url, branch=None, quiet=True, dest_ctx=temp_dir): + """ + Check out the repo indicated by url. + + If dest_ctx is supplied, it should be a context manager + to yield the target directory for the check out. + """ + exe = 'git' if 'git' in url else 'hg' + with dest_ctx() as repo_dir: + cmd = [exe, 'clone', url, repo_dir] + if branch: + cmd.extend(['--branch', branch]) + devnull = open(os.path.devnull, 'w') + stdout = devnull if quiet else None + subprocess.check_call(cmd, stdout=stdout) + yield repo_dir + + +def null(): + """ + A null context suitable to stand in for a meaningful context. + + >>> with null() as value: + ... assert value is None + + This context is most useful when dealing with two or more code + branches but only some need a context. Wrap the others in a null + context to provide symmetry across all options. + """ + warnings.warn( + "null is deprecated. Use contextlib.nullcontext", + DeprecationWarning, + stacklevel=2, + ) + return contextlib.nullcontext() + + +class ExceptionTrap: + """ + A context manager that will catch certain exceptions and provide an + indication they occurred. + + >>> with ExceptionTrap() as trap: + ... raise Exception() + >>> bool(trap) + True + + >>> with ExceptionTrap() as trap: + ... pass + >>> bool(trap) + False + + >>> with ExceptionTrap(ValueError) as trap: + ... raise ValueError("1 + 1 is not 3") + >>> bool(trap) + True + >>> trap.value + ValueError('1 + 1 is not 3') + >>> trap.tb + + + >>> with ExceptionTrap(ValueError) as trap: + ... raise Exception() + Traceback (most recent call last): + ... + Exception + + >>> bool(trap) + False + """ + + exc_info = None, None, None + + def __init__(self, exceptions=(Exception,)): + self.exceptions = exceptions + + def __enter__(self): + return self + + @property + def type(self): + return self.exc_info[0] + + @property + def value(self): + return self.exc_info[1] + + @property + def tb(self): + return self.exc_info[2] + + def __exit__(self, *exc_info): + type = exc_info[0] + matches = type and issubclass(type, self.exceptions) + if matches: + self.exc_info = exc_info + return matches + + def __bool__(self): + return bool(self.type) + + def raises(self, func, *, _test=bool): + """ + Wrap func and replace the result with the truth + value of the trap (True if an exception occurred). + + First, give the decorator an alias to support Python 3.8 + Syntax. + + >>> raises = ExceptionTrap(ValueError).raises + + Now decorate a function that always fails. + + >>> @raises + ... def fail(): + ... raise ValueError('failed') + >>> fail() + True + """ + + @functools.wraps(func) + def wrapper(*args, **kwargs): + with ExceptionTrap(self.exceptions) as trap: + func(*args, **kwargs) + return _test(trap) + + return wrapper + + def passes(self, func): + """ + Wrap func and replace the result with the truth + value of the trap (True if no exception). + + First, give the decorator an alias to support Python 3.8 + Syntax. + + >>> passes = ExceptionTrap(ValueError).passes + + Now decorate a function that always fails. + + >>> @passes + ... def fail(): + ... raise ValueError('failed') + + >>> fail() + False + """ + return self.raises(func, _test=operator.not_) + + +class suppress(contextlib.suppress, contextlib.ContextDecorator): + """ + A version of contextlib.suppress with decorator support. + + >>> @suppress(KeyError) + ... def key_error(): + ... {}[''] + >>> key_error() + """ + + +class on_interrupt(contextlib.ContextDecorator): + """ + Replace a KeyboardInterrupt with SystemExit(1) + + >>> def do_interrupt(): + ... raise KeyboardInterrupt() + >>> on_interrupt('error')(do_interrupt)() + Traceback (most recent call last): + ... + SystemExit: 1 + >>> on_interrupt('error', code=255)(do_interrupt)() + Traceback (most recent call last): + ... + SystemExit: 255 + >>> on_interrupt('suppress')(do_interrupt)() + >>> with __import__('pytest').raises(KeyboardInterrupt): + ... on_interrupt('ignore')(do_interrupt)() + """ + + def __init__(self, action='error', /, code=1): + self.action = action + self.code = code + + def __enter__(self): + return self + + def __exit__(self, exctype, excinst, exctb): + if exctype is not KeyboardInterrupt or self.action == 'ignore': + return + elif self.action == 'error': + raise SystemExit(self.code) from excinst + return self.action == 'suppress' diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__init__.py new file mode 100644 index 000000000..ca6c22fa9 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__init__.py @@ -0,0 +1,633 @@ +import collections.abc +import functools +import inspect +import itertools +import operator +import time +import types +import warnings + +import more_itertools + + +def compose(*funcs): + """ + Compose any number of unary functions into a single unary function. + + >>> import textwrap + >>> expected = str.strip(textwrap.dedent(compose.__doc__)) + >>> strip_and_dedent = compose(str.strip, textwrap.dedent) + >>> strip_and_dedent(compose.__doc__) == expected + True + + Compose also allows the innermost function to take arbitrary arguments. + + >>> round_three = lambda x: round(x, ndigits=3) + >>> f = compose(round_three, int.__truediv__) + >>> [f(3*x, x+1) for x in range(1,10)] + [1.5, 2.0, 2.25, 2.4, 2.5, 2.571, 2.625, 2.667, 2.7] + """ + + def compose_two(f1, f2): + return lambda *args, **kwargs: f1(f2(*args, **kwargs)) + + return functools.reduce(compose_two, funcs) + + +def once(func): + """ + Decorate func so it's only ever called the first time. + + This decorator can ensure that an expensive or non-idempotent function + will not be expensive on subsequent calls and is idempotent. + + >>> add_three = once(lambda a: a+3) + >>> add_three(3) + 6 + >>> add_three(9) + 6 + >>> add_three('12') + 6 + + To reset the stored value, simply clear the property ``saved_result``. + + >>> del add_three.saved_result + >>> add_three(9) + 12 + >>> add_three(8) + 12 + + Or invoke 'reset()' on it. + + >>> add_three.reset() + >>> add_three(-3) + 0 + >>> add_three(0) + 0 + """ + + @functools.wraps(func) + def wrapper(*args, **kwargs): + if not hasattr(wrapper, 'saved_result'): + wrapper.saved_result = func(*args, **kwargs) + return wrapper.saved_result + + wrapper.reset = lambda: vars(wrapper).__delitem__('saved_result') + return wrapper + + +def method_cache(method, cache_wrapper=functools.lru_cache()): + """ + Wrap lru_cache to support storing the cache data in the object instances. + + Abstracts the common paradigm where the method explicitly saves an + underscore-prefixed protected property on first call and returns that + subsequently. + + >>> class MyClass: + ... calls = 0 + ... + ... @method_cache + ... def method(self, value): + ... self.calls += 1 + ... return value + + >>> a = MyClass() + >>> a.method(3) + 3 + >>> for x in range(75): + ... res = a.method(x) + >>> a.calls + 75 + + Note that the apparent behavior will be exactly like that of lru_cache + except that the cache is stored on each instance, so values in one + instance will not flush values from another, and when an instance is + deleted, so are the cached values for that instance. + + >>> b = MyClass() + >>> for x in range(35): + ... res = b.method(x) + >>> b.calls + 35 + >>> a.method(0) + 0 + >>> a.calls + 75 + + Note that if method had been decorated with ``functools.lru_cache()``, + a.calls would have been 76 (due to the cached value of 0 having been + flushed by the 'b' instance). + + Clear the cache with ``.cache_clear()`` + + >>> a.method.cache_clear() + + Same for a method that hasn't yet been called. + + >>> c = MyClass() + >>> c.method.cache_clear() + + Another cache wrapper may be supplied: + + >>> cache = functools.lru_cache(maxsize=2) + >>> MyClass.method2 = method_cache(lambda self: 3, cache_wrapper=cache) + >>> a = MyClass() + >>> a.method2() + 3 + + Caution - do not subsequently wrap the method with another decorator, such + as ``@property``, which changes the semantics of the function. + + See also + http://code.activestate.com/recipes/577452-a-memoize-decorator-for-instance-methods/ + for another implementation and additional justification. + """ + + def wrapper(self, *args, **kwargs): + # it's the first call, replace the method with a cached, bound method + bound_method = types.MethodType(method, self) + cached_method = cache_wrapper(bound_method) + setattr(self, method.__name__, cached_method) + return cached_method(*args, **kwargs) + + # Support cache clear even before cache has been created. + wrapper.cache_clear = lambda: None + + return _special_method_cache(method, cache_wrapper) or wrapper + + +def _special_method_cache(method, cache_wrapper): + """ + Because Python treats special methods differently, it's not + possible to use instance attributes to implement the cached + methods. + + Instead, install the wrapper method under a different name + and return a simple proxy to that wrapper. + + https://github.com/jaraco/jaraco.functools/issues/5 + """ + name = method.__name__ + special_names = '__getattr__', '__getitem__' + + if name not in special_names: + return None + + wrapper_name = '__cached' + name + + def proxy(self, /, *args, **kwargs): + if wrapper_name not in vars(self): + bound = types.MethodType(method, self) + cache = cache_wrapper(bound) + setattr(self, wrapper_name, cache) + else: + cache = getattr(self, wrapper_name) + return cache(*args, **kwargs) + + return proxy + + +def apply(transform): + """ + Decorate a function with a transform function that is + invoked on results returned from the decorated function. + + >>> @apply(reversed) + ... def get_numbers(start): + ... "doc for get_numbers" + ... return range(start, start+3) + >>> list(get_numbers(4)) + [6, 5, 4] + >>> get_numbers.__doc__ + 'doc for get_numbers' + """ + + def wrap(func): + return functools.wraps(func)(compose(transform, func)) + + return wrap + + +def result_invoke(action): + r""" + Decorate a function with an action function that is + invoked on the results returned from the decorated + function (for its side effect), then return the original + result. + + >>> @result_invoke(print) + ... def add_two(a, b): + ... return a + b + >>> x = add_two(2, 3) + 5 + >>> x + 5 + """ + + def wrap(func): + @functools.wraps(func) + def wrapper(*args, **kwargs): + result = func(*args, **kwargs) + action(result) + return result + + return wrapper + + return wrap + + +def invoke(f, /, *args, **kwargs): + """ + Call a function for its side effect after initialization. + + The benefit of using the decorator instead of simply invoking a function + after defining it is that it makes explicit the author's intent for the + function to be called immediately. Whereas if one simply calls the + function immediately, it's less obvious if that was intentional or + incidental. It also avoids repeating the name - the two actions, defining + the function and calling it immediately are modeled separately, but linked + by the decorator construct. + + The benefit of having a function construct (opposed to just invoking some + behavior inline) is to serve as a scope in which the behavior occurs. It + avoids polluting the global namespace with local variables, provides an + anchor on which to attach documentation (docstring), keeps the behavior + logically separated (instead of conceptually separated or not separated at + all), and provides potential to re-use the behavior for testing or other + purposes. + + This function is named as a pithy way to communicate, "call this function + primarily for its side effect", or "while defining this function, also + take it aside and call it". It exists because there's no Python construct + for "define and call" (nor should there be, as decorators serve this need + just fine). The behavior happens immediately and synchronously. + + >>> @invoke + ... def func(): print("called") + called + >>> func() + called + + Use functools.partial to pass parameters to the initial call + + >>> @functools.partial(invoke, name='bingo') + ... def func(name): print('called with', name) + called with bingo + """ + f(*args, **kwargs) + return f + + +class Throttler: + """Rate-limit a function (or other callable).""" + + def __init__(self, func, max_rate=float('Inf')): + if isinstance(func, Throttler): + func = func.func + self.func = func + self.max_rate = max_rate + self.reset() + + def reset(self): + self.last_called = 0 + + def __call__(self, *args, **kwargs): + self._wait() + return self.func(*args, **kwargs) + + def _wait(self): + """Ensure at least 1/max_rate seconds from last call.""" + elapsed = time.time() - self.last_called + must_wait = 1 / self.max_rate - elapsed + time.sleep(max(0, must_wait)) + self.last_called = time.time() + + def __get__(self, obj, owner=None): + return first_invoke(self._wait, functools.partial(self.func, obj)) + + +def first_invoke(func1, func2): + """ + Return a function that when invoked will invoke func1 without + any parameters (for its side effect) and then invoke func2 + with whatever parameters were passed, returning its result. + """ + + def wrapper(*args, **kwargs): + func1() + return func2(*args, **kwargs) + + return wrapper + + +method_caller = first_invoke( + lambda: warnings.warn( + '`jaraco.functools.method_caller` is deprecated, ' + 'use `operator.methodcaller` instead', + DeprecationWarning, + stacklevel=3, + ), + operator.methodcaller, +) + + +def retry_call(func, cleanup=lambda: None, retries=0, trap=()): + """ + Given a callable func, trap the indicated exceptions + for up to 'retries' times, invoking cleanup on the + exception. On the final attempt, allow any exceptions + to propagate. + """ + attempts = itertools.count() if retries == float('inf') else range(retries) + for _ in attempts: + try: + return func() + except trap: + cleanup() + + return func() + + +def retry(*r_args, **r_kwargs): + """ + Decorator wrapper for retry_call. Accepts arguments to retry_call + except func and then returns a decorator for the decorated function. + + Ex: + + >>> @retry(retries=3) + ... def my_func(a, b): + ... "this is my funk" + ... print(a, b) + >>> my_func.__doc__ + 'this is my funk' + """ + + def decorate(func): + @functools.wraps(func) + def wrapper(*f_args, **f_kwargs): + bound = functools.partial(func, *f_args, **f_kwargs) + return retry_call(bound, *r_args, **r_kwargs) + + return wrapper + + return decorate + + +def print_yielded(func): + """ + Convert a generator into a function that prints all yielded elements. + + >>> @print_yielded + ... def x(): + ... yield 3; yield None + >>> x() + 3 + None + """ + print_all = functools.partial(map, print) + print_results = compose(more_itertools.consume, print_all, func) + return functools.wraps(func)(print_results) + + +def pass_none(func): + """ + Wrap func so it's not called if its first param is None. + + >>> print_text = pass_none(print) + >>> print_text('text') + text + >>> print_text(None) + """ + + @functools.wraps(func) + def wrapper(param, /, *args, **kwargs): + if param is not None: + return func(param, *args, **kwargs) + return None + + return wrapper + + +def assign_params(func, namespace): + """ + Assign parameters from namespace where func solicits. + + >>> def func(x, y=3): + ... print(x, y) + >>> assigned = assign_params(func, dict(x=2, z=4)) + >>> assigned() + 2 3 + + The usual errors are raised if a function doesn't receive + its required parameters: + + >>> assigned = assign_params(func, dict(y=3, z=4)) + >>> assigned() + Traceback (most recent call last): + TypeError: func() ...argument... + + It even works on methods: + + >>> class Handler: + ... def meth(self, arg): + ... print(arg) + >>> assign_params(Handler().meth, dict(arg='crystal', foo='clear'))() + crystal + """ + sig = inspect.signature(func) + params = sig.parameters.keys() + call_ns = {k: namespace[k] for k in params if k in namespace} + return functools.partial(func, **call_ns) + + +def save_method_args(method): + """ + Wrap a method such that when it is called, the args and kwargs are + saved on the method. + + >>> class MyClass: + ... @save_method_args + ... def method(self, a, b): + ... print(a, b) + >>> my_ob = MyClass() + >>> my_ob.method(1, 2) + 1 2 + >>> my_ob._saved_method.args + (1, 2) + >>> my_ob._saved_method.kwargs + {} + >>> my_ob.method(a=3, b='foo') + 3 foo + >>> my_ob._saved_method.args + () + >>> my_ob._saved_method.kwargs == dict(a=3, b='foo') + True + + The arguments are stored on the instance, allowing for + different instance to save different args. + + >>> your_ob = MyClass() + >>> your_ob.method({str('x'): 3}, b=[4]) + {'x': 3} [4] + >>> your_ob._saved_method.args + ({'x': 3},) + >>> my_ob._saved_method.args + () + """ + args_and_kwargs = collections.namedtuple('args_and_kwargs', 'args kwargs') + + @functools.wraps(method) + def wrapper(self, /, *args, **kwargs): + attr_name = '_saved_' + method.__name__ + attr = args_and_kwargs(args, kwargs) + setattr(self, attr_name, attr) + return method(self, *args, **kwargs) + + return wrapper + + +def except_(*exceptions, replace=None, use=None): + """ + Replace the indicated exceptions, if raised, with the indicated + literal replacement or evaluated expression (if present). + + >>> safe_int = except_(ValueError)(int) + >>> safe_int('five') + >>> safe_int('5') + 5 + + Specify a literal replacement with ``replace``. + + >>> safe_int_r = except_(ValueError, replace=0)(int) + >>> safe_int_r('five') + 0 + + Provide an expression to ``use`` to pass through particular parameters. + + >>> safe_int_pt = except_(ValueError, use='args[0]')(int) + >>> safe_int_pt('five') + 'five' + + """ + + def decorate(func): + @functools.wraps(func) + def wrapper(*args, **kwargs): + try: + return func(*args, **kwargs) + except exceptions: + try: + return eval(use) + except TypeError: + return replace + + return wrapper + + return decorate + + +def identity(x): + """ + Return the argument. + + >>> o = object() + >>> identity(o) is o + True + """ + return x + + +def bypass_when(check, *, _op=identity): + """ + Decorate a function to return its parameter when ``check``. + + >>> bypassed = [] # False + + >>> @bypass_when(bypassed) + ... def double(x): + ... return x * 2 + >>> double(2) + 4 + >>> bypassed[:] = [object()] # True + >>> double(2) + 2 + """ + + def decorate(func): + @functools.wraps(func) + def wrapper(param, /): + return param if _op(check) else func(param) + + return wrapper + + return decorate + + +def bypass_unless(check): + """ + Decorate a function to return its parameter unless ``check``. + + >>> enabled = [object()] # True + + >>> @bypass_unless(enabled) + ... def double(x): + ... return x * 2 + >>> double(2) + 4 + >>> del enabled[:] # False + >>> double(2) + 2 + """ + return bypass_when(check, _op=operator.not_) + + +@functools.singledispatch +def _splat_inner(args, func): + """Splat args to func.""" + return func(*args) + + +@_splat_inner.register +def _(args: collections.abc.Mapping, func): + """Splat kargs to func as kwargs.""" + return func(**args) + + +def splat(func): + """ + Wrap func to expect its parameters to be passed positionally in a tuple. + + Has a similar effect to that of ``itertools.starmap`` over + simple ``map``. + + >>> pairs = [(-1, 1), (0, 2)] + >>> more_itertools.consume(itertools.starmap(print, pairs)) + -1 1 + 0 2 + >>> more_itertools.consume(map(splat(print), pairs)) + -1 1 + 0 2 + + The approach generalizes to other iterators that don't have a "star" + equivalent, such as a "starfilter". + + >>> list(filter(splat(operator.add), pairs)) + [(0, 2)] + + Splat also accepts a mapping argument. + + >>> def is_nice(msg, code): + ... return "smile" in msg or code == 0 + >>> msgs = [ + ... dict(msg='smile!', code=20), + ... dict(msg='error :(', code=1), + ... dict(msg='unknown', code=0), + ... ] + >>> for msg in filter(splat(is_nice), msgs): + ... print(msg) + {'msg': 'smile!', 'code': 20} + {'msg': 'unknown', 'code': 0} + """ + return functools.wraps(func)(functools.partial(_splat_inner, func=func)) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__init__.pyi b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__init__.pyi new file mode 100644 index 000000000..19191bf93 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__init__.pyi @@ -0,0 +1,125 @@ +from collections.abc import Callable, Hashable, Iterator +from functools import partial +from operator import methodcaller +import sys +from typing import ( + Any, + Generic, + Protocol, + TypeVar, + overload, +) + +if sys.version_info >= (3, 10): + from typing import Concatenate, ParamSpec +else: + from typing_extensions import Concatenate, ParamSpec + +_P = ParamSpec('_P') +_R = TypeVar('_R') +_T = TypeVar('_T') +_R1 = TypeVar('_R1') +_R2 = TypeVar('_R2') +_V = TypeVar('_V') +_S = TypeVar('_S') +_R_co = TypeVar('_R_co', covariant=True) + +class _OnceCallable(Protocol[_P, _R]): + saved_result: _R + reset: Callable[[], None] + def __call__(self, *args: _P.args, **kwargs: _P.kwargs) -> _R: ... + +class _ProxyMethodCacheWrapper(Protocol[_R_co]): + cache_clear: Callable[[], None] + def __call__(self, *args: Hashable, **kwargs: Hashable) -> _R_co: ... + +class _MethodCacheWrapper(Protocol[_R_co]): + def cache_clear(self) -> None: ... + def __call__(self, *args: Hashable, **kwargs: Hashable) -> _R_co: ... + +# `compose()` overloads below will cover most use cases. + +@overload +def compose( + __func1: Callable[[_R], _T], + __func2: Callable[_P, _R], + /, +) -> Callable[_P, _T]: ... +@overload +def compose( + __func1: Callable[[_R], _T], + __func2: Callable[[_R1], _R], + __func3: Callable[_P, _R1], + /, +) -> Callable[_P, _T]: ... +@overload +def compose( + __func1: Callable[[_R], _T], + __func2: Callable[[_R2], _R], + __func3: Callable[[_R1], _R2], + __func4: Callable[_P, _R1], + /, +) -> Callable[_P, _T]: ... +def once(func: Callable[_P, _R]) -> _OnceCallable[_P, _R]: ... +def method_cache( + method: Callable[..., _R], + cache_wrapper: Callable[[Callable[..., _R]], _MethodCacheWrapper[_R]] = ..., +) -> _MethodCacheWrapper[_R] | _ProxyMethodCacheWrapper[_R]: ... +def apply( + transform: Callable[[_R], _T] +) -> Callable[[Callable[_P, _R]], Callable[_P, _T]]: ... +def result_invoke( + action: Callable[[_R], Any] +) -> Callable[[Callable[_P, _R]], Callable[_P, _R]]: ... +def invoke( + f: Callable[_P, _R], /, *args: _P.args, **kwargs: _P.kwargs +) -> Callable[_P, _R]: ... + +class Throttler(Generic[_R]): + last_called: float + func: Callable[..., _R] + max_rate: float + def __init__( + self, func: Callable[..., _R] | Throttler[_R], max_rate: float = ... + ) -> None: ... + def reset(self) -> None: ... + def __call__(self, *args: Any, **kwargs: Any) -> _R: ... + def __get__(self, obj: Any, owner: type[Any] | None = ...) -> Callable[..., _R]: ... + +def first_invoke( + func1: Callable[..., Any], func2: Callable[_P, _R] +) -> Callable[_P, _R]: ... + +method_caller: Callable[..., methodcaller] + +def retry_call( + func: Callable[..., _R], + cleanup: Callable[..., None] = ..., + retries: int | float = ..., + trap: type[BaseException] | tuple[type[BaseException], ...] = ..., +) -> _R: ... +def retry( + cleanup: Callable[..., None] = ..., + retries: int | float = ..., + trap: type[BaseException] | tuple[type[BaseException], ...] = ..., +) -> Callable[[Callable[..., _R]], Callable[..., _R]]: ... +def print_yielded(func: Callable[_P, Iterator[Any]]) -> Callable[_P, None]: ... +def pass_none( + func: Callable[Concatenate[_T, _P], _R] +) -> Callable[Concatenate[_T, _P], _R]: ... +def assign_params( + func: Callable[..., _R], namespace: dict[str, Any] +) -> partial[_R]: ... +def save_method_args( + method: Callable[Concatenate[_S, _P], _R] +) -> Callable[Concatenate[_S, _P], _R]: ... +def except_( + *exceptions: type[BaseException], replace: Any = ..., use: Any = ... +) -> Callable[[Callable[_P, Any]], Callable[_P, Any]]: ... +def identity(x: _T) -> _T: ... +def bypass_when( + check: _V, *, _op: Callable[[_V], Any] = ... +) -> Callable[[Callable[[_T], _R]], Callable[[_T], _T | _R]]: ... +def bypass_unless( + check: Any, +) -> Callable[[Callable[[_T], _R]], Callable[[_T], _T | _R]]: ... diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/functools/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..3d2b058b8f9ff3486700931b19fbaaeaed1c6f36 GIT binary patch literal 22950 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 multi_substitution(('foo', 'bar'), ('bar', 'baz'))('foo') + 'baz' + """ + substitutions = itertools.starmap(substitution, substitutions) + # compose function applies last function first, so reverse the + # substitutions to get the expected order. + substitutions = reversed(tuple(substitutions)) + return compose(*substitutions) + + +class FoldedCase(str): + """ + A case insensitive string class; behaves just like str + except compares equal when the only variation is case. + + >>> s = FoldedCase('hello world') + + >>> s == 'Hello World' + True + + >>> 'Hello World' == s + True + + >>> s != 'Hello World' + False + + >>> s.index('O') + 4 + + >>> s.split('O') + ['hell', ' w', 'rld'] + + >>> sorted(map(FoldedCase, ['GAMMA', 'alpha', 'Beta'])) + ['alpha', 'Beta', 'GAMMA'] + + Sequence membership is straightforward. + + >>> "Hello World" in [s] + True + >>> s in ["Hello World"] + True + + Allows testing for set inclusion, but candidate and elements + must both be folded. + + >>> FoldedCase("Hello World") in {s} + True + >>> s in {FoldedCase("Hello World")} + True + + String inclusion works as long as the FoldedCase object + is on the right. + + >>> "hello" in FoldedCase("Hello World") + True + + But not if the FoldedCase object is on the left: + + >>> FoldedCase('hello') in 'Hello World' + False + + In that case, use ``in_``: + + >>> FoldedCase('hello').in_('Hello World') + True + + >>> FoldedCase('hello') > FoldedCase('Hello') + False + + >>> FoldedCase('ß') == FoldedCase('ss') + True + """ + + def __lt__(self, other): + return self.casefold() < other.casefold() + + def __gt__(self, other): + return self.casefold() > other.casefold() + + def __eq__(self, other): + return self.casefold() == other.casefold() + + def __ne__(self, other): + return self.casefold() != other.casefold() + + def __hash__(self): + return hash(self.casefold()) + + def __contains__(self, other): + return super().casefold().__contains__(other.casefold()) + + def in_(self, other): + "Does self appear in other?" + return self in FoldedCase(other) + + # cache casefold since it's likely to be called frequently. + @method_cache + def casefold(self): + return super().casefold() + + def index(self, sub): + return self.casefold().index(sub.casefold()) + + def split(self, splitter=' ', maxsplit=0): + pattern = re.compile(re.escape(splitter), re.I) + return pattern.split(self, maxsplit) + + +# Python 3.8 compatibility +_unicode_trap = ExceptionTrap(UnicodeDecodeError) + + +@_unicode_trap.passes +def is_decodable(value): + r""" + Return True if the supplied value is decodable (using the default + encoding). + + >>> is_decodable(b'\xff') + False + >>> is_decodable(b'\x32') + True + """ + value.decode() + + +def is_binary(value): + r""" + Return True if the value appears to be binary (that is, it's a byte + string and isn't decodable). + + >>> is_binary(b'\xff') + True + >>> is_binary('\xff') + False + """ + return isinstance(value, bytes) and not is_decodable(value) + + +def trim(s): + r""" + Trim something like a docstring to remove the whitespace that + is common due to indentation and formatting. + + >>> trim("\n\tfoo = bar\n\t\tbar = baz\n") + 'foo = bar\n\tbar = baz' + """ + return textwrap.dedent(s).strip() + + +def wrap(s): + """ + Wrap lines of text, retaining existing newlines as + paragraph markers. + + >>> print(wrap(lorem_ipsum)) + Lorem 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. + + Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam + varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus + magna felis sollicitudin mauris. Integer in mauris eu nibh euismod + gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis + risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, + eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas + fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla + a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, + neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing + sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque + nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus + quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, + molestie eu, feugiat in, orci. In hac habitasse platea dictumst. + """ + paragraphs = s.splitlines() + wrapped = ('\n'.join(textwrap.wrap(para)) for para in paragraphs) + return '\n\n'.join(wrapped) + + +def unwrap(s): + r""" + Given a multi-line string, return an unwrapped version. + + >>> wrapped = wrap(lorem_ipsum) + >>> wrapped.count('\n') + 20 + >>> unwrapped = unwrap(wrapped) + >>> unwrapped.count('\n') + 1 + >>> print(unwrapped) + Lorem ipsum dolor sit amet, consectetur adipiscing ... + Curabitur pretium tincidunt lacus. Nulla gravida orci ... + + """ + paragraphs = re.split(r'\n\n+', s) + cleaned = (para.replace('\n', ' ') for para in paragraphs) + return '\n'.join(cleaned) + + +lorem_ipsum: str = ( + files(__name__).joinpath('Lorem ipsum.txt').read_text(encoding='utf-8') +) + + +class Splitter: + """object that will split a string with the given arguments for each call + + >>> s = Splitter(',') + >>> s('hello, world, this is your, master calling') + ['hello', ' world', ' this is your', ' master calling'] + """ + + def __init__(self, *args): + self.args = args + + def __call__(self, s): + return s.split(*self.args) + + +def indent(string, prefix=' ' * 4): + """ + >>> indent('foo') + ' foo' + """ + return prefix + string + + +class WordSet(tuple): + """ + Given an identifier, return the words that identifier represents, + whether in camel case, underscore-separated, etc. + + >>> WordSet.parse("camelCase") + ('camel', 'Case') + + >>> WordSet.parse("under_sep") + ('under', 'sep') + + Acronyms should be retained + + >>> WordSet.parse("firstSNL") + ('first', 'SNL') + + >>> WordSet.parse("you_and_I") + ('you', 'and', 'I') + + >>> WordSet.parse("A simple test") + ('A', 'simple', 'test') + + Multiple caps should not interfere with the first cap of another word. + + >>> WordSet.parse("myABCClass") + ('my', 'ABC', 'Class') + + The result is a WordSet, providing access to other forms. + + >>> WordSet.parse("myABCClass").underscore_separated() + 'my_ABC_Class' + + >>> WordSet.parse('a-command').camel_case() + 'ACommand' + + >>> WordSet.parse('someIdentifier').lowered().space_separated() + 'some identifier' + + Slices of the result should return another WordSet. + + >>> WordSet.parse('taken-out-of-context')[1:].underscore_separated() + 'out_of_context' + + >>> WordSet.from_class_name(WordSet()).lowered().space_separated() + 'word set' + + >>> example = WordSet.parse('figured it out') + >>> example.headless_camel_case() + 'figuredItOut' + >>> example.dash_separated() + 'figured-it-out' + + """ + + _pattern = re.compile('([A-Z]?[a-z]+)|([A-Z]+(?![a-z]))') + + def capitalized(self): + return WordSet(word.capitalize() for word in self) + + def lowered(self): + return WordSet(word.lower() for word in self) + + def camel_case(self): + return ''.join(self.capitalized()) + + def headless_camel_case(self): + words = iter(self) + first = next(words).lower() + new_words = itertools.chain((first,), WordSet(words).camel_case()) + return ''.join(new_words) + + def underscore_separated(self): + return '_'.join(self) + + def dash_separated(self): + return '-'.join(self) + + def space_separated(self): + return ' '.join(self) + + def trim_right(self, item): + """ + Remove the item from the end of the set. + + >>> WordSet.parse('foo bar').trim_right('foo') + ('foo', 'bar') + >>> WordSet.parse('foo bar').trim_right('bar') + ('foo',) + >>> WordSet.parse('').trim_right('bar') + () + """ + return self[:-1] if self and self[-1] == item else self + + def trim_left(self, item): + """ + Remove the item from the beginning of the set. + + >>> WordSet.parse('foo bar').trim_left('foo') + ('bar',) + >>> WordSet.parse('foo bar').trim_left('bar') + ('foo', 'bar') + >>> WordSet.parse('').trim_left('bar') + () + """ + return self[1:] if self and self[0] == item else self + + def trim(self, item): + """ + >>> WordSet.parse('foo bar').trim('foo') + ('bar',) + """ + return self.trim_left(item).trim_right(item) + + def __getitem__(self, item): + result = super().__getitem__(item) + if isinstance(item, slice): + result = WordSet(result) + return result + + @classmethod + def parse(cls, identifier): + matches = cls._pattern.finditer(identifier) + return WordSet(match.group(0) for match in matches) + + @classmethod + def from_class_name(cls, subject): + return cls.parse(subject.__class__.__name__) + + +# for backward compatibility +words = WordSet.parse + + +def simple_html_strip(s): + r""" + Remove HTML from the string `s`. + + >>> str(simple_html_strip('')) + '' + + >>> print(simple_html_strip('A stormy day in paradise')) + A stormy day in paradise + + >>> print(simple_html_strip('Somebody tell the truth.')) + Somebody tell the truth. + + >>> print(simple_html_strip('What about
    \nmultiple lines?')) + What about + multiple lines? + """ + html_stripper = re.compile('()|(<[^>]*>)|([^<]+)', re.DOTALL) + texts = (match.group(3) or '' for match in html_stripper.finditer(s)) + return ''.join(texts) + + +class SeparatedValues(str): + """ + A string separated by a separator. Overrides __iter__ for getting + the values. + + >>> list(SeparatedValues('a,b,c')) + ['a', 'b', 'c'] + + Whitespace is stripped and empty values are discarded. + + >>> list(SeparatedValues(' a, b , c, ')) + ['a', 'b', 'c'] + """ + + separator = ',' + + def __iter__(self): + parts = self.split(self.separator) + return filter(None, (part.strip() for part in parts)) + + +class Stripper: + r""" + Given a series of lines, find the common prefix and strip it from them. + + >>> lines = [ + ... 'abcdefg\n', + ... 'abc\n', + ... 'abcde\n', + ... ] + >>> res = Stripper.strip_prefix(lines) + >>> res.prefix + 'abc' + >>> list(res.lines) + ['defg\n', '\n', 'de\n'] + + If no prefix is common, nothing should be stripped. + + >>> lines = [ + ... 'abcd\n', + ... '1234\n', + ... ] + >>> res = Stripper.strip_prefix(lines) + >>> res.prefix = '' + >>> list(res.lines) + ['abcd\n', '1234\n'] + """ + + def __init__(self, prefix, lines): + self.prefix = prefix + self.lines = map(self, lines) + + @classmethod + def strip_prefix(cls, lines): + prefix_lines, lines = itertools.tee(lines) + prefix = functools.reduce(cls.common_prefix, prefix_lines) + return cls(prefix, lines) + + def __call__(self, line): + if not self.prefix: + return line + null, prefix, rest = line.partition(self.prefix) + return rest + + @staticmethod + def common_prefix(s1, s2): + """ + Return the common prefix of two lines. + """ + index = min(len(s1), len(s2)) + while s1[:index] != s2[:index]: + index -= 1 + return s1[:index] + + +def remove_prefix(text, prefix): + """ + Remove the prefix from the text if it exists. + + >>> remove_prefix('underwhelming performance', 'underwhelming ') + 'performance' + + >>> remove_prefix('something special', 'sample') + 'something special' + """ + null, prefix, rest = text.rpartition(prefix) + return rest + + +def remove_suffix(text, suffix): + """ + Remove the suffix from the text if it exists. + + >>> remove_suffix('name.git', '.git') + 'name' + + >>> remove_suffix('something special', 'sample') + 'something special' + """ + rest, suffix, null = text.partition(suffix) + return rest + + +def normalize_newlines(text): + r""" + Replace alternate newlines with the canonical newline. + + >>> normalize_newlines('Lorem Ipsum\u2029') + 'Lorem Ipsum\n' + >>> normalize_newlines('Lorem Ipsum\r\n') + 'Lorem Ipsum\n' + >>> normalize_newlines('Lorem Ipsum\x85') + 'Lorem Ipsum\n' + """ + newlines = ['\r\n', '\r', '\n', '\u0085', '\u2028', '\u2029'] + pattern = '|'.join(newlines) + return re.sub(pattern, '\n', text) + + +def _nonblank(str): + return str and not str.startswith('#') + + +@functools.singledispatch +def yield_lines(iterable): + r""" + Yield valid lines of a string or iterable. + + >>> list(yield_lines('')) + [] + >>> list(yield_lines(['foo', 'bar'])) + ['foo', 'bar'] + >>> list(yield_lines('foo\nbar')) + ['foo', 'bar'] + >>> list(yield_lines('\nfoo\n#bar\nbaz #comment')) + ['foo', 'baz #comment'] + >>> list(yield_lines(['foo\nbar', 'baz', 'bing\n\n\n'])) + ['foo', 'bar', 'baz', 'bing'] + """ + return itertools.chain.from_iterable(map(yield_lines, iterable)) + + +@yield_lines.register(str) +def _(text): + return filter(_nonblank, map(str.strip, text.splitlines())) + + +def drop_comment(line): + """ + Drop comments. + + >>> drop_comment('foo # bar') + 'foo' + + A hash without a space may be in a URL. + + >>> drop_comment('http://example.com/foo#bar') + 'http://example.com/foo#bar' + """ + return line.partition(' #')[0] + + +def join_continuation(lines): + r""" + Join lines continued by a trailing backslash. + + >>> list(join_continuation(['foo \\', 'bar', 'baz'])) + ['foobar', 'baz'] + >>> list(join_continuation(['foo \\', 'bar', 'baz'])) + ['foobar', 'baz'] + >>> list(join_continuation(['foo \\', 'bar \\', 'baz'])) + ['foobarbaz'] + + Not sure why, but... + The character 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 + + +def read_newlines(filename, limit=1024): + r""" + >>> tmp_path = getfixture('tmp_path') + >>> filename = tmp_path / 'out.txt' + >>> _ = filename.write_text('foo\n', newline='', encoding='utf-8') + >>> read_newlines(filename) + '\n' + >>> _ = filename.write_text('foo\r\n', newline='', encoding='utf-8') + >>> read_newlines(filename) + '\r\n' + >>> _ = filename.write_text('foo\r\nbar\nbing\r', newline='', encoding='utf-8') + >>> read_newlines(filename) + ('\r', '\n', '\r\n') + """ + with open(filename, encoding='utf-8') as fp: + fp.read(limit) + return fp.newlines diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..65de6d335832ab8d777edd7f4cb088137bf43ce5 GIT binary patch literal 25533 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 S4cBUewc1mzK7hK)TJ0zG=7IhI literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/__pycache__/to-qwerty.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/__pycache__/to-qwerty.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6b67f734c2363dd0c0b833e463be7713c18e5c8a GIT binary patch literal 487 zcmY*UJxfC|6uo&>`+-Fqbm~?3W}{$yM(j}_SL+XnxwYxALuX8zaTC; zIk-5vxL84i=O_+t1ve)XYZWitd(S=O+?;!#&1S&H-3@JaZGUycD8_!kN6&&&V8D=o z8ZeI~1PZ*Ghkz&8*ufk?52-u?54hJ#jpTowL+ksOKgJ>ZcJe>trVDS#A&8L6{P?>g zcHWV#c@!rFjbz8@I7LW6{g9A+GEV47$Do{H$A>iFgv8UtC>m-(4JXT6BhKt4d1+0C;3vJpsp!-&>x#_fxltN>2#6u<(Zc#-W5*yyL>ttbQr`V1@ zQ_F#59l=-Bly&CL)=Rbw5(uFe$h^VKU;?" +dvorak = "[]',.pyfgcrl/=aoeuidhtns-;qjkxbmwvz{}\"<>PYFGCRL?+AOEUIDHTNS_:QJKXBMWVZ" + + +to_dvorak = str.maketrans(qwerty, dvorak) +to_qwerty = str.maketrans(dvorak, qwerty) + + +def translate(input, translation): + """ + >>> translate('dvorak', to_dvorak) + 'ekrpat' + >>> translate('qwerty', to_qwerty) + 'x,dokt' + """ + return input.translate(translation) + + +def _translate_stream(stream, translation): + """ + >>> import io + >>> _translate_stream(io.StringIO('foo'), to_dvorak) + urr + """ + print(translate(stream.read(), translation)) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/show-newlines.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/show-newlines.py new file mode 100644 index 000000000..e11d1ba42 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/show-newlines.py @@ -0,0 +1,33 @@ +import autocommand +import inflect + +from more_itertools import always_iterable + +import jaraco.text + + +def report_newlines(filename): + r""" + Report the newlines in the indicated file. + + >>> tmp_path = getfixture('tmp_path') + >>> filename = tmp_path / 'out.txt' + >>> _ = filename.write_text('foo\nbar\n', newline='', encoding='utf-8') + >>> report_newlines(filename) + newline is '\n' + >>> filename = tmp_path / 'out.txt' + >>> _ = filename.write_text('foo\nbar\r\n', newline='', encoding='utf-8') + >>> report_newlines(filename) + newlines are ('\n', '\r\n') + """ + newlines = jaraco.text.read_newlines(filename) + count = len(tuple(always_iterable(newlines))) + engine = inflect.engine() + print( + engine.plural_noun("newline", count), + engine.plural_verb("is", count), + repr(newlines), + ) + + +autocommand.autocommand(__name__)(report_newlines) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/strip-prefix.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/strip-prefix.py new file mode 100644 index 000000000..761717a9b --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/strip-prefix.py @@ -0,0 +1,21 @@ +import sys + +import autocommand + +from jaraco.text import Stripper + + +def strip_prefix(): + r""" + Strip any common prefix from stdin. + + >>> import io, pytest + >>> getfixture('monkeypatch').setattr('sys.stdin', io.StringIO('abcdef\nabc123')) + >>> strip_prefix() + def + 123 + """ + sys.stdout.writelines(Stripper.strip_prefix(sys.stdin).lines) + + +autocommand.autocommand(__name__)(strip_prefix) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/to-dvorak.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/to-dvorak.py new file mode 100644 index 000000000..a6d5da80b --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/to-dvorak.py @@ -0,0 +1,6 @@ +import sys + +from . import layouts + + +__name__ == '__main__' and layouts._translate_stream(sys.stdin, layouts.to_dvorak) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/to-qwerty.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/to-qwerty.py new file mode 100644 index 000000000..abe272866 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/jaraco/text/to-qwerty.py @@ -0,0 +1,6 @@ +import sys + +from . import layouts + + +__name__ == '__main__' and layouts._translate_stream(sys.stdin, layouts.to_qwerty) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/INSTALLER new file mode 100644 index 000000000..a1b589e38 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/INSTALLER @@ -0,0 +1 @@ +pip diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/LICENSE new file mode 100644 index 000000000..0a523bece --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/LICENSE @@ -0,0 +1,19 @@ +Copyright (c) 2012 Erik Rose + +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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/METADATA new file mode 100644 index 000000000..fb41b0cfe --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/METADATA @@ -0,0 +1,266 @@ +Metadata-Version: 2.1 +Name: more-itertools +Version: 10.3.0 +Summary: More routines for operating on iterables, beyond itertools +Keywords: itertools,iterator,iteration,filter,peek,peekable,chunk,chunked +Author-email: Erik Rose +Requires-Python: >=3.8 +Description-Content-Type: text/x-rst +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: Natural Language :: English +Classifier: License :: OSI Approved :: MIT License +Classifier: Programming Language :: Python :: 3 +Classifier: Programming Language :: Python :: 3.8 +Classifier: Programming Language :: Python :: 3.9 +Classifier: Programming Language :: Python :: 3.10 +Classifier: Programming Language :: Python :: 3.11 +Classifier: Programming Language :: Python :: 3.12 +Classifier: Programming Language :: Python :: 3 :: Only +Classifier: Programming Language :: Python :: Implementation :: CPython +Classifier: Programming Language :: Python :: Implementation :: PyPy +Classifier: Topic :: Software Development :: Libraries +Project-URL: Homepage, https://github.com/more-itertools/more-itertools + +============== +More Itertools +============== + +.. image:: https://readthedocs.org/projects/more-itertools/badge/?version=latest + :target: https://more-itertools.readthedocs.io/en/stable/ + +Python's ``itertools`` library is a gem - you can compose elegant solutions +for a variety of problems with the functions it provides. In ``more-itertools`` +we collect additional building blocks, recipes, and routines for working with +Python iterables. + ++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Grouping | `chunked `_, | +| | `ichunked `_, | +| | `chunked_even `_, | +| | `sliced `_, | +| | `constrained_batches `_, | +| | `distribute `_, | +| | `divide `_, | +| | `split_at `_, | +| | `split_before `_, | +| | `split_after `_, | +| | `split_into `_, | +| | `split_when `_, | +| | `bucket `_, | +| | `unzip `_, | +| | `batched `_, | +| | `grouper `_, | +| | `partition `_, | +| | `transpose `_ | ++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Lookahead and lookback | `spy `_, | +| | `peekable `_, | +| | `seekable `_ | ++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Windowing | `windowed `_, | +| | `substrings `_, | +| | `substrings_indexes `_, | +| | `stagger `_, | +| | `windowed_complete `_, | +| | `pairwise `_, | +| | `triplewise `_, | +| | `sliding_window `_, | +| | `subslices `_ | ++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Augmenting | `count_cycle `_, | +| | `intersperse `_, | +| | `padded `_, | +| | `repeat_each `_, | +| | `mark_ends `_, | +| | `repeat_last `_, | +| | `adjacent `_, | +| | `groupby_transform `_, | +| | `pad_none `_, | +| | `ncycles `_ | ++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Combining | `collapse `_, | +| | `sort_together `_, | +| | `interleave `_, | +| | `interleave_longest `_, | +| | `interleave_evenly `_, | +| | `zip_offset `_, | +| | `zip_equal `_, | +| | `zip_broadcast `_, | +| | `flatten `_, | +| | `roundrobin `_, | +| | `prepend `_, | +| | `value_chain `_, | +| | `partial_product `_ | ++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Summarizing | `ilen `_, | +| | `unique_to_each `_, | +| | `sample `_, | +| | `consecutive_groups `_, | +| | `run_length `_, | +| | `map_reduce `_, | +| | `join_mappings `_, | +| | `exactly_n `_, | +| | `is_sorted `_, | +| | `all_equal `_, | +| | `all_unique `_, | +| | `minmax `_, | +| | `first_true `_, | +| | `quantify `_, | +| | `iequals `_ | ++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Selecting | `islice_extended `_, | +| | `first `_, | +| | `last `_, | +| | `one `_, | +| | `only `_, | +| | `strictly_n `_, | +| | `strip `_, | +| | `lstrip `_, | +| | `rstrip `_, | +| | `filter_except `_, | +| | `map_except `_, | +| | `filter_map `_, | +| | `iter_suppress `_, | +| | `nth_or_last `_, | +| | `unique_in_window `_, | +| | `before_and_after `_, | +| | `nth `_, | +| | `take `_, | +| | `tail `_, | +| | `unique_everseen `_, | +| | `unique_justseen `_, | +| | `unique `_, | +| | `duplicates_everseen `_, | +| | `duplicates_justseen `_, | +| | `classify_unique `_, | +| | `longest_common_prefix `_, | +| | `takewhile_inclusive `_ | ++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Math | `dft `_, | +| | `idft `_, | +| | `convolve `_, | +| | `dotproduct `_, | +| | `factor `_, | +| | `matmul `_, | +| | `polynomial_from_roots `_, | +| | `polynomial_derivative `_, | +| | `polynomial_eval `_, | +| | `sieve `_, | +| | `sum_of_squares `_, | +| | `totient `_ | ++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Combinatorics | `distinct_permutations `_, | +| | `distinct_combinations `_, | +| | `circular_shifts `_, | +| | `partitions `_, | +| | `set_partitions `_, | +| | `product_index `_, | +| | `combination_index `_, | +| | `permutation_index `_, | +| | `combination_with_replacement_index `_, | +| | `gray_product `_, | +| | `outer_product `_, | +| | `powerset `_, | +| | `powerset_of_sets `_, | +| | `random_product `_, | +| | `random_permutation `_, | +| | `random_combination `_, | +| | `random_combination_with_replacement `_, | +| | `nth_product `_, | +| | `nth_permutation `_, | +| | `nth_combination `_, | +| | `nth_combination_with_replacement `_ | ++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Wrapping | `always_iterable `_, | +| | `always_reversible `_, | +| | `countable `_, | +| | `consumer `_, | +| | `with_iter `_, | +| | `iter_except `_ | ++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ +| Others | `locate `_, | +| | `rlocate `_, | +| | `replace `_, | +| | `numeric_range `_, | +| | `side_effect `_, | +| | `iterate `_, | +| | `difference `_, | +| | `make_decorator `_, | +| | `SequenceView `_, | +| | `time_limited `_, | +| | `map_if `_, | +| | `iter_index `_, | +| | `consume `_, | +| | `tabulate `_, | +| | `repeatfunc `_, | +| | `reshape `_ | +| | `doublestarmap `_ | ++------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ + + +Getting started +=============== + +To get started, install the library with `pip `_: + +.. code-block:: shell + + pip install more-itertools + +The recipes from the `itertools docs `_ +are included in the top-level package: + +.. code-block:: python + + >>> from more_itertools import flatten + >>> iterable = [(0, 1), (2, 3)] + >>> list(flatten(iterable)) + [0, 1, 2, 3] + +Several new recipes are available as well: + +.. code-block:: python + + >>> from more_itertools import chunked + >>> iterable = [0, 1, 2, 3, 4, 5, 6, 7, 8] + >>> list(chunked(iterable, 3)) + [[0, 1, 2], [3, 4, 5], [6, 7, 8]] + + >>> from more_itertools import spy + >>> iterable = (x * x for x in range(1, 6)) + >>> head, iterable = spy(iterable, n=3) + >>> list(head) + [1, 4, 9] + >>> list(iterable) + [1, 4, 9, 16, 25] + + + +For the full listing of functions, see the `API documentation `_. + + +Links elsewhere +=============== + +Blog posts about ``more-itertools``: + +* `Yo, I heard you like decorators `__ +* `Tour of Python Itertools `__ (`Alternate `__) +* `Real-World Python More Itertools `_ + + +Development +=========== + +``more-itertools`` is maintained by `@erikrose `_ +and `@bbayles `_, with help from `many others `_. +If you have a problem or suggestion, please file a bug or pull request in this +repository. Thanks for contributing! + + +Version History +=============== + +The version history can be found in `documentation `_. + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/RECORD new file mode 100644 index 000000000..4def70f4e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/RECORD @@ -0,0 +1,16 @@ +more_itertools-10.3.0.dist-info/INSTALLER,sha256=zuuue4knoyJ-UwPPXg8fezS7VCrXJQrAP7zeNuwvFQg,4 +more_itertools-10.3.0.dist-info/LICENSE,sha256=CfHIyelBrz5YTVlkHqm4fYPAyw_QB-te85Gn4mQ8GkY,1053 +more_itertools-10.3.0.dist-info/METADATA,sha256=BFO90O-fLNiVQMpj7oIS5ztzgJUUQZ3TA32P5HH3N-A,36293 +more_itertools-10.3.0.dist-info/RECORD,, +more_itertools-10.3.0.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +more_itertools-10.3.0.dist-info/WHEEL,sha256=rSgq_JpHF9fHR1lx53qwg_1-2LypZE_qmcuXbVUq948,81 +more_itertools/__init__.py,sha256=dtAbGjTDmn_ghiU5YXfhyDy0phAlXVdt5klZA5fUa-Q,149 +more_itertools/__init__.pyi,sha256=5B3eTzON1BBuOLob1vCflyEb2lSd6usXQQ-Cv-hXkeA,43 +more_itertools/__pycache__/__init__.cpython-312.pyc,, +more_itertools/__pycache__/more.cpython-312.pyc,, +more_itertools/__pycache__/recipes.cpython-312.pyc,, +more_itertools/more.py,sha256=1E5kzFncRKTDw0cYv1yRXMgDdunstLQd1QStcnL6U90,148370 +more_itertools/more.pyi,sha256=iXXeqt48Nxe8VGmIWpkVXuKpR2FYNuu2DU8nQLWCCu0,21484 +more_itertools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +more_itertools/recipes.py,sha256=WedhhfhGVgr6zii8fIbGJVmRTw0ZKRiLKnYBDGJv4nY,28591 +more_itertools/recipes.pyi,sha256=T_mdGpcFdfrP3JSWbwzYP9JyNV-Go-7RPfpxfftAWlA,4617 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/REQUESTED b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/REQUESTED new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/WHEEL new file mode 100644 index 000000000..db4a255f3 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools-10.3.0.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: flit 3.8.0 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__init__.py new file mode 100644 index 000000000..9c4662fc3 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__init__.py @@ -0,0 +1,6 @@ +"""More routines for operating on iterables, beyond itertools""" + +from .more import * # noqa +from .recipes import * # noqa + +__version__ = '10.3.0' diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__init__.pyi b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__init__.pyi new file mode 100644 index 000000000..96f6e36c7 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__init__.pyi @@ -0,0 +1,2 @@ +from .more import * +from .recipes import * diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..da9b1e85bf4517fa71fc3d907f1877292a439443 GIT binary patch literal 390 zcmX|+u};G<5QgovP@pOcQs=BiG;ZmJ5Mlr%hE^49U92QFt-z{@AD{l!?-@yZ7Xn+`Ip2SZc zUXVAZ(x8-;8!MB&E@gBGf-^qSO96hv0Kr= zIo_VEwp&3bX!RQ9yh161n9{sFc0cD8&0~>plUFId=Gq8Qls=+q5p#A&Mlj|il>CNt zv%ZE)9$Q0>&-=|DFutJEqZ4`t5m;hV3tEJd1pg#OM3T&oKy`xlE-@}{GYR9XaOkED zw`nquO5AS6K$9X9EpA%cR48F74U%lOwm$}zN`9cLE?aS%*>cZM31j?*4!_XWJF0(d K)^DqN-TA*vVR)PX literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__pycache__/more.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__pycache__/more.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..27aaa24d807939e1d103282aa0a87276afd75cd1 GIT binary patch literal 174238 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%0D$zl2P?umGO;4+ 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 Uc}COBvV5auwl3FLDBJ!20}V)+g8%>k literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__pycache__/recipes.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/__pycache__/recipes.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..95703ecf9818b57da02053659c790a582748ead0 GIT binary patch literal 36367 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/more.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/more.py new file mode 100644 index 000000000..7b481907d --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/more.py @@ -0,0 +1,4806 @@ +import math +import warnings + +from collections import Counter, defaultdict, deque, abc +from collections.abc import Sequence +from functools import cached_property, partial, reduce, wraps +from heapq import heapify, heapreplace, heappop +from itertools import ( + chain, + combinations, + compress, + count, + cycle, + dropwhile, + groupby, + islice, + repeat, + starmap, + takewhile, + tee, + zip_longest, + product, +) +from math import comb, e, exp, factorial, floor, fsum, log, perm, tau +from queue import Empty, Queue +from random import random, randrange, uniform +from operator import itemgetter, mul, sub, gt, lt, ge, le +from sys import hexversion, maxsize +from time import monotonic + +from .recipes import ( + _marker, + _zip_equal, + UnequalIterablesError, + consume, + flatten, + pairwise, + powerset, + take, + unique_everseen, + all_equal, + batched, +) + +__all__ = [ + 'AbortThread', + 'SequenceView', + 'UnequalIterablesError', + 'adjacent', + 'all_unique', + 'always_iterable', + 'always_reversible', + 'bucket', + 'callback_iter', + 'chunked', + 'chunked_even', + 'circular_shifts', + 'collapse', + 'combination_index', + 'combination_with_replacement_index', + 'consecutive_groups', + 'constrained_batches', + 'consumer', + 'count_cycle', + 'countable', + 'dft', + 'difference', + 'distinct_combinations', + 'distinct_permutations', + 'distribute', + 'divide', + 'doublestarmap', + 'duplicates_everseen', + 'duplicates_justseen', + 'classify_unique', + 'exactly_n', + 'filter_except', + 'filter_map', + 'first', + 'gray_product', + 'groupby_transform', + 'ichunked', + 'iequals', + 'idft', + 'ilen', + 'interleave', + 'interleave_evenly', + 'interleave_longest', + 'intersperse', + 'is_sorted', + 'islice_extended', + 'iterate', + 'iter_suppress', + 'join_mappings', + 'last', + 'locate', + 'longest_common_prefix', + 'lstrip', + 'make_decorator', + 'map_except', + 'map_if', + 'map_reduce', + 'mark_ends', + 'minmax', + 'nth_or_last', + 'nth_permutation', + 'nth_product', + 'nth_combination_with_replacement', + 'numeric_range', + 'one', + 'only', + 'outer_product', + 'padded', + 'partial_product', + 'partitions', + 'peekable', + 'permutation_index', + 'powerset_of_sets', + 'product_index', + 'raise_', + 'repeat_each', + 'repeat_last', + 'replace', + 'rlocate', + 'rstrip', + 'run_length', + 'sample', + 'seekable', + 'set_partitions', + 'side_effect', + 'sliced', + 'sort_together', + 'split_after', + 'split_at', + 'split_before', + 'split_into', + 'split_when', + 'spy', + 'stagger', + 'strip', + 'strictly_n', + 'substrings', + 'substrings_indexes', + 'takewhile_inclusive', + 'time_limited', + 'unique_in_window', + 'unique_to_each', + 'unzip', + 'value_chain', + 'windowed', + 'windowed_complete', + 'with_iter', + 'zip_broadcast', + 'zip_equal', + 'zip_offset', +] + +# math.sumprod is available for Python 3.12+ +_fsumprod = getattr(math, 'sumprod', lambda x, y: fsum(map(mul, x, y))) + + +def chunked(iterable, n, strict=False): + """Break *iterable* into lists of length *n*: + + >>> list(chunked([1, 2, 3, 4, 5, 6], 3)) + [[1, 2, 3], [4, 5, 6]] + + By the default, the last yielded list will have fewer than *n* elements + if the length of *iterable* is not divisible by *n*: + + >>> list(chunked([1, 2, 3, 4, 5, 6, 7, 8], 3)) + [[1, 2, 3], [4, 5, 6], [7, 8]] + + To use a fill-in value instead, see the :func:`grouper` recipe. + + If the length of *iterable* is not divisible by *n* and *strict* is + ``True``, then ``ValueError`` will be raised before the last + list is yielded. + + """ + iterator = iter(partial(take, n, iter(iterable)), []) + if strict: + if n is None: + raise ValueError('n must not be None when using strict mode.') + + def ret(): + for chunk in iterator: + if len(chunk) != n: + raise ValueError('iterable is not divisible by n.') + yield chunk + + return iter(ret()) + else: + return iterator + + +def first(iterable, default=_marker): + """Return the first item of *iterable*, or *default* if *iterable* is + empty. + + >>> first([0, 1, 2, 3]) + 0 + >>> first([], 'some default') + 'some default' + + If *default* is not provided and there are no items in the iterable, + raise ``ValueError``. + + :func:`first` is useful when you have a generator of expensive-to-retrieve + values and want any arbitrary one. It is marginally shorter than + ``next(iter(iterable), default)``. + + """ + for item in iterable: + return item + if default is _marker: + raise ValueError( + 'first() was called on an empty iterable, and no ' + 'default value was provided.' + ) + return default + + +def last(iterable, default=_marker): + """Return the last item of *iterable*, or *default* if *iterable* is + empty. + + >>> last([0, 1, 2, 3]) + 3 + >>> last([], 'some default') + 'some default' + + If *default* is not provided and there are no items in the iterable, + raise ``ValueError``. + """ + try: + if isinstance(iterable, Sequence): + return iterable[-1] + # Work around https://bugs.python.org/issue38525 + elif hasattr(iterable, '__reversed__') and (hexversion != 0x030800F0): + return next(reversed(iterable)) + else: + return deque(iterable, maxlen=1)[-1] + except (IndexError, TypeError, StopIteration): + if default is _marker: + raise ValueError( + 'last() was called on an empty iterable, and no default was ' + 'provided.' + ) + return default + + +def nth_or_last(iterable, n, default=_marker): + """Return the nth or the last item of *iterable*, + or *default* if *iterable* is empty. + + >>> nth_or_last([0, 1, 2, 3], 2) + 2 + >>> nth_or_last([0, 1], 2) + 1 + >>> nth_or_last([], 0, 'some default') + 'some default' + + If *default* is not provided and there are no items in the iterable, + raise ``ValueError``. + """ + return last(islice(iterable, n + 1), default=default) + + +class peekable: + """Wrap an iterator to allow lookahead and prepending elements. + + Call :meth:`peek` on the result to get the value that will be returned + by :func:`next`. This won't advance the iterator: + + >>> p = peekable(['a', 'b']) + >>> p.peek() + 'a' + >>> next(p) + 'a' + + Pass :meth:`peek` a default value to return that instead of raising + ``StopIteration`` when the iterator is exhausted. + + >>> p = peekable([]) + >>> p.peek('hi') + 'hi' + + peekables also offer a :meth:`prepend` method, which "inserts" items + at the head of the iterable: + + >>> p = peekable([1, 2, 3]) + >>> p.prepend(10, 11, 12) + >>> next(p) + 10 + >>> p.peek() + 11 + >>> list(p) + [11, 12, 1, 2, 3] + + peekables can be indexed. Index 0 is the item that will be returned by + :func:`next`, index 1 is the item after that, and so on: + The values up to the given index will be cached. + + >>> p = peekable(['a', 'b', 'c', 'd']) + >>> p[0] + 'a' + >>> p[1] + 'b' + >>> next(p) + 'a' + + Negative indexes are supported, but be aware that they will cache the + remaining items in the source iterator, which may require significant + storage. + + To check whether a peekable is exhausted, check its truth value: + + >>> p = peekable(['a', 'b']) + >>> if p: # peekable has items + ... list(p) + ['a', 'b'] + >>> if not p: # peekable is exhausted + ... list(p) + [] + + """ + + def __init__(self, iterable): + self._it = iter(iterable) + self._cache = deque() + + def __iter__(self): + return self + + def __bool__(self): + try: + self.peek() + except StopIteration: + return False + return True + + def peek(self, default=_marker): + """Return the item that will be next returned from ``next()``. + + Return ``default`` if there are no items left. If ``default`` is not + provided, raise ``StopIteration``. + + """ + if not self._cache: + try: + self._cache.append(next(self._it)) + except StopIteration: + if default is _marker: + raise + return default + return self._cache[0] + + def prepend(self, *items): + """Stack up items to be the next ones returned from ``next()`` or + ``self.peek()``. The items will be returned in + first in, first out order:: + + >>> p = peekable([1, 2, 3]) + >>> p.prepend(10, 11, 12) + >>> next(p) + 10 + >>> list(p) + [11, 12, 1, 2, 3] + + It is possible, by prepending items, to "resurrect" a peekable that + previously raised ``StopIteration``. + + >>> p = peekable([]) + >>> next(p) + Traceback (most recent call last): + ... + StopIteration + >>> p.prepend(1) + >>> next(p) + 1 + >>> next(p) + Traceback (most recent call last): + ... + StopIteration + + """ + self._cache.extendleft(reversed(items)) + + def __next__(self): + if self._cache: + return self._cache.popleft() + + return next(self._it) + + def _get_slice(self, index): + # Normalize the slice's arguments + step = 1 if (index.step is None) else index.step + if step > 0: + start = 0 if (index.start is None) else index.start + stop = maxsize if (index.stop is None) else index.stop + elif step < 0: + start = -1 if (index.start is None) else index.start + stop = (-maxsize - 1) if (index.stop is None) else index.stop + else: + raise ValueError('slice step cannot be zero') + + # If either the start or stop index is negative, we'll need to cache + # the rest of the iterable in order to slice from the right side. + if (start < 0) or (stop < 0): + self._cache.extend(self._it) + # Otherwise we'll need to find the rightmost index and cache to that + # point. + else: + n = min(max(start, stop) + 1, maxsize) + cache_len = len(self._cache) + if n >= cache_len: + self._cache.extend(islice(self._it, n - cache_len)) + + return list(self._cache)[index] + + def __getitem__(self, index): + if isinstance(index, slice): + return self._get_slice(index) + + cache_len = len(self._cache) + if index < 0: + self._cache.extend(self._it) + elif index >= cache_len: + self._cache.extend(islice(self._it, index + 1 - cache_len)) + + return self._cache[index] + + +def consumer(func): + """Decorator that automatically advances a PEP-342-style "reverse iterator" + to its first yield point so you don't have to call ``next()`` on it + manually. + + >>> @consumer + ... def tally(): + ... i = 0 + ... while True: + ... print('Thing number %s is %s.' % (i, (yield))) + ... i += 1 + ... + >>> t = tally() + >>> t.send('red') + Thing number 0 is red. + >>> t.send('fish') + Thing number 1 is fish. + + Without the decorator, you would have to call ``next(t)`` before + ``t.send()`` could be used. + + """ + + @wraps(func) + def wrapper(*args, **kwargs): + gen = func(*args, **kwargs) + next(gen) + return gen + + return wrapper + + +def ilen(iterable): + """Return the number of items in *iterable*. + + >>> ilen(x for x in range(1000000) if x % 3 == 0) + 333334 + + This consumes the iterable, so handle with care. + + """ + # This approach was selected because benchmarks showed it's likely the + # fastest of the known implementations at the time of writing. + # See GitHub tracker: #236, #230. + counter = count() + deque(zip(iterable, counter), maxlen=0) + return next(counter) + + +def iterate(func, start): + """Return ``start``, ``func(start)``, ``func(func(start))``, ... + + >>> from itertools import islice + >>> list(islice(iterate(lambda x: 2*x, 1), 10)) + [1, 2, 4, 8, 16, 32, 64, 128, 256, 512] + + """ + while True: + yield start + try: + start = func(start) + except StopIteration: + break + + +def with_iter(context_manager): + """Wrap an iterable in a ``with`` statement, so it closes once exhausted. + + For example, this will close the file when the iterator is exhausted:: + + upper_lines = (line.upper() for line in with_iter(open('foo'))) + + Any context manager which returns an iterable is a candidate for + ``with_iter``. + + """ + with context_manager as iterable: + yield from iterable + + +def one(iterable, too_short=None, too_long=None): + """Return the first item from *iterable*, which is expected to contain only + that item. Raise an exception if *iterable* is empty or has more than one + item. + + :func:`one` is useful for ensuring that an iterable contains only one item. + For example, it can be used to retrieve the result of a database query + that is expected to return a single row. + + If *iterable* is empty, ``ValueError`` will be raised. You may specify a + different exception with the *too_short* keyword: + + >>> it = [] + >>> one(it) # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + ... + ValueError: too many items in iterable (expected 1)' + >>> too_short = IndexError('too few items') + >>> one(it, too_short=too_short) # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + ... + IndexError: too few items + + Similarly, if *iterable* contains more than one item, ``ValueError`` will + be raised. You may specify a different exception with the *too_long* + keyword: + + >>> it = ['too', 'many'] + >>> one(it) # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + ... + ValueError: Expected exactly one item in iterable, but got 'too', + 'many', and perhaps more. + >>> too_long = RuntimeError + >>> one(it, too_long=too_long) # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + ... + RuntimeError + + Note that :func:`one` attempts to advance *iterable* twice to ensure there + is only one item. See :func:`spy` or :func:`peekable` to check iterable + contents less destructively. + + """ + it = iter(iterable) + + try: + first_value = next(it) + except StopIteration as exc: + raise ( + too_short or ValueError('too few items in iterable (expected 1)') + ) from exc + + try: + second_value = next(it) + except StopIteration: + pass + else: + msg = ( + 'Expected exactly one item in iterable, but got {!r}, {!r}, ' + 'and perhaps more.'.format(first_value, second_value) + ) + raise too_long or ValueError(msg) + + return first_value + + +def raise_(exception, *args): + raise exception(*args) + + +def strictly_n(iterable, n, too_short=None, too_long=None): + """Validate that *iterable* has exactly *n* items and return them if + it does. If it has fewer than *n* items, call function *too_short* + with those items. If it has more than *n* items, call function + *too_long* with the first ``n + 1`` items. + + >>> iterable = ['a', 'b', 'c', 'd'] + >>> n = 4 + >>> list(strictly_n(iterable, n)) + ['a', 'b', 'c', 'd'] + + Note that the returned iterable must be consumed in order for the check to + be made. + + By default, *too_short* and *too_long* are functions that raise + ``ValueError``. + + >>> list(strictly_n('ab', 3)) # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + ... + ValueError: too few items in iterable (got 2) + + >>> list(strictly_n('abc', 2)) # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + ... + ValueError: too many items in iterable (got at least 3) + + You can instead supply functions that do something else. + *too_short* will be called with the number of items in *iterable*. + *too_long* will be called with `n + 1`. + + >>> def too_short(item_count): + ... raise RuntimeError + >>> it = strictly_n('abcd', 6, too_short=too_short) + >>> list(it) # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + ... + RuntimeError + + >>> def too_long(item_count): + ... print('The boss is going to hear about this') + >>> it = strictly_n('abcdef', 4, too_long=too_long) + >>> list(it) + The boss is going to hear about this + ['a', 'b', 'c', 'd'] + + """ + if too_short is None: + too_short = lambda item_count: raise_( + ValueError, + 'Too few items in iterable (got {})'.format(item_count), + ) + + if too_long is None: + too_long = lambda item_count: raise_( + ValueError, + 'Too many items in iterable (got at least {})'.format(item_count), + ) + + it = iter(iterable) + for i in range(n): + try: + item = next(it) + except StopIteration: + too_short(i) + return + else: + yield item + + try: + next(it) + except StopIteration: + pass + else: + too_long(n + 1) + + +def distinct_permutations(iterable, r=None): + """Yield successive distinct permutations of the elements in *iterable*. + + >>> sorted(distinct_permutations([1, 0, 1])) + [(0, 1, 1), (1, 0, 1), (1, 1, 0)] + + Equivalent to ``set(permutations(iterable))``, except duplicates are not + generated and thrown away. For larger input sequences this is much more + efficient. + + Duplicate permutations arise when there are duplicated elements in the + input iterable. The number of items returned is + `n! / (x_1! * x_2! * ... * x_n!)`, where `n` is the total number of + items input, and each `x_i` is the count of a distinct item in the input + sequence. + + If *r* is given, only the *r*-length permutations are yielded. + + >>> sorted(distinct_permutations([1, 0, 1], r=2)) + [(0, 1), (1, 0), (1, 1)] + >>> sorted(distinct_permutations(range(3), r=2)) + [(0, 1), (0, 2), (1, 0), (1, 2), (2, 0), (2, 1)] + + """ + + # Algorithm: https://w.wiki/Qai + def _full(A): + while True: + # Yield the permutation we have + yield tuple(A) + + # Find the largest index i such that A[i] < A[i + 1] + for i in range(size - 2, -1, -1): + if A[i] < A[i + 1]: + break + # If no such index exists, this permutation is the last one + else: + return + + # Find the largest index j greater than j such that A[i] < A[j] + for j in range(size - 1, i, -1): + if A[i] < A[j]: + break + + # Swap the value of A[i] with that of A[j], then reverse the + # sequence from A[i + 1] to form the new permutation + A[i], A[j] = A[j], A[i] + A[i + 1 :] = A[: i - size : -1] # A[i + 1:][::-1] + + # Algorithm: modified from the above + def _partial(A, r): + # Split A into the first r items and the last r items + head, tail = A[:r], A[r:] + right_head_indexes = range(r - 1, -1, -1) + left_tail_indexes = range(len(tail)) + + while True: + # Yield the permutation we have + yield tuple(head) + + # Starting from the right, find the first index of the head with + # value smaller than the maximum value of the tail - call it i. + pivot = tail[-1] + for i in right_head_indexes: + if head[i] < pivot: + break + pivot = head[i] + else: + return + + # Starting from the left, find the first value of the tail + # with a value greater than head[i] and swap. + for j in left_tail_indexes: + if tail[j] > head[i]: + head[i], tail[j] = tail[j], head[i] + break + # If we didn't find one, start from the right and find the first + # index of the head with a value greater than head[i] and swap. + else: + for j in right_head_indexes: + if head[j] > head[i]: + head[i], head[j] = head[j], head[i] + break + + # Reverse head[i + 1:] and swap it with tail[:r - (i + 1)] + tail += head[: i - r : -1] # head[i + 1:][::-1] + i += 1 + head[i:], tail[:] = tail[: r - i], tail[r - i :] + + items = sorted(iterable) + + size = len(items) + if r is None: + r = size + + if 0 < r <= size: + return _full(items) if (r == size) else _partial(items, r) + + return iter(() if r else ((),)) + + +def intersperse(e, iterable, n=1): + """Intersperse filler element *e* among the items in *iterable*, leaving + *n* items between each filler element. + + >>> list(intersperse('!', [1, 2, 3, 4, 5])) + [1, '!', 2, '!', 3, '!', 4, '!', 5] + + >>> list(intersperse(None, [1, 2, 3, 4, 5], n=2)) + [1, 2, None, 3, 4, None, 5] + + """ + if n == 0: + raise ValueError('n must be > 0') + elif n == 1: + # interleave(repeat(e), iterable) -> e, x_0, e, x_1, e, x_2... + # islice(..., 1, None) -> x_0, e, x_1, e, x_2... + return islice(interleave(repeat(e), iterable), 1, None) + else: + # interleave(filler, chunks) -> [e], [x_0, x_1], [e], [x_2, x_3]... + # islice(..., 1, None) -> [x_0, x_1], [e], [x_2, x_3]... + # flatten(...) -> x_0, x_1, e, x_2, x_3... + filler = repeat([e]) + chunks = chunked(iterable, n) + return flatten(islice(interleave(filler, chunks), 1, None)) + + +def unique_to_each(*iterables): + """Return the elements from each of the input iterables that aren't in the + other input iterables. + + For example, suppose you have a set of packages, each with a set of + dependencies:: + + {'pkg_1': {'A', 'B'}, 'pkg_2': {'B', 'C'}, 'pkg_3': {'B', 'D'}} + + If you remove one package, which dependencies can also be removed? + + If ``pkg_1`` is removed, then ``A`` is no longer necessary - it is not + associated with ``pkg_2`` or ``pkg_3``. Similarly, ``C`` is only needed for + ``pkg_2``, and ``D`` is only needed for ``pkg_3``:: + + >>> unique_to_each({'A', 'B'}, {'B', 'C'}, {'B', 'D'}) + [['A'], ['C'], ['D']] + + If there are duplicates in one input iterable that aren't in the others + they will be duplicated in the output. Input order is preserved:: + + >>> unique_to_each("mississippi", "missouri") + [['p', 'p'], ['o', 'u', 'r']] + + It is assumed that the elements of each iterable are hashable. + + """ + pool = [list(it) for it in iterables] + counts = Counter(chain.from_iterable(map(set, pool))) + uniques = {element for element in counts if counts[element] == 1} + return [list(filter(uniques.__contains__, it)) for it in pool] + + +def windowed(seq, n, fillvalue=None, step=1): + """Return a sliding window of width *n* over the given iterable. + + >>> all_windows = windowed([1, 2, 3, 4, 5], 3) + >>> list(all_windows) + [(1, 2, 3), (2, 3, 4), (3, 4, 5)] + + When the window is larger than the iterable, *fillvalue* is used in place + of missing values: + + >>> list(windowed([1, 2, 3], 4)) + [(1, 2, 3, None)] + + Each window will advance in increments of *step*: + + >>> list(windowed([1, 2, 3, 4, 5, 6], 3, fillvalue='!', step=2)) + [(1, 2, 3), (3, 4, 5), (5, 6, '!')] + + To slide into the iterable's items, use :func:`chain` to add filler items + to the left: + + >>> iterable = [1, 2, 3, 4] + >>> n = 3 + >>> padding = [None] * (n - 1) + >>> list(windowed(chain(padding, iterable), 3)) + [(None, None, 1), (None, 1, 2), (1, 2, 3), (2, 3, 4)] + """ + if n < 0: + raise ValueError('n must be >= 0') + if n == 0: + yield () + return + if step < 1: + raise ValueError('step must be >= 1') + + iterable = iter(seq) + + # Generate first window + window = deque(islice(iterable, n), maxlen=n) + + # Deal with the first window not being full + if not window: + return + if len(window) < n: + yield tuple(window) + ((fillvalue,) * (n - len(window))) + return + yield tuple(window) + + # Create the filler for the next windows. The padding ensures + # we have just enough elements to fill the last window. + padding = (fillvalue,) * (n - 1 if step >= n else step - 1) + filler = map(window.append, chain(iterable, padding)) + + # Generate the rest of the windows + for _ in islice(filler, step - 1, None, step): + yield tuple(window) + + +def substrings(iterable): + """Yield all of the substrings of *iterable*. + + >>> [''.join(s) for s in substrings('more')] + ['m', 'o', 'r', 'e', 'mo', 'or', 're', 'mor', 'ore', 'more'] + + Note that non-string iterables can also be subdivided. + + >>> list(substrings([0, 1, 2])) + [(0,), (1,), (2,), (0, 1), (1, 2), (0, 1, 2)] + + """ + # The length-1 substrings + seq = [] + for item in iter(iterable): + seq.append(item) + yield (item,) + seq = tuple(seq) + item_count = len(seq) + + # And the rest + for n in range(2, item_count + 1): + for i in range(item_count - n + 1): + yield seq[i : i + n] + + +def substrings_indexes(seq, reverse=False): + """Yield all substrings and their positions in *seq* + + The items yielded will be a tuple of the form ``(substr, i, j)``, where + ``substr == seq[i:j]``. + + This function only works for iterables that support slicing, such as + ``str`` objects. + + >>> for item in substrings_indexes('more'): + ... print(item) + ('m', 0, 1) + ('o', 1, 2) + ('r', 2, 3) + ('e', 3, 4) + ('mo', 0, 2) + ('or', 1, 3) + ('re', 2, 4) + ('mor', 0, 3) + ('ore', 1, 4) + ('more', 0, 4) + + Set *reverse* to ``True`` to yield the same items in the opposite order. + + + """ + r = range(1, len(seq) + 1) + if reverse: + r = reversed(r) + return ( + (seq[i : i + L], i, i + L) for L in r for i in range(len(seq) - L + 1) + ) + + +class bucket: + """Wrap *iterable* and return an object that buckets the iterable into + child iterables based on a *key* function. + + >>> iterable = ['a1', 'b1', 'c1', 'a2', 'b2', 'c2', 'b3'] + >>> s = bucket(iterable, key=lambda x: x[0]) # Bucket by 1st character + >>> sorted(list(s)) # Get the keys + ['a', 'b', 'c'] + >>> a_iterable = s['a'] + >>> next(a_iterable) + 'a1' + >>> next(a_iterable) + 'a2' + >>> list(s['b']) + ['b1', 'b2', 'b3'] + + The original iterable will be advanced and its items will be cached until + they are used by the child iterables. This may require significant storage. + + By default, attempting to select a bucket to which no items belong will + exhaust the iterable and cache all values. + If you specify a *validator* function, selected buckets will instead be + checked against it. + + >>> from itertools import count + >>> it = count(1, 2) # Infinite sequence of odd numbers + >>> key = lambda x: x % 10 # Bucket by last digit + >>> validator = lambda x: x in {1, 3, 5, 7, 9} # Odd digits only + >>> s = bucket(it, key=key, validator=validator) + >>> 2 in s + False + >>> list(s[2]) + [] + + """ + + def __init__(self, iterable, key, validator=None): + self._it = iter(iterable) + self._key = key + self._cache = defaultdict(deque) + self._validator = validator or (lambda x: True) + + def __contains__(self, value): + if not self._validator(value): + return False + + try: + item = next(self[value]) + except StopIteration: + return False + else: + self._cache[value].appendleft(item) + + return True + + def _get_values(self, value): + """ + Helper to yield items from the parent iterator that match *value*. + Items that don't match are stored in the local cache as they + are encountered. + """ + while True: + # If we've cached some items that match the target value, emit + # the first one and evict it from the cache. + if self._cache[value]: + yield self._cache[value].popleft() + # Otherwise we need to advance the parent iterator to search for + # a matching item, caching the rest. + else: + while True: + try: + item = next(self._it) + except StopIteration: + return + item_value = self._key(item) + if item_value == value: + yield item + break + elif self._validator(item_value): + self._cache[item_value].append(item) + + def __iter__(self): + for item in self._it: + item_value = self._key(item) + if self._validator(item_value): + self._cache[item_value].append(item) + + yield from self._cache.keys() + + def __getitem__(self, value): + if not self._validator(value): + return iter(()) + + return self._get_values(value) + + +def spy(iterable, n=1): + """Return a 2-tuple with a list containing the first *n* elements of + *iterable*, and an iterator with the same items as *iterable*. + This allows you to "look ahead" at the items in the iterable without + advancing it. + + There is one item in the list by default: + + >>> iterable = 'abcdefg' + >>> head, iterable = spy(iterable) + >>> head + ['a'] + >>> list(iterable) + ['a', 'b', 'c', 'd', 'e', 'f', 'g'] + + You may use unpacking to retrieve items instead of lists: + + >>> (head,), iterable = spy('abcdefg') + >>> head + 'a' + >>> (first, second), iterable = spy('abcdefg', 2) + >>> first + 'a' + >>> second + 'b' + + The number of items requested can be larger than the number of items in + the iterable: + + >>> iterable = [1, 2, 3, 4, 5] + >>> head, iterable = spy(iterable, 10) + >>> head + [1, 2, 3, 4, 5] + >>> list(iterable) + [1, 2, 3, 4, 5] + + """ + it = iter(iterable) + head = take(n, it) + + return head.copy(), chain(head, it) + + +def interleave(*iterables): + """Return a new iterable yielding from each iterable in turn, + until the shortest is exhausted. + + >>> list(interleave([1, 2, 3], [4, 5], [6, 7, 8])) + [1, 4, 6, 2, 5, 7] + + For a version that doesn't terminate after the shortest iterable is + exhausted, see :func:`interleave_longest`. + + """ + return chain.from_iterable(zip(*iterables)) + + +def interleave_longest(*iterables): + """Return a new iterable yielding from each iterable in turn, + skipping any that are exhausted. + + >>> list(interleave_longest([1, 2, 3], [4, 5], [6, 7, 8])) + [1, 4, 6, 2, 5, 7, 3, 8] + + This function produces the same output as :func:`roundrobin`, but may + perform better for some inputs (in particular when the number of iterables + is large). + + """ + i = chain.from_iterable(zip_longest(*iterables, fillvalue=_marker)) + return (x for x in i if x is not _marker) + + +def interleave_evenly(iterables, lengths=None): + """ + Interleave multiple iterables so that their elements are evenly distributed + throughout the output sequence. + + >>> iterables = [1, 2, 3, 4, 5], ['a', 'b'] + >>> list(interleave_evenly(iterables)) + [1, 2, 'a', 3, 4, 'b', 5] + + >>> iterables = [[1, 2, 3], [4, 5], [6, 7, 8]] + >>> list(interleave_evenly(iterables)) + [1, 6, 4, 2, 7, 3, 8, 5] + + This function requires iterables of known length. Iterables without + ``__len__()`` can be used by manually specifying lengths with *lengths*: + + >>> from itertools import combinations, repeat + >>> iterables = [combinations(range(4), 2), ['a', 'b', 'c']] + >>> lengths = [4 * (4 - 1) // 2, 3] + >>> list(interleave_evenly(iterables, lengths=lengths)) + [(0, 1), (0, 2), 'a', (0, 3), (1, 2), 'b', (1, 3), (2, 3), 'c'] + + Based on Bresenham's algorithm. + """ + if lengths is None: + try: + lengths = [len(it) for it in iterables] + except TypeError: + raise ValueError( + 'Iterable lengths could not be determined automatically. ' + 'Specify them with the lengths keyword.' + ) + elif len(iterables) != len(lengths): + raise ValueError('Mismatching number of iterables and lengths.') + + dims = len(lengths) + + # sort iterables by length, descending + lengths_permute = sorted( + range(dims), key=lambda i: lengths[i], reverse=True + ) + lengths_desc = [lengths[i] for i in lengths_permute] + iters_desc = [iter(iterables[i]) for i in lengths_permute] + + # the longest iterable is the primary one (Bresenham: the longest + # distance along an axis) + delta_primary, deltas_secondary = lengths_desc[0], lengths_desc[1:] + iter_primary, iters_secondary = iters_desc[0], iters_desc[1:] + errors = [delta_primary // dims] * len(deltas_secondary) + + to_yield = sum(lengths) + while to_yield: + yield next(iter_primary) + to_yield -= 1 + # update errors for each secondary iterable + errors = [e - delta for e, delta in zip(errors, deltas_secondary)] + + # those iterables for which the error is negative are yielded + # ("diagonal step" in Bresenham) + for i, e_ in enumerate(errors): + if e_ < 0: + yield next(iters_secondary[i]) + to_yield -= 1 + errors[i] += delta_primary + + +def collapse(iterable, base_type=None, levels=None): + """Flatten an iterable with multiple levels of nesting (e.g., a list of + lists of tuples) into non-iterable types. + + >>> iterable = [(1, 2), ([3, 4], [[5], [6]])] + >>> list(collapse(iterable)) + [1, 2, 3, 4, 5, 6] + + Binary and text strings are not considered iterable and + will not be collapsed. + + To avoid collapsing other types, specify *base_type*: + + >>> iterable = ['ab', ('cd', 'ef'), ['gh', 'ij']] + >>> list(collapse(iterable, base_type=tuple)) + ['ab', ('cd', 'ef'), 'gh', 'ij'] + + Specify *levels* to stop flattening after a certain level: + + >>> iterable = [('a', ['b']), ('c', ['d'])] + >>> list(collapse(iterable)) # Fully flattened + ['a', 'b', 'c', 'd'] + >>> list(collapse(iterable, levels=1)) # Only one level flattened + ['a', ['b'], 'c', ['d']] + + """ + stack = deque() + # Add our first node group, treat the iterable as a single node + stack.appendleft((0, repeat(iterable, 1))) + + while stack: + node_group = stack.popleft() + level, nodes = node_group + + # Check if beyond max level + if levels is not None and level > levels: + yield from nodes + continue + + for node in nodes: + # Check if done iterating + if isinstance(node, (str, bytes)) or ( + (base_type is not None) and isinstance(node, base_type) + ): + yield node + # Otherwise try to create child nodes + else: + try: + tree = iter(node) + except TypeError: + yield node + else: + # Save our current location + stack.appendleft(node_group) + # Append the new child node + stack.appendleft((level + 1, tree)) + # Break to process child node + break + + +def side_effect(func, iterable, chunk_size=None, before=None, after=None): + """Invoke *func* on each item in *iterable* (or on each *chunk_size* group + of items) before yielding the item. + + `func` must be a function that takes a single argument. Its return value + will be discarded. + + *before* and *after* are optional functions that take no arguments. They + will be executed before iteration starts and after it ends, respectively. + + `side_effect` can be used for logging, updating progress bars, or anything + that is not functionally "pure." + + Emitting a status message: + + >>> from more_itertools import consume + >>> func = lambda item: print('Received {}'.format(item)) + >>> consume(side_effect(func, range(2))) + Received 0 + Received 1 + + Operating on chunks of items: + + >>> pair_sums = [] + >>> func = lambda chunk: pair_sums.append(sum(chunk)) + >>> list(side_effect(func, [0, 1, 2, 3, 4, 5], 2)) + [0, 1, 2, 3, 4, 5] + >>> list(pair_sums) + [1, 5, 9] + + Writing to a file-like object: + + >>> from io import StringIO + >>> from more_itertools import consume + >>> f = StringIO() + >>> func = lambda x: print(x, file=f) + >>> before = lambda: print(u'HEADER', file=f) + >>> after = f.close + >>> it = [u'a', u'b', u'c'] + >>> consume(side_effect(func, it, before=before, after=after)) + >>> f.closed + True + + """ + try: + if before is not None: + before() + + if chunk_size is None: + for item in iterable: + func(item) + yield item + else: + for chunk in chunked(iterable, chunk_size): + func(chunk) + yield from chunk + finally: + if after is not None: + after() + + +def sliced(seq, n, strict=False): + """Yield slices of length *n* from the sequence *seq*. + + >>> list(sliced((1, 2, 3, 4, 5, 6), 3)) + [(1, 2, 3), (4, 5, 6)] + + By the default, the last yielded slice will have fewer than *n* elements + if the length of *seq* is not divisible by *n*: + + >>> list(sliced((1, 2, 3, 4, 5, 6, 7, 8), 3)) + [(1, 2, 3), (4, 5, 6), (7, 8)] + + If the length of *seq* is not divisible by *n* and *strict* is + ``True``, then ``ValueError`` will be raised before the last + slice is yielded. + + This function will only work for iterables that support slicing. + For non-sliceable iterables, see :func:`chunked`. + + """ + iterator = takewhile(len, (seq[i : i + n] for i in count(0, n))) + if strict: + + def ret(): + for _slice in iterator: + if len(_slice) != n: + raise ValueError("seq is not divisible by n.") + yield _slice + + return iter(ret()) + else: + return iterator + + +def split_at(iterable, pred, maxsplit=-1, keep_separator=False): + """Yield lists of items from *iterable*, where each list is delimited by + an item where callable *pred* returns ``True``. + + >>> list(split_at('abcdcba', lambda x: x == 'b')) + [['a'], ['c', 'd', 'c'], ['a']] + + >>> list(split_at(range(10), lambda n: n % 2 == 1)) + [[0], [2], [4], [6], [8], []] + + At most *maxsplit* splits are done. If *maxsplit* is not specified or -1, + then there is no limit on the number of splits: + + >>> list(split_at(range(10), lambda n: n % 2 == 1, maxsplit=2)) + [[0], [2], [4, 5, 6, 7, 8, 9]] + + By default, the delimiting items are not included in the output. + To include them, set *keep_separator* to ``True``. + + >>> list(split_at('abcdcba', lambda x: x == 'b', keep_separator=True)) + [['a'], ['b'], ['c', 'd', 'c'], ['b'], ['a']] + + """ + if maxsplit == 0: + yield list(iterable) + return + + buf = [] + it = iter(iterable) + for item in it: + if pred(item): + yield buf + if keep_separator: + yield [item] + if maxsplit == 1: + yield list(it) + return + buf = [] + maxsplit -= 1 + else: + buf.append(item) + yield buf + + +def split_before(iterable, pred, maxsplit=-1): + """Yield lists of items from *iterable*, where each list ends just before + an item for which callable *pred* returns ``True``: + + >>> list(split_before('OneTwo', lambda s: s.isupper())) + [['O', 'n', 'e'], ['T', 'w', 'o']] + + >>> list(split_before(range(10), lambda n: n % 3 == 0)) + [[0, 1, 2], [3, 4, 5], [6, 7, 8], [9]] + + At most *maxsplit* splits are done. If *maxsplit* is not specified or -1, + then there is no limit on the number of splits: + + >>> list(split_before(range(10), lambda n: n % 3 == 0, maxsplit=2)) + [[0, 1, 2], [3, 4, 5], [6, 7, 8, 9]] + """ + if maxsplit == 0: + yield list(iterable) + return + + buf = [] + it = iter(iterable) + for item in it: + if pred(item) and buf: + yield buf + if maxsplit == 1: + yield [item] + list(it) + return + buf = [] + maxsplit -= 1 + buf.append(item) + if buf: + yield buf + + +def split_after(iterable, pred, maxsplit=-1): + """Yield lists of items from *iterable*, where each list ends with an + item where callable *pred* returns ``True``: + + >>> list(split_after('one1two2', lambda s: s.isdigit())) + [['o', 'n', 'e', '1'], ['t', 'w', 'o', '2']] + + >>> list(split_after(range(10), lambda n: n % 3 == 0)) + [[0], [1, 2, 3], [4, 5, 6], [7, 8, 9]] + + At most *maxsplit* splits are done. If *maxsplit* is not specified or -1, + then there is no limit on the number of splits: + + >>> list(split_after(range(10), lambda n: n % 3 == 0, maxsplit=2)) + [[0], [1, 2, 3], [4, 5, 6, 7, 8, 9]] + + """ + if maxsplit == 0: + yield list(iterable) + return + + buf = [] + it = iter(iterable) + for item in it: + buf.append(item) + if pred(item) and buf: + yield buf + if maxsplit == 1: + buf = list(it) + if buf: + yield buf + return + buf = [] + maxsplit -= 1 + if buf: + yield buf + + +def split_when(iterable, pred, maxsplit=-1): + """Split *iterable* into pieces based on the output of *pred*. + *pred* should be a function that takes successive pairs of items and + returns ``True`` if the iterable should be split in between them. + + For example, to find runs of increasing numbers, split the iterable when + element ``i`` is larger than element ``i + 1``: + + >>> list(split_when([1, 2, 3, 3, 2, 5, 2, 4, 2], lambda x, y: x > y)) + [[1, 2, 3, 3], [2, 5], [2, 4], [2]] + + At most *maxsplit* splits are done. If *maxsplit* is not specified or -1, + then there is no limit on the number of splits: + + >>> list(split_when([1, 2, 3, 3, 2, 5, 2, 4, 2], + ... lambda x, y: x > y, maxsplit=2)) + [[1, 2, 3, 3], [2, 5], [2, 4, 2]] + + """ + if maxsplit == 0: + yield list(iterable) + return + + it = iter(iterable) + try: + cur_item = next(it) + except StopIteration: + return + + buf = [cur_item] + for next_item in it: + if pred(cur_item, next_item): + yield buf + if maxsplit == 1: + yield [next_item] + list(it) + return + buf = [] + maxsplit -= 1 + + buf.append(next_item) + cur_item = next_item + + yield buf + + +def split_into(iterable, sizes): + """Yield a list of sequential items from *iterable* of length 'n' for each + integer 'n' in *sizes*. + + >>> list(split_into([1,2,3,4,5,6], [1,2,3])) + [[1], [2, 3], [4, 5, 6]] + + If the sum of *sizes* is smaller than the length of *iterable*, then the + remaining items of *iterable* will not be returned. + + >>> list(split_into([1,2,3,4,5,6], [2,3])) + [[1, 2], [3, 4, 5]] + + If the sum of *sizes* is larger than the length of *iterable*, fewer items + will be returned in the iteration that overruns *iterable* and further + lists will be empty: + + >>> list(split_into([1,2,3,4], [1,2,3,4])) + [[1], [2, 3], [4], []] + + When a ``None`` object is encountered in *sizes*, the returned list will + contain items up to the end of *iterable* the same way that itertools.slice + does: + + >>> list(split_into([1,2,3,4,5,6,7,8,9,0], [2,3,None])) + [[1, 2], [3, 4, 5], [6, 7, 8, 9, 0]] + + :func:`split_into` can be useful for grouping a series of items where the + sizes of the groups are not uniform. An example would be where in a row + from a table, multiple columns represent elements of the same feature + (e.g. a point represented by x,y,z) but, the format is not the same for + all columns. + """ + # convert the iterable argument into an iterator so its contents can + # be consumed by islice in case it is a generator + it = iter(iterable) + + for size in sizes: + if size is None: + yield list(it) + return + else: + yield list(islice(it, size)) + + +def padded(iterable, fillvalue=None, n=None, next_multiple=False): + """Yield the elements from *iterable*, followed by *fillvalue*, such that + at least *n* items are emitted. + + >>> list(padded([1, 2, 3], '?', 5)) + [1, 2, 3, '?', '?'] + + If *next_multiple* is ``True``, *fillvalue* will be emitted until the + number of items emitted is a multiple of *n*: + + >>> list(padded([1, 2, 3, 4], n=3, next_multiple=True)) + [1, 2, 3, 4, None, None] + + If *n* is ``None``, *fillvalue* will be emitted indefinitely. + + To create an *iterable* of exactly size *n*, you can truncate with + :func:`islice`. + + >>> list(islice(padded([1, 2, 3], '?'), 5)) + [1, 2, 3, '?', '?'] + >>> list(islice(padded([1, 2, 3, 4, 5, 6, 7, 8], '?'), 5)) + [1, 2, 3, 4, 5] + + """ + iterable = iter(iterable) + iterable_with_repeat = chain(iterable, repeat(fillvalue)) + + if n is None: + return iterable_with_repeat + elif n < 1: + raise ValueError('n must be at least 1') + elif next_multiple: + + def slice_generator(): + for first in iterable: + yield (first,) + yield islice(iterable_with_repeat, n - 1) + + # While elements exist produce slices of size n + return chain.from_iterable(slice_generator()) + else: + # Ensure the first batch is at least size n then iterate + return chain(islice(iterable_with_repeat, n), iterable) + + +def repeat_each(iterable, n=2): + """Repeat each element in *iterable* *n* times. + + >>> list(repeat_each('ABC', 3)) + ['A', 'A', 'A', 'B', 'B', 'B', 'C', 'C', 'C'] + """ + return chain.from_iterable(map(repeat, iterable, repeat(n))) + + +def repeat_last(iterable, default=None): + """After the *iterable* is exhausted, keep yielding its last element. + + >>> list(islice(repeat_last(range(3)), 5)) + [0, 1, 2, 2, 2] + + If the iterable is empty, yield *default* forever:: + + >>> list(islice(repeat_last(range(0), 42), 5)) + [42, 42, 42, 42, 42] + + """ + item = _marker + for item in iterable: + yield item + final = default if item is _marker else item + yield from repeat(final) + + +def distribute(n, iterable): + """Distribute the items from *iterable* among *n* smaller iterables. + + >>> group_1, group_2 = distribute(2, [1, 2, 3, 4, 5, 6]) + >>> list(group_1) + [1, 3, 5] + >>> list(group_2) + [2, 4, 6] + + If the length of *iterable* is not evenly divisible by *n*, then the + length of the returned iterables will not be identical: + + >>> children = distribute(3, [1, 2, 3, 4, 5, 6, 7]) + >>> [list(c) for c in children] + [[1, 4, 7], [2, 5], [3, 6]] + + If the length of *iterable* is smaller than *n*, then the last returned + iterables will be empty: + + >>> children = distribute(5, [1, 2, 3]) + >>> [list(c) for c in children] + [[1], [2], [3], [], []] + + This function uses :func:`itertools.tee` and may require significant + storage. + + If you need the order items in the smaller iterables to match the + original iterable, see :func:`divide`. + + """ + if n < 1: + raise ValueError('n must be at least 1') + + children = tee(iterable, n) + return [islice(it, index, None, n) for index, it in enumerate(children)] + + +def stagger(iterable, offsets=(-1, 0, 1), longest=False, fillvalue=None): + """Yield tuples whose elements are offset from *iterable*. + The amount by which the `i`-th item in each tuple is offset is given by + the `i`-th item in *offsets*. + + >>> list(stagger([0, 1, 2, 3])) + [(None, 0, 1), (0, 1, 2), (1, 2, 3)] + >>> list(stagger(range(8), offsets=(0, 2, 4))) + [(0, 2, 4), (1, 3, 5), (2, 4, 6), (3, 5, 7)] + + By default, the sequence will end when the final element of a tuple is the + last item in the iterable. To continue until the first element of a tuple + is the last item in the iterable, set *longest* to ``True``:: + + >>> list(stagger([0, 1, 2, 3], longest=True)) + [(None, 0, 1), (0, 1, 2), (1, 2, 3), (2, 3, None), (3, None, None)] + + By default, ``None`` will be used to replace offsets beyond the end of the + sequence. Specify *fillvalue* to use some other value. + + """ + children = tee(iterable, len(offsets)) + + return zip_offset( + *children, offsets=offsets, longest=longest, fillvalue=fillvalue + ) + + +def zip_equal(*iterables): + """``zip`` the input *iterables* together, but raise + ``UnequalIterablesError`` if they aren't all the same length. + + >>> it_1 = range(3) + >>> it_2 = iter('abc') + >>> list(zip_equal(it_1, it_2)) + [(0, 'a'), (1, 'b'), (2, 'c')] + + >>> it_1 = range(3) + >>> it_2 = iter('abcd') + >>> list(zip_equal(it_1, it_2)) # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + ... + more_itertools.more.UnequalIterablesError: Iterables have different + lengths + + """ + if hexversion >= 0x30A00A6: + warnings.warn( + ( + 'zip_equal will be removed in a future version of ' + 'more-itertools. Use the builtin zip function with ' + 'strict=True instead.' + ), + DeprecationWarning, + ) + + return _zip_equal(*iterables) + + +def zip_offset(*iterables, offsets, longest=False, fillvalue=None): + """``zip`` the input *iterables* together, but offset the `i`-th iterable + by the `i`-th item in *offsets*. + + >>> list(zip_offset('0123', 'abcdef', offsets=(0, 1))) + [('0', 'b'), ('1', 'c'), ('2', 'd'), ('3', 'e')] + + This can be used as a lightweight alternative to SciPy or pandas to analyze + data sets in which some series have a lead or lag relationship. + + By default, the sequence will end when the shortest iterable is exhausted. + To continue until the longest iterable is exhausted, set *longest* to + ``True``. + + >>> list(zip_offset('0123', 'abcdef', offsets=(0, 1), longest=True)) + [('0', 'b'), ('1', 'c'), ('2', 'd'), ('3', 'e'), (None, 'f')] + + By default, ``None`` will be used to replace offsets beyond the end of the + sequence. Specify *fillvalue* to use some other value. + + """ + if len(iterables) != len(offsets): + raise ValueError("Number of iterables and offsets didn't match") + + staggered = [] + for it, n in zip(iterables, offsets): + if n < 0: + staggered.append(chain(repeat(fillvalue, -n), it)) + elif n > 0: + staggered.append(islice(it, n, None)) + else: + staggered.append(it) + + if longest: + return zip_longest(*staggered, fillvalue=fillvalue) + + return zip(*staggered) + + +def sort_together(iterables, key_list=(0,), key=None, reverse=False): + """Return the input iterables sorted together, with *key_list* as the + priority for sorting. All iterables are trimmed to the length of the + shortest one. + + This can be used like the sorting function in a spreadsheet. If each + iterable represents a column of data, the key list determines which + columns are used for sorting. + + By default, all iterables are sorted using the ``0``-th iterable:: + + >>> iterables = [(4, 3, 2, 1), ('a', 'b', 'c', 'd')] + >>> sort_together(iterables) + [(1, 2, 3, 4), ('d', 'c', 'b', 'a')] + + Set a different key list to sort according to another iterable. + Specifying multiple keys dictates how ties are broken:: + + >>> iterables = [(3, 1, 2), (0, 1, 0), ('c', 'b', 'a')] + >>> sort_together(iterables, key_list=(1, 2)) + [(2, 3, 1), (0, 0, 1), ('a', 'c', 'b')] + + To sort by a function of the elements of the iterable, pass a *key* + function. Its arguments are the elements of the iterables corresponding to + the key list:: + + >>> names = ('a', 'b', 'c') + >>> lengths = (1, 2, 3) + >>> widths = (5, 2, 1) + >>> def area(length, width): + ... return length * width + >>> sort_together([names, lengths, widths], key_list=(1, 2), key=area) + [('c', 'b', 'a'), (3, 2, 1), (1, 2, 5)] + + Set *reverse* to ``True`` to sort in descending order. + + >>> sort_together([(1, 2, 3), ('c', 'b', 'a')], reverse=True) + [(3, 2, 1), ('a', 'b', 'c')] + + """ + if key is None: + # if there is no key function, the key argument to sorted is an + # itemgetter + key_argument = itemgetter(*key_list) + else: + # if there is a key function, call it with the items at the offsets + # specified by the key function as arguments + key_list = list(key_list) + if len(key_list) == 1: + # if key_list contains a single item, pass the item at that offset + # as the only argument to the key function + key_offset = key_list[0] + key_argument = lambda zipped_items: key(zipped_items[key_offset]) + else: + # if key_list contains multiple items, use itemgetter to return a + # tuple of items, which we pass as *args to the key function + get_key_items = itemgetter(*key_list) + key_argument = lambda zipped_items: key( + *get_key_items(zipped_items) + ) + + return list( + zip(*sorted(zip(*iterables), key=key_argument, reverse=reverse)) + ) + + +def unzip(iterable): + """The inverse of :func:`zip`, this function disaggregates the elements + of the zipped *iterable*. + + The ``i``-th iterable contains the ``i``-th element from each element + of the zipped iterable. The first element is used to determine the + length of the remaining elements. + + >>> iterable = [('a', 1), ('b', 2), ('c', 3), ('d', 4)] + >>> letters, numbers = unzip(iterable) + >>> list(letters) + ['a', 'b', 'c', 'd'] + >>> list(numbers) + [1, 2, 3, 4] + + This is similar to using ``zip(*iterable)``, but it avoids reading + *iterable* into memory. Note, however, that this function uses + :func:`itertools.tee` and thus may require significant storage. + + """ + head, iterable = spy(iter(iterable)) + if not head: + # empty iterable, e.g. zip([], [], []) + return () + # spy returns a one-length iterable as head + head = head[0] + iterables = tee(iterable, len(head)) + + def itemgetter(i): + def getter(obj): + try: + return obj[i] + except IndexError: + # basically if we have an iterable like + # iter([(1, 2, 3), (4, 5), (6,)]) + # the second unzipped iterable would fail at the third tuple + # since it would try to access tup[1] + # same with the third unzipped iterable and the second tuple + # to support these "improperly zipped" iterables, + # we create a custom itemgetter + # which just stops the unzipped iterables + # at first length mismatch + raise StopIteration + + return getter + + return tuple(map(itemgetter(i), it) for i, it in enumerate(iterables)) + + +def divide(n, iterable): + """Divide the elements from *iterable* into *n* parts, maintaining + order. + + >>> group_1, group_2 = divide(2, [1, 2, 3, 4, 5, 6]) + >>> list(group_1) + [1, 2, 3] + >>> list(group_2) + [4, 5, 6] + + If the length of *iterable* is not evenly divisible by *n*, then the + length of the returned iterables will not be identical: + + >>> children = divide(3, [1, 2, 3, 4, 5, 6, 7]) + >>> [list(c) for c in children] + [[1, 2, 3], [4, 5], [6, 7]] + + If the length of the iterable is smaller than n, then the last returned + iterables will be empty: + + >>> children = divide(5, [1, 2, 3]) + >>> [list(c) for c in children] + [[1], [2], [3], [], []] + + This function will exhaust the iterable before returning. + If order is not important, see :func:`distribute`, which does not first + pull the iterable into memory. + + """ + if n < 1: + raise ValueError('n must be at least 1') + + try: + iterable[:0] + except TypeError: + seq = tuple(iterable) + else: + seq = iterable + + q, r = divmod(len(seq), n) + + ret = [] + stop = 0 + for i in range(1, n + 1): + start = stop + stop += q + 1 if i <= r else q + ret.append(iter(seq[start:stop])) + + return ret + + +def always_iterable(obj, base_type=(str, bytes)): + """If *obj* is iterable, return an iterator over its items:: + + >>> obj = (1, 2, 3) + >>> list(always_iterable(obj)) + [1, 2, 3] + + If *obj* is not iterable, return a one-item iterable containing *obj*:: + + >>> obj = 1 + >>> list(always_iterable(obj)) + [1] + + If *obj* is ``None``, return an empty iterable: + + >>> obj = None + >>> list(always_iterable(None)) + [] + + By default, binary and text strings are not considered iterable:: + + >>> obj = 'foo' + >>> list(always_iterable(obj)) + ['foo'] + + If *base_type* is set, objects for which ``isinstance(obj, base_type)`` + returns ``True`` won't be considered iterable. + + >>> obj = {'a': 1} + >>> list(always_iterable(obj)) # Iterate over the dict's keys + ['a'] + >>> list(always_iterable(obj, base_type=dict)) # Treat dicts as a unit + [{'a': 1}] + + Set *base_type* to ``None`` to avoid any special handling and treat objects + Python considers iterable as iterable: + + >>> obj = 'foo' + >>> list(always_iterable(obj, base_type=None)) + ['f', 'o', 'o'] + """ + if obj is None: + return iter(()) + + if (base_type is not None) and isinstance(obj, base_type): + return iter((obj,)) + + try: + return iter(obj) + except TypeError: + return iter((obj,)) + + +def adjacent(predicate, iterable, distance=1): + """Return an iterable over `(bool, item)` tuples where the `item` is + drawn from *iterable* and the `bool` indicates whether + that item satisfies the *predicate* or is adjacent to an item that does. + + For example, to find whether items are adjacent to a ``3``:: + + >>> list(adjacent(lambda x: x == 3, range(6))) + [(False, 0), (False, 1), (True, 2), (True, 3), (True, 4), (False, 5)] + + Set *distance* to change what counts as adjacent. For example, to find + whether items are two places away from a ``3``: + + >>> list(adjacent(lambda x: x == 3, range(6), distance=2)) + [(False, 0), (True, 1), (True, 2), (True, 3), (True, 4), (True, 5)] + + This is useful for contextualizing the results of a search function. + For example, a code comparison tool might want to identify lines that + have changed, but also surrounding lines to give the viewer of the diff + context. + + The predicate function will only be called once for each item in the + iterable. + + See also :func:`groupby_transform`, which can be used with this function + to group ranges of items with the same `bool` value. + + """ + # Allow distance=0 mainly for testing that it reproduces results with map() + if distance < 0: + raise ValueError('distance must be at least 0') + + i1, i2 = tee(iterable) + padding = [False] * distance + selected = chain(padding, map(predicate, i1), padding) + adjacent_to_selected = map(any, windowed(selected, 2 * distance + 1)) + return zip(adjacent_to_selected, i2) + + +def groupby_transform(iterable, keyfunc=None, valuefunc=None, reducefunc=None): + """An extension of :func:`itertools.groupby` that can apply transformations + to the grouped data. + + * *keyfunc* is a function computing a key value for each item in *iterable* + * *valuefunc* is a function that transforms the individual items from + *iterable* after grouping + * *reducefunc* is a function that transforms each group of items + + >>> iterable = 'aAAbBBcCC' + >>> keyfunc = lambda k: k.upper() + >>> valuefunc = lambda v: v.lower() + >>> reducefunc = lambda g: ''.join(g) + >>> list(groupby_transform(iterable, keyfunc, valuefunc, reducefunc)) + [('A', 'aaa'), ('B', 'bbb'), ('C', 'ccc')] + + Each optional argument defaults to an identity function if not specified. + + :func:`groupby_transform` is useful when grouping elements of an iterable + using a separate iterable as the key. To do this, :func:`zip` the iterables + and pass a *keyfunc* that extracts the first element and a *valuefunc* + that extracts the second element:: + + >>> from operator import itemgetter + >>> keys = [0, 0, 1, 1, 1, 2, 2, 2, 3] + >>> values = 'abcdefghi' + >>> iterable = zip(keys, values) + >>> grouper = groupby_transform(iterable, itemgetter(0), itemgetter(1)) + >>> [(k, ''.join(g)) for k, g in grouper] + [(0, 'ab'), (1, 'cde'), (2, 'fgh'), (3, 'i')] + + Note that the order of items in the iterable is significant. + Only adjacent items are grouped together, so if you don't want any + duplicate groups, you should sort the iterable by the key function. + + """ + ret = groupby(iterable, keyfunc) + if valuefunc: + ret = ((k, map(valuefunc, g)) for k, g in ret) + if reducefunc: + ret = ((k, reducefunc(g)) for k, g in ret) + + return ret + + +class numeric_range(abc.Sequence, abc.Hashable): + """An extension of the built-in ``range()`` function whose arguments can + be any orderable numeric type. + + With only *stop* specified, *start* defaults to ``0`` and *step* + defaults to ``1``. The output items will match the type of *stop*: + + >>> list(numeric_range(3.5)) + [0.0, 1.0, 2.0, 3.0] + + With only *start* and *stop* specified, *step* defaults to ``1``. The + output items will match the type of *start*: + + >>> from decimal import Decimal + >>> start = Decimal('2.1') + >>> stop = Decimal('5.1') + >>> list(numeric_range(start, stop)) + [Decimal('2.1'), Decimal('3.1'), Decimal('4.1')] + + With *start*, *stop*, and *step* specified the output items will match + the type of ``start + step``: + + >>> from fractions import Fraction + >>> start = Fraction(1, 2) # Start at 1/2 + >>> stop = Fraction(5, 2) # End at 5/2 + >>> step = Fraction(1, 2) # Count by 1/2 + >>> list(numeric_range(start, stop, step)) + [Fraction(1, 2), Fraction(1, 1), Fraction(3, 2), Fraction(2, 1)] + + If *step* is zero, ``ValueError`` is raised. Negative steps are supported: + + >>> list(numeric_range(3, -1, -1.0)) + [3.0, 2.0, 1.0, 0.0] + + Be aware of the limitations of floating point numbers; the representation + of the yielded numbers may be surprising. + + ``datetime.datetime`` objects can be used for *start* and *stop*, if *step* + is a ``datetime.timedelta`` object: + + >>> import datetime + >>> start = datetime.datetime(2019, 1, 1) + >>> stop = datetime.datetime(2019, 1, 3) + >>> step = datetime.timedelta(days=1) + >>> items = iter(numeric_range(start, stop, step)) + >>> next(items) + datetime.datetime(2019, 1, 1, 0, 0) + >>> next(items) + datetime.datetime(2019, 1, 2, 0, 0) + + """ + + _EMPTY_HASH = hash(range(0, 0)) + + def __init__(self, *args): + argc = len(args) + if argc == 1: + (self._stop,) = args + self._start = type(self._stop)(0) + self._step = type(self._stop - self._start)(1) + elif argc == 2: + self._start, self._stop = args + self._step = type(self._stop - self._start)(1) + elif argc == 3: + self._start, self._stop, self._step = args + elif argc == 0: + raise TypeError( + 'numeric_range expected at least ' + '1 argument, got {}'.format(argc) + ) + else: + raise TypeError( + 'numeric_range expected at most ' + '3 arguments, got {}'.format(argc) + ) + + self._zero = type(self._step)(0) + if self._step == self._zero: + raise ValueError('numeric_range() arg 3 must not be zero') + self._growing = self._step > self._zero + + def __bool__(self): + if self._growing: + return self._start < self._stop + else: + return self._start > self._stop + + def __contains__(self, elem): + if self._growing: + if self._start <= elem < self._stop: + return (elem - self._start) % self._step == self._zero + else: + if self._start >= elem > self._stop: + return (self._start - elem) % (-self._step) == self._zero + + return False + + def __eq__(self, other): + if isinstance(other, numeric_range): + empty_self = not bool(self) + empty_other = not bool(other) + if empty_self or empty_other: + return empty_self and empty_other # True if both empty + else: + return ( + self._start == other._start + and self._step == other._step + and self._get_by_index(-1) == other._get_by_index(-1) + ) + else: + return False + + def __getitem__(self, key): + if isinstance(key, int): + return self._get_by_index(key) + elif isinstance(key, slice): + step = self._step if key.step is None else key.step * self._step + + if key.start is None or key.start <= -self._len: + start = self._start + elif key.start >= self._len: + start = self._stop + else: # -self._len < key.start < self._len + start = self._get_by_index(key.start) + + if key.stop is None or key.stop >= self._len: + stop = self._stop + elif key.stop <= -self._len: + stop = self._start + else: # -self._len < key.stop < self._len + stop = self._get_by_index(key.stop) + + return numeric_range(start, stop, step) + else: + raise TypeError( + 'numeric range indices must be ' + 'integers or slices, not {}'.format(type(key).__name__) + ) + + def __hash__(self): + if self: + return hash((self._start, self._get_by_index(-1), self._step)) + else: + return self._EMPTY_HASH + + def __iter__(self): + values = (self._start + (n * self._step) for n in count()) + if self._growing: + return takewhile(partial(gt, self._stop), values) + else: + return takewhile(partial(lt, self._stop), values) + + def __len__(self): + return self._len + + @cached_property + def _len(self): + if self._growing: + start = self._start + stop = self._stop + step = self._step + else: + start = self._stop + stop = self._start + step = -self._step + distance = stop - start + if distance <= self._zero: + return 0 + else: # distance > 0 and step > 0: regular euclidean division + q, r = divmod(distance, step) + return int(q) + int(r != self._zero) + + def __reduce__(self): + return numeric_range, (self._start, self._stop, self._step) + + def __repr__(self): + if self._step == 1: + return "numeric_range({}, {})".format( + repr(self._start), repr(self._stop) + ) + else: + return "numeric_range({}, {}, {})".format( + repr(self._start), repr(self._stop), repr(self._step) + ) + + def __reversed__(self): + return iter( + numeric_range( + self._get_by_index(-1), self._start - self._step, -self._step + ) + ) + + def count(self, value): + return int(value in self) + + def index(self, value): + if self._growing: + if self._start <= value < self._stop: + q, r = divmod(value - self._start, self._step) + if r == self._zero: + return int(q) + else: + if self._start >= value > self._stop: + q, r = divmod(self._start - value, -self._step) + if r == self._zero: + return int(q) + + raise ValueError("{} is not in numeric range".format(value)) + + def _get_by_index(self, i): + if i < 0: + i += self._len + if i < 0 or i >= self._len: + raise IndexError("numeric range object index out of range") + return self._start + i * self._step + + +def count_cycle(iterable, n=None): + """Cycle through the items from *iterable* up to *n* times, yielding + the number of completed cycles along with each item. If *n* is omitted the + process repeats indefinitely. + + >>> list(count_cycle('AB', 3)) + [(0, 'A'), (0, 'B'), (1, 'A'), (1, 'B'), (2, 'A'), (2, 'B')] + + """ + iterable = tuple(iterable) + if not iterable: + return iter(()) + counter = count() if n is None else range(n) + return ((i, item) for i in counter for item in iterable) + + +def mark_ends(iterable): + """Yield 3-tuples of the form ``(is_first, is_last, item)``. + + >>> list(mark_ends('ABC')) + [(True, False, 'A'), (False, False, 'B'), (False, True, 'C')] + + Use this when looping over an iterable to take special action on its first + and/or last items: + + >>> iterable = ['Header', 100, 200, 'Footer'] + >>> total = 0 + >>> for is_first, is_last, item in mark_ends(iterable): + ... if is_first: + ... continue # Skip the header + ... if is_last: + ... continue # Skip the footer + ... total += item + >>> print(total) + 300 + """ + it = iter(iterable) + + try: + b = next(it) + except StopIteration: + return + + try: + for i in count(): + a = b + b = next(it) + yield i == 0, False, a + + except StopIteration: + yield i == 0, True, a + + +def locate(iterable, pred=bool, window_size=None): + """Yield the index of each item in *iterable* for which *pred* returns + ``True``. + + *pred* defaults to :func:`bool`, which will select truthy items: + + >>> list(locate([0, 1, 1, 0, 1, 0, 0])) + [1, 2, 4] + + Set *pred* to a custom function to, e.g., find the indexes for a particular + item. + + >>> list(locate(['a', 'b', 'c', 'b'], lambda x: x == 'b')) + [1, 3] + + If *window_size* is given, then the *pred* function will be called with + that many items. This enables searching for sub-sequences: + + >>> iterable = [0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3] + >>> pred = lambda *args: args == (1, 2, 3) + >>> list(locate(iterable, pred=pred, window_size=3)) + [1, 5, 9] + + Use with :func:`seekable` to find indexes and then retrieve the associated + items: + + >>> from itertools import count + >>> from more_itertools import seekable + >>> source = (3 * n + 1 if (n % 2) else n // 2 for n in count()) + >>> it = seekable(source) + >>> pred = lambda x: x > 100 + >>> indexes = locate(it, pred=pred) + >>> i = next(indexes) + >>> it.seek(i) + >>> next(it) + 106 + + """ + if window_size is None: + return compress(count(), map(pred, iterable)) + + if window_size < 1: + raise ValueError('window size must be at least 1') + + it = windowed(iterable, window_size, fillvalue=_marker) + return compress(count(), starmap(pred, it)) + + +def longest_common_prefix(iterables): + """Yield elements of the longest common prefix amongst given *iterables*. + + >>> ''.join(longest_common_prefix(['abcd', 'abc', 'abf'])) + 'ab' + + """ + return (c[0] for c in takewhile(all_equal, zip(*iterables))) + + +def lstrip(iterable, pred): + """Yield the items from *iterable*, but strip any from the beginning + for which *pred* returns ``True``. + + For example, to remove a set of items from the start of an iterable: + + >>> iterable = (None, False, None, 1, 2, None, 3, False, None) + >>> pred = lambda x: x in {None, False, ''} + >>> list(lstrip(iterable, pred)) + [1, 2, None, 3, False, None] + + This function is analogous to to :func:`str.lstrip`, and is essentially + an wrapper for :func:`itertools.dropwhile`. + + """ + return dropwhile(pred, iterable) + + +def rstrip(iterable, pred): + """Yield the items from *iterable*, but strip any from the end + for which *pred* returns ``True``. + + For example, to remove a set of items from the end of an iterable: + + >>> iterable = (None, False, None, 1, 2, None, 3, False, None) + >>> pred = lambda x: x in {None, False, ''} + >>> list(rstrip(iterable, pred)) + [None, False, None, 1, 2, None, 3] + + This function is analogous to :func:`str.rstrip`. + + """ + cache = [] + cache_append = cache.append + cache_clear = cache.clear + for x in iterable: + if pred(x): + cache_append(x) + else: + yield from cache + cache_clear() + yield x + + +def strip(iterable, pred): + """Yield the items from *iterable*, but strip any from the + beginning and end for which *pred* returns ``True``. + + For example, to remove a set of items from both ends of an iterable: + + >>> iterable = (None, False, None, 1, 2, None, 3, False, None) + >>> pred = lambda x: x in {None, False, ''} + >>> list(strip(iterable, pred)) + [1, 2, None, 3] + + This function is analogous to :func:`str.strip`. + + """ + return rstrip(lstrip(iterable, pred), pred) + + +class islice_extended: + """An extension of :func:`itertools.islice` that supports negative values + for *stop*, *start*, and *step*. + + >>> iterable = iter('abcdefgh') + >>> list(islice_extended(iterable, -4, -1)) + ['e', 'f', 'g'] + + Slices with negative values require some caching of *iterable*, but this + function takes care to minimize the amount of memory required. + + For example, you can use a negative step with an infinite iterator: + + >>> from itertools import count + >>> list(islice_extended(count(), 110, 99, -2)) + [110, 108, 106, 104, 102, 100] + + You can also use slice notation directly: + + >>> iterable = map(str, count()) + >>> it = islice_extended(iterable)[10:20:2] + >>> list(it) + ['10', '12', '14', '16', '18'] + + """ + + def __init__(self, iterable, *args): + it = iter(iterable) + if args: + self._iterable = _islice_helper(it, slice(*args)) + else: + self._iterable = it + + def __iter__(self): + return self + + def __next__(self): + return next(self._iterable) + + def __getitem__(self, key): + if isinstance(key, slice): + return islice_extended(_islice_helper(self._iterable, key)) + + raise TypeError('islice_extended.__getitem__ argument must be a slice') + + +def _islice_helper(it, s): + start = s.start + stop = s.stop + if s.step == 0: + raise ValueError('step argument must be a non-zero integer or None.') + step = s.step or 1 + + if step > 0: + start = 0 if (start is None) else start + + if start < 0: + # Consume all but the last -start items + cache = deque(enumerate(it, 1), maxlen=-start) + len_iter = cache[-1][0] if cache else 0 + + # Adjust start to be positive + i = max(len_iter + start, 0) + + # Adjust stop to be positive + if stop is None: + j = len_iter + elif stop >= 0: + j = min(stop, len_iter) + else: + j = max(len_iter + stop, 0) + + # Slice the cache + n = j - i + if n <= 0: + return + + for index, item in islice(cache, 0, n, step): + yield item + elif (stop is not None) and (stop < 0): + # Advance to the start position + next(islice(it, start, start), None) + + # When stop is negative, we have to carry -stop items while + # iterating + cache = deque(islice(it, -stop), maxlen=-stop) + + for index, item in enumerate(it): + cached_item = cache.popleft() + if index % step == 0: + yield cached_item + cache.append(item) + else: + # When both start and stop are positive we have the normal case + yield from islice(it, start, stop, step) + else: + start = -1 if (start is None) else start + + if (stop is not None) and (stop < 0): + # Consume all but the last items + n = -stop - 1 + cache = deque(enumerate(it, 1), maxlen=n) + len_iter = cache[-1][0] if cache else 0 + + # If start and stop are both negative they are comparable and + # we can just slice. Otherwise we can adjust start to be negative + # and then slice. + if start < 0: + i, j = start, stop + else: + i, j = min(start - len_iter, -1), None + + for index, item in list(cache)[i:j:step]: + yield item + else: + # Advance to the stop position + if stop is not None: + m = stop + 1 + next(islice(it, m, m), None) + + # stop is positive, so if start is negative they are not comparable + # and we need the rest of the items. + if start < 0: + i = start + n = None + # stop is None and start is positive, so we just need items up to + # the start index. + elif stop is None: + i = None + n = start + 1 + # Both stop and start are positive, so they are comparable. + else: + i = None + n = start - stop + if n <= 0: + return + + cache = list(islice(it, n)) + + yield from cache[i::step] + + +def always_reversible(iterable): + """An extension of :func:`reversed` that supports all iterables, not + just those which implement the ``Reversible`` or ``Sequence`` protocols. + + >>> print(*always_reversible(x for x in range(3))) + 2 1 0 + + If the iterable is already reversible, this function returns the + result of :func:`reversed()`. If the iterable is not reversible, + this function will cache the remaining items in the iterable and + yield them in reverse order, which may require significant storage. + """ + try: + return reversed(iterable) + except TypeError: + return reversed(list(iterable)) + + +def consecutive_groups(iterable, ordering=lambda x: x): + """Yield groups of consecutive items using :func:`itertools.groupby`. + The *ordering* function determines whether two items are adjacent by + returning their position. + + By default, the ordering function is the identity function. This is + suitable for finding runs of numbers: + + >>> iterable = [1, 10, 11, 12, 20, 30, 31, 32, 33, 40] + >>> for group in consecutive_groups(iterable): + ... print(list(group)) + [1] + [10, 11, 12] + [20] + [30, 31, 32, 33] + [40] + + For finding runs of adjacent letters, try using the :meth:`index` method + of a string of letters: + + >>> from string import ascii_lowercase + >>> iterable = 'abcdfgilmnop' + >>> ordering = ascii_lowercase.index + >>> for group in consecutive_groups(iterable, ordering): + ... print(list(group)) + ['a', 'b', 'c', 'd'] + ['f', 'g'] + ['i'] + ['l', 'm', 'n', 'o', 'p'] + + Each group of consecutive items is an iterator that shares it source with + *iterable*. When an an output group is advanced, the previous group is + no longer available unless its elements are copied (e.g., into a ``list``). + + >>> iterable = [1, 2, 11, 12, 21, 22] + >>> saved_groups = [] + >>> for group in consecutive_groups(iterable): + ... saved_groups.append(list(group)) # Copy group elements + >>> saved_groups + [[1, 2], [11, 12], [21, 22]] + + """ + for k, g in groupby( + enumerate(iterable), key=lambda x: x[0] - ordering(x[1]) + ): + yield map(itemgetter(1), g) + + +def difference(iterable, func=sub, *, initial=None): + """This function is the inverse of :func:`itertools.accumulate`. By default + it will compute the first difference of *iterable* using + :func:`operator.sub`: + + >>> from itertools import accumulate + >>> iterable = accumulate([0, 1, 2, 3, 4]) # produces 0, 1, 3, 6, 10 + >>> list(difference(iterable)) + [0, 1, 2, 3, 4] + + *func* defaults to :func:`operator.sub`, but other functions can be + specified. They will be applied as follows:: + + A, B, C, D, ... --> A, func(B, A), func(C, B), func(D, C), ... + + For example, to do progressive division: + + >>> iterable = [1, 2, 6, 24, 120] + >>> func = lambda x, y: x // y + >>> list(difference(iterable, func)) + [1, 2, 3, 4, 5] + + If the *initial* keyword is set, the first element will be skipped when + computing successive differences. + + >>> it = [10, 11, 13, 16] # from accumulate([1, 2, 3], initial=10) + >>> list(difference(it, initial=10)) + [1, 2, 3] + + """ + a, b = tee(iterable) + try: + first = [next(b)] + except StopIteration: + return iter([]) + + if initial is not None: + first = [] + + return chain(first, map(func, b, a)) + + +class SequenceView(Sequence): + """Return a read-only view of the sequence object *target*. + + :class:`SequenceView` objects are analogous to Python's built-in + "dictionary view" types. They provide a dynamic view of a sequence's items, + meaning that when the sequence updates, so does the view. + + >>> seq = ['0', '1', '2'] + >>> view = SequenceView(seq) + >>> view + SequenceView(['0', '1', '2']) + >>> seq.append('3') + >>> view + SequenceView(['0', '1', '2', '3']) + + Sequence views support indexing, slicing, and length queries. They act + like the underlying sequence, except they don't allow assignment: + + >>> view[1] + '1' + >>> view[1:-1] + ['1', '2'] + >>> len(view) + 4 + + Sequence views are useful as an alternative to copying, as they don't + require (much) extra storage. + + """ + + def __init__(self, target): + if not isinstance(target, Sequence): + raise TypeError + self._target = target + + def __getitem__(self, index): + return self._target[index] + + def __len__(self): + return len(self._target) + + def __repr__(self): + return '{}({})'.format(self.__class__.__name__, repr(self._target)) + + +class seekable: + """Wrap an iterator to allow for seeking backward and forward. This + progressively caches the items in the source iterable so they can be + re-visited. + + Call :meth:`seek` with an index to seek to that position in the source + iterable. + + To "reset" an iterator, seek to ``0``: + + >>> from itertools import count + >>> it = seekable((str(n) for n in count())) + >>> next(it), next(it), next(it) + ('0', '1', '2') + >>> it.seek(0) + >>> next(it), next(it), next(it) + ('0', '1', '2') + >>> next(it) + '3' + + You can also seek forward: + + >>> it = seekable((str(n) for n in range(20))) + >>> it.seek(10) + >>> next(it) + '10' + >>> it.relative_seek(-2) # Seeking relative to the current position + >>> next(it) + '9' + >>> it.seek(20) # Seeking past the end of the source isn't a problem + >>> list(it) + [] + >>> it.seek(0) # Resetting works even after hitting the end + >>> next(it), next(it), next(it) + ('0', '1', '2') + + Call :meth:`peek` to look ahead one item without advancing the iterator: + + >>> it = seekable('1234') + >>> it.peek() + '1' + >>> list(it) + ['1', '2', '3', '4'] + >>> it.peek(default='empty') + 'empty' + + Before the iterator is at its end, calling :func:`bool` on it will return + ``True``. After it will return ``False``: + + >>> it = seekable('5678') + >>> bool(it) + True + >>> list(it) + ['5', '6', '7', '8'] + >>> bool(it) + False + + You may view the contents of the cache with the :meth:`elements` method. + That returns a :class:`SequenceView`, a view that updates automatically: + + >>> it = seekable((str(n) for n in range(10))) + >>> next(it), next(it), next(it) + ('0', '1', '2') + >>> elements = it.elements() + >>> elements + SequenceView(['0', '1', '2']) + >>> next(it) + '3' + >>> elements + SequenceView(['0', '1', '2', '3']) + + By default, the cache grows as the source iterable progresses, so beware of + wrapping very large or infinite iterables. Supply *maxlen* to limit the + size of the cache (this of course limits how far back you can seek). + + >>> from itertools import count + >>> it = seekable((str(n) for n in count()), maxlen=2) + >>> next(it), next(it), next(it), next(it) + ('0', '1', '2', '3') + >>> list(it.elements()) + ['2', '3'] + >>> it.seek(0) + >>> next(it), next(it), next(it), next(it) + ('2', '3', '4', '5') + >>> next(it) + '6' + + """ + + def __init__(self, iterable, maxlen=None): + self._source = iter(iterable) + if maxlen is None: + self._cache = [] + else: + self._cache = deque([], maxlen) + self._index = None + + def __iter__(self): + return self + + def __next__(self): + if self._index is not None: + try: + item = self._cache[self._index] + except IndexError: + self._index = None + else: + self._index += 1 + return item + + item = next(self._source) + self._cache.append(item) + return item + + def __bool__(self): + try: + self.peek() + except StopIteration: + return False + return True + + def peek(self, default=_marker): + try: + peeked = next(self) + except StopIteration: + if default is _marker: + raise + return default + if self._index is None: + self._index = len(self._cache) + self._index -= 1 + return peeked + + def elements(self): + return SequenceView(self._cache) + + def seek(self, index): + self._index = index + remainder = index - len(self._cache) + if remainder > 0: + consume(self, remainder) + + def relative_seek(self, count): + index = len(self._cache) + self.seek(max(index + count, 0)) + + +class run_length: + """ + :func:`run_length.encode` compresses an iterable with run-length encoding. + It yields groups of repeated items with the count of how many times they + were repeated: + + >>> uncompressed = 'abbcccdddd' + >>> list(run_length.encode(uncompressed)) + [('a', 1), ('b', 2), ('c', 3), ('d', 4)] + + :func:`run_length.decode` decompresses an iterable that was previously + compressed with run-length encoding. It yields the items of the + decompressed iterable: + + >>> compressed = [('a', 1), ('b', 2), ('c', 3), ('d', 4)] + >>> list(run_length.decode(compressed)) + ['a', 'b', 'b', 'c', 'c', 'c', 'd', 'd', 'd', 'd'] + + """ + + @staticmethod + def encode(iterable): + return ((k, ilen(g)) for k, g in groupby(iterable)) + + @staticmethod + def decode(iterable): + return chain.from_iterable(repeat(k, n) for k, n in iterable) + + +def exactly_n(iterable, n, predicate=bool): + """Return ``True`` if exactly ``n`` items in the iterable are ``True`` + according to the *predicate* function. + + >>> exactly_n([True, True, False], 2) + True + >>> exactly_n([True, True, False], 1) + False + >>> exactly_n([0, 1, 2, 3, 4, 5], 3, lambda x: x < 3) + True + + The iterable will be advanced until ``n + 1`` truthy items are encountered, + so avoid calling it on infinite iterables. + + """ + return len(take(n + 1, filter(predicate, iterable))) == n + + +def circular_shifts(iterable): + """Return a list of circular shifts of *iterable*. + + >>> circular_shifts(range(4)) + [(0, 1, 2, 3), (1, 2, 3, 0), (2, 3, 0, 1), (3, 0, 1, 2)] + """ + lst = list(iterable) + return take(len(lst), windowed(cycle(lst), len(lst))) + + +def make_decorator(wrapping_func, result_index=0): + """Return a decorator version of *wrapping_func*, which is a function that + modifies an iterable. *result_index* is the position in that function's + signature where the iterable goes. + + This lets you use itertools on the "production end," i.e. at function + definition. This can augment what the function returns without changing the + function's code. + + For example, to produce a decorator version of :func:`chunked`: + + >>> from more_itertools import chunked + >>> chunker = make_decorator(chunked, result_index=0) + >>> @chunker(3) + ... def iter_range(n): + ... return iter(range(n)) + ... + >>> list(iter_range(9)) + [[0, 1, 2], [3, 4, 5], [6, 7, 8]] + + To only allow truthy items to be returned: + + >>> truth_serum = make_decorator(filter, result_index=1) + >>> @truth_serum(bool) + ... def boolean_test(): + ... return [0, 1, '', ' ', False, True] + ... + >>> list(boolean_test()) + [1, ' ', True] + + The :func:`peekable` and :func:`seekable` wrappers make for practical + decorators: + + >>> from more_itertools import peekable + >>> peekable_function = make_decorator(peekable) + >>> @peekable_function() + ... def str_range(*args): + ... return (str(x) for x in range(*args)) + ... + >>> it = str_range(1, 20, 2) + >>> next(it), next(it), next(it) + ('1', '3', '5') + >>> it.peek() + '7' + >>> next(it) + '7' + + """ + + # See https://sites.google.com/site/bbayles/index/decorator_factory for + # notes on how this works. + def decorator(*wrapping_args, **wrapping_kwargs): + def outer_wrapper(f): + def inner_wrapper(*args, **kwargs): + result = f(*args, **kwargs) + wrapping_args_ = list(wrapping_args) + wrapping_args_.insert(result_index, result) + return wrapping_func(*wrapping_args_, **wrapping_kwargs) + + return inner_wrapper + + return outer_wrapper + + return decorator + + +def map_reduce(iterable, keyfunc, valuefunc=None, reducefunc=None): + """Return a dictionary that maps the items in *iterable* to categories + defined by *keyfunc*, transforms them with *valuefunc*, and + then summarizes them by category with *reducefunc*. + + *valuefunc* defaults to the identity function if it is unspecified. + If *reducefunc* is unspecified, no summarization takes place: + + >>> keyfunc = lambda x: x.upper() + >>> result = map_reduce('abbccc', keyfunc) + >>> sorted(result.items()) + [('A', ['a']), ('B', ['b', 'b']), ('C', ['c', 'c', 'c'])] + + Specifying *valuefunc* transforms the categorized items: + + >>> keyfunc = lambda x: x.upper() + >>> valuefunc = lambda x: 1 + >>> result = map_reduce('abbccc', keyfunc, valuefunc) + >>> sorted(result.items()) + [('A', [1]), ('B', [1, 1]), ('C', [1, 1, 1])] + + Specifying *reducefunc* summarizes the categorized items: + + >>> keyfunc = lambda x: x.upper() + >>> valuefunc = lambda x: 1 + >>> reducefunc = sum + >>> result = map_reduce('abbccc', keyfunc, valuefunc, reducefunc) + >>> sorted(result.items()) + [('A', 1), ('B', 2), ('C', 3)] + + You may want to filter the input iterable before applying the map/reduce + procedure: + + >>> all_items = range(30) + >>> items = [x for x in all_items if 10 <= x <= 20] # Filter + >>> keyfunc = lambda x: x % 2 # Evens map to 0; odds to 1 + >>> categories = map_reduce(items, keyfunc=keyfunc) + >>> sorted(categories.items()) + [(0, [10, 12, 14, 16, 18, 20]), (1, [11, 13, 15, 17, 19])] + >>> summaries = map_reduce(items, keyfunc=keyfunc, reducefunc=sum) + >>> sorted(summaries.items()) + [(0, 90), (1, 75)] + + Note that all items in the iterable are gathered into a list before the + summarization step, which may require significant storage. + + The returned object is a :obj:`collections.defaultdict` with the + ``default_factory`` set to ``None``, such that it behaves like a normal + dictionary. + + """ + valuefunc = (lambda x: x) if (valuefunc is None) else valuefunc + + ret = defaultdict(list) + for item in iterable: + key = keyfunc(item) + value = valuefunc(item) + ret[key].append(value) + + if reducefunc is not None: + for key, value_list in ret.items(): + ret[key] = reducefunc(value_list) + + ret.default_factory = None + return ret + + +def rlocate(iterable, pred=bool, window_size=None): + """Yield the index of each item in *iterable* for which *pred* returns + ``True``, starting from the right and moving left. + + *pred* defaults to :func:`bool`, which will select truthy items: + + >>> list(rlocate([0, 1, 1, 0, 1, 0, 0])) # Truthy at 1, 2, and 4 + [4, 2, 1] + + Set *pred* to a custom function to, e.g., find the indexes for a particular + item: + + >>> iterable = iter('abcb') + >>> pred = lambda x: x == 'b' + >>> list(rlocate(iterable, pred)) + [3, 1] + + If *window_size* is given, then the *pred* function will be called with + that many items. This enables searching for sub-sequences: + + >>> iterable = [0, 1, 2, 3, 0, 1, 2, 3, 0, 1, 2, 3] + >>> pred = lambda *args: args == (1, 2, 3) + >>> list(rlocate(iterable, pred=pred, window_size=3)) + [9, 5, 1] + + Beware, this function won't return anything for infinite iterables. + If *iterable* is reversible, ``rlocate`` will reverse it and search from + the right. Otherwise, it will search from the left and return the results + in reverse order. + + See :func:`locate` to for other example applications. + + """ + if window_size is None: + try: + len_iter = len(iterable) + return (len_iter - i - 1 for i in locate(reversed(iterable), pred)) + except TypeError: + pass + + return reversed(list(locate(iterable, pred, window_size))) + + +def replace(iterable, pred, substitutes, count=None, window_size=1): + """Yield the items from *iterable*, replacing the items for which *pred* + returns ``True`` with the items from the iterable *substitutes*. + + >>> iterable = [1, 1, 0, 1, 1, 0, 1, 1] + >>> pred = lambda x: x == 0 + >>> substitutes = (2, 3) + >>> list(replace(iterable, pred, substitutes)) + [1, 1, 2, 3, 1, 1, 2, 3, 1, 1] + + If *count* is given, the number of replacements will be limited: + + >>> iterable = [1, 1, 0, 1, 1, 0, 1, 1, 0] + >>> pred = lambda x: x == 0 + >>> substitutes = [None] + >>> list(replace(iterable, pred, substitutes, count=2)) + [1, 1, None, 1, 1, None, 1, 1, 0] + + Use *window_size* to control the number of items passed as arguments to + *pred*. This allows for locating and replacing subsequences. + + >>> iterable = [0, 1, 2, 5, 0, 1, 2, 5] + >>> window_size = 3 + >>> pred = lambda *args: args == (0, 1, 2) # 3 items passed to pred + >>> substitutes = [3, 4] # Splice in these items + >>> list(replace(iterable, pred, substitutes, window_size=window_size)) + [3, 4, 5, 3, 4, 5] + + """ + if window_size < 1: + raise ValueError('window_size must be at least 1') + + # Save the substitutes iterable, since it's used more than once + substitutes = tuple(substitutes) + + # Add padding such that the number of windows matches the length of the + # iterable + it = chain(iterable, [_marker] * (window_size - 1)) + windows = windowed(it, window_size) + + n = 0 + for w in windows: + # If the current window matches our predicate (and we haven't hit + # our maximum number of replacements), splice in the substitutes + # and then consume the following windows that overlap with this one. + # For example, if the iterable is (0, 1, 2, 3, 4...) + # and the window size is 2, we have (0, 1), (1, 2), (2, 3)... + # If the predicate matches on (0, 1), we need to zap (0, 1) and (1, 2) + if pred(*w): + if (count is None) or (n < count): + n += 1 + yield from substitutes + consume(windows, window_size - 1) + continue + + # If there was no match (or we've reached the replacement limit), + # yield the first item from the window. + if w and (w[0] is not _marker): + yield w[0] + + +def partitions(iterable): + """Yield all possible order-preserving partitions of *iterable*. + + >>> iterable = 'abc' + >>> for part in partitions(iterable): + ... print([''.join(p) for p in part]) + ['abc'] + ['a', 'bc'] + ['ab', 'c'] + ['a', 'b', 'c'] + + This is unrelated to :func:`partition`. + + """ + sequence = list(iterable) + n = len(sequence) + for i in powerset(range(1, n)): + yield [sequence[i:j] for i, j in zip((0,) + i, i + (n,))] + + +def set_partitions(iterable, k=None): + """ + Yield the set partitions of *iterable* into *k* parts. Set partitions are + not order-preserving. + + >>> iterable = 'abc' + >>> for part in set_partitions(iterable, 2): + ... print([''.join(p) for p in part]) + ['a', 'bc'] + ['ab', 'c'] + ['b', 'ac'] + + + If *k* is not given, every set partition is generated. + + >>> iterable = 'abc' + >>> for part in set_partitions(iterable): + ... print([''.join(p) for p in part]) + ['abc'] + ['a', 'bc'] + ['ab', 'c'] + ['b', 'ac'] + ['a', 'b', 'c'] + + """ + L = list(iterable) + n = len(L) + if k is not None: + if k < 1: + raise ValueError( + "Can't partition in a negative or zero number of groups" + ) + elif k > n: + return + + def set_partitions_helper(L, k): + n = len(L) + if k == 1: + yield [L] + elif n == k: + yield [[s] for s in L] + else: + e, *M = L + for p in set_partitions_helper(M, k - 1): + yield [[e], *p] + for p in set_partitions_helper(M, k): + for i in range(len(p)): + yield p[:i] + [[e] + p[i]] + p[i + 1 :] + + if k is None: + for k in range(1, n + 1): + yield from set_partitions_helper(L, k) + else: + yield from set_partitions_helper(L, k) + + +class time_limited: + """ + Yield items from *iterable* until *limit_seconds* have passed. + If the time limit expires before all items have been yielded, the + ``timed_out`` parameter will be set to ``True``. + + >>> from time import sleep + >>> def generator(): + ... yield 1 + ... yield 2 + ... sleep(0.2) + ... yield 3 + >>> iterable = time_limited(0.1, generator()) + >>> list(iterable) + [1, 2] + >>> iterable.timed_out + True + + Note that the time is checked before each item is yielded, and iteration + stops if the time elapsed is greater than *limit_seconds*. If your time + limit is 1 second, but it takes 2 seconds to generate the first item from + the iterable, the function will run for 2 seconds and not yield anything. + As a special case, when *limit_seconds* is zero, the iterator never + returns anything. + + """ + + def __init__(self, limit_seconds, iterable): + if limit_seconds < 0: + raise ValueError('limit_seconds must be positive') + self.limit_seconds = limit_seconds + self._iterable = iter(iterable) + self._start_time = monotonic() + self.timed_out = False + + def __iter__(self): + return self + + def __next__(self): + if self.limit_seconds == 0: + self.timed_out = True + raise StopIteration + item = next(self._iterable) + if monotonic() - self._start_time > self.limit_seconds: + self.timed_out = True + raise StopIteration + + return item + + +def only(iterable, default=None, too_long=None): + """If *iterable* has only one item, return it. + If it has zero items, return *default*. + If it has more than one item, raise the exception given by *too_long*, + which is ``ValueError`` by default. + + >>> only([], default='missing') + 'missing' + >>> only([1]) + 1 + >>> only([1, 2]) # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + ... + ValueError: Expected exactly one item in iterable, but got 1, 2, + and perhaps more.' + >>> only([1, 2], too_long=TypeError) # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + ... + TypeError + + Note that :func:`only` attempts to advance *iterable* twice to ensure there + is only one item. See :func:`spy` or :func:`peekable` to check + iterable contents less destructively. + """ + it = iter(iterable) + first_value = next(it, default) + + try: + second_value = next(it) + except StopIteration: + pass + else: + msg = ( + 'Expected exactly one item in iterable, but got {!r}, {!r}, ' + 'and perhaps more.'.format(first_value, second_value) + ) + raise too_long or ValueError(msg) + + return first_value + + +def _ichunk(iterable, n): + cache = deque() + chunk = islice(iterable, n) + + def generator(): + while True: + if cache: + yield cache.popleft() + else: + try: + item = next(chunk) + except StopIteration: + return + else: + yield item + + def materialize_next(n=1): + # if n not specified materialize everything + if n is None: + cache.extend(chunk) + return len(cache) + + to_cache = n - len(cache) + + # materialize up to n + if to_cache > 0: + cache.extend(islice(chunk, to_cache)) + + # return number materialized up to n + return min(n, len(cache)) + + return (generator(), materialize_next) + + +def ichunked(iterable, n): + """Break *iterable* into sub-iterables with *n* elements each. + :func:`ichunked` is like :func:`chunked`, but it yields iterables + instead of lists. + + If the sub-iterables are read in order, the elements of *iterable* + won't be stored in memory. + If they are read out of order, :func:`itertools.tee` is used to cache + elements as necessary. + + >>> from itertools import count + >>> all_chunks = ichunked(count(), 4) + >>> c_1, c_2, c_3 = next(all_chunks), next(all_chunks), next(all_chunks) + >>> list(c_2) # c_1's elements have been cached; c_3's haven't been + [4, 5, 6, 7] + >>> list(c_1) + [0, 1, 2, 3] + >>> list(c_3) + [8, 9, 10, 11] + + """ + iterable = iter(iterable) + while True: + # Create new chunk + chunk, materialize_next = _ichunk(iterable, n) + + # Check to see whether we're at the end of the source iterable + if not materialize_next(): + return + + yield chunk + + # Fill previous chunk's cache + materialize_next(None) + + +def iequals(*iterables): + """Return ``True`` if all given *iterables* are equal to each other, + which means that they contain the same elements in the same order. + + The function is useful for comparing iterables of different data types + or iterables that do not support equality checks. + + >>> iequals("abc", ['a', 'b', 'c'], ('a', 'b', 'c'), iter("abc")) + True + + >>> iequals("abc", "acb") + False + + Not to be confused with :func:`all_equal`, which checks whether all + elements of iterable are equal to each other. + + """ + return all(map(all_equal, zip_longest(*iterables, fillvalue=object()))) + + +def distinct_combinations(iterable, r): + """Yield the distinct combinations of *r* items taken from *iterable*. + + >>> list(distinct_combinations([0, 0, 1], 2)) + [(0, 0), (0, 1)] + + Equivalent to ``set(combinations(iterable))``, except duplicates are not + generated and thrown away. For larger input sequences this is much more + efficient. + + """ + if r < 0: + raise ValueError('r must be non-negative') + elif r == 0: + yield () + return + pool = tuple(iterable) + generators = [unique_everseen(enumerate(pool), key=itemgetter(1))] + current_combo = [None] * r + level = 0 + while generators: + try: + cur_idx, p = next(generators[-1]) + except StopIteration: + generators.pop() + level -= 1 + continue + current_combo[level] = p + if level + 1 == r: + yield tuple(current_combo) + else: + generators.append( + unique_everseen( + enumerate(pool[cur_idx + 1 :], cur_idx + 1), + key=itemgetter(1), + ) + ) + level += 1 + + +def filter_except(validator, iterable, *exceptions): + """Yield the items from *iterable* for which the *validator* function does + not raise one of the specified *exceptions*. + + *validator* is called for each item in *iterable*. + It should be a function that accepts one argument and raises an exception + if that item is not valid. + + >>> iterable = ['1', '2', 'three', '4', None] + >>> list(filter_except(int, iterable, ValueError, TypeError)) + ['1', '2', '4'] + + If an exception other than one given by *exceptions* is raised by + *validator*, it is raised like normal. + """ + for item in iterable: + try: + validator(item) + except exceptions: + pass + else: + yield item + + +def map_except(function, iterable, *exceptions): + """Transform each item from *iterable* with *function* and yield the + result, unless *function* raises one of the specified *exceptions*. + + *function* is called to transform each item in *iterable*. + It should accept one argument. + + >>> iterable = ['1', '2', 'three', '4', None] + >>> list(map_except(int, iterable, ValueError, TypeError)) + [1, 2, 4] + + If an exception other than one given by *exceptions* is raised by + *function*, it is raised like normal. + """ + for item in iterable: + try: + yield function(item) + except exceptions: + pass + + +def map_if(iterable, pred, func, func_else=lambda x: x): + """Evaluate each item from *iterable* using *pred*. If the result is + equivalent to ``True``, transform the item with *func* and yield it. + Otherwise, transform the item with *func_else* and yield it. + + *pred*, *func*, and *func_else* should each be functions that accept + one argument. By default, *func_else* is the identity function. + + >>> from math import sqrt + >>> iterable = list(range(-5, 5)) + >>> iterable + [-5, -4, -3, -2, -1, 0, 1, 2, 3, 4] + >>> list(map_if(iterable, lambda x: x > 3, lambda x: 'toobig')) + [-5, -4, -3, -2, -1, 0, 1, 2, 3, 'toobig'] + >>> list(map_if(iterable, lambda x: x >= 0, + ... lambda x: f'{sqrt(x):.2f}', lambda x: None)) + [None, None, None, None, None, '0.00', '1.00', '1.41', '1.73', '2.00'] + """ + for item in iterable: + yield func(item) if pred(item) else func_else(item) + + +def _sample_unweighted(iterable, k): + # Implementation of "Algorithm L" from the 1994 paper by Kim-Hung Li: + # "Reservoir-Sampling Algorithms of Time Complexity O(n(1+log(N/n)))". + + # Fill up the reservoir (collection of samples) with the first `k` samples + reservoir = take(k, iterable) + + # Generate random number that's the largest in a sample of k U(0,1) numbers + # Largest order statistic: https://en.wikipedia.org/wiki/Order_statistic + W = exp(log(random()) / k) + + # The number of elements to skip before changing the reservoir is a random + # number with a geometric distribution. Sample it using random() and logs. + next_index = k + floor(log(random()) / log(1 - W)) + + for index, element in enumerate(iterable, k): + if index == next_index: + reservoir[randrange(k)] = element + # The new W is the largest in a sample of k U(0, `old_W`) numbers + W *= exp(log(random()) / k) + next_index += floor(log(random()) / log(1 - W)) + 1 + + return reservoir + + +def _sample_weighted(iterable, k, weights): + # Implementation of "A-ExpJ" from the 2006 paper by Efraimidis et al. : + # "Weighted random sampling with a reservoir". + + # Log-transform for numerical stability for weights that are small/large + weight_keys = (log(random()) / weight for weight in weights) + + # Fill up the reservoir (collection of samples) with the first `k` + # weight-keys and elements, then heapify the list. + reservoir = take(k, zip(weight_keys, iterable)) + heapify(reservoir) + + # The number of jumps before changing the reservoir is a random variable + # with an exponential distribution. Sample it using random() and logs. + smallest_weight_key, _ = reservoir[0] + weights_to_skip = log(random()) / smallest_weight_key + + for weight, element in zip(weights, iterable): + if weight >= weights_to_skip: + # The notation here is consistent with the paper, but we store + # the weight-keys in log-space for better numerical stability. + smallest_weight_key, _ = reservoir[0] + t_w = exp(weight * smallest_weight_key) + r_2 = uniform(t_w, 1) # generate U(t_w, 1) + weight_key = log(r_2) / weight + heapreplace(reservoir, (weight_key, element)) + smallest_weight_key, _ = reservoir[0] + weights_to_skip = log(random()) / smallest_weight_key + else: + weights_to_skip -= weight + + # Equivalent to [element for weight_key, element in sorted(reservoir)] + return [heappop(reservoir)[1] for _ in range(k)] + + +def sample(iterable, k, weights=None): + """Return a *k*-length list of elements chosen (without replacement) + from the *iterable*. Like :func:`random.sample`, but works on iterables + of unknown length. + + >>> iterable = range(100) + >>> sample(iterable, 5) # doctest: +SKIP + [81, 60, 96, 16, 4] + + An iterable with *weights* may also be given: + + >>> iterable = range(100) + >>> weights = (i * i + 1 for i in range(100)) + >>> sampled = sample(iterable, 5, weights=weights) # doctest: +SKIP + [79, 67, 74, 66, 78] + + The algorithm can also be used to generate weighted random permutations. + The relative weight of each item determines the probability that it + appears late in the permutation. + + >>> data = "abcdefgh" + >>> weights = range(1, len(data) + 1) + >>> sample(data, k=len(data), weights=weights) # doctest: +SKIP + ['c', 'a', 'b', 'e', 'g', 'd', 'h', 'f'] + """ + if k == 0: + return [] + + iterable = iter(iterable) + if weights is None: + return _sample_unweighted(iterable, k) + else: + weights = iter(weights) + return _sample_weighted(iterable, k, weights) + + +def is_sorted(iterable, key=None, reverse=False, strict=False): + """Returns ``True`` if the items of iterable are in sorted order, and + ``False`` otherwise. *key* and *reverse* have the same meaning that they do + in the built-in :func:`sorted` function. + + >>> is_sorted(['1', '2', '3', '4', '5'], key=int) + True + >>> is_sorted([5, 4, 3, 1, 2], reverse=True) + False + + If *strict*, tests for strict sorting, that is, returns ``False`` if equal + elements are found: + + >>> is_sorted([1, 2, 2]) + True + >>> is_sorted([1, 2, 2], strict=True) + False + + The function returns ``False`` after encountering the first out-of-order + item. If there are no out-of-order items, the iterable is exhausted. + """ + + compare = (le if reverse else ge) if strict else (lt if reverse else gt) + it = iterable if key is None else map(key, iterable) + return not any(starmap(compare, pairwise(it))) + + +class AbortThread(BaseException): + pass + + +class callback_iter: + """Convert a function that uses callbacks to an iterator. + + Let *func* be a function that takes a `callback` keyword argument. + For example: + + >>> def func(callback=None): + ... for i, c in [(1, 'a'), (2, 'b'), (3, 'c')]: + ... if callback: + ... callback(i, c) + ... return 4 + + + Use ``with callback_iter(func)`` to get an iterator over the parameters + that are delivered to the callback. + + >>> with callback_iter(func) as it: + ... for args, kwargs in it: + ... print(args) + (1, 'a') + (2, 'b') + (3, 'c') + + The function will be called in a background thread. The ``done`` property + indicates whether it has completed execution. + + >>> it.done + True + + If it completes successfully, its return value will be available + in the ``result`` property. + + >>> it.result + 4 + + Notes: + + * If the function uses some keyword argument besides ``callback``, supply + *callback_kwd*. + * If it finished executing, but raised an exception, accessing the + ``result`` property will raise the same exception. + * If it hasn't finished executing, accessing the ``result`` + property from within the ``with`` block will raise ``RuntimeError``. + * If it hasn't finished executing, accessing the ``result`` property from + outside the ``with`` block will raise a + ``more_itertools.AbortThread`` exception. + * Provide *wait_seconds* to adjust how frequently the it is polled for + output. + + """ + + def __init__(self, func, callback_kwd='callback', wait_seconds=0.1): + self._func = func + self._callback_kwd = callback_kwd + self._aborted = False + self._future = None + self._wait_seconds = wait_seconds + # Lazily import concurrent.future + self._executor = __import__( + 'concurrent.futures' + ).futures.ThreadPoolExecutor(max_workers=1) + self._iterator = self._reader() + + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_value, traceback): + self._aborted = True + self._executor.shutdown() + + def __iter__(self): + return self + + def __next__(self): + return next(self._iterator) + + @property + def done(self): + if self._future is None: + return False + return self._future.done() + + @property + def result(self): + if not self.done: + raise RuntimeError('Function has not yet completed') + + return self._future.result() + + def _reader(self): + q = Queue() + + def callback(*args, **kwargs): + if self._aborted: + raise AbortThread('canceled by user') + + q.put((args, kwargs)) + + self._future = self._executor.submit( + self._func, **{self._callback_kwd: callback} + ) + + while True: + try: + item = q.get(timeout=self._wait_seconds) + except Empty: + pass + else: + q.task_done() + yield item + + if self._future.done(): + break + + remaining = [] + while True: + try: + item = q.get_nowait() + except Empty: + break + else: + q.task_done() + remaining.append(item) + q.join() + yield from remaining + + +def windowed_complete(iterable, n): + """ + Yield ``(beginning, middle, end)`` tuples, where: + + * Each ``middle`` has *n* items from *iterable* + * Each ``beginning`` has the items before the ones in ``middle`` + * Each ``end`` has the items after the ones in ``middle`` + + >>> iterable = range(7) + >>> n = 3 + >>> for beginning, middle, end in windowed_complete(iterable, n): + ... print(beginning, middle, end) + () (0, 1, 2) (3, 4, 5, 6) + (0,) (1, 2, 3) (4, 5, 6) + (0, 1) (2, 3, 4) (5, 6) + (0, 1, 2) (3, 4, 5) (6,) + (0, 1, 2, 3) (4, 5, 6) () + + Note that *n* must be at least 0 and most equal to the length of + *iterable*. + + This function will exhaust the iterable and may require significant + storage. + """ + if n < 0: + raise ValueError('n must be >= 0') + + seq = tuple(iterable) + size = len(seq) + + if n > size: + raise ValueError('n must be <= len(seq)') + + for i in range(size - n + 1): + beginning = seq[:i] + middle = seq[i : i + n] + end = seq[i + n :] + yield beginning, middle, end + + +def all_unique(iterable, key=None): + """ + Returns ``True`` if all the elements of *iterable* are unique (no two + elements are equal). + + >>> all_unique('ABCB') + False + + If a *key* function is specified, it will be used to make comparisons. + + >>> all_unique('ABCb') + True + >>> all_unique('ABCb', str.lower) + False + + The function returns as soon as the first non-unique element is + encountered. Iterables with a mix of hashable and unhashable items can + be used, but the function will be slower for unhashable items. + """ + seenset = set() + seenset_add = seenset.add + seenlist = [] + seenlist_add = seenlist.append + for element in map(key, iterable) if key else iterable: + try: + if element in seenset: + return False + seenset_add(element) + except TypeError: + if element in seenlist: + return False + seenlist_add(element) + return True + + +def nth_product(index, *args): + """Equivalent to ``list(product(*args))[index]``. + + The products of *args* can be ordered lexicographically. + :func:`nth_product` computes the product at sort position *index* without + computing the previous products. + + >>> nth_product(8, range(2), range(2), range(2), range(2)) + (1, 0, 0, 0) + + ``IndexError`` will be raised if the given *index* is invalid. + """ + pools = list(map(tuple, reversed(args))) + ns = list(map(len, pools)) + + c = reduce(mul, ns) + + if index < 0: + index += c + + if not 0 <= index < c: + raise IndexError + + result = [] + for pool, n in zip(pools, ns): + result.append(pool[index % n]) + index //= n + + return tuple(reversed(result)) + + +def nth_permutation(iterable, r, index): + """Equivalent to ``list(permutations(iterable, r))[index]``` + + The subsequences of *iterable* that are of length *r* where order is + important can be ordered lexicographically. :func:`nth_permutation` + computes the subsequence at sort position *index* directly, without + computing the previous subsequences. + + >>> nth_permutation('ghijk', 2, 5) + ('h', 'i') + + ``ValueError`` will be raised If *r* is negative or greater than the length + of *iterable*. + ``IndexError`` will be raised if the given *index* is invalid. + """ + pool = list(iterable) + n = len(pool) + + if r is None or r == n: + r, c = n, factorial(n) + elif not 0 <= r < n: + raise ValueError + else: + c = perm(n, r) + assert c > 0 # factortial(n)>0, and r>> nth_combination_with_replacement(range(5), 3, 5) + (0, 1, 1) + + ``ValueError`` will be raised If *r* is negative or greater than the length + of *iterable*. + ``IndexError`` will be raised if the given *index* is invalid. + """ + pool = tuple(iterable) + n = len(pool) + if (r < 0) or (r > n): + raise ValueError + + c = comb(n + r - 1, r) + + if index < 0: + index += c + + if (index < 0) or (index >= c): + raise IndexError + + result = [] + i = 0 + while r: + r -= 1 + while n >= 0: + num_combs = comb(n + r - 1, r) + if index < num_combs: + break + n -= 1 + i += 1 + index -= num_combs + result.append(pool[i]) + + return tuple(result) + + +def value_chain(*args): + """Yield all arguments passed to the function in the same order in which + they were passed. If an argument itself is iterable then iterate over its + values. + + >>> list(value_chain(1, 2, 3, [4, 5, 6])) + [1, 2, 3, 4, 5, 6] + + Binary and text strings are not considered iterable and are emitted + as-is: + + >>> list(value_chain('12', '34', ['56', '78'])) + ['12', '34', '56', '78'] + + Pre- or postpend a single element to an iterable: + + >>> list(value_chain(1, [2, 3, 4, 5, 6])) + [1, 2, 3, 4, 5, 6] + >>> list(value_chain([1, 2, 3, 4, 5], 6)) + [1, 2, 3, 4, 5, 6] + + Multiple levels of nesting are not flattened. + + """ + for value in args: + if isinstance(value, (str, bytes)): + yield value + continue + try: + yield from value + except TypeError: + yield value + + +def product_index(element, *args): + """Equivalent to ``list(product(*args)).index(element)`` + + The products of *args* can be ordered lexicographically. + :func:`product_index` computes the first index of *element* without + computing the previous products. + + >>> product_index([8, 2], range(10), range(5)) + 42 + + ``ValueError`` will be raised if the given *element* isn't in the product + of *args*. + """ + index = 0 + + for x, pool in zip_longest(element, args, fillvalue=_marker): + if x is _marker or pool is _marker: + raise ValueError('element is not a product of args') + + pool = tuple(pool) + index = index * len(pool) + pool.index(x) + + return index + + +def combination_index(element, iterable): + """Equivalent to ``list(combinations(iterable, r)).index(element)`` + + The subsequences of *iterable* that are of length *r* can be ordered + lexicographically. :func:`combination_index` computes the index of the + first *element*, without computing the previous combinations. + + >>> combination_index('adf', 'abcdefg') + 10 + + ``ValueError`` will be raised if the given *element* isn't one of the + combinations of *iterable*. + """ + element = enumerate(element) + k, y = next(element, (None, None)) + if k is None: + return 0 + + indexes = [] + pool = enumerate(iterable) + for n, x in pool: + if x == y: + indexes.append(n) + tmp, y = next(element, (None, None)) + if tmp is None: + break + else: + k = tmp + else: + raise ValueError('element is not a combination of iterable') + + n, _ = last(pool, default=(n, None)) + + # Python versions below 3.8 don't have math.comb + index = 1 + for i, j in enumerate(reversed(indexes), start=1): + j = n - j + if i <= j: + index += comb(j, i) + + return comb(n + 1, k + 1) - index + + +def combination_with_replacement_index(element, iterable): + """Equivalent to + ``list(combinations_with_replacement(iterable, r)).index(element)`` + + The subsequences with repetition of *iterable* that are of length *r* can + be ordered lexicographically. :func:`combination_with_replacement_index` + computes the index of the first *element*, without computing the previous + combinations with replacement. + + >>> combination_with_replacement_index('adf', 'abcdefg') + 20 + + ``ValueError`` will be raised if the given *element* isn't one of the + combinations with replacement of *iterable*. + """ + element = tuple(element) + l = len(element) + element = enumerate(element) + + k, y = next(element, (None, None)) + if k is None: + return 0 + + indexes = [] + pool = tuple(iterable) + for n, x in enumerate(pool): + while x == y: + indexes.append(n) + tmp, y = next(element, (None, None)) + if tmp is None: + break + else: + k = tmp + if y is None: + break + else: + raise ValueError( + 'element is not a combination with replacement of iterable' + ) + + n = len(pool) + occupations = [0] * n + for p in indexes: + occupations[p] += 1 + + index = 0 + cumulative_sum = 0 + for k in range(1, n): + cumulative_sum += occupations[k - 1] + j = l + n - 1 - k - cumulative_sum + i = n - k + if i <= j: + index += comb(j, i) + + return index + + +def permutation_index(element, iterable): + """Equivalent to ``list(permutations(iterable, r)).index(element)``` + + The subsequences of *iterable* that are of length *r* where order is + important can be ordered lexicographically. :func:`permutation_index` + computes the index of the first *element* directly, without computing + the previous permutations. + + >>> permutation_index([1, 3, 2], range(5)) + 19 + + ``ValueError`` will be raised if the given *element* isn't one of the + permutations of *iterable*. + """ + index = 0 + pool = list(iterable) + for i, x in zip(range(len(pool), -1, -1), element): + r = pool.index(x) + index = index * i + r + del pool[r] + + return index + + +class countable: + """Wrap *iterable* and keep a count of how many items have been consumed. + + The ``items_seen`` attribute starts at ``0`` and increments as the iterable + is consumed: + + >>> iterable = map(str, range(10)) + >>> it = countable(iterable) + >>> it.items_seen + 0 + >>> next(it), next(it) + ('0', '1') + >>> list(it) + ['2', '3', '4', '5', '6', '7', '8', '9'] + >>> it.items_seen + 10 + """ + + def __init__(self, iterable): + self._it = iter(iterable) + self.items_seen = 0 + + def __iter__(self): + return self + + def __next__(self): + item = next(self._it) + self.items_seen += 1 + + return item + + +def chunked_even(iterable, n): + """Break *iterable* into lists of approximately length *n*. + Items are distributed such the lengths of the lists differ by at most + 1 item. + + >>> iterable = [1, 2, 3, 4, 5, 6, 7] + >>> n = 3 + >>> list(chunked_even(iterable, n)) # List lengths: 3, 2, 2 + [[1, 2, 3], [4, 5], [6, 7]] + >>> list(chunked(iterable, n)) # List lengths: 3, 3, 1 + [[1, 2, 3], [4, 5, 6], [7]] + + """ + iterable = iter(iterable) + + # Initialize a buffer to process the chunks while keeping + # some back to fill any underfilled chunks + min_buffer = (n - 1) * (n - 2) + buffer = list(islice(iterable, min_buffer)) + + # Append items until we have a completed chunk + for _ in islice(map(buffer.append, iterable), n, None, n): + yield buffer[:n] + del buffer[:n] + + # Check if any chunks need addition processing + if not buffer: + return + length = len(buffer) + + # Chunks are either size `full_size <= n` or `partial_size = full_size - 1` + q, r = divmod(length, n) + num_lists = q + (1 if r > 0 else 0) + q, r = divmod(length, num_lists) + full_size = q + (1 if r > 0 else 0) + partial_size = full_size - 1 + num_full = length - partial_size * num_lists + + # Yield chunks of full size + partial_start_idx = num_full * full_size + if full_size > 0: + for i in range(0, partial_start_idx, full_size): + yield buffer[i : i + full_size] + + # Yield chunks of partial size + if partial_size > 0: + for i in range(partial_start_idx, length, partial_size): + yield buffer[i : i + partial_size] + + +def zip_broadcast(*objects, scalar_types=(str, bytes), strict=False): + """A version of :func:`zip` that "broadcasts" any scalar + (i.e., non-iterable) items into output tuples. + + >>> iterable_1 = [1, 2, 3] + >>> iterable_2 = ['a', 'b', 'c'] + >>> scalar = '_' + >>> list(zip_broadcast(iterable_1, iterable_2, scalar)) + [(1, 'a', '_'), (2, 'b', '_'), (3, 'c', '_')] + + The *scalar_types* keyword argument determines what types are considered + scalar. It is set to ``(str, bytes)`` by default. Set it to ``None`` to + treat strings and byte strings as iterable: + + >>> list(zip_broadcast('abc', 0, 'xyz', scalar_types=None)) + [('a', 0, 'x'), ('b', 0, 'y'), ('c', 0, 'z')] + + If the *strict* keyword argument is ``True``, then + ``UnequalIterablesError`` will be raised if any of the iterables have + different lengths. + """ + + def is_scalar(obj): + if scalar_types and isinstance(obj, scalar_types): + return True + try: + iter(obj) + except TypeError: + return True + else: + return False + + size = len(objects) + if not size: + return + + new_item = [None] * size + iterables, iterable_positions = [], [] + for i, obj in enumerate(objects): + if is_scalar(obj): + new_item[i] = obj + else: + iterables.append(iter(obj)) + iterable_positions.append(i) + + if not iterables: + yield tuple(objects) + return + + zipper = _zip_equal if strict else zip + for item in zipper(*iterables): + for i, new_item[i] in zip(iterable_positions, item): + pass + yield tuple(new_item) + + +def unique_in_window(iterable, n, key=None): + """Yield the items from *iterable* that haven't been seen recently. + *n* is the size of the lookback window. + + >>> iterable = [0, 1, 0, 2, 3, 0] + >>> n = 3 + >>> list(unique_in_window(iterable, n)) + [0, 1, 2, 3, 0] + + The *key* function, if provided, will be used to determine uniqueness: + + >>> list(unique_in_window('abAcda', 3, key=lambda x: x.lower())) + ['a', 'b', 'c', 'd', 'a'] + + The items in *iterable* must be hashable. + + """ + if n <= 0: + raise ValueError('n must be greater than 0') + + window = deque(maxlen=n) + counts = defaultdict(int) + use_key = key is not None + + for item in iterable: + if len(window) == n: + to_discard = window[0] + if counts[to_discard] == 1: + del counts[to_discard] + else: + counts[to_discard] -= 1 + + k = key(item) if use_key else item + if k not in counts: + yield item + counts[k] += 1 + window.append(k) + + +def duplicates_everseen(iterable, key=None): + """Yield duplicate elements after their first appearance. + + >>> list(duplicates_everseen('mississippi')) + ['s', 'i', 's', 's', 'i', 'p', 'i'] + >>> list(duplicates_everseen('AaaBbbCccAaa', str.lower)) + ['a', 'a', 'b', 'b', 'c', 'c', 'A', 'a', 'a'] + + This function is analogous to :func:`unique_everseen` and is subject to + the same performance considerations. + + """ + seen_set = set() + seen_list = [] + use_key = key is not None + + for element in iterable: + k = key(element) if use_key else element + try: + if k not in seen_set: + seen_set.add(k) + else: + yield element + except TypeError: + if k not in seen_list: + seen_list.append(k) + else: + yield element + + +def duplicates_justseen(iterable, key=None): + """Yields serially-duplicate elements after their first appearance. + + >>> list(duplicates_justseen('mississippi')) + ['s', 's', 'p'] + >>> list(duplicates_justseen('AaaBbbCccAaa', str.lower)) + ['a', 'a', 'b', 'b', 'c', 'c', 'a', 'a'] + + This function is analogous to :func:`unique_justseen`. + + """ + return flatten(g for _, g in groupby(iterable, key) for _ in g) + + +def classify_unique(iterable, key=None): + """Classify each element in terms of its uniqueness. + + For each element in the input iterable, return a 3-tuple consisting of: + + 1. The element itself + 2. ``False`` if the element is equal to the one preceding it in the input, + ``True`` otherwise (i.e. the equivalent of :func:`unique_justseen`) + 3. ``False`` if this element has been seen anywhere in the input before, + ``True`` otherwise (i.e. the equivalent of :func:`unique_everseen`) + + >>> list(classify_unique('otto')) # doctest: +NORMALIZE_WHITESPACE + [('o', True, True), + ('t', True, True), + ('t', False, False), + ('o', True, False)] + + This function is analogous to :func:`unique_everseen` and is subject to + the same performance considerations. + + """ + seen_set = set() + seen_list = [] + use_key = key is not None + previous = None + + for i, element in enumerate(iterable): + k = key(element) if use_key else element + is_unique_justseen = not i or previous != k + previous = k + is_unique_everseen = False + try: + if k not in seen_set: + seen_set.add(k) + is_unique_everseen = True + except TypeError: + if k not in seen_list: + seen_list.append(k) + is_unique_everseen = True + yield element, is_unique_justseen, is_unique_everseen + + +def minmax(iterable_or_value, *others, key=None, default=_marker): + """Returns both the smallest and largest items in an iterable + or the largest of two or more arguments. + + >>> minmax([3, 1, 5]) + (1, 5) + + >>> minmax(4, 2, 6) + (2, 6) + + If a *key* function is provided, it will be used to transform the input + items for comparison. + + >>> minmax([5, 30], key=str) # '30' sorts before '5' + (30, 5) + + If a *default* value is provided, it will be returned if there are no + input items. + + >>> minmax([], default=(0, 0)) + (0, 0) + + Otherwise ``ValueError`` is raised. + + This function is based on the + `recipe `__ by + Raymond Hettinger and takes care to minimize the number of comparisons + performed. + """ + iterable = (iterable_or_value, *others) if others else iterable_or_value + + it = iter(iterable) + + try: + lo = hi = next(it) + except StopIteration as exc: + if default is _marker: + raise ValueError( + '`minmax()` argument is an empty iterable. ' + 'Provide a `default` value to suppress this error.' + ) from exc + return default + + # Different branches depending on the presence of key. This saves a lot + # of unimportant copies which would slow the "key=None" branch + # significantly down. + if key is None: + for x, y in zip_longest(it, it, fillvalue=lo): + if y < x: + x, y = y, x + if x < lo: + lo = x + if hi < y: + hi = y + + else: + lo_key = hi_key = key(lo) + + for x, y in zip_longest(it, it, fillvalue=lo): + x_key, y_key = key(x), key(y) + + if y_key < x_key: + x, y, x_key, y_key = y, x, y_key, x_key + if x_key < lo_key: + lo, lo_key = x, x_key + if hi_key < y_key: + hi, hi_key = y, y_key + + return lo, hi + + +def constrained_batches( + iterable, max_size, max_count=None, get_len=len, strict=True +): + """Yield batches of items from *iterable* with a combined size limited by + *max_size*. + + >>> iterable = [b'12345', b'123', b'12345678', b'1', b'1', b'12', b'1'] + >>> list(constrained_batches(iterable, 10)) + [(b'12345', b'123'), (b'12345678', b'1', b'1'), (b'12', b'1')] + + If a *max_count* is supplied, the number of items per batch is also + limited: + + >>> iterable = [b'12345', b'123', b'12345678', b'1', b'1', b'12', b'1'] + >>> list(constrained_batches(iterable, 10, max_count = 2)) + [(b'12345', b'123'), (b'12345678', b'1'), (b'1', b'12'), (b'1',)] + + If a *get_len* function is supplied, use that instead of :func:`len` to + determine item size. + + If *strict* is ``True``, raise ``ValueError`` if any single item is bigger + than *max_size*. Otherwise, allow single items to exceed *max_size*. + """ + if max_size <= 0: + raise ValueError('maximum size must be greater than zero') + + batch = [] + batch_size = 0 + batch_count = 0 + for item in iterable: + item_len = get_len(item) + if strict and item_len > max_size: + raise ValueError('item size exceeds maximum size') + + reached_count = batch_count == max_count + reached_size = item_len + batch_size > max_size + if batch_count and (reached_size or reached_count): + yield tuple(batch) + batch.clear() + batch_size = 0 + batch_count = 0 + + batch.append(item) + batch_size += item_len + batch_count += 1 + + if batch: + yield tuple(batch) + + +def gray_product(*iterables): + """Like :func:`itertools.product`, but return tuples in an order such + that only one element in the generated tuple changes from one iteration + to the next. + + >>> list(gray_product('AB','CD')) + [('A', 'C'), ('B', 'C'), ('B', 'D'), ('A', 'D')] + + This function consumes all of the input iterables before producing output. + If any of the input iterables have fewer than two items, ``ValueError`` + is raised. + + For information on the algorithm, see + `this section `__ + of Donald Knuth's *The Art of Computer Programming*. + """ + all_iterables = tuple(tuple(x) for x in iterables) + iterable_count = len(all_iterables) + for iterable in all_iterables: + if len(iterable) < 2: + raise ValueError("each iterable must have two or more items") + + # This is based on "Algorithm H" from section 7.2.1.1, page 20. + # a holds the indexes of the source iterables for the n-tuple to be yielded + # f is the array of "focus pointers" + # o is the array of "directions" + a = [0] * iterable_count + f = list(range(iterable_count + 1)) + o = [1] * iterable_count + while True: + yield tuple(all_iterables[i][a[i]] for i in range(iterable_count)) + j = f[0] + f[0] = 0 + if j == iterable_count: + break + a[j] = a[j] + o[j] + if a[j] == 0 or a[j] == len(all_iterables[j]) - 1: + o[j] = -o[j] + f[j] = f[j + 1] + f[j + 1] = j + 1 + + +def partial_product(*iterables): + """Yields tuples containing one item from each iterator, with subsequent + tuples changing a single item at a time by advancing each iterator until it + is exhausted. This sequence guarantees every value in each iterable is + output at least once without generating all possible combinations. + + This may be useful, for example, when testing an expensive function. + + >>> list(partial_product('AB', 'C', 'DEF')) + [('A', 'C', 'D'), ('B', 'C', 'D'), ('B', 'C', 'E'), ('B', 'C', 'F')] + """ + + iterators = list(map(iter, iterables)) + + try: + prod = [next(it) for it in iterators] + except StopIteration: + return + yield tuple(prod) + + for i, it in enumerate(iterators): + for prod[i] in it: + yield tuple(prod) + + +def takewhile_inclusive(predicate, iterable): + """A variant of :func:`takewhile` that yields one additional element. + + >>> list(takewhile_inclusive(lambda x: x < 5, [1, 4, 6, 4, 1])) + [1, 4, 6] + + :func:`takewhile` would return ``[1, 4]``. + """ + for x in iterable: + yield x + if not predicate(x): + break + + +def outer_product(func, xs, ys, *args, **kwargs): + """A generalized outer product that applies a binary function to all + pairs of items. Returns a 2D matrix with ``len(xs)`` rows and ``len(ys)`` + columns. + Also accepts ``*args`` and ``**kwargs`` that are passed to ``func``. + + Multiplication table: + + >>> list(outer_product(mul, range(1, 4), range(1, 6))) + [(1, 2, 3, 4, 5), (2, 4, 6, 8, 10), (3, 6, 9, 12, 15)] + + Cross tabulation: + + >>> xs = ['A', 'B', 'A', 'A', 'B', 'B', 'A', 'A', 'B', 'B'] + >>> ys = ['X', 'X', 'X', 'Y', 'Z', 'Z', 'Y', 'Y', 'Z', 'Z'] + >>> rows = list(zip(xs, ys)) + >>> count_rows = lambda x, y: rows.count((x, y)) + >>> list(outer_product(count_rows, sorted(set(xs)), sorted(set(ys)))) + [(2, 3, 0), (1, 0, 4)] + + Usage with ``*args`` and ``**kwargs``: + + >>> animals = ['cat', 'wolf', 'mouse'] + >>> list(outer_product(min, animals, animals, key=len)) + [('cat', 'cat', 'cat'), ('cat', 'wolf', 'wolf'), ('cat', 'wolf', 'mouse')] + """ + ys = tuple(ys) + return batched( + starmap(lambda x, y: func(x, y, *args, **kwargs), product(xs, ys)), + n=len(ys), + ) + + +def iter_suppress(iterable, *exceptions): + """Yield each of the items from *iterable*. If the iteration raises one of + the specified *exceptions*, that exception will be suppressed and iteration + will stop. + + >>> from itertools import chain + >>> def breaks_at_five(x): + ... while True: + ... if x >= 5: + ... raise RuntimeError + ... yield x + ... x += 1 + >>> it_1 = iter_suppress(breaks_at_five(1), RuntimeError) + >>> it_2 = iter_suppress(breaks_at_five(2), RuntimeError) + >>> list(chain(it_1, it_2)) + [1, 2, 3, 4, 2, 3, 4] + """ + try: + yield from iterable + except exceptions: + return + + +def filter_map(func, iterable): + """Apply *func* to every element of *iterable*, yielding only those which + are not ``None``. + + >>> elems = ['1', 'a', '2', 'b', '3'] + >>> list(filter_map(lambda s: int(s) if s.isnumeric() else None, elems)) + [1, 2, 3] + """ + for x in iterable: + y = func(x) + if y is not None: + yield y + + +def powerset_of_sets(iterable): + """Yields all possible subsets of the iterable. + + >>> list(powerset_of_sets([1, 2, 3])) # doctest: +SKIP + [set(), {1}, {2}, {3}, {1, 2}, {1, 3}, {2, 3}, {1, 2, 3}] + >>> list(powerset_of_sets([1, 1, 0])) # doctest: +SKIP + [set(), {1}, {0}, {0, 1}] + + :func:`powerset_of_sets` takes care to minimize the number + of hash operations performed. + """ + sets = tuple(map(set, dict.fromkeys(map(frozenset, zip(iterable))))) + for r in range(len(sets) + 1): + yield from starmap(set().union, combinations(sets, r)) + + +def join_mappings(**field_to_map): + """ + Joins multiple mappings together using their common keys. + + >>> user_scores = {'elliot': 50, 'claris': 60} + >>> user_times = {'elliot': 30, 'claris': 40} + >>> join_mappings(score=user_scores, time=user_times) + {'elliot': {'score': 50, 'time': 30}, 'claris': {'score': 60, 'time': 40}} + """ + ret = defaultdict(dict) + + for field_name, mapping in field_to_map.items(): + for key, value in mapping.items(): + ret[key][field_name] = value + + return dict(ret) + + +def _complex_sumprod(v1, v2): + """High precision sumprod() for complex numbers. + Used by :func:`dft` and :func:`idft`. + """ + + r1 = chain((p.real for p in v1), (-p.imag for p in v1)) + r2 = chain((q.real for q in v2), (q.imag for q in v2)) + i1 = chain((p.real for p in v1), (p.imag for p in v1)) + i2 = chain((q.imag for q in v2), (q.real for q in v2)) + return complex(_fsumprod(r1, r2), _fsumprod(i1, i2)) + + +def dft(xarr): + """Discrete Fourier Tranform. *xarr* is a sequence of complex numbers. + Yields the components of the corresponding transformed output vector. + + >>> import cmath + >>> xarr = [1, 2-1j, -1j, -1+2j] + >>> Xarr = [2, -2-2j, -2j, 4+4j] + >>> all(map(cmath.isclose, dft(xarr), Xarr)) + True + + See :func:`idft` for the inverse Discrete Fourier Transform. + """ + N = len(xarr) + roots_of_unity = [e ** (n / N * tau * -1j) for n in range(N)] + for k in range(N): + coeffs = [roots_of_unity[k * n % N] for n in range(N)] + yield _complex_sumprod(xarr, coeffs) + + +def idft(Xarr): + """Inverse Discrete Fourier Tranform. *Xarr* is a sequence of + complex numbers. Yields the components of the corresponding + inverse-transformed output vector. + + >>> import cmath + >>> xarr = [1, 2-1j, -1j, -1+2j] + >>> Xarr = [2, -2-2j, -2j, 4+4j] + >>> all(map(cmath.isclose, idft(Xarr), xarr)) + True + + See :func:`dft` for the Discrete Fourier Transform. + """ + N = len(Xarr) + roots_of_unity = [e ** (n / N * tau * 1j) for n in range(N)] + for k in range(N): + coeffs = [roots_of_unity[k * n % N] for n in range(N)] + yield _complex_sumprod(Xarr, coeffs) / N + + +def doublestarmap(func, iterable): + """Apply *func* to every item of *iterable* by dictionary unpacking + the item into *func*. + + The difference between :func:`itertools.starmap` and :func:`doublestarmap` + parallels the distinction between ``func(*a)`` and ``func(**a)``. + + >>> iterable = [{'a': 1, 'b': 2}, {'a': 40, 'b': 60}] + >>> list(doublestarmap(lambda a, b: a + b, iterable)) + [3, 100] + + ``TypeError`` will be raised if *func*'s signature doesn't match the + mapping contained in *iterable* or if *iterable* does not contain mappings. + """ + for item in iterable: + yield func(**item) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/more.pyi b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/more.pyi new file mode 100644 index 000000000..e94602325 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/more.pyi @@ -0,0 +1,709 @@ +"""Stubs for more_itertools.more""" + +from __future__ import annotations + +from types import TracebackType +from typing import ( + Any, + Callable, + Container, + ContextManager, + Generic, + Hashable, + Mapping, + Iterable, + Iterator, + Mapping, + overload, + Reversible, + Sequence, + Sized, + Type, + TypeVar, + type_check_only, +) +from typing_extensions import Protocol + +# Type and type variable definitions +_T = TypeVar('_T') +_T1 = TypeVar('_T1') +_T2 = TypeVar('_T2') +_U = TypeVar('_U') +_V = TypeVar('_V') +_W = TypeVar('_W') +_T_co = TypeVar('_T_co', covariant=True) +_GenFn = TypeVar('_GenFn', bound=Callable[..., Iterator[Any]]) +_Raisable = BaseException | Type[BaseException] + +@type_check_only +class _SizedIterable(Protocol[_T_co], Sized, Iterable[_T_co]): ... + +@type_check_only +class _SizedReversible(Protocol[_T_co], Sized, Reversible[_T_co]): ... + +@type_check_only +class _SupportsSlicing(Protocol[_T_co]): + def __getitem__(self, __k: slice) -> _T_co: ... + +def chunked( + iterable: Iterable[_T], n: int | None, strict: bool = ... +) -> Iterator[list[_T]]: ... +@overload +def first(iterable: Iterable[_T]) -> _T: ... +@overload +def first(iterable: Iterable[_T], default: _U) -> _T | _U: ... +@overload +def last(iterable: Iterable[_T]) -> _T: ... +@overload +def last(iterable: Iterable[_T], default: _U) -> _T | _U: ... +@overload +def nth_or_last(iterable: Iterable[_T], n: int) -> _T: ... +@overload +def nth_or_last(iterable: Iterable[_T], n: int, default: _U) -> _T | _U: ... + +class peekable(Generic[_T], Iterator[_T]): + def __init__(self, iterable: Iterable[_T]) -> None: ... + def __iter__(self) -> peekable[_T]: ... + def __bool__(self) -> bool: ... + @overload + def peek(self) -> _T: ... + @overload + def peek(self, default: _U) -> _T | _U: ... + def prepend(self, *items: _T) -> None: ... + def __next__(self) -> _T: ... + @overload + def __getitem__(self, index: int) -> _T: ... + @overload + def __getitem__(self, index: slice) -> list[_T]: ... + +def consumer(func: _GenFn) -> _GenFn: ... +def ilen(iterable: Iterable[_T]) -> int: ... +def iterate(func: Callable[[_T], _T], start: _T) -> Iterator[_T]: ... +def with_iter( + context_manager: ContextManager[Iterable[_T]], +) -> Iterator[_T]: ... +def one( + iterable: Iterable[_T], + too_short: _Raisable | None = ..., + too_long: _Raisable | None = ..., +) -> _T: ... +def raise_(exception: _Raisable, *args: Any) -> None: ... +def strictly_n( + iterable: Iterable[_T], + n: int, + too_short: _GenFn | None = ..., + too_long: _GenFn | None = ..., +) -> list[_T]: ... +def distinct_permutations( + iterable: Iterable[_T], r: int | None = ... +) -> Iterator[tuple[_T, ...]]: ... +def intersperse( + e: _U, iterable: Iterable[_T], n: int = ... +) -> Iterator[_T | _U]: ... +def unique_to_each(*iterables: Iterable[_T]) -> list[list[_T]]: ... +@overload +def windowed( + seq: Iterable[_T], n: int, *, step: int = ... +) -> Iterator[tuple[_T | None, ...]]: ... +@overload +def windowed( + seq: Iterable[_T], n: int, fillvalue: _U, step: int = ... +) -> Iterator[tuple[_T | _U, ...]]: ... +def substrings(iterable: Iterable[_T]) -> Iterator[tuple[_T, ...]]: ... +def substrings_indexes( + seq: Sequence[_T], reverse: bool = ... +) -> Iterator[tuple[Sequence[_T], int, int]]: ... + +class bucket(Generic[_T, _U], Container[_U]): + def __init__( + self, + iterable: Iterable[_T], + key: Callable[[_T], _U], + validator: Callable[[_U], object] | None = ..., + ) -> None: ... + def __contains__(self, value: object) -> bool: ... + def __iter__(self) -> Iterator[_U]: ... + def __getitem__(self, value: object) -> Iterator[_T]: ... + +def spy( + iterable: Iterable[_T], n: int = ... +) -> tuple[list[_T], Iterator[_T]]: ... +def interleave(*iterables: Iterable[_T]) -> Iterator[_T]: ... +def interleave_longest(*iterables: Iterable[_T]) -> Iterator[_T]: ... +def interleave_evenly( + iterables: list[Iterable[_T]], lengths: list[int] | None = ... +) -> Iterator[_T]: ... +def collapse( + iterable: Iterable[Any], + base_type: type | None = ..., + levels: int | None = ..., +) -> Iterator[Any]: ... +@overload +def side_effect( + func: Callable[[_T], object], + iterable: Iterable[_T], + chunk_size: None = ..., + before: Callable[[], object] | None = ..., + after: Callable[[], object] | None = ..., +) -> Iterator[_T]: ... +@overload +def side_effect( + func: Callable[[list[_T]], object], + iterable: Iterable[_T], + chunk_size: int, + before: Callable[[], object] | None = ..., + after: Callable[[], object] | None = ..., +) -> Iterator[_T]: ... +def sliced( + seq: _SupportsSlicing[_T], n: int, strict: bool = ... +) -> Iterator[_T]: ... +def split_at( + iterable: Iterable[_T], + pred: Callable[[_T], object], + maxsplit: int = ..., + keep_separator: bool = ..., +) -> Iterator[list[_T]]: ... +def split_before( + iterable: Iterable[_T], pred: Callable[[_T], object], maxsplit: int = ... +) -> Iterator[list[_T]]: ... +def split_after( + iterable: Iterable[_T], pred: Callable[[_T], object], maxsplit: int = ... +) -> Iterator[list[_T]]: ... +def split_when( + iterable: Iterable[_T], + pred: Callable[[_T, _T], object], + maxsplit: int = ..., +) -> Iterator[list[_T]]: ... +def split_into( + iterable: Iterable[_T], sizes: Iterable[int | None] +) -> Iterator[list[_T]]: ... +@overload +def padded( + iterable: Iterable[_T], + *, + n: int | None = ..., + next_multiple: bool = ..., +) -> Iterator[_T | None]: ... +@overload +def padded( + iterable: Iterable[_T], + fillvalue: _U, + n: int | None = ..., + next_multiple: bool = ..., +) -> Iterator[_T | _U]: ... +@overload +def repeat_last(iterable: Iterable[_T]) -> Iterator[_T]: ... +@overload +def repeat_last(iterable: Iterable[_T], default: _U) -> Iterator[_T | _U]: ... +def distribute(n: int, iterable: Iterable[_T]) -> list[Iterator[_T]]: ... +@overload +def stagger( + iterable: Iterable[_T], + offsets: _SizedIterable[int] = ..., + longest: bool = ..., +) -> Iterator[tuple[_T | None, ...]]: ... +@overload +def stagger( + iterable: Iterable[_T], + offsets: _SizedIterable[int] = ..., + longest: bool = ..., + fillvalue: _U = ..., +) -> Iterator[tuple[_T | _U, ...]]: ... + +class UnequalIterablesError(ValueError): + def __init__(self, details: tuple[int, int, int] | None = ...) -> None: ... + +@overload +def zip_equal(__iter1: Iterable[_T1]) -> Iterator[tuple[_T1]]: ... +@overload +def zip_equal( + __iter1: Iterable[_T1], __iter2: Iterable[_T2] +) -> Iterator[tuple[_T1, _T2]]: ... +@overload +def zip_equal( + __iter1: Iterable[_T], + __iter2: Iterable[_T], + __iter3: Iterable[_T], + *iterables: Iterable[_T], +) -> Iterator[tuple[_T, ...]]: ... +@overload +def zip_offset( + __iter1: Iterable[_T1], + *, + offsets: _SizedIterable[int], + longest: bool = ..., + fillvalue: None = None, +) -> Iterator[tuple[_T1 | None]]: ... +@overload +def zip_offset( + __iter1: Iterable[_T1], + __iter2: Iterable[_T2], + *, + offsets: _SizedIterable[int], + longest: bool = ..., + fillvalue: None = None, +) -> Iterator[tuple[_T1 | None, _T2 | None]]: ... +@overload +def zip_offset( + __iter1: Iterable[_T], + __iter2: Iterable[_T], + __iter3: Iterable[_T], + *iterables: Iterable[_T], + offsets: _SizedIterable[int], + longest: bool = ..., + fillvalue: None = None, +) -> Iterator[tuple[_T | None, ...]]: ... +@overload +def zip_offset( + __iter1: Iterable[_T1], + *, + offsets: _SizedIterable[int], + longest: bool = ..., + fillvalue: _U, +) -> Iterator[tuple[_T1 | _U]]: ... +@overload +def zip_offset( + __iter1: Iterable[_T1], + __iter2: Iterable[_T2], + *, + offsets: _SizedIterable[int], + longest: bool = ..., + fillvalue: _U, +) -> Iterator[tuple[_T1 | _U, _T2 | _U]]: ... +@overload +def zip_offset( + __iter1: Iterable[_T], + __iter2: Iterable[_T], + __iter3: Iterable[_T], + *iterables: Iterable[_T], + offsets: _SizedIterable[int], + longest: bool = ..., + fillvalue: _U, +) -> Iterator[tuple[_T | _U, ...]]: ... +def sort_together( + iterables: Iterable[Iterable[_T]], + key_list: Iterable[int] = ..., + key: Callable[..., Any] | None = ..., + reverse: bool = ..., +) -> list[tuple[_T, ...]]: ... +def unzip(iterable: Iterable[Sequence[_T]]) -> tuple[Iterator[_T], ...]: ... +def divide(n: int, iterable: Iterable[_T]) -> list[Iterator[_T]]: ... +def always_iterable( + obj: object, + base_type: type | tuple[type | tuple[Any, ...], ...] | None = ..., +) -> Iterator[Any]: ... +def adjacent( + predicate: Callable[[_T], bool], + iterable: Iterable[_T], + distance: int = ..., +) -> Iterator[tuple[bool, _T]]: ... +@overload +def groupby_transform( + iterable: Iterable[_T], + keyfunc: None = None, + valuefunc: None = None, + reducefunc: None = None, +) -> Iterator[tuple[_T, Iterator[_T]]]: ... +@overload +def groupby_transform( + iterable: Iterable[_T], + keyfunc: Callable[[_T], _U], + valuefunc: None, + reducefunc: None, +) -> Iterator[tuple[_U, Iterator[_T]]]: ... +@overload +def groupby_transform( + iterable: Iterable[_T], + keyfunc: None, + valuefunc: Callable[[_T], _V], + reducefunc: None, +) -> Iterable[tuple[_T, Iterable[_V]]]: ... +@overload +def groupby_transform( + iterable: Iterable[_T], + keyfunc: Callable[[_T], _U], + valuefunc: Callable[[_T], _V], + reducefunc: None, +) -> Iterable[tuple[_U, Iterator[_V]]]: ... +@overload +def groupby_transform( + iterable: Iterable[_T], + keyfunc: None, + valuefunc: None, + reducefunc: Callable[[Iterator[_T]], _W], +) -> Iterable[tuple[_T, _W]]: ... +@overload +def groupby_transform( + iterable: Iterable[_T], + keyfunc: Callable[[_T], _U], + valuefunc: None, + reducefunc: Callable[[Iterator[_T]], _W], +) -> Iterable[tuple[_U, _W]]: ... +@overload +def groupby_transform( + iterable: Iterable[_T], + keyfunc: None, + valuefunc: Callable[[_T], _V], + reducefunc: Callable[[Iterable[_V]], _W], +) -> Iterable[tuple[_T, _W]]: ... +@overload +def groupby_transform( + iterable: Iterable[_T], + keyfunc: Callable[[_T], _U], + valuefunc: Callable[[_T], _V], + reducefunc: Callable[[Iterable[_V]], _W], +) -> Iterable[tuple[_U, _W]]: ... + +class numeric_range(Generic[_T, _U], Sequence[_T], Hashable, Reversible[_T]): + @overload + def __init__(self, __stop: _T) -> None: ... + @overload + def __init__(self, __start: _T, __stop: _T) -> None: ... + @overload + def __init__(self, __start: _T, __stop: _T, __step: _U) -> None: ... + def __bool__(self) -> bool: ... + def __contains__(self, elem: object) -> bool: ... + def __eq__(self, other: object) -> bool: ... + @overload + def __getitem__(self, key: int) -> _T: ... + @overload + def __getitem__(self, key: slice) -> numeric_range[_T, _U]: ... + def __hash__(self) -> int: ... + def __iter__(self) -> Iterator[_T]: ... + def __len__(self) -> int: ... + def __reduce__( + self, + ) -> tuple[Type[numeric_range[_T, _U]], tuple[_T, _T, _U]]: ... + def __repr__(self) -> str: ... + def __reversed__(self) -> Iterator[_T]: ... + def count(self, value: _T) -> int: ... + def index(self, value: _T) -> int: ... # type: ignore + +def count_cycle( + iterable: Iterable[_T], n: int | None = ... +) -> Iterable[tuple[int, _T]]: ... +def mark_ends( + iterable: Iterable[_T], +) -> Iterable[tuple[bool, bool, _T]]: ... +def locate( + iterable: Iterable[_T], + pred: Callable[..., Any] = ..., + window_size: int | None = ..., +) -> Iterator[int]: ... +def lstrip( + iterable: Iterable[_T], pred: Callable[[_T], object] +) -> Iterator[_T]: ... +def rstrip( + iterable: Iterable[_T], pred: Callable[[_T], object] +) -> Iterator[_T]: ... +def strip( + iterable: Iterable[_T], pred: Callable[[_T], object] +) -> Iterator[_T]: ... + +class islice_extended(Generic[_T], Iterator[_T]): + def __init__(self, iterable: Iterable[_T], *args: int | None) -> None: ... + def __iter__(self) -> islice_extended[_T]: ... + def __next__(self) -> _T: ... + def __getitem__(self, index: slice) -> islice_extended[_T]: ... + +def always_reversible(iterable: Iterable[_T]) -> Iterator[_T]: ... +def consecutive_groups( + iterable: Iterable[_T], ordering: Callable[[_T], int] = ... +) -> Iterator[Iterator[_T]]: ... +@overload +def difference( + iterable: Iterable[_T], + func: Callable[[_T, _T], _U] = ..., + *, + initial: None = ..., +) -> Iterator[_T | _U]: ... +@overload +def difference( + iterable: Iterable[_T], func: Callable[[_T, _T], _U] = ..., *, initial: _U +) -> Iterator[_U]: ... + +class SequenceView(Generic[_T], Sequence[_T]): + def __init__(self, target: Sequence[_T]) -> None: ... + @overload + def __getitem__(self, index: int) -> _T: ... + @overload + def __getitem__(self, index: slice) -> Sequence[_T]: ... + def __len__(self) -> int: ... + +class seekable(Generic[_T], Iterator[_T]): + def __init__( + self, iterable: Iterable[_T], maxlen: int | None = ... + ) -> None: ... + def __iter__(self) -> seekable[_T]: ... + def __next__(self) -> _T: ... + def __bool__(self) -> bool: ... + @overload + def peek(self) -> _T: ... + @overload + def peek(self, default: _U) -> _T | _U: ... + def elements(self) -> SequenceView[_T]: ... + def seek(self, index: int) -> None: ... + def relative_seek(self, count: int) -> None: ... + +class run_length: + @staticmethod + def encode(iterable: Iterable[_T]) -> Iterator[tuple[_T, int]]: ... + @staticmethod + def decode(iterable: Iterable[tuple[_T, int]]) -> Iterator[_T]: ... + +def exactly_n( + iterable: Iterable[_T], n: int, predicate: Callable[[_T], object] = ... +) -> bool: ... +def circular_shifts(iterable: Iterable[_T]) -> list[tuple[_T, ...]]: ... +def make_decorator( + wrapping_func: Callable[..., _U], result_index: int = ... +) -> Callable[..., Callable[[Callable[..., Any]], Callable[..., _U]]]: ... +@overload +def map_reduce( + iterable: Iterable[_T], + keyfunc: Callable[[_T], _U], + valuefunc: None = ..., + reducefunc: None = ..., +) -> dict[_U, list[_T]]: ... +@overload +def map_reduce( + iterable: Iterable[_T], + keyfunc: Callable[[_T], _U], + valuefunc: Callable[[_T], _V], + reducefunc: None = ..., +) -> dict[_U, list[_V]]: ... +@overload +def map_reduce( + iterable: Iterable[_T], + keyfunc: Callable[[_T], _U], + valuefunc: None = ..., + reducefunc: Callable[[list[_T]], _W] = ..., +) -> dict[_U, _W]: ... +@overload +def map_reduce( + iterable: Iterable[_T], + keyfunc: Callable[[_T], _U], + valuefunc: Callable[[_T], _V], + reducefunc: Callable[[list[_V]], _W], +) -> dict[_U, _W]: ... +def rlocate( + iterable: Iterable[_T], + pred: Callable[..., object] = ..., + window_size: int | None = ..., +) -> Iterator[int]: ... +def replace( + iterable: Iterable[_T], + pred: Callable[..., object], + substitutes: Iterable[_U], + count: int | None = ..., + window_size: int = ..., +) -> Iterator[_T | _U]: ... +def partitions(iterable: Iterable[_T]) -> Iterator[list[list[_T]]]: ... +def set_partitions( + iterable: Iterable[_T], k: int | None = ... +) -> Iterator[list[list[_T]]]: ... + +class time_limited(Generic[_T], Iterator[_T]): + def __init__( + self, limit_seconds: float, iterable: Iterable[_T] + ) -> None: ... + def __iter__(self) -> islice_extended[_T]: ... + def __next__(self) -> _T: ... + +@overload +def only( + iterable: Iterable[_T], *, too_long: _Raisable | None = ... +) -> _T | None: ... +@overload +def only( + iterable: Iterable[_T], default: _U, too_long: _Raisable | None = ... +) -> _T | _U: ... +def ichunked(iterable: Iterable[_T], n: int) -> Iterator[Iterator[_T]]: ... +def distinct_combinations( + iterable: Iterable[_T], r: int +) -> Iterator[tuple[_T, ...]]: ... +def filter_except( + validator: Callable[[Any], object], + iterable: Iterable[_T], + *exceptions: Type[BaseException], +) -> Iterator[_T]: ... +def map_except( + function: Callable[[Any], _U], + iterable: Iterable[_T], + *exceptions: Type[BaseException], +) -> Iterator[_U]: ... +def map_if( + iterable: Iterable[Any], + pred: Callable[[Any], bool], + func: Callable[[Any], Any], + func_else: Callable[[Any], Any] | None = ..., +) -> Iterator[Any]: ... +def sample( + iterable: Iterable[_T], + k: int, + weights: Iterable[float] | None = ..., +) -> list[_T]: ... +def is_sorted( + iterable: Iterable[_T], + key: Callable[[_T], _U] | None = ..., + reverse: bool = False, + strict: bool = False, +) -> bool: ... + +class AbortThread(BaseException): + pass + +class callback_iter(Generic[_T], Iterator[_T]): + def __init__( + self, + func: Callable[..., Any], + callback_kwd: str = ..., + wait_seconds: float = ..., + ) -> None: ... + def __enter__(self) -> callback_iter[_T]: ... + def __exit__( + self, + exc_type: Type[BaseException] | None, + exc_value: BaseException | None, + traceback: TracebackType | None, + ) -> bool | None: ... + def __iter__(self) -> callback_iter[_T]: ... + def __next__(self) -> _T: ... + def _reader(self) -> Iterator[_T]: ... + @property + def done(self) -> bool: ... + @property + def result(self) -> Any: ... + +def windowed_complete( + iterable: Iterable[_T], n: int +) -> Iterator[tuple[_T, ...]]: ... +def all_unique( + iterable: Iterable[_T], key: Callable[[_T], _U] | None = ... +) -> bool: ... +def nth_product(index: int, *args: Iterable[_T]) -> tuple[_T, ...]: ... +def nth_combination_with_replacement( + iterable: Iterable[_T], r: int, index: int +) -> tuple[_T, ...]: ... +def nth_permutation( + iterable: Iterable[_T], r: int, index: int +) -> tuple[_T, ...]: ... +def value_chain(*args: _T | Iterable[_T]) -> Iterable[_T]: ... +def product_index(element: Iterable[_T], *args: Iterable[_T]) -> int: ... +def combination_index( + element: Iterable[_T], iterable: Iterable[_T] +) -> int: ... +def combination_with_replacement_index( + element: Iterable[_T], iterable: Iterable[_T] +) -> int: ... +def permutation_index( + element: Iterable[_T], iterable: Iterable[_T] +) -> int: ... +def repeat_each(iterable: Iterable[_T], n: int = ...) -> Iterator[_T]: ... + +class countable(Generic[_T], Iterator[_T]): + def __init__(self, iterable: Iterable[_T]) -> None: ... + def __iter__(self) -> countable[_T]: ... + def __next__(self) -> _T: ... + items_seen: int + +def chunked_even(iterable: Iterable[_T], n: int) -> Iterator[list[_T]]: ... +def zip_broadcast( + *objects: _T | Iterable[_T], + scalar_types: type | tuple[type | tuple[Any, ...], ...] | None = ..., + strict: bool = ..., +) -> Iterable[tuple[_T, ...]]: ... +def unique_in_window( + iterable: Iterable[_T], n: int, key: Callable[[_T], _U] | None = ... +) -> Iterator[_T]: ... +def duplicates_everseen( + iterable: Iterable[_T], key: Callable[[_T], _U] | None = ... +) -> Iterator[_T]: ... +def duplicates_justseen( + iterable: Iterable[_T], key: Callable[[_T], _U] | None = ... +) -> Iterator[_T]: ... +def classify_unique( + iterable: Iterable[_T], key: Callable[[_T], _U] | None = ... +) -> Iterator[tuple[_T, bool, bool]]: ... + +class _SupportsLessThan(Protocol): + def __lt__(self, __other: Any) -> bool: ... + +_SupportsLessThanT = TypeVar("_SupportsLessThanT", bound=_SupportsLessThan) + +@overload +def minmax( + iterable_or_value: Iterable[_SupportsLessThanT], *, key: None = None +) -> tuple[_SupportsLessThanT, _SupportsLessThanT]: ... +@overload +def minmax( + iterable_or_value: Iterable[_T], *, key: Callable[[_T], _SupportsLessThan] +) -> tuple[_T, _T]: ... +@overload +def minmax( + iterable_or_value: Iterable[_SupportsLessThanT], + *, + key: None = None, + default: _U, +) -> _U | tuple[_SupportsLessThanT, _SupportsLessThanT]: ... +@overload +def minmax( + iterable_or_value: Iterable[_T], + *, + key: Callable[[_T], _SupportsLessThan], + default: _U, +) -> _U | tuple[_T, _T]: ... +@overload +def minmax( + iterable_or_value: _SupportsLessThanT, + __other: _SupportsLessThanT, + *others: _SupportsLessThanT, +) -> tuple[_SupportsLessThanT, _SupportsLessThanT]: ... +@overload +def minmax( + iterable_or_value: _T, + __other: _T, + *others: _T, + key: Callable[[_T], _SupportsLessThan], +) -> tuple[_T, _T]: ... +def longest_common_prefix( + iterables: Iterable[Iterable[_T]], +) -> Iterator[_T]: ... +def iequals(*iterables: Iterable[Any]) -> bool: ... +def constrained_batches( + iterable: Iterable[_T], + max_size: int, + max_count: int | None = ..., + get_len: Callable[[_T], object] = ..., + strict: bool = ..., +) -> Iterator[tuple[_T]]: ... +def gray_product(*iterables: Iterable[_T]) -> Iterator[tuple[_T, ...]]: ... +def partial_product(*iterables: Iterable[_T]) -> Iterator[tuple[_T, ...]]: ... +def takewhile_inclusive( + predicate: Callable[[_T], bool], iterable: Iterable[_T] +) -> Iterator[_T]: ... +def outer_product( + func: Callable[[_T, _U], _V], + xs: Iterable[_T], + ys: Iterable[_U], + *args: Any, + **kwargs: Any, +) -> Iterator[tuple[_V, ...]]: ... +def iter_suppress( + iterable: Iterable[_T], + *exceptions: Type[BaseException], +) -> Iterator[_T]: ... +def filter_map( + func: Callable[[_T], _V | None], + iterable: Iterable[_T], +) -> Iterator[_V]: ... +def powerset_of_sets(iterable: Iterable[_T]) -> Iterator[set[_T]]: ... +def join_mappings( + **field_to_map: Mapping[_T, _V] +) -> dict[_T, dict[str, _V]]: ... +def doublestarmap( + func: Callable[..., _T], + iterable: Iterable[Mapping[str, Any]], +) -> Iterator[_T]: ... +def dft(xarr: Sequence[complex]) -> Iterator[complex]: ... +def idft(Xarr: Sequence[complex]) -> Iterator[complex]: ... diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/py.typed b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/py.typed new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/recipes.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/recipes.py new file mode 100644 index 000000000..b32fa9553 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/recipes.py @@ -0,0 +1,1046 @@ +"""Imported from the recipes section of the itertools documentation. + +All functions taken from the recipes section of the itertools library docs +[1]_. +Some backward-compatible usability improvements have been made. + +.. [1] http://docs.python.org/library/itertools.html#recipes + +""" + +import math +import operator + +from collections import deque +from collections.abc import Sized +from functools import partial, reduce +from itertools import ( + chain, + combinations, + compress, + count, + cycle, + groupby, + islice, + product, + repeat, + starmap, + tee, + zip_longest, +) +from random import randrange, sample, choice +from sys import hexversion + +__all__ = [ + 'all_equal', + 'batched', + 'before_and_after', + 'consume', + 'convolve', + 'dotproduct', + 'first_true', + 'factor', + 'flatten', + 'grouper', + 'iter_except', + 'iter_index', + 'matmul', + 'ncycles', + 'nth', + 'nth_combination', + 'padnone', + 'pad_none', + 'pairwise', + 'partition', + 'polynomial_eval', + 'polynomial_from_roots', + 'polynomial_derivative', + 'powerset', + 'prepend', + 'quantify', + 'reshape', + 'random_combination_with_replacement', + 'random_combination', + 'random_permutation', + 'random_product', + 'repeatfunc', + 'roundrobin', + 'sieve', + 'sliding_window', + 'subslices', + 'sum_of_squares', + 'tabulate', + 'tail', + 'take', + 'totient', + 'transpose', + 'triplewise', + 'unique', + 'unique_everseen', + 'unique_justseen', +] + +_marker = object() + + +# zip with strict is available for Python 3.10+ +try: + zip(strict=True) +except TypeError: + _zip_strict = zip +else: + _zip_strict = partial(zip, strict=True) + +# math.sumprod is available for Python 3.12+ +_sumprod = getattr(math, 'sumprod', lambda x, y: dotproduct(x, y)) + + +def take(n, iterable): + """Return first *n* items of the iterable as a list. + + >>> take(3, range(10)) + [0, 1, 2] + + If there are fewer than *n* items in the iterable, all of them are + returned. + + >>> take(10, range(3)) + [0, 1, 2] + + """ + return list(islice(iterable, n)) + + +def tabulate(function, start=0): + """Return an iterator over the results of ``func(start)``, + ``func(start + 1)``, ``func(start + 2)``... + + *func* should be a function that accepts one integer argument. + + If *start* is not specified it defaults to 0. It will be incremented each + time the iterator is advanced. + + >>> square = lambda x: x ** 2 + >>> iterator = tabulate(square, -3) + >>> take(4, iterator) + [9, 4, 1, 0] + + """ + return map(function, count(start)) + + +def tail(n, iterable): + """Return an iterator over the last *n* items of *iterable*. + + >>> t = tail(3, 'ABCDEFG') + >>> list(t) + ['E', 'F', 'G'] + + """ + # If the given iterable has a length, then we can use islice to get its + # final elements. Note that if the iterable is not actually Iterable, + # either islice or deque will throw a TypeError. This is why we don't + # check if it is Iterable. + if isinstance(iterable, Sized): + yield from islice(iterable, max(0, len(iterable) - n), None) + else: + yield from iter(deque(iterable, maxlen=n)) + + +def consume(iterator, n=None): + """Advance *iterable* by *n* steps. If *n* is ``None``, consume it + entirely. + + Efficiently exhausts an iterator without returning values. Defaults to + consuming the whole iterator, but an optional second argument may be + provided to limit consumption. + + >>> i = (x for x in range(10)) + >>> next(i) + 0 + >>> consume(i, 3) + >>> next(i) + 4 + >>> consume(i) + >>> next(i) + Traceback (most recent call last): + File "", line 1, in + StopIteration + + If the iterator has fewer items remaining than the provided limit, the + whole iterator will be consumed. + + >>> i = (x for x in range(3)) + >>> consume(i, 5) + >>> next(i) + Traceback (most recent call last): + File "", line 1, in + StopIteration + + """ + # Use functions that consume iterators at C speed. + if n is None: + # feed the entire iterator into a zero-length deque + deque(iterator, maxlen=0) + else: + # advance to the empty slice starting at position n + next(islice(iterator, n, n), None) + + +def nth(iterable, n, default=None): + """Returns the nth item or a default value. + + >>> l = range(10) + >>> nth(l, 3) + 3 + >>> nth(l, 20, "zebra") + 'zebra' + + """ + return next(islice(iterable, n, None), default) + + +def all_equal(iterable, key=None): + """ + Returns ``True`` if all the elements are equal to each other. + + >>> all_equal('aaaa') + True + >>> all_equal('aaab') + False + + A function that accepts a single argument and returns a transformed version + of each input item can be specified with *key*: + + >>> all_equal('AaaA', key=str.casefold) + True + >>> all_equal([1, 2, 3], key=lambda x: x < 10) + True + + """ + return len(list(islice(groupby(iterable, key), 2))) <= 1 + + +def quantify(iterable, pred=bool): + """Return the how many times the predicate is true. + + >>> quantify([True, False, True]) + 2 + + """ + return sum(map(pred, iterable)) + + +def pad_none(iterable): + """Returns the sequence of elements and then returns ``None`` indefinitely. + + >>> take(5, pad_none(range(3))) + [0, 1, 2, None, None] + + Useful for emulating the behavior of the built-in :func:`map` function. + + See also :func:`padded`. + + """ + return chain(iterable, repeat(None)) + + +padnone = pad_none + + +def ncycles(iterable, n): + """Returns the sequence elements *n* times + + >>> list(ncycles(["a", "b"], 3)) + ['a', 'b', 'a', 'b', 'a', 'b'] + + """ + return chain.from_iterable(repeat(tuple(iterable), n)) + + +def dotproduct(vec1, vec2): + """Returns the dot product of the two iterables. + + >>> dotproduct([10, 10], [20, 20]) + 400 + + """ + return sum(map(operator.mul, vec1, vec2)) + + +def flatten(listOfLists): + """Return an iterator flattening one level of nesting in a list of lists. + + >>> list(flatten([[0, 1], [2, 3]])) + [0, 1, 2, 3] + + See also :func:`collapse`, which can flatten multiple levels of nesting. + + """ + return chain.from_iterable(listOfLists) + + +def repeatfunc(func, times=None, *args): + """Call *func* with *args* repeatedly, returning an iterable over the + results. + + If *times* is specified, the iterable will terminate after that many + repetitions: + + >>> from operator import add + >>> times = 4 + >>> args = 3, 5 + >>> list(repeatfunc(add, times, *args)) + [8, 8, 8, 8] + + If *times* is ``None`` the iterable will not terminate: + + >>> from random import randrange + >>> times = None + >>> args = 1, 11 + >>> take(6, repeatfunc(randrange, times, *args)) # doctest:+SKIP + [2, 4, 8, 1, 8, 4] + + """ + if times is None: + return starmap(func, repeat(args)) + return starmap(func, repeat(args, times)) + + +def _pairwise(iterable): + """Returns an iterator of paired items, overlapping, from the original + + >>> take(4, pairwise(count())) + [(0, 1), (1, 2), (2, 3), (3, 4)] + + On Python 3.10 and above, this is an alias for :func:`itertools.pairwise`. + + """ + a, b = tee(iterable) + next(b, None) + return zip(a, b) + + +try: + from itertools import pairwise as itertools_pairwise +except ImportError: + pairwise = _pairwise +else: + + def pairwise(iterable): + return itertools_pairwise(iterable) + + pairwise.__doc__ = _pairwise.__doc__ + + +class UnequalIterablesError(ValueError): + def __init__(self, details=None): + msg = 'Iterables have different lengths' + if details is not None: + msg += (': index 0 has length {}; index {} has length {}').format( + *details + ) + + super().__init__(msg) + + +def _zip_equal_generator(iterables): + for combo in zip_longest(*iterables, fillvalue=_marker): + for val in combo: + if val is _marker: + raise UnequalIterablesError() + yield combo + + +def _zip_equal(*iterables): + # Check whether the iterables are all the same size. + try: + first_size = len(iterables[0]) + for i, it in enumerate(iterables[1:], 1): + size = len(it) + if size != first_size: + raise UnequalIterablesError(details=(first_size, i, size)) + # All sizes are equal, we can use the built-in zip. + return zip(*iterables) + # If any one of the iterables didn't have a length, start reading + # them until one runs out. + except TypeError: + return _zip_equal_generator(iterables) + + +def grouper(iterable, n, incomplete='fill', fillvalue=None): + """Group elements from *iterable* into fixed-length groups of length *n*. + + >>> list(grouper('ABCDEF', 3)) + [('A', 'B', 'C'), ('D', 'E', 'F')] + + The keyword arguments *incomplete* and *fillvalue* control what happens for + iterables whose length is not a multiple of *n*. + + When *incomplete* is `'fill'`, the last group will contain instances of + *fillvalue*. + + >>> list(grouper('ABCDEFG', 3, incomplete='fill', fillvalue='x')) + [('A', 'B', 'C'), ('D', 'E', 'F'), ('G', 'x', 'x')] + + When *incomplete* is `'ignore'`, the last group will not be emitted. + + >>> list(grouper('ABCDEFG', 3, incomplete='ignore', fillvalue='x')) + [('A', 'B', 'C'), ('D', 'E', 'F')] + + When *incomplete* is `'strict'`, a subclass of `ValueError` will be raised. + + >>> it = grouper('ABCDEFG', 3, incomplete='strict') + >>> list(it) # doctest: +IGNORE_EXCEPTION_DETAIL + Traceback (most recent call last): + ... + UnequalIterablesError + + """ + args = [iter(iterable)] * n + if incomplete == 'fill': + return zip_longest(*args, fillvalue=fillvalue) + if incomplete == 'strict': + return _zip_equal(*args) + if incomplete == 'ignore': + return zip(*args) + else: + raise ValueError('Expected fill, strict, or ignore') + + +def roundrobin(*iterables): + """Yields an item from each iterable, alternating between them. + + >>> list(roundrobin('ABC', 'D', 'EF')) + ['A', 'D', 'E', 'B', 'F', 'C'] + + This function produces the same output as :func:`interleave_longest`, but + may perform better for some inputs (in particular when the number of + iterables is small). + + """ + # Algorithm credited to George Sakkis + iterators = map(iter, iterables) + for num_active in range(len(iterables), 0, -1): + iterators = cycle(islice(iterators, num_active)) + yield from map(next, iterators) + + +def partition(pred, iterable): + """ + Returns a 2-tuple of iterables derived from the input iterable. + The first yields the items that have ``pred(item) == False``. + The second yields the items that have ``pred(item) == True``. + + >>> is_odd = lambda x: x % 2 != 0 + >>> iterable = range(10) + >>> even_items, odd_items = partition(is_odd, iterable) + >>> list(even_items), list(odd_items) + ([0, 2, 4, 6, 8], [1, 3, 5, 7, 9]) + + If *pred* is None, :func:`bool` is used. + + >>> iterable = [0, 1, False, True, '', ' '] + >>> false_items, true_items = partition(None, iterable) + >>> list(false_items), list(true_items) + ([0, False, ''], [1, True, ' ']) + + """ + if pred is None: + pred = bool + + t1, t2, p = tee(iterable, 3) + p1, p2 = tee(map(pred, p)) + return (compress(t1, map(operator.not_, p1)), compress(t2, p2)) + + +def powerset(iterable): + """Yields all possible subsets of the iterable. + + >>> list(powerset([1, 2, 3])) + [(), (1,), (2,), (3,), (1, 2), (1, 3), (2, 3), (1, 2, 3)] + + :func:`powerset` will operate on iterables that aren't :class:`set` + instances, so repeated elements in the input will produce repeated elements + in the output. + + >>> seq = [1, 1, 0] + >>> list(powerset(seq)) + [(), (1,), (1,), (0,), (1, 1), (1, 0), (1, 0), (1, 1, 0)] + + For a variant that efficiently yields actual :class:`set` instances, see + :func:`powerset_of_sets`. + """ + s = list(iterable) + return chain.from_iterable(combinations(s, r) for r in range(len(s) + 1)) + + +def unique_everseen(iterable, key=None): + """ + Yield unique elements, preserving order. + + >>> list(unique_everseen('AAAABBBCCDAABBB')) + ['A', 'B', 'C', 'D'] + >>> list(unique_everseen('ABBCcAD', str.lower)) + ['A', 'B', 'C', 'D'] + + Sequences with a mix of hashable and unhashable items can be used. + The function will be slower (i.e., `O(n^2)`) for unhashable items. + + Remember that ``list`` objects are unhashable - you can use the *key* + parameter to transform the list to a tuple (which is hashable) to + avoid a slowdown. + + >>> iterable = ([1, 2], [2, 3], [1, 2]) + >>> list(unique_everseen(iterable)) # Slow + [[1, 2], [2, 3]] + >>> list(unique_everseen(iterable, key=tuple)) # Faster + [[1, 2], [2, 3]] + + Similarly, you may want to convert unhashable ``set`` objects with + ``key=frozenset``. For ``dict`` objects, + ``key=lambda x: frozenset(x.items())`` can be used. + + """ + seenset = set() + seenset_add = seenset.add + seenlist = [] + seenlist_add = seenlist.append + use_key = key is not None + + for element in iterable: + k = key(element) if use_key else element + try: + if k not in seenset: + seenset_add(k) + yield element + except TypeError: + if k not in seenlist: + seenlist_add(k) + yield element + + +def unique_justseen(iterable, key=None): + """Yields elements in order, ignoring serial duplicates + + >>> list(unique_justseen('AAAABBBCCDAABBB')) + ['A', 'B', 'C', 'D', 'A', 'B'] + >>> list(unique_justseen('ABBCcAD', str.lower)) + ['A', 'B', 'C', 'A', 'D'] + + """ + if key is None: + return map(operator.itemgetter(0), groupby(iterable)) + + return map(next, map(operator.itemgetter(1), groupby(iterable, key))) + + +def unique(iterable, key=None, reverse=False): + """Yields unique elements in sorted order. + + >>> list(unique([[1, 2], [3, 4], [1, 2]])) + [[1, 2], [3, 4]] + + *key* and *reverse* are passed to :func:`sorted`. + + >>> list(unique('ABBcCAD', str.casefold)) + ['A', 'B', 'c', 'D'] + >>> list(unique('ABBcCAD', str.casefold, reverse=True)) + ['D', 'c', 'B', 'A'] + + The elements in *iterable* need not be hashable, but they must be + comparable for sorting to work. + """ + return unique_justseen(sorted(iterable, key=key, reverse=reverse), key=key) + + +def iter_except(func, exception, first=None): + """Yields results from a function repeatedly until an exception is raised. + + Converts a call-until-exception interface to an iterator interface. + Like ``iter(func, sentinel)``, but uses an exception instead of a sentinel + to end the loop. + + >>> l = [0, 1, 2] + >>> list(iter_except(l.pop, IndexError)) + [2, 1, 0] + + Multiple exceptions can be specified as a stopping condition: + + >>> l = [1, 2, 3, '...', 4, 5, 6] + >>> list(iter_except(lambda: 1 + l.pop(), (IndexError, TypeError))) + [7, 6, 5] + >>> list(iter_except(lambda: 1 + l.pop(), (IndexError, TypeError))) + [4, 3, 2] + >>> list(iter_except(lambda: 1 + l.pop(), (IndexError, TypeError))) + [] + + """ + try: + if first is not None: + yield first() + while 1: + yield func() + except exception: + pass + + +def first_true(iterable, default=None, pred=None): + """ + Returns the first true value in the iterable. + + If no true value is found, returns *default* + + If *pred* is not None, returns the first item for which + ``pred(item) == True`` . + + >>> first_true(range(10)) + 1 + >>> first_true(range(10), pred=lambda x: x > 5) + 6 + >>> first_true(range(10), default='missing', pred=lambda x: x > 9) + 'missing' + + """ + return next(filter(pred, iterable), default) + + +def random_product(*args, repeat=1): + """Draw an item at random from each of the input iterables. + + >>> random_product('abc', range(4), 'XYZ') # doctest:+SKIP + ('c', 3, 'Z') + + If *repeat* is provided as a keyword argument, that many items will be + drawn from each iterable. + + >>> random_product('abcd', range(4), repeat=2) # doctest:+SKIP + ('a', 2, 'd', 3) + + This equivalent to taking a random selection from + ``itertools.product(*args, **kwarg)``. + + """ + pools = [tuple(pool) for pool in args] * repeat + return tuple(choice(pool) for pool in pools) + + +def random_permutation(iterable, r=None): + """Return a random *r* length permutation of the elements in *iterable*. + + If *r* is not specified or is ``None``, then *r* defaults to the length of + *iterable*. + + >>> random_permutation(range(5)) # doctest:+SKIP + (3, 4, 0, 1, 2) + + This equivalent to taking a random selection from + ``itertools.permutations(iterable, r)``. + + """ + pool = tuple(iterable) + r = len(pool) if r is None else r + return tuple(sample(pool, r)) + + +def random_combination(iterable, r): + """Return a random *r* length subsequence of the elements in *iterable*. + + >>> random_combination(range(5), 3) # doctest:+SKIP + (2, 3, 4) + + This equivalent to taking a random selection from + ``itertools.combinations(iterable, r)``. + + """ + pool = tuple(iterable) + n = len(pool) + indices = sorted(sample(range(n), r)) + return tuple(pool[i] for i in indices) + + +def random_combination_with_replacement(iterable, r): + """Return a random *r* length subsequence of elements in *iterable*, + allowing individual elements to be repeated. + + >>> random_combination_with_replacement(range(3), 5) # doctest:+SKIP + (0, 0, 1, 2, 2) + + This equivalent to taking a random selection from + ``itertools.combinations_with_replacement(iterable, r)``. + + """ + pool = tuple(iterable) + n = len(pool) + indices = sorted(randrange(n) for i in range(r)) + return tuple(pool[i] for i in indices) + + +def nth_combination(iterable, r, index): + """Equivalent to ``list(combinations(iterable, r))[index]``. + + The subsequences of *iterable* that are of length *r* can be ordered + lexicographically. :func:`nth_combination` computes the subsequence at + sort position *index* directly, without computing the previous + subsequences. + + >>> nth_combination(range(5), 3, 5) + (0, 3, 4) + + ``ValueError`` will be raised If *r* is negative or greater than the length + of *iterable*. + ``IndexError`` will be raised if the given *index* is invalid. + """ + pool = tuple(iterable) + n = len(pool) + if (r < 0) or (r > n): + raise ValueError + + c = 1 + k = min(r, n - r) + for i in range(1, k + 1): + c = c * (n - k + i) // i + + if index < 0: + index += c + + if (index < 0) or (index >= c): + raise IndexError + + result = [] + while r: + c, n, r = c * r // n, n - 1, r - 1 + while index >= c: + index -= c + c, n = c * (n - r) // n, n - 1 + result.append(pool[-1 - n]) + + return tuple(result) + + +def prepend(value, iterator): + """Yield *value*, followed by the elements in *iterator*. + + >>> value = '0' + >>> iterator = ['1', '2', '3'] + >>> list(prepend(value, iterator)) + ['0', '1', '2', '3'] + + To prepend multiple values, see :func:`itertools.chain` + or :func:`value_chain`. + + """ + return chain([value], iterator) + + +def convolve(signal, kernel): + """Convolve the iterable *signal* with the iterable *kernel*. + + >>> signal = (1, 2, 3, 4, 5) + >>> kernel = [3, 2, 1] + >>> list(convolve(signal, kernel)) + [3, 8, 14, 20, 26, 14, 5] + + Note: the input arguments are not interchangeable, as the *kernel* + is immediately consumed and stored. + + """ + # This implementation intentionally doesn't match the one in the itertools + # documentation. + kernel = tuple(kernel)[::-1] + n = len(kernel) + window = deque([0], maxlen=n) * n + for x in chain(signal, repeat(0, n - 1)): + window.append(x) + yield _sumprod(kernel, window) + + +def before_and_after(predicate, it): + """A variant of :func:`takewhile` that allows complete access to the + remainder of the iterator. + + >>> it = iter('ABCdEfGhI') + >>> all_upper, remainder = before_and_after(str.isupper, it) + >>> ''.join(all_upper) + 'ABC' + >>> ''.join(remainder) # takewhile() would lose the 'd' + 'dEfGhI' + + Note that the first iterator must be fully consumed before the second + iterator can generate valid results. + """ + it = iter(it) + transition = [] + + def true_iterator(): + for elem in it: + if predicate(elem): + yield elem + else: + transition.append(elem) + return + + # Note: this is different from itertools recipes to allow nesting + # before_and_after remainders into before_and_after again. See tests + # for an example. + remainder_iterator = chain(transition, it) + + return true_iterator(), remainder_iterator + + +def triplewise(iterable): + """Return overlapping triplets from *iterable*. + + >>> list(triplewise('ABCDE')) + [('A', 'B', 'C'), ('B', 'C', 'D'), ('C', 'D', 'E')] + + """ + for (a, _), (b, c) in pairwise(pairwise(iterable)): + yield a, b, c + + +def sliding_window(iterable, n): + """Return a sliding window of width *n* over *iterable*. + + >>> list(sliding_window(range(6), 4)) + [(0, 1, 2, 3), (1, 2, 3, 4), (2, 3, 4, 5)] + + If *iterable* has fewer than *n* items, then nothing is yielded: + + >>> list(sliding_window(range(3), 4)) + [] + + For a variant with more features, see :func:`windowed`. + """ + it = iter(iterable) + window = deque(islice(it, n - 1), maxlen=n) + for x in it: + window.append(x) + yield tuple(window) + + +def subslices(iterable): + """Return all contiguous non-empty subslices of *iterable*. + + >>> list(subslices('ABC')) + [['A'], ['A', 'B'], ['A', 'B', 'C'], ['B'], ['B', 'C'], ['C']] + + This is similar to :func:`substrings`, but emits items in a different + order. + """ + seq = list(iterable) + slices = starmap(slice, combinations(range(len(seq) + 1), 2)) + return map(operator.getitem, repeat(seq), slices) + + +def polynomial_from_roots(roots): + """Compute a polynomial's coefficients from its roots. + + >>> roots = [5, -4, 3] # (x - 5) * (x + 4) * (x - 3) + >>> polynomial_from_roots(roots) # x^3 - 4 * x^2 - 17 * x + 60 + [1, -4, -17, 60] + """ + factors = zip(repeat(1), map(operator.neg, roots)) + return list(reduce(convolve, factors, [1])) + + +def iter_index(iterable, value, start=0, stop=None): + """Yield the index of each place in *iterable* that *value* occurs, + beginning with index *start* and ending before index *stop*. + + + >>> list(iter_index('AABCADEAF', 'A')) + [0, 1, 4, 7] + >>> list(iter_index('AABCADEAF', 'A', 1)) # start index is inclusive + [1, 4, 7] + >>> list(iter_index('AABCADEAF', 'A', 1, 7)) # stop index is not inclusive + [1, 4] + + The behavior for non-scalar *values* matches the built-in Python types. + + >>> list(iter_index('ABCDABCD', 'AB')) + [0, 4] + >>> list(iter_index([0, 1, 2, 3, 0, 1, 2, 3], [0, 1])) + [] + >>> list(iter_index([[0, 1], [2, 3], [0, 1], [2, 3]], [0, 1])) + [0, 2] + + See :func:`locate` for a more general means of finding the indexes + associated with particular values. + + """ + seq_index = getattr(iterable, 'index', None) + if seq_index is None: + # Slow path for general iterables + it = islice(iterable, start, stop) + for i, element in enumerate(it, start): + if element is value or element == value: + yield i + else: + # Fast path for sequences + stop = len(iterable) if stop is None else stop + i = start - 1 + try: + while True: + yield (i := seq_index(value, i + 1, stop)) + except ValueError: + pass + + +def sieve(n): + """Yield the primes less than n. + + >>> list(sieve(30)) + [2, 3, 5, 7, 11, 13, 17, 19, 23, 29] + """ + if n > 2: + yield 2 + start = 3 + data = bytearray((0, 1)) * (n // 2) + limit = math.isqrt(n) + 1 + for p in iter_index(data, 1, start, limit): + yield from iter_index(data, 1, start, p * p) + data[p * p : n : p + p] = bytes(len(range(p * p, n, p + p))) + start = p * p + yield from iter_index(data, 1, start) + + +def _batched(iterable, n, *, strict=False): + """Batch data into tuples of length *n*. If the number of items in + *iterable* is not divisible by *n*: + * The last batch will be shorter if *strict* is ``False``. + * :exc:`ValueError` will be raised if *strict* is ``True``. + + >>> list(batched('ABCDEFG', 3)) + [('A', 'B', 'C'), ('D', 'E', 'F'), ('G',)] + + On Python 3.13 and above, this is an alias for :func:`itertools.batched`. + """ + if n < 1: + raise ValueError('n must be at least one') + it = iter(iterable) + while batch := tuple(islice(it, n)): + if strict and len(batch) != n: + raise ValueError('batched(): incomplete batch') + yield batch + + +if hexversion >= 0x30D00A2: + from itertools import batched as itertools_batched + + def batched(iterable, n, *, strict=False): + return itertools_batched(iterable, n, strict=strict) + +else: + batched = _batched + + batched.__doc__ = _batched.__doc__ + + +def transpose(it): + """Swap the rows and columns of the input matrix. + + >>> list(transpose([(1, 2, 3), (11, 22, 33)])) + [(1, 11), (2, 22), (3, 33)] + + The caller should ensure that the dimensions of the input are compatible. + If the input is empty, no output will be produced. + """ + return _zip_strict(*it) + + +def reshape(matrix, cols): + """Reshape the 2-D input *matrix* to have a column count given by *cols*. + + >>> matrix = [(0, 1), (2, 3), (4, 5)] + >>> cols = 3 + >>> list(reshape(matrix, cols)) + [(0, 1, 2), (3, 4, 5)] + """ + return batched(chain.from_iterable(matrix), cols) + + +def matmul(m1, m2): + """Multiply two matrices. + + >>> list(matmul([(7, 5), (3, 5)], [(2, 5), (7, 9)])) + [(49, 80), (41, 60)] + + The caller should ensure that the dimensions of the input matrices are + compatible with each other. + """ + n = len(m2[0]) + return batched(starmap(_sumprod, product(m1, transpose(m2))), n) + + +def factor(n): + """Yield the prime factors of n. + + >>> list(factor(360)) + [2, 2, 2, 3, 3, 5] + """ + for prime in sieve(math.isqrt(n) + 1): + while not n % prime: + yield prime + n //= prime + if n == 1: + return + if n > 1: + yield n + + +def polynomial_eval(coefficients, x): + """Evaluate a polynomial at a specific value. + + Example: evaluating x^3 - 4 * x^2 - 17 * x + 60 at x = 2.5: + + >>> coefficients = [1, -4, -17, 60] + >>> x = 2.5 + >>> polynomial_eval(coefficients, x) + 8.125 + """ + n = len(coefficients) + if n == 0: + return x * 0 # coerce zero to the type of x + powers = map(pow, repeat(x), reversed(range(n))) + return _sumprod(coefficients, powers) + + +def sum_of_squares(it): + """Return the sum of the squares of the input values. + + >>> sum_of_squares([10, 20, 30]) + 1400 + """ + return _sumprod(*tee(it)) + + +def polynomial_derivative(coefficients): + """Compute the first derivative of a polynomial. + + Example: evaluating the derivative of x^3 - 4 * x^2 - 17 * x + 60 + + >>> coefficients = [1, -4, -17, 60] + >>> derivative_coefficients = polynomial_derivative(coefficients) + >>> derivative_coefficients + [3, -8, -17] + """ + n = len(coefficients) + powers = reversed(range(1, n)) + return list(map(operator.mul, coefficients, powers)) + + +def totient(n): + """Return the count of natural numbers up to *n* that are coprime with *n*. + + >>> totient(9) + 6 + >>> totient(12) + 4 + """ + # The itertools docs use unique_justseen instead of set; see + # https://github.com/more-itertools/more-itertools/issues/823 + for p in set(factor(n)): + n = n // p * (p - 1) + + return n diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/recipes.pyi b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/recipes.pyi new file mode 100644 index 000000000..739acec05 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/more_itertools/recipes.pyi @@ -0,0 +1,136 @@ +"""Stubs for more_itertools.recipes""" + +from __future__ import annotations + +from typing import ( + Any, + Callable, + Iterable, + Iterator, + overload, + Sequence, + Type, + TypeVar, +) + +# Type and type variable definitions +_T = TypeVar('_T') +_T1 = TypeVar('_T1') +_T2 = TypeVar('_T2') +_U = TypeVar('_U') + +def take(n: int, iterable: Iterable[_T]) -> list[_T]: ... +def tabulate( + function: Callable[[int], _T], start: int = ... +) -> Iterator[_T]: ... +def tail(n: int, iterable: Iterable[_T]) -> Iterator[_T]: ... +def consume(iterator: Iterable[_T], n: int | None = ...) -> None: ... +@overload +def nth(iterable: Iterable[_T], n: int) -> _T | None: ... +@overload +def nth(iterable: Iterable[_T], n: int, default: _U) -> _T | _U: ... +def all_equal( + iterable: Iterable[_T], key: Callable[[_T], _U] | None = ... +) -> bool: ... +def quantify( + iterable: Iterable[_T], pred: Callable[[_T], bool] = ... +) -> int: ... +def pad_none(iterable: Iterable[_T]) -> Iterator[_T | None]: ... +def padnone(iterable: Iterable[_T]) -> Iterator[_T | None]: ... +def ncycles(iterable: Iterable[_T], n: int) -> Iterator[_T]: ... +def dotproduct(vec1: Iterable[_T1], vec2: Iterable[_T2]) -> Any: ... +def flatten(listOfLists: Iterable[Iterable[_T]]) -> Iterator[_T]: ... +def repeatfunc( + func: Callable[..., _U], times: int | None = ..., *args: Any +) -> Iterator[_U]: ... +def pairwise(iterable: Iterable[_T]) -> Iterator[tuple[_T, _T]]: ... +def grouper( + iterable: Iterable[_T], + n: int, + incomplete: str = ..., + fillvalue: _U = ..., +) -> Iterator[tuple[_T | _U, ...]]: ... +def roundrobin(*iterables: Iterable[_T]) -> Iterator[_T]: ... +def partition( + pred: Callable[[_T], object] | None, iterable: Iterable[_T] +) -> tuple[Iterator[_T], Iterator[_T]]: ... +def powerset(iterable: Iterable[_T]) -> Iterator[tuple[_T, ...]]: ... +def unique_everseen( + iterable: Iterable[_T], key: Callable[[_T], _U] | None = ... +) -> Iterator[_T]: ... +def unique_justseen( + iterable: Iterable[_T], key: Callable[[_T], object] | None = ... +) -> Iterator[_T]: ... +def unique( + iterable: Iterable[_T], + key: Callable[[_T], object] | None = ..., + reverse: bool = False, +) -> Iterator[_T]: ... +@overload +def iter_except( + func: Callable[[], _T], + exception: Type[BaseException] | tuple[Type[BaseException], ...], + first: None = ..., +) -> Iterator[_T]: ... +@overload +def iter_except( + func: Callable[[], _T], + exception: Type[BaseException] | tuple[Type[BaseException], ...], + first: Callable[[], _U], +) -> Iterator[_T | _U]: ... +@overload +def first_true( + iterable: Iterable[_T], *, pred: Callable[[_T], object] | None = ... +) -> _T | None: ... +@overload +def first_true( + iterable: Iterable[_T], + default: _U, + pred: Callable[[_T], object] | None = ..., +) -> _T | _U: ... +def random_product( + *args: Iterable[_T], repeat: int = ... +) -> tuple[_T, ...]: ... +def random_permutation( + iterable: Iterable[_T], r: int | None = ... +) -> tuple[_T, ...]: ... +def random_combination(iterable: Iterable[_T], r: int) -> tuple[_T, ...]: ... +def random_combination_with_replacement( + iterable: Iterable[_T], r: int +) -> tuple[_T, ...]: ... +def nth_combination( + iterable: Iterable[_T], r: int, index: int +) -> tuple[_T, ...]: ... +def prepend(value: _T, iterator: Iterable[_U]) -> Iterator[_T | _U]: ... +def convolve(signal: Iterable[_T], kernel: Iterable[_T]) -> Iterator[_T]: ... +def before_and_after( + predicate: Callable[[_T], bool], it: Iterable[_T] +) -> tuple[Iterator[_T], Iterator[_T]]: ... +def triplewise(iterable: Iterable[_T]) -> Iterator[tuple[_T, _T, _T]]: ... +def sliding_window( + iterable: Iterable[_T], n: int +) -> Iterator[tuple[_T, ...]]: ... +def subslices(iterable: Iterable[_T]) -> Iterator[list[_T]]: ... +def polynomial_from_roots(roots: Sequence[_T]) -> list[_T]: ... +def iter_index( + iterable: Iterable[_T], + value: Any, + start: int | None = ..., + stop: int | None = ..., +) -> Iterator[int]: ... +def sieve(n: int) -> Iterator[int]: ... +def batched( + iterable: Iterable[_T], n: int, *, strict: bool = False +) -> Iterator[tuple[_T]]: ... +def transpose( + it: Iterable[Iterable[_T]], +) -> Iterator[tuple[_T, ...]]: ... +def reshape( + matrix: Iterable[Iterable[_T]], cols: int +) -> Iterator[tuple[_T, ...]]: ... +def matmul(m1: Sequence[_T], m2: Sequence[_T]) -> Iterator[tuple[_T]]: ... +def factor(n: int) -> Iterator[int]: ... +def polynomial_eval(coefficients: Sequence[_T], x: _U) -> _U: ... +def sum_of_squares(it: Iterable[_T]) -> _T: ... +def polynomial_derivative(coefficients: Sequence[_T]) -> list[_T]: ... +def totient(n: int) -> int: ... diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/INSTALLER b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/INSTALLER new file mode 100644 index 000000000..5c69047b2 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/INSTALLER @@ -0,0 +1 @@ +uv \ No newline at end of file diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE new file mode 100644 index 000000000..6f62d44e4 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE @@ -0,0 +1,3 @@ +This software is made available under the terms of *either* of the licenses +found in LICENSE.APACHE or LICENSE.BSD. Contributions to this software is made +under the terms of *both* these licenses. diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE.APACHE b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE.APACHE new file mode 100644 index 000000000..f433b1a53 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE.APACHE @@ -0,0 +1,177 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE.BSD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE.BSD new file mode 100644 index 000000000..42ce7b75c --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/LICENSE.BSD @@ -0,0 +1,23 @@ +Copyright (c) Donald Stufft and individual contributors. +All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are met: + + 1. Redistributions of source code must retain the above copyright notice, + this list of conditions and the following disclaimer. + + 2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE +DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR +SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER +CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, +OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/METADATA b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/METADATA new file mode 100644 index 000000000..1479c8694 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/METADATA @@ -0,0 +1,102 @@ +Metadata-Version: 2.3 +Name: packaging +Version: 24.2 +Summary: Core utilities for Python packages +Author-email: Donald Stufft +Requires-Python: >=3.8 +Description-Content-Type: text/x-rst +Classifier: Development Status :: 5 - Production/Stable +Classifier: Intended Audience :: Developers +Classifier: License :: OSI Approved :: Apache Software License +Classifier: License :: OSI Approved :: BSD License +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 +Classifier: Typing :: Typed +Project-URL: Documentation, https://packaging.pypa.io/ +Project-URL: Source, https://github.com/pypa/packaging + +packaging +========= + +.. start-intro + +Reusable core utilities for various Python Packaging +`interoperability specifications `_. + +This library provides utilities that implement the interoperability +specifications which have clearly one correct behaviour (eg: :pep:`440`) +or benefit greatly from having a single shared implementation (eg: :pep:`425`). + +.. end-intro + +The ``packaging`` project includes the following: version handling, specifiers, +markers, requirements, tags, utilities. + +Documentation +------------- + +The `documentation`_ provides information and the API for the following: + +- Version Handling +- Specifiers +- Markers +- Requirements +- Tags +- Utilities + +Installation +------------ + +Use ``pip`` to install these utilities:: + + pip install packaging + +The ``packaging`` library uses calendar-based versioning (``YY.N``). + +Discussion +---------- + +If you run into bugs, you can file them in our `issue tracker`_. + +You can also join ``#pypa`` on Freenode to ask questions or get involved. + + +.. _`documentation`: https://packaging.pypa.io/ +.. _`issue tracker`: https://github.com/pypa/packaging/issues + + +Code of Conduct +--------------- + +Everyone interacting in the packaging project's codebases, issue trackers, chat +rooms, and mailing lists is expected to follow the `PSF Code of Conduct`_. + +.. _PSF Code of Conduct: https://github.com/pypa/.github/blob/main/CODE_OF_CONDUCT.md + +Contributing +------------ + +The ``CONTRIBUTING.rst`` file outlines how to contribute to this project as +well as how to report a potential security issue. The documentation for this +project also covers information about `project development`_ and `security`_. + +.. _`project development`: https://packaging.pypa.io/en/latest/development/ +.. _`security`: https://packaging.pypa.io/en/latest/security/ + +Project History +--------------- + +Please review the ``CHANGELOG.rst`` file or the `Changelog documentation`_ for +recent changes and project history. + +.. _`Changelog documentation`: https://packaging.pypa.io/en/latest/changelog/ + diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/RECORD b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/RECORD new file mode 100644 index 000000000..678aa5a50 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/RECORD @@ -0,0 +1,25 @@ +packaging-24.2.dist-info/INSTALLER,sha256=5hhM4Q4mYTT9z6QB6PGpUAW81PGNFrYrdXMj4oM_6ak,2 +packaging-24.2.dist-info/LICENSE,sha256=ytHvW9NA1z4HS6YU0m996spceUDD2MNIUuZcSQlobEg,197 +packaging-24.2.dist-info/LICENSE.APACHE,sha256=DVQuDIgE45qn836wDaWnYhSdxoLXgpRRKH4RuTjpRZQ,10174 +packaging-24.2.dist-info/LICENSE.BSD,sha256=tw5-m3QvHMb5SLNMFqo5_-zpQZY2S8iP8NIYDwAo-sU,1344 +packaging-24.2.dist-info/METADATA,sha256=ohH86s6k5mIfQxY2TS0LcSfADeOFa4BiCC-bxZV-pNs,3204 +packaging-24.2.dist-info/RECORD,, +packaging-24.2.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +packaging-24.2.dist-info/WHEEL,sha256=CpUCUxeHQbRN5UGRQHYRJorO5Af-Qy_fHMctcQ8DSGI,82 +packaging/__init__.py,sha256=dk4Ta_vmdVJxYHDcfyhvQNw8V3PgSBomKNXqg-D2JDY,494 +packaging/_elffile.py,sha256=cflAQAkE25tzhYmq_aCi72QfbT_tn891tPzfpbeHOwE,3306 +packaging/_manylinux.py,sha256=vl5OCoz4kx80H5rwXKeXWjl9WNISGmr4ZgTpTP9lU9c,9612 +packaging/_musllinux.py,sha256=p9ZqNYiOItGee8KcZFeHF_YcdhVwGHdK6r-8lgixvGQ,2694 +packaging/_parser.py,sha256=s_TvTvDNK0NrM2QB3VKThdWFM4Nc0P6JnkObkl3MjpM,10236 +packaging/_structures.py,sha256=q3eVNmbWJGG_S0Dit_S3Ao8qQqz_5PYTXFAKBZe5yr4,1431 +packaging/_tokenizer.py,sha256=J6v5H7Jzvb-g81xp_2QACKwO7LxHQA6ikryMU7zXwN8,5273 +packaging/licenses/__init__.py,sha256=1x5M1nEYjcgwEbLt0dXwz2ukjr18DiCzC0sraQqJ-Ww,5715 +packaging/licenses/_spdx.py,sha256=oAm1ztPFwlsmCKe7lAAsv_OIOfS1cWDu9bNBkeu-2ns,48398 +packaging/markers.py,sha256=c89TNzB7ZdGYhkovm6PYmqGyHxXlYVaLW591PHUNKD8,10561 +packaging/metadata.py,sha256=YJibM7GYe4re8-0a3OlXmGS-XDgTEoO4tlBt2q25Bng,34762 +packaging/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0 +packaging/requirements.py,sha256=gYyRSAdbrIyKDY66ugIDUQjRMvxkH2ALioTmX3tnL6o,2947 +packaging/specifiers.py,sha256=GG1wPNMcL0fMJO68vF53wKMdwnfehDcaI-r9NpTfilA,40074 +packaging/tags.py,sha256=CFqrJzAzc2XNGexerH__T-Y5Iwq7WbsYXsiLERLWxY0,21014 +packaging/utils.py,sha256=0F3Hh9OFuRgrhTgGZUl5K22Fv1YP2tZl1z_2gO6kJiA,5050 +packaging/version.py,sha256=olfyuk_DPbflNkJ4wBWetXQ17c74x3DB501degUv7DY,16676 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/REQUESTED b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/REQUESTED new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/WHEEL b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/WHEEL new file mode 100644 index 000000000..e3c6feefa --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging-24.2.dist-info/WHEEL @@ -0,0 +1,4 @@ +Wheel-Version: 1.0 +Generator: flit 3.10.1 +Root-Is-Purelib: true +Tag: py3-none-any diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__init__.py new file mode 100644 index 000000000..d79f73c57 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..56112b445a0ba6be5d43bd7f6da4115c295f1262 GIT binary patch literal 596 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/_musllinux.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..2845d947fe14993e558a3d31cf0e6d916cf831a2 GIT binary patch literal 4607 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 TWb#wL49@ClU5Fv6g&XBRsq~Ew literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/_parser.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/_parser.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..23ec2e41d85d519a86f875e5b6fe8fa2649a34de GIT binary patch literal 14038 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/_structures.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/_structures.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..75263940f4261944a5b5d7a9c8c13e2745e91c20 GIT binary patch literal 3279 zcmc&#&u<%55PrK}J5FN9fjGoz($-a|sDWgY7J-neo=TudSQY8Xm(|9*v0a>9_wA;_ zQ4Tre00JZ=kdk9Kp(uX>cP?ClazQI@`~yL*RH-NCd(U2Z9d8J^u+q-X%+7l=Z+?95 zw`_Kd(evvsW_>@&*k2HOkJe>6pAfUpRQ55m*dDW#V^#jCkj`euU9*ZJEL5^cgcd4U zsG&uot(B71uD$q#KK4l5r`;-w#VV?$*oh6*QunlqMtqX^1o0_LvqwlyZ)jGM#nc+TfWO1W>a4Zxn^TsZ?*lp>)cyfxvP5(-(GB))i2B%t@bFu zmhZYvPdA?1j^%P){%bfj-SB+ARizWy-cqX_qz!}HEp8aw)4gzU%B7xqgaY=c5!f#K zBRAV2hDA<}U*hC%6SL3!Fe^T^;@M%xU2X5XMhPh&sex8Ey?US_0G=jWnI4V~L}2(k zBrvIlQRg)xyX?>0)Q=Aj@;`ifn!9qQB4rp&pJJFANDh=)vg`CxlNVkucE{g<5BTFVM9w*~hdCnUBv#CV;A9aW z=r?hsC1U#1zoYE1r-O$lo8BOe6=AI5H5|`3ovIy-8b-BgdLC7OScLYoArV43 zMO$@1P>k7w+lTp|Z~S!QG`D<`UOpc**+r*?>hL5!FSTI>fD-8p3ovyFKYW2!T;OO} z0cxZaxxbCID1c~{AYZm?rr&sO_jg8QG|=>-Hb^wphNyhHxi2Zf|CcO769XzPR@yg({G2T}xi6XY$BcR)lZi;Q3xInF9biWu)ZB75viRg%{Z7CMYR zXDKCFlzb8V^ug*G>8B5U{GN_ctw^gCX|)2Yyj10-Dj%aNe!qe3izl}}c!9619fGXV z8$OsIJe@rv|JQ|MPtb)kP8UwDohfDc9SVgbut-0V9330FWVS~adwn6xF#w~YyxZ3Y z+bja{sA>rD*W?(5Fi!uj2=M}6c#bw0Y--VIu|Y|A7hMKKk!1rgM}UvyXfiICZPCWt zb1_K(l;iT^;ecP=5k@865l!G?yd%_Gz{M4zoL|S@gRm_IH#Q_-_cE5<0y%fPka8f& z@i&+Nhge5|>wEAq{2KdDj?fzMjws3RM;r;bjttVj12YGNooicw-u8S<8wouAkSsjF zBJg=tXamSLyrm#(Kc-(;}41 sL+;KJilV&C%qYdb8OVDqQ~2h=Zu(_vMkzp5AXWa(=~U@=HYuF`0|Ua7fB*mh literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/_tokenizer.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/_tokenizer.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..ccbeb3abc12d2b1d8de87a2c6af8e1a393bfa975 GIT binary patch literal 7949 zcma($S!^6va<8x9oScKC4vM5&JR}aqLu>D@Z5>|m7)c}XT9WcHB-L(CH^q_W;C2r! zO=q-F90p5nEKtNIAq{zBB|s1f%EsLMtd0HHMLq%p`5_?(8h0)NPJry+*wn(iLV%>| z^~~^;ohPxnUcGwNuV2-xs#o(*9*>hi`^R6(Q}0z0@;P>jt;|B0jsIZ?St6H-LKG%W z5=?|)5NG3Tgr!d|!oib^^9dm$&@n!4OO!>*684B4`hsGMI}*-_lOd|WlJi6;w*B+6C;XCasPx-JW4r0ui^vfR{{VlluCeA%07VmS)y{+ zY6`-(Jd^`KuiHW>pvCvY+=EIrz(Yz6z*?ma;9*4sc;vY<>%UQE!}I2<&THcC)d01A zH`M^r-fseG;~xB=wJqP(s5HS>99511Y*vB*Ta@DfTa`AYUFmqA`)ejrp`1`Fm2aH} zVRZjrfc<~5C?ispVT0fP4ZbMIm@YY)Or_;?ES1#zq3=-Sv>c7gx*lXrdpNCXayq4% z_Wsn6nx4^;zX8j^d5+;}H5!|Ysag~z6R&MpD<+q{-=N&E%7ELN)ocdNXZuv1Hn`Pp9-4uChPKn|4XUaY-_rl9Wg( zGjYV-lJtWaIbIm?O4623lca}a0~h&hu45{dP&?$fdb6W1GpMDmsnN9F5gHzB>rW}F zg@t?0NkgfLRJtQQ1D_w0;~niKEFPQan9ii9Qpp$Fzx6@~EK6;hmZR6@t1w%KU7Aj( zQgOXQdRt8@DXqgAizTmiNNN1Sn4xOz(-{rVDFrS-bU%PUChJbmABA%il>2A_&GAkDD12|!o#`cX8DLPM{Y6^+b{{*O#h&)>8duINv7qS zAx%qZ#!DkpsyMBs-i|4%BI>CbEvkyB3Nf0Ri7O%)j5q-tI8gzbrok4*GwspB=?9}D z1T6vnn2laQ{)|~7SuRT?z^#^Lpog|ZTb6}haW+ZYiu8FtOYXqV6#WT9GGKiDLBZtp zX*p?@B~)F9eK&2^DosJ3nO4DEB`KDSr6q}Ss_{wf5Qx-j5L5#&9g;+iT#|GF`XaR3 z+CCgcuVPg1+LZR9MAV4h1mJhKNxqy^9h~Feb>#Nf!NZ-~R|5~%f7(6sWoz~W|7@?O z3XGP%6Q<$o=)U{|AWLu>vg8_IJDb8D1d;*V3hdjS96WM7XUv)n7KReg<0t~cTa046 zhML*YKnlNu1YMw(G_g6FWv+6M3SR^kRM!8D5jE7^Gv|1mIirixA|+S zSaMSZK~_5qe5NfSYu8mx$H}5dx8E!Sjifb6G7j#g0y zU(Bxg8}3IRjC}a!!#7uc@Nn#-o?nGO4*y#IxOc7X!rIaBnm_zW_nLoT&X)7;U$`}Y zYgzdq{$Bh+&xe;DUixU?YVFy_-p*BfCskR{ZY>v&re!u1L)$UDaKhv2D0rn-5x}@< z)2M4S`TkT=g^z2-Nyr~8(|m~I+13I8@bi>ZRFbHfX~&S{DVSnZjmN=Y8BGMLjvIW| zvd9B~Y6wt*{t|%S&63af&OGlD4z2qu^8!5cb^@3KF(>iXBh;W`!=s z@+K(B^!0|$jYxx?L!thW3!&lgu)&TsoBpBj`3pPALDNl{yM{WuFNH>can$r!jGLr! z2neCRaQ8s(0NBGRQ|KP(>+5{Rw3?ppUmh3<^+>}bL*f4O#&v2KXdKv@xAiFH*yxpG z<1NR6yGF9RD9!bwSL(-G>bLW5_DptQ&^XY1=FFKa{Qu#Z?2$9s(`T};0?fV|G;Li2 zu-rkzJvPyt(z0?=364#eY`EXBjZMUofOGu=BSzWS1UNkC*~1jB9X=Nh4Vi2wTIX4lyFAoul#N~y$I|1+O=q|V zjGS^9bz>8wa+}fF7CF)O%J?SQF13xffQl<$3k?m22l}PKq0qVT8`8*7XSmnk$J)nQ zjKgEcaRN>}-u%6jqixbyI~74G!4|_dN?-VlX$*4a!J?$zf$q*;skgH$)N6?|+1H0n zF4W)iOjKgg^eFhWRuO=h6*aYeP)xK)jE zBr#*5qN%`yoCY4fopws83i??){Lzs7_kcj6f~iUABeU#Y0kimdJ!FAf;Go3 zF~%U4-QsTXSuTx%p0+)MDF3JsLVv=(Tg#Iu%(;aLQYj285PqeS3``TGQZUZI+nBX&D};@B6QpS8U7 zpmC*auIEqdms%EEmS2AyXj*eOZQvMiJM%UYYy-rbI{*pQ9nbGK956!Pe^2bJu$A-$ zFWF2jFF*(MMXnY05(kSd%M^E5^8?2oNl#ISkW?}mCde8u_ocuXC)7+Tsch!ImT{t! zf^a`6%8&)mK*pO)i^VHRdq3Qj1ZsdL5B8`O5*)gj+q0V}T(f2ps^Q<K8yKr*;z=i4Aj`lXuogj%rNk3(a8wvb-a%UOLRKdKt zYbAr;6bN%lhP{o7$8tw2-eKW@@wb@_pJnyKX;+a6Rtw&(kQMJWyI=%ck2l^tjsNZb z8s{NS$>4mp-iXi^3SJ6>XIDm4)Jb_Jj``puWwo40P9ZXw&eTr=bfm1?p)npMp+?-f@eb2K|dRgltar=ClUaH^?Ql5g_bz zHt0_b@0N3dI?|Ex0|4M@e8l5l7?>YebvNWW)^U+p_tY(?m#6NhR+L|)ex6$W&V^N1 zctgOUoV#J&TLE_kW6@ai9$B?_tv0>#QR7DkRvWq=L&tk$z3SjnWHEA|U#n`GbFTZU zpZLTzpLoCWZw~$Cp$E!`iHC{DzSDC;&gGjsldCxJnYZF!>l*I&JZM^B9yYJ^{G#vY zeUIz9=6c>8$ayQQdtdS7;Q2(yPS0l?kZ*QcdL^8TJ)9PtUiKb=GgokV^vvyXs)}b4 zZfLBbhi*c(CN0WhRMpa;`Yk#XF(kB#lX5H$!B@NyOHToxPRjwJiuC}I+T@LxzSZbQ z;6PXw4d&MZ_SZrUdW%gtte1kd1vw3sX$CYIgh-ZbiOSXnVF1SQK4`@rJD3Hm6^;#l zJs78TFSJ=?!?$S=7G(~&^lt+Ii*OQO<$^J9EH{4YJ)8^ddlCq)1%eO4D^n|x)t0l5 z1D&hxPSDOmWFUxX?8D*zx2`6`#Zi(W8!Z{@02T(ye;*X`~F&yPLtS1e!tAo5=1-r+TS z^BqsF8tWh4b#LXIo0>jGL?@PL;5IL7P`;x$)Wb?K3(rO=W@*rY&1P@A!Ri6u*^*%O zS?+5_xk>gGpDvvj8n^Jo?Pyv4Z<%5h`W+1U?L%mi;;vc)hI#b)S0O!x%(PH@Y=_On z5KXHZV71h{(d#)PRC6cRcTCHs>^j^*joDWi{r*`5MbMA^<#r~yJi>Gq_s;6bV*O@20!)ZCA;^v^^ zz~I<`#kr?|Tq4Z>!y#$4dk1$2#bmFrUUWbVNwNyL#Vh2`nI(oHG;lvJXDhiiy#}Nf zey)HemYU`MAbDZ#Vfw*=E3|=9`C?)K^1op<8S*pk1``zejX=pk(SU{C&k#f!{Ol0? zCgC0?LOBLC2}cV(n5A%ZSsH4vpm5WfnpTrmR&BbX@f7$tde}^xtfgj>is_*YMJw82 z45m*_;v{&#HBC3FH!Wl5*w5g-I+pVOn-(DL1oA`76|a5jI+CjqKj?d}Z?3PDG_Kc( zbA6xNJ?pLmt1d8)00cqmAdi3QJqlb;+zo5)hFqZW{^`mFa@K*Uqh3%3SdFNVBcuK zr{m2yM5(qdRGJI$6Hqa?rcL6stqgDAv`qm}(?p*}g;9KKr4DuV%n3y~xJ+X)&N_it zQ39QSD~Hmaj07rjqJ%|D7;+lr#h*S#QO^KO?=z3!{PN?$cp z`g|v_(pL>iah7jDrLTIUniCE{_r!O8ODcrQjg~Uu&_=*6ROM?({n6avhA&(`!AWa{ z@B|4}hw~1^oTQ>Qk7HOX3~YE1Ya}+`6QOQRsLQjJLS?SHHqYU+wZnRz{vLgc_r}ZiL0l|Iv%gp2q#3uM_|mjn~+mP)oCn0(SoRU5s76`YUvsn4w)4aoHP1+m87Xx)tgvJHUq`t z+7_BKe7=8RDAe6K9MXDFcm)Ew{o7UY%zoPXdFfRRGf#A#`dmaW|ANL)=b;%Db2I4#b^A@ZGJ)^REV8%)d^%Z$S6Z^7;Im pv=?DWeGij!R^(jXFC`@1_N;n4HpmHv{c4h#VwlP=2|{X%{|ASxApHOU literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/markers.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/markers.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e59c01e4558d8fb8af0a82dfa4e5e65e7599cd14 GIT binary patch literal 11414 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 O03IFYY^;Ye;r{{pjl=T* literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/metadata.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/metadata.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..373844233936ee1b5afb8813f54e8ad49d515271 GIT binary patch literal 27292 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/requirements.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/requirements.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cb71090703e8254a24d92d863d79e290e36a7fad GIT binary patch literal 4448 zcmaJ^Z%iD=6`$R`UG5*p-2o=H)36u_z7}(FAdMAlV#k>3;+ndqwbVr475EoA)JKr)aGCWG|5E>oWkB}0_ttn?Ji<^4eFG4w{i<;9XR;^r|kWF#a$mvSAn1l73qB&;d zG789ys#vrP@$`w);%l!Q>Y;-S$2_)IlE|_o$@WW9)=+X8LI)-3VouJKdg>%eF;bFr z4{eg=Zq3HWjI0`$GwNjgRQ@zJ(rU^w<0nQ=9~d?i)u9rDL(&=JoMFYS9GF{^Gx44> zmC??{$Me>hq4)M2d^K)rmU>`ZPF;}CgSM$!xpB)dGG<)5r0R-+<4&KZpO07V*6bP2 z;}9%}Rt-Rybx>VH8!XFvag*D#&EzGZFq=oAd%MXMpTb@PxGH{ygO*nUiU(Q&S{~Xu zC8!9{dX;*m4q9K{8w=Ti>a+P1g^egzpGl9O+S=_oufdk8`$f~jurWAJI3CS1MZlwF zc8g{%H73Gwk~4rW7gybMv>%`Oezz#=ib(Ni_K0U>%~VbCdAx{*4(mB5E1CR(QGl&V zz)*%d9n4vP1Bq10K42V#1o(3Vo&^Bv0`eiN1XzS-nENIAGCRYjy;Oc%HG?FN%K!-) zM%-_won%ZF+#G>qDU={&)w?pFL(X=kAqcd& z9L~VEYT1H=ISkhUvVCP>+Cr9wM@(#ML&(t82}#1l4iIFVJ`)0t$5b<;cC-qFk^?|n zpi5C~Ml}g?NSMRTj=H4jnk7k7O;z63BbB)OK*sz%R9DbC%lZ1&n!5`7-zYZsUmsfc zqCMjB-le_QJvV);t)0tLOH+?p58nL|e0$f#_B%r#o_hb(qmI`foGFTjfEifp>U}Wu zq;GJgZ?M>P0yv@7&KT)f4Mc7oxpAZr=vadxdzN}W+Ev{1%JspUC)e8F`1HGm0DROaiT| zf#WQC$oh_Vat{N|$3^a;$OFC28OcGn6KDJxINnLbfJ4qOzh)K~1{^32ojVKeR+u!n z@6J+zOl>_EG;VvDRlvpHgFE~-SDufAh8+dBSY@|@k!wh}BbG-gJ4t0I+@^RyyGGA@ z=r&u{3|2H;3VRg(8~dY*03+AXtc*;Y>|=0}Sl#dz)4j#Kv&FnS#U2&67;%d27h`p} z6{fR2X+zU(!8EX?Dp&*-CSH!eMXENaVjS)u^ovm0VG?&`3q+lC!8FOKl+hiK;P%7B z4=r=5WgEaN9S1?foQLXP=<6$JH58roKMge8>YwdjZQZv#xitBaaM$`|`rdSLe}A#{ za3T2OYEyGz*UN?Gt~(bC(b%J4jK~kn4y;9+=adC~UN1&F9|b!J_t5O2)uvr@*23ic z1$0jQs6vlAQZUetHY5awTm9N9YHa6*e0g#fnH23MD2Z#p|&^4 zbfo|S(FkG;#E-^p=5?6ILCzGR0=qUuZcW^nn6sX=bgi^>-SvFpyXPymyjpDNEqHrr zMzL*=WbJg1BubM#&LHp;_BID=} zhdV^X$?XP9jI`eIEMB@ZQfP=3ys_ukM4~rc(@h{2s;_L6E?*wdRVuYCeIE9aE?+0E zBwWtb{$0aE-IHYY! zP>j6!6%U=893S?tBi`qCtXXX(flBzIvyLX!*zH-hnMSbv78#Vu+5fNIrKiK=Y;lNrW+|q5&1XTahqOzjH{2FL>v@izk*7ONo_m=SCf2dkMRGi1mO_!XmuTa3|R&xn67m!^;TkwrAMT zRp=qNi*xZD18S28I+}xh!aEd`0BZ|YejHv%&Wg#k0@)=^6)`3* zhW8MbU$Tq~st#{*OcPkUu9R}peAG!p{pDoUbh1}IXK5LeLdy1^C69Re)^{G21bsVp zxaB?UJdp?RDd;6Pj7dT{q;d@NZ!con|B1wZpu=CF*xyj!7pMb%&jgO~F7A1Tp!rX5 Nh++I2h}1OJ{2wzYwwC|^ literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/specifiers.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d26afbe4cb523d34670a96fc8734df9dfeb5ca86 GIT binary patch literal 39081 zcmeHw3v?XUdEU&vumBcV01FTxUL3p#EC>R8K$HXmq$pC9NtuvD(vl5{0+yH|x#R*1 z&n`#;0$j>bYfw>5D2hYqSgxR2si{(_nZ`}%*ymV2Z4;%h>~iS>-mo>(IHz?_j}Ii! zJvQ4D_xtb6+?m}S0HhqdK5a(g%0g{mHjNr(Ste5dMmO7?)dn z5tsW#LAWf)!hj%)vLhmnI0hUdy*ne$0VjL923+jv9&qF7ig-ry2J%L{1KyGRf&7tz zfr633fkKpV%btjDq-dasz2`-WNBjeRQBVpMzfy9-u^vqhlsW{ZK=vx7@8w^0Xnhzc zQ}QUsNrw{9bCt{M<${-80~HS8aX~J8S&)6ox~on-e z-V)?3Ro3&=YV^W=dWW@)_AZxQ#eC2;P%Br<0ra6xu93^}te0!$3OqN+b@DnqC027K zYOb=>+%Vw`)=$1t(Ag=)l~_Ec#K*^adI}08Tqo4%h%^=&J`*|_9zEF^8&ihEC&G#v zlfoloQ8g|dF;Y6r*CR^2Lpm^eHWUfV{JULsXHii&I%?GQjP|qOM>LqAm@W*Bjz;65 zII_h0gYL9^>eHAC-sonWYX1F8srKip#xtxh%x_w<#g6 z!-XIi5E3hl>uWCvQ-ZNV(|A83yeswx9qEE_EIb;Ehen4LwGcH@pY-m?)@@y}a9r7}ttLvdg^ov~kysbzWmJx;U3{gx%$4pOn@IZyhog!*%;!%H zpo7);7puYTf^e&_V)o>l=WZ6Z-YQ!^*P1G8oXJ}(EW6OZjL*U_-Hc10HF3EFDVGIB z7!a|O9kMv!oNxr4>5^=~2{}=OLC@h(7|SG`JEe?Dp?F*w8H)obrFc{tR+Ug(kwQ|> za3mCq^$c;a8s{YsZd-B1DG{n?bLvN*REYAFt;^EqLFi+i zJgSC@hZs+0h=U zRcpGHRns4IrM-iLqoEOHa4=mkI5-lO$0PLa8yx)XcqpQO$r~J$qr-!P?+R);rdTbb z+dAVW;U$)b+snd74zJs*<)P0Rt3)N-J1x2L6z>Z8e6q{T$J@?V@=w#Kvo5(vcAL2e@>i&{SoX_#FS~hdh4%UK zfyMI$<3G7X_FBsLCOpB?bkU=sn8JZD1C3DEoHVsG$Crf(G3c25A_tnoz`p8eOp2dU zBmgPkYfM#Q05OIJrRWKK0l@OAH%G!}6e)U~P(!D56yJDNu~X6Uh%6mfGAcQX+*FBT z)**#~^dl!UXeG$)S7}?nE2dqPu3;kvM`-{TdNnvWS&=coPCa=uiY*f^d`SboH3z<* z_tqGANIDgYosw{Pj4RTKsJhyCd10-?>ISrI?Jc$oRfg`a%kHk0-i-okBi#sShB+3; z54y6K=_+r~?Co(NP$e{K&N1N?peW3+Dxv#0!Psoa&qd7{XRF35(^fAgg;YgSXeaA< zh?b%UXH#fIic)nwSYNE3Rx?|1hWkz_z(%2yAv#TR*3h9!7)aX9O2ue^lB6xAXK+yY zET*PBduk}P2N^9Bqa$r3YFGBe{P@|-0Rv_?s|w~NreIk3A2Wh!Vj~2mjGj|u%NPl2 zfk8(JRBjWeXlZbA zede@UKJCRETIO~wpnDqR6sR4x7kY5)sXarM%7!fSsKW}|IvT8Ky9fiqv}SkzT>~^& zCM#&D?dahu1Ndad0Q!dk4H;K9bR6a@vQNQCM#7_jim--+PKH5xU}=;QI){g&Ky>(w zLmmJS9@REKKf1Gr5OiwL?V|Fm*D>k~wv7hjUcJ6p_Wn20k07^YDb^aum-s-AhRzUV zvz{|Tl#nX*f)ZuvL^y(hGAuqK#iAGn=#1znpjFFr?o@dA6t9f-{Td^;?i^4nsAi?P z@S+9QBb)i~X#L9G@>=R=GUno4N7|#ZvncHZ#s{!GfbVH%cr^a5OKqihkA}Cj4=%!k zdak>L^h27GXnP?yoeJtsy0JQ3l&t#kJLplnD4Dn#)?KyF$i?!%>ruBMVY2psKBnh# zY4u}S1@+7zh3zs2i_}VLqKaIQbX6EfrY4c=#8*EtLqKVoQZ?{Ug;{yyU{qrDDNTYSg+?d&`cM+PnSq zr;}GtqHLCub>_5|TOc#94R( zrz6Uri>hZdZZC%m#1T5g>PN{A&?3OTj22*wKd)*yIx-U498-woila}tW0Tsnvgq77 zLg_j$EfL(yp?JtZo?hH!jBG8)AS66M9{2pn8WY&bNg zU@haA3wA!83r8Xum1~vBQ99?8^T3Y8kNRt=a!1v+yBDk1 z7o@p=l1_PTf;8?$k#d$IXC%+Z+H=yLd*S)m&fu|jV?jge@i5LPb%MjCPR*Vkha4gV zc@^%X5cXgWI&x|=hDo(yZnX|7SUar%)^}JLi!eXTP6=QUqBT%p;QIh*Ga!?t`oPKl1 z&R)+tv_T{oWUSUoI|L9a0|Hfy0HcURA>hfVn_6o!`wEyR=0z8V%0%;FmQRJi zZQ~PI3&1aS88~?fjG#?T2AIYG&l>@?@n-OvWj95{7AgFB!RK%RN!z#to_Mwk*e zs{Pckv{_1$?11p>?wr12R-fCl`Qc-m8iKpc;!Tn=7PZi{#uqIs$~@nxy$0LysR`^d z;|_Cs(ZrCwzW0d_1Mirz79j~J-{3Agq%lb0%wHkQ^;z(OIlXSu*3einOzlaHMaN2= zRHNf#v^pc&@eu;)N~=BsB4106Ledx=CC1zsm+`cNG5Yp==kpk7lk_a_du#%{&3QUA zJ99TX70Co%N}&r4XfLbXn`ln>oUWAfxy^&mcOJ`KQ6qm_C^B{`G<6(@*%azK8&=NI za|%gQ!&B;T=3X;O(Q~bu+0xsOI%waYdmXkWgVkWk+9T^b>e{RW-xS{U&bATcOktQ) zYEVzox@kYmmHVj|2H<5@WA2V729*ZLTf1hwqg&5!dM>nilI<+sNuCmH$7a)EI0pu^ zx|Z4hOsGQ5ImI=40mRQ3WQv+MM4>yUge^UUlHQk#5!q=PHKBrNAMwOlR;b3?hZ-qnJYkR zjCrR=*0uJw)gdZpmZ_qTw_R7OafNM~1z)Uf+wo)#4@*jWY*oC3iTTC$rhVtu-jnDY z9Tj$)GIROvWdrR2IjhTM^}Q3*#623x4eitTagxCid@#lVu${A}P0~tai5%@TWXGgv z0%34UnUFx3({aw4u&IpEEXH{UQB)R%GD-qdl1!l{t(UalfbLI(&)d|-2u32~_+f03 zhZ^e+dZa;PYpmNFhoHVw7=09qfUY9BuudMwa%aM*FZ0=CVP!P>>Kp{KG%$8h$Hs94 z(r|KmpIMFZ3+o>pZH?=sFr>|jMU-k}`W2y;cC=^GL`LJr^Y4(y3NZ5PjXX>=GU);@ z*FNdOtvOv_o@r?}qs7zt*vC-DK-iJ?N0eA>5aj--o=|p@>9$pCT0YN|_E|rt^Es0k z^xk!RuJ5j+uW!=PfM+lM?drQL_TCkD-F1Rl%@o^{F49R#$sgn8GOQF%=SsbV)5wv1 zO^H`^<sC4tl8IB|mmObm7~elHPB~AL<~i$L?JX zE+NTP+u{r`Ol5Qd6fkLoxJF$70*<4=*zxoPf*xW0Ar&rgr9xUMlbF(b0fem|VX^Ga zK;RKqA`xAe%o~T|1)4Bjnid*nY`Q3WOOGqMjAIm)dqki`HHC}!@)LWsMFZM zLa;_5(G8?VXpYHbfSfa`)O0_5S}X@jk4mNO zAu!~O`_jd7G`*7n-2}s2mmVqYHTZC~6cExM%u9O)Rpq2|o`n7(b@&vsq)59N%b0f4 zYLBJegVZ?8FwAL;1zoyoiau#-12;QEW3<(%1GXeb2jI z(}nB18jUl|pkaq^=x=`h^PeBxA9SlPQ1UU{(q7m~#YjKN%(l`+;h1INb(N(0Y06G8 zl%bJifG}BMuCxVWeoC43#r6uml7+(BWMOThux&9=xe#bh2AUJTX6S_K8s0ki#=)d_ z{fu|Eb+IszsC*<@_z2d#q-w7FhJVBS;|tB*$>#2BM{hRwELJznH_dOG>zK{E;}uFO zXV0bl8y5VVZ}>MaR@U71m**Nj&{DCZfYd2iY!T=ZZ`w5>FvZ=wqBb8)zeNRfa9(YE zC4i`9vhKVf+^%g{0n&Km5;Cp?X|hO~yCVV&XNCv|8GDwfYo<7$J;%%xEm%9tsH?AU zYv;Dk?Tx`sqclfNt$lr(#TDD7)FTX+Rz6$d&lcIbZ;h(TX{a=P*tf+(N%^J8i<5H= z7pD{6+T6``ze5hukPV^x#~QI-*c>pM3d@-399GZRjhG;MveblMy{bA4SdCBtW=CVi z9dyz%aC#LlE3N2DeozaxSb`{sQDBB?Sob0aAi^unoSs zzv2P(ctS_f(LG=Ru?w?ItgO~iOgVz{@*LBkfFgiC0l-F`r`DQ{MP9=PAB}qgg2PG3PdQdRXER9 z!D^IkM|5aMhy9w!%-mmgo_SCZ-g6mN1Jf%YCN1}rc)|fx;_g=&&Lm)E^aN}t1B^Hv zgvu^V%JRWUMU4g>DxH9AR`4$2Jza`b)eO`P>+}qmhv_x{PUqU>dcM4!S)U%I`P+p$ zF9<)Z-LmK_xpeU2!P(DVJha%*^0n%>tFP>NyY5bnyD zu7tNMcak}%(|Mn1`EEDKSJ4l;j%dUJput7vmg+Rpa?a3ZBwEi|9kxi9mi5H_catTNm_ebLgM#drv zDRLB9+rb<0#fqYsjof4j?=;v~G9f-h8#s)-7lb<-1>d?^<;^2E3mcXk&Z3QrRkd#w zzft^7?8*aQolI42d(C~vBb3$7JvQI{wOw!Tx>>sIR-hr_Yq;$XEcly}{-*iyh1T9A z{`dDLyuClYQz(=-eTa^m%FjHuJ!s@~Hme7DiRr`!46?IP|OR^6N$ zB{Z3d$yTC3rx>^KWdV{b9piv!C8Y1@2lc{)d8#r9B$o$`GTGhzfYo$x6$FT0fkodELb3^;YKt!1A*Pa70Gmh+a9Ktlyfb+mmk zVzuc81yP~wm@I+-!08}VjJNE|WcR^=@~J;Bs#PLrtrg0+jP_8*Y4m}e&p!em|8sR1 zt!SJ-G5C<~6d7mk;OS_1H0_FnWASu8nb0!FsC0fDHUKb)fzMg-AQ*iT)W*h7Ku3b# zI`aeRPXv}ZGgPB4^?@aLG={@E4(n!>xaYJ7v@A+xNq+(yeoUe8WSwQ<4e&BQkJ0j< zLzUQ8WkT78TfUOtUcXSe#&?%R0>qbp+HFbYa-(UFg(vh(xeWkelBm3C?^K>FSb*7W02Aa)`BV8*ZtY}_ zb6_>WeY#+(z|MR%R$<9)J659&keT9Cfz|?%lLV>zRWf>2W!!>ZRiSsvTF|~4nKRd z{?jv0;;^Z1yW&r+e`x05odThuE7A2>O4^_B)ggP!*2LCF-#?gYelqF98B{+nV(YX# zn0W9L-ws?K_|}F*^8q@U0&Q0gCIdSXz8$EowrRfm%Y8GSM9y+)A<%Lo&~mH3W&X^< z#)py{A4=6fJX?4>P(R<140I-Zow-|xHUTz;xD48lwvb@Ag{*kc$BAoEeH&%o)jT20 zbV6b^d-3_q-dfCalb={P+D>L(^nkQUF%d7%_tv4?=mZPL{a%L1>80WJBQcBg`Y zDVdG{{g`mP>+Iiu6ciQ%kQ3-c+IJk51qPad=ZS0Vf&ZV%pJYqZ&(aeLAFFfs0REZM6mnD#@)C4>t+FC zUCGL>lz+=N9>2bCq4!X-_fV?4|AxPRv9gvb&_(jLYgCVRS6w6Qyz*5}d)5X8=zuD@4ruM{Ye3E^^e_W*I6Y>k)xV0|bXoQ!N6xF|*XS3`x68qp z$u#JYbMTeQMcwA6<3xeiBgOL+KBHLKth2L}zFyJWAfMhJhwoDIZtJ%v{&*kwvM18bj*IapLh|j1WVEmVS_cp;42IK=ol2mym*ksnB?H zIRcJnw1^&UdIiDzuK^{YL}^^JV5T@j@AUT0EupQyjIuToBKt{z=5PyuP1k5JZ%3=> zghDqMi$h-O7F=UVzXQNu)jR|k#ng{xn0LsFALzyc1$r zm~y`(eo>5xuQpEQ+2T+MIJ6#E(1s|El})+qj2NeQ>!R>#zwCmUrRR6V%OZY#$|b<$ z(m&-=eN!&<8?{b*_*bt>m~hg6zvqOK$Q^nTE3}`*C1AMEaNv-51O^s0paXOUygf8D zL?lNHd{ee9jY-I`GMPASk0mGq*IMh#pM_I3pR^V6sKp?VAj`noyypNuE%t(8NvQ=g z0KEjW#;7V2)&_dZ8U+JV+}1Ln%*D-`nY0BF)<7FX}*TJfp%81Lf!R!cNEuitV+LTQ-Y46?R%NUXgMsn^Jh-`%aj zT_3*(b|XUC#~G7#j%*Gw^SIS!jSc4Bo3g2~)3Q$1#&Z_Prm6kx=0LdAjrjnetf7M`LNnnRCo;G+nIOg&WeW7}3|X z-RaWK*zHKM>Rq*wJU}Px@8Z*c6Ml+AwpR#LAsAn6Ju2*8 z*VVmV^dXeB^)Sk+-8^&dXG|CH`7L`M7XM(62X}BvW9WN7$P!Xl*oKDLjSoRBAdMDQ zhLpJ~nPKUvlYWG-j4026a_=CEsADQjdIa@h%HdM~0lkx*nHG+wWUsD`eNyMD(KJ(+ zFtMW935s3An#=h9^^D52?=D6xO%|bLcoOToj5Vfp7m*!|&^Kv+Rzw?(80#~7rxkdF z3N&R!u2CT*7t#T)FxKqUNyM2hGl0gD=1`S%9;p#Ymznp>V}~Do^2lT9f&-8DKY94E zy?c&4rV>@A{(ZWI=(d+`j5ORwZ=a?cDcIGsbZej+Gw2~<3Nr!F2*=my=i799hi+e^ z+drk-HM;!)-Tshne@r*xjcp_7JWe0zHjIC0_|m||fkm%BQPz_5wj|nmlHQ){&nCV57QF?R3N9AR9=?3+wPQ(dJLlv%RCnj-dR`aZUc$xDgMY&;jUO_ zp>^nOsnZf#M|3yR7liV`8*H#Cx5r(l=f)cg)svOBTvFnG6jCU!yM3vg6>+<_=tbzQ zSai29durT$%RMf4!?Lf;U9jA?(cQKDlqkA;mOU)3(mKraX2Q2!;^!sy;SQ+&wGwpSOZMp9EDd zLYCnQRifY#vJK#5FNixx`>+WS0c$jFgvuepmMK^*pBRZnwBRU3BO&>pPMWYhAvGL} zj%pq_k?6_rFnk#mP3%YHABZ~&j!MKYNK*t!~A06%);>d*x4S^`sLis>BERPQ}7fi@Xw5AwMli8f+!E{$_ zNQ+zUik+~*C{S_IAyf@WO!Yfh8MxKZq`@`=BqnSoG$f`D&?k>_o~9)2VGcMkICBt6 zqEKZq#O{MX9R;CK{}H9RkQUe2)*<|6K~J^QQ$Iduk;-)FXX(WJ9DXso)AcnM_TR3k zU8rbHRc8;V%+?us(N*w;LoXegZTYQ^x$QSy8*Z1BUoLp9U~c>C{*MH= z8w#LXC3OoW&B>DH`J<_lcKGKMmMr?pE*-jfXs+e0jyF2K-1$9U@V1`P{5{`>r9zYg zF7lOKIHWPI){Vrs8l6@ouzo?*JZ50S4x4zpO=oKDV6o%`7&<3EJcxDD0nAtn%la~y z%$9cPR4yatY1L_QAXtt;NUYJ`;n6X~n;9l~GxP1rh7GoaLnKp!e;R=w1BDY|75?D7 zacP7?*MJr$R)Z~_)TT#%B=|+_BCs=PQVkCW^>8wVqcy9JR}?d{Y0#zq2U^+$ZU{=| zA}~c@Vdi(K?K^dWzAxeyBW%P8s^6q!y1hye(TW#9M6pm_f8mpWfPIU_fthD#_skAo zKK0tEx%lg&iHep);l_k(WA4(qP?%xKPP}{pi)YFcW`q-Pd3xC^JN60LIEM84L1%vk z!lkM}>WRyb;N?rACcu~yj#U8ti5KmmfNOVjQ9&hy0RjmEG~J8{>y9`!9dl#C+&DV7 zsK15U(|LN(27O*GFhcWgelJDsIzOiFnrz6lg6iyLW+t&+ojl7N&0Pa3`za$pVO13H zEVgc*$y@MNC%x5kI~Kf+A3BlvGp2z1jhcE$C(=$hxkAMe1N<6Sx^3l!h(bfq0`Q^hK zTcaCDrIQS2nUjqB>^7DuD_`9%4l9d|YRI&Wv%`4eTyy?HwL4I|xJvD|eMf+D(;3Dg zJITi0=#h*#-p2b%y_*s(<(;dRci5e;vP*WK6irho*|~CkmM>X7oh&e8`Aq^f8neK9 zUC39JzpUD7R^66Xv&Oe_s}_i$Ey^xCBe2tSL}gtjnl|SC7pje$xEZxEuLMsf9wE>V z5FVlZvXc7KKuEgnKKvN+!Z8-{1+U_Hwh6WK^RBly5*j%!hjvZYTW!!RC_(@JHd>C+ zX1gF^4zv5(U~^}nN9^?%@I>6!Xt{9db5|Jc&0hVKNw8T{5Jy;CZ6 zMDyqPbG!xf8C9abN~!;lZeOI^W!%ypL?eW$XxcdvI-hnAp8~0sE~4{r(2z|cXuB(- zoB(M8lIT=CT|hrHi_vr;OVWO18Y8H`Lru`_E7Z*gfch>7i}lic<80xDgWxmV{smV> z(pB->@|zDY)O05Cf7ibEq$!;v+|qU=O(W-yfK}s*_^29O03&*)3ue?FgyO{k@=b{PrqHCs@p>5#g(9a zx~=6yb4_yz}^qI&9YZ z*}3g=E$=kVhu#ZZ891pbfdi-{4OU@W9!cb%2B-U=|>J@p4sbr`H0(bHL%$)xTRF2PseB%;6{YXW5j6LmX9w}Bs_7*x$6@T3S9&q5wS?_eNfau6RHI%0GSb}z=5V}|zMXphWp7_?G#bRmj;*rJeH zOMAq&of&?Ex5*~@*Ej+PAM?iu!7(&sE+4ZgQkXJ|EgcIS!jwR93IMBx8zrVvpK#tT z%{7bu0V5=Or|YiR(T`)e1e-z=+!FFuVL1!`VVt&;3Ql2m2#+yw7Gic#M`A2Sfv&$M zb9P;k8PkODVk}+4xKx%|`>RITTI>*-u!L*C;_=uV-=u^2MSO?dUkAB2oqnh3X5mJh zi`}~xw(m`D-~0aF)b>yO#|_V134O5V&maG@$N&9-dGTv`Z|D7PeqzHj312Plr0;Hi zXYYIYiS2t+&HGZ-;4)u*0xYKdeK@6ijr5;=R4GW$iZM{c!aEg@`doip zhFcET$gtzf$it{TJhQL+joASMAi-pRG*-vX>Nl6MCF7o4a+I;PB)I2HE!LP^Ax>xa z6u)&=wk(5{g@IK&zCms913XkH_cMLd{t~H^o2=Wf)1tVv(5eQ9`(s*HvXW-p>y5G< z^H0xiz1;VuzGT@Bjbr`%x+)P?$1hNOe?zzbO1BNTS!qz}mBojFK*!SX52%&h$N~Yw zYQa8W?DgU+FTw<$4AcYY!j$1NA|1`wSjMP%{+>9 z!S@ikp+Cw(jw3S(qF^}yi4$3TY4L@^qjLCcSVnZNjN{4p0~MfxaCqucP>!-p0}4%2 zrpa0@M=NQ0tzgMRLVy<9wqoE2fKgkko}q&bn^=SiGxEaPwPvb7ncb7AR5c@1*fwNW z_T#rrwoMW&Vbbd2A^Z(3 zau0GLbJmrMbFTs!(nTW0&?tWFSv}f>&E`Su0g}(I6mjDJ*2ckZGL0?>RGHlc_5wB! z?TM|87WF;$3rpksg>O>YEo)b02lXc0u3WqNzcBYXXEHnTw&4pu^89q~{3ywdPyY<}xoXOs0i^;52*l1{la z+CuCz^68Vc(=Pj2i#O|crmA4Y zPafU5`vPUPbBvCu4DQZ0PLK)fhWEkWLpl2%H{(mrX4n28*gEPm$?No}6PKTO?FqQ{ za2IOe0)EjRM0RoczhEgcdT7Ug`Yb0Km(C-m#5(KB$Ei+s8GI|^NN@$`5ew~Q@S!l` z=G>*dc{PZs0;5**$^I}3`c2oA!x9})IL$dz?JM0cY(OnG=`RKB(@`VuHTlY;XLhAm zsP#g?KL5SdYTqN~HFl5n#<3%{%ajg$9)G4U^m$B}Zk!&WuA{5ducSq z)()fGz0el6En5*mTTVAjy!r9_F}Z)Q_Lo5*WMVU9ZIb@B2>#wD5eO`XKO=A~wu({| zVlEXnm9b9PWtkl1&#>U?OLY6+bYpZqQM2iSXDG1AW2zcefet15NQ%L9evI>zgsQNl zOf^M+ArS_Z^mp~F-2y6Rsp|>9{5A4}Yb-Z|V%#d1<||U=trs7=Ra!Im*gL&9OSfnd zFn(Arz1}~Qe+z8j(XT!C_H)-B_@mz6?@hMsPSrdzlYi4&1s7<;ORV`y#X@jrGPpAl ze0;H`eWB&SWXppy2X6Wr3H`25c&nBwgyOP=qWWY}eF9?C@rABE$*w(#t^K)SZJn(~BVS4nNsuJ_8H1K~8M&)?Of>F6V?c+q|fm0YMG_uWu!8l~Z+W}Q# z{o986apG4@$F{gmUKum(|PM@g+5kjJ+1%qkckVB(aV{#du54UI@+%|T)- zkM167v(0jEekQiV&5Yw?lV#hAmBUQYL~oB{yQwCQW9V%o(lVH!HY7|2tV00WqEJ2$ z6V}>?ufSS*D4*eX9!}J4zFF7_)CJYgr@mU9D(}ceUkKoH>BWmL&M9w2-iRdq?Fn!D z-y*3O6el0l&ST9e1-2r`VQY?4H^z}Oc@8p>BTu5ExD%G5q`|W#5DAAPj)n~mXQ@YM zHZ&UXhwww~zP$4_@-IB*VaIcWKr)!c&bw=y_Z5W}D0A-qN%x!!)O~ufX<7Lqu&@;cJDpt<{{0UlC1h z>Wnz!IN^Y7%xlj%=E}yHOzaz&hL5wMIUb`~H?gM9(-9)b)sr&xK-Ry8ufL&j)J1IB z7MM(D${~WWj7*E)GoXBNM_Hl0io#qR3irp_12n zy9HUYh$!RWI7?j{!S|nmis}_gs^^;D$-C)qyA`OO>wdj&W*>QFXE|+u2x_ZlF21l~ z>x~Ut;i&zWh2?YQ3+p%CSigxCTd3)P6Id#+d1l`o#6$|*#CYXDJ@ef&cuDyWC%lKX zGYU=fi|k+UTU=JL5FpQ131R_^ZLWv!9Coq7GeGhExqRMDv&6f(qkSy5oe<#)QO4M{|mT_>t5RA z0=&W@`FFnKq-|FJ&Uf5I^6amEBVcmIiT+ul^U6c zQ)8AIiT)&*w&r?}j*LJKFd)L;DH(=|$_a}~gV%c2h||EtJIpS{!kv&zCo@_B8zTM! zjs?i9GigzwuN|VmrmmdDMVx`PT=lhT{+6bjm?paJd*n9l-vbOWq7h0ZW@f@9te{FY zmvOZmWQ--m&Uf%3CoF&#pVzCc2DI(prP7R?`Spb!-ApB8fn zHlpE5F713}Cxu}ze4~(@^PduDU5hmv-rD)b&iV7-KKlNqRA2wx&Q#5luX!oB`cvW$ z1C?{$*LNZGEsAgJp83RLPcH)I-lq5g`9P19mk zaG`2TvI^h7SGD7IdF|yVUwd+X-}lOcO92%9uv#duO-fs@ok{FCaI3N=QM)-+*_kNm zG@E1uqWZ6B);#LZ@t9l>kt3Yz4^Y4r{LSL$IJa?3n}5@TemAnKy>#0}H?lTl;Q&A| zx8mIrqzJ%=Dp9fKtIx#c4Z-;eb*zc83!eIl=E z)$H9)Do2!@`Uq~pGCL=KTYr4ASW+A4)=W1)RZ9YVwT#{>=td%K|aTR zgcowLcfrNJMA*80v8i<_ui4#pyL|JK8&BA^u4`Z^Slxo+<$Ox}q{zJ2i`@?{Ywq!Q zTas3Ck0<~12bS9l;i+CN!mr&^?_R(Bh*;&`wA}4*OUqs_63gMkzO+SXZo}U!S;~LV zeMG!nT({(=7rhJY6%e*T`wVDAcM4f5Oer+4_e1c;XKwH8h5X*>g*m>{iv~_Kb}S!B z@>O&Bh{-ZinV}6W>fL<8oD@&u7{2`lm0*AJiY++hLh5ZwFyzddI2LTwf;$up4xSiCXdwl*Xv7_|;%jEELu;$PDnNzc_H0-beKI&aUTdk?{XT&<(@ z$LaQO=$4|}EZu&SZkOoxJ9J|pRYPwibY#pXyu?P}7amb|spO`C|AiRAC6J0Je&}_J zuAdYOV$)v<1%Dxw{DqMJ17Y{~gx!BFwEicd_I6q2T;6-7yc zD-I-tvc*8n+_Uq;bNyHL(Vuh*Y)uFy%O0l~xZ}$gy|a^d1U&9kb&I~a;kVAbapori zUhj;GhrD9_Y|$Noo=Za|LTSycgPgb%HNB~lz6(VFQn75g!z;EfuXBnX1YZz6ciIoS O#m3pbp9u71WBWhld@J7o literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/tags.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/tags.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5b0a8bc5641872c28169c258384db99adbaaebf1 GIT binary patch literal 23181 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/utils.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/__pycache__/utils.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..d86ab179161d6816988a5794e77503705bdfe335 GIT binary patch literal 6673 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 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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_manylinux.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_manylinux.py new file mode 100644 index 000000000..61339a6fc --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_musllinux.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_musllinux.py new file mode 100644 index 000000000..d2bf30b56 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_parser.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_parser.py new file mode 100644 index 000000000..c1238c06e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_structures.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_structures.py new file mode 100644 index 000000000..90a6465f9 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_tokenizer.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/_tokenizer.py new file mode 100644 index 000000000..89d041605 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/__init__.py new file mode 100644 index 000000000..569156d6c --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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 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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..83ae233cf7df2d60675d031479bdbd5e34447556 GIT binary patch literal 4155 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 u>I`c=W6vfFoyRrM_S)$}h=5ElI%(IYYSXT1 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 AYybcN literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/_spdx.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/licenses/_spdx.py new file mode 100644 index 000000000..eac22276a --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/markers.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/markers.py new file mode 100644 index 000000000..fb7f49cf8 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/metadata.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/metadata.py new file mode 100644 index 000000000..721f411cf --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/py.typed b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/py.typed new file mode 100644 index 000000000..e69de29bb diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/requirements.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/requirements.py new file mode 100644 index 000000000..4e068c956 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/specifiers.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/specifiers.py new file mode 100644 index 000000000..b30926af8 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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 packaging.specifiers import Specifier, SpecifierSet, InvalidSpecifier + from 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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/tags.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/tags.py new file mode 100644 index 000000000..f5903402a --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/utils.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/utils.py new file mode 100644 index 000000000..23450953d --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/version.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_vendor/packaging/version.py new file mode 100644 index 000000000..c9bbda20e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_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 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

    ?nDMASY6g}-ip%8ZSWYSYF; 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/build_scripts.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/build_scripts.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..38edee04803501b6021d2e96b5f7ca94e4f594e7 GIT binary patch literal 6838 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 OQ@?cXe+Yi*n*R?DtRqYS literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/check.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/check.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..f27da6cfb544ac8ad700e1a5639680a6be2c1336 GIT binary patch literal 7203 zcma)BYiu0Xb-wf3oqceZ`w-s}hk9~law%EXqmm_C7A41x%*d4d+8`K=c827x_QBj4 zO5}DK2!VpG47suj6r$i5A%Y-~Ava+DBraN@uF(Vr`iE=E*zH&W3=~D7e-tS{s{Clr zna6TPQAIDo`{zqPdZ38X*%qcSlXBji7@;U;3P+XEQli z>!>zaq=rV*V$;+Wm(4$k(_k- z(UqZzVqP0ka@zFJt21Y4F{`Bwedy%bGlL^VRkLfa44;xmi|32R5S((6W|Z7evQf)r z&JRt_7!$?9zU1C#hxCl04NfZQ3;1b6Iv$fzEavnfxuGOO&Y=%kI*^>4p)IhcQv2h( zpLDkaY>w#tkbQTVEXT>_-pcT`SMLQQS6{9Md+M!ibHVxS!p@I(eA4mR(XTnSCA12% zB<-pKHqcDN@W1+N$Zo>HWuaW3vdtr$hwdSc@vcEK#1Pz(S=apC4k)wDO5@JLjx%NM zm(1ULU_O$y;G}5?RLe{!pFgx zr5Cgv#d{$uZC-aKkH29ni0CQEE|Yq&_4=z_X_oaVW{YD2X)Tun z8)Il2t{!3bMf-#C;3#HMe9#TqcUQ=AkiW4h61|V-$gOEqm7RaMBp+wjeEK@7(JvWijUCfoNJ{y?xnxPD; zilIowF$<|33r?1{0yK>kX$LbFhUv*FB8a0Zjfms;P@Xl86iYD^0PtyBZB zno1i}R8tLY+AtYfI(Y*9gf3;qq+GEuE`bD~*V;HqpD7s1w4_i?qT1QU_;WCR5MX37 zmr)7^%#J{qNyD6assGJPE+=Wz8AH01F(xFXAX#9DFH!6-kj4~nR%UQY*Qi{aG&044 zp5W*JY%E33LH9srhR*|VX-dJBNIO0mo)K`9jz7TD0M8GGz2*&67FrEy>siA;s2n_N zK+O!F5K0nwGhI@(F=Z-eNEemdl%`9t>5{XwTTUn z1nQk#75-gY`ybm57-PFf9x6A%$x%eP4+%X8Me}-E$1;V-SJP&%W_|yQI1n)jz(ovN zIFN2^B6Q=6a2r?Of($Wzn%M}|Ri*^qCC#oKj?visEY7hml>v)gGK45x+I^xp%V3Va@AAblQ?>fz3xzxn>#)$q<`mWv#!$2)5Ap=x~Si}+p`7;U@R{kPrs+7gSq zzrWOWda?ENvWT-CdFRO7bH6xt>)7q%pLY-5i|$z5IlL4-xfndT%#ogC<;Zsr!=$5c zg)osr_qql@N-u1?GqKcla4~-H&&wQiKGKn!{I2yS5Bb#Nd#RuMG#r0v8~5op0qTzd z5;}6r9_mnenmuHj0R`kR&BE^Q*2k3i>U*)__Cgb;2^jtx=fTBOY0V6Vk_ zGRw^Z-=}*(PaBqE&xpCoZDb`XpG8WyE|nYB;Oe4V!tDVxIt_QQG&{>)BH%kdI9bra zqoPs*5GmmKsP^Nj4ER_{bFW^2R}D{Wxl*`rfae6Y^!uHgfHdlk8p~)oRX^N#fC5OS z2BeD`)xlG)jd>F=%kteyVaA#_pV4*jL&?Tqps+j+HoeZ^k`yo8h^N@k+w*u*_#kN;t+iS7GYHY9~f>LkU`whp&{Pj(p|K$Bd z{A~N;nR8zpdi|YY;IlD*#S3&b=6?Wc9z!nt%GFmE+YZ#)j#k@_eysj;<{vVjd6$lz zS!#Rji{L0IdocFjD?S*YBR0JsJ-&OKV^^ zOn!726&#e>x`Aw{x~!{yvs{_G>;YLG>F6w52)On4fvlD}$UPtMFx!SMq1>1Uf(Os@ zWQI$4OV6EX5I_tNG?PGE5nbwcZjJ6G@Ba@Zlh0)e+KAgG zP!}2Jli_ZZrWuRnnPJ&Jb*dY(#a1~Gvoy-lA(OYdy^e#YqcGPx9eN46NuIf zIEX?9jyxQzg{5j(s)hGg!~2)Q2P=HNy}Q=_Ott-)+rvxkdsm3Z*IRkH9_yNW_QsK$ zFWh)x{=iafcV)O9j#bL_uDY!KJP2#)KJ~)Fy#! zj%g4nN@I+Pj-{L0Rs@71U#DnJX2{tq8Jsu7C9RJ%Lv}2(5u5CJye->JCsaw%DD2o4 z#*NJY?1Cmcfl$HvG&6J@JUns(hwz@j_oG2lw6lb0lYuvJqJTY8o>bstJoe6*cs>T+ zmrc=*tilQ|pfscD$QzL^V6rL0>(Eo$WW)VB?{Ntp=>}XJEV>M+-nOgSwyV~*uiCcn z^S0v)rApvlq_Y<3t48{2ksZ~@j#^}(8W~uMBr6_>i@6+QZ#A~}UWZic=&yG4*E$BO z9RszFebtVAi|zY?EX1E(C2ZXPU;dt|zh}w6WmzD;2r`o1ig;J-s&CziWv^S_i}lrm z?e$>17VN76XU7Wi_d33CcQv-V9__lBypgPL+FaW-P~9{D!MIx23)QX{9)`uZzal=2 zlX#CEvqSOQhZf%YhB&*o}yb1k^N8r)uQjn<=k79tDW!rsN! z{n%`cF8hR?p>K)M5?;2lQ1gU;UXH*tk8}(T{_8;Wq@Vo3A3hb~{?NJYRFL~)P=NYK zB1RGN=q}9qAv3+Q3>P$r5C)nE0YyZj$f1x=fV~J1u!e~FF!qFHSt)@2DOP|;mgzne zK7`p3%#euEQ<%Mo8S(;(+CqU-5z7(V8ie>sF+;%BCm{P7`FH-vSJ4BPzrVtYhdq~1 zzt=za+`KTKzP)dOo6lFJ=c?WNtI-3iL=-$LaWe1*bNL7Fy)~!K@4J<$Zt7p+Uti$` zp?f972rVlfPS~~Lj|iujm7QVXEVHuJC-kni^$C6UBCJ=(r~xlVJOUV)HXv+odLXO} zX5f52TuL=NYT>agQnxRXB3>4N;OJ%me$9a&Mo!`{3ueT<>?U1cvC${g=(mH?@kZM= zK8TXQF0V;B5p25<-Jf1;T(S1;@x6Q`K5s{QkI|pO=ir^)BJFTHWS9pm$MCCu!bJZ> zy8n}O{fYE{C3IX))r5|!&@tD&B^VNf{mYPW{E+v50e}0Lxc~qF literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/clean.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/clean.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8517791cb9f18b0b8b8fd457caa838ba6de27521 GIT binary patch literal 3170 zcmbVOO>7fK6rT02?X_dahB$=(EGaaY;#duBLm`Axppepr-y(2@R%`Dj*>t_@&W;PV zsK|jzfT#jerH~V-C!$mWPEhsGLw{7M7f=JFs~{nj9=N3ml`2ksGwZcOLR6_E`OTa6 zW}e@C?`QVcXf%vq{QRBLe+0Nc=)xQR3Nv#Qm|>)%3{pAOXK)z~X5R4S`3%odnP3Qc zf5s2IUkw<6d@vJae9#c{p-hNFKC}m^;#s7IwBQ);+RcPZzGS%kuBzLlNOZ$)%USun zVybO9LsQIfxI14kw7g~#TO$3Mw9DHkwXzMZlDGdUHQ1Bn9Nw_{U=nv4iftcN@KYZs zKoH#NS_ZZbYkBK4O(s~=a;_sTt$2lI_QHA?X$WqKGQN-Cei^Xnj#Bwwy$vQ$>FwQUZUEw@unVnRvPv6dqi82MP$dX=I|~1r+Y0dDTX2CEwxCUS-={cX2vQm(JO#Uq})-v%v{S0SfU4*se0Eh zJBRfGu@~~KqF%_ain`((%_JADp7Luo&uUoF+tR-!fS*mUo`t-#OgqUtJb>VEO1Z;L z4~B_*BdbUXMY2&cEg}sRZ89r<*;1;20k|BoaRf5JiDfN|=B{iNnBg1;Qg6^)q)9e& z3F9no*vd;!cc<`z&MQ<@f@JSW1{^o$GR+q!#I7Mj1U)fD#)-P( z3V@)Zh_DmvDx;hu*qYI6Q=g>gXVd*wUP~*6b}Id0=>WC{Ap7j}?!yOCJ(jAuT=%Z` z~0B59~+3+sxJZmV+e|LH=B^jqepw%6O!wobHELCJlh^ucLcBgFy%?Ci8m{b21N zT`BK0tDLq%$yuzMIsvnKS@RGsFLkx^HEY3fI|XDAO)Ou1PPiDGShfnLdT+IA%{gIQ zT<$F!n$8JdiZc}07s3_<0Snt9V1^-R1Jy9mz3zY>=u>%BQ2k?-U~miV45-1eN@zJ6 zFtNw+vsfg3I1bhr0e%tXDFMEL@{|C-nDUgsF^Uz45>!M9^tVR9QZAa%6m(NlJ(zGK zXx&)iCVDmw>KB1r;sQBWzL6em2LdpPk%wZ-J+WmX(l8NOKM{F#BGLxTv${YiJXMcE zQCEGf`c zf@Lqi3!T`H(C6I$K#r@Tv~(6q9Q@ONAaZfbEJT*h_X-f1h2O=40?quF*tBIG!6q1V{5TKK7wZX*pqssx6Wo7z zH^vr*x~D1PgsRV*O)n}*Zh`aE|BzeLz`g}4`!SF~^eliP^+O%!JBGT>cU@U~H9e9Z zuiG#gX}Tg@jg7=^CT_31wemrv>q#Uw)P27D?vibH$oFTyJu@EJ|F|wTwE4p3$E#be znj_|Q^@cTS-60RRAH28y;N4Y+rjZam!d(hYHZ%@*T<#d|y4-awIo_~wGSPf3bn}hd zowqt4B;I+FXd2#kdEZ@W&o9gFCk{`A=%J}NiYJCnUpPJG6QYfi@x{a9W${YlYV%0* zcsw~7Z(!@@>uYbMN7MJ?Tc(02zVe@EB1){7MqIS<_jqE8hxxfpYwU+D+jnh6KW+`} z4)Q+*IG{brs3XdyW|ic!(j!DGh0NZ`A`i4<)OS6e7;23P>% z2nOVV!^0PZ6O(1dgxpZrdoRnF76_)NO6zX{|EG_iQc;J#^J zED;#|V5$YB+OKyE?!R>Gih6C+h<>ke{cl41v=HzwosNtC_qmxwlfTimNR1`yoS-bL zRu2Am4XmB|>f_la!>6#DW&u(vKq^&S&skW*w1+w(B#um9TFmm2dAA7^HIJW*oi0pW w_-#sZvX%Q literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/config.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/config.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..204b1d7a88b473d44706d44b126fe4a5bf729169 GIT binary patch literal 15210 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/install.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/install.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e98f8efff6fab3168e53a903e74480a7f0a5b725 GIT binary patch literal 27026 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/install_egg_info.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/install_egg_info.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..b3b678a9b39586eb6ce4428206f31e73086ac018 GIT binary patch literal 5201 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 J5&Zb;{{tKATwVYG literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/install_lib.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/install_lib.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5b732348bca7fab4b221a6e44653bcda33938f18 GIT binary patch literal 8353 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/sdist.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/__pycache__/sdist.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cce39fe27caf80d42fa0d7ba77ecc25542eb3991 GIT binary patch literal 22584 zcmdsfX>c6ZeP{O^Kx1Zb&HxykYyc#IA#w1MDDj2>f;vc$CaJ>^nehPK0EQgQz}*9a zn1Bi^tL%barU-61ORDUYD95#?BV`S3xgvTu70Y%dQ7RvdF@Ox*ORedcTeaT(!b2|E z%$NQBUmtUzNy*;Sen^ve^ZMP#|NZaR|4>@$;qd(Je~XO&_(hKU1-+P$TaWM$R}s0! zN!$=8@scCPPdJ7gJjIe ztac(e6lC$TSlvYZP(6#6#~LOYhZ+&Dc#|7ya&U(@sq#%us*?ThI`tV1HA?}>|E6nb z-HbC-or*|NH93`x#?PF&UF5NcENIFj`H-L*2imenY(Gjl|=LWP}pcLA(onkytD;9Fs#%%@v83l^AvIFHD`a{yonShxxPD<-fwCY%>Io=cXP)#exrcnAbqySm2Z*kqScu+@Zsu2?iK8?{2+ zthnOCP_SaFFwtyTD7BaSG`Yf5|b+*HO$t;i&UJ^4EBtyBu(FGyGpTr}>cckzkB)?;sn; zw>f~AqkD^1q^BzZR8;9ah~mXZZ}yBQCgh$-Og`UpWagNXI3tfF)t-YVj&%(tBw3HW z&_579o)}IfdvI71N;DGd>9%6A=y1>EOmaLC-`>4-TaOw|%3YI@k+YF8)K=x>)MPS| zh^akcIvDJ%^%!TThaIKv$(ctbd&cCre11~dms+QeC#J*36uS4s5+eZdece`pW*U7D zf?xkH?$;N&2b{CI=#H=Io|E$g=10>djn}0cM;8Xt>v!MkO|Rd#EbPDUM3LX9F4Xxq z!3I9nO|UH{M#advNR*vHyQ52xK>)F9FjTD2=CF0se515~;W4&>N;T58A~m5TWl3|L zm1k7VGfA)(CQu1E^#a94Q@JaDKxv@5zTDX=tw^fHpW2H6llzsxxqCi#ZMs_)c*y2i zvmsNnDP6N^siyN2H)e&@@}i4}?xS4AeDRVim~pkGU2Ti&Pp-ILeuzf6ymLxRfQNq= z0OVccWNrwMHRO01a0O((Npb)&y2d!k`3-)^jb9gjizK&PEEVlRJ*ij{q!L*eb&c^u zC6Wi}UY72YN~N-|JBB<`InpXvTBYn7b)cMAsv7c1exwIjdNojUskB+DL0@I~t;KIS zeuMa}z;7LXE9EMw{!Q!b5Ba4A)Cx$A2&<(ggf&t#!dht^!k{D~tdm+0)}w`1w9tUx zHvBf?cRhZaqz%Yz#@j}`t;26SentFt;I~BzA-8o#2z6?129&9%pM=)Mj$}j`20G~! zQ_)G0&~&FLCr7$Nc}JR#H$#i{h|pm^gWtmE1Q12)izYP?8P);3FqAVgE{~iQ)v4hw zlR9}Aej$`}EEX97f*O|<8Q@Fxl(3GvRBV_~yws#ZUoYce`eORYd~k-H~w6@g57Yr4F3QD{}#kQgcpIa4J` zgQD!!_+;v-cw_?jaa06(jgHDVdS*6TIPrB!9*s=JlDotsy@M|d96WKdI~qSt&6pL? z%tR`*rWsmxo7$-Q$cN?VGTK!KQ^%w6k=T?Zvqd$M_0EBx#AuwQo4r|0?j}-BBwCz~ zCdb9Du6V*~lREL{ybq>Yr9`})8hd5#{rGC7O}i z1Nsjf3^WV!lpK#FMc|03m?VOK5QlU43+#T!@Kh8zNks+#9`8HR)Az~=j9O6*aD3ui z*idL90w!XNYrQ^;2+%x`U%~JqaiDns396KutJRf=$7VD>kve#03R|nlgvb?Qh=^vI zr9^O6ln@tH5I(UZ3XX%O*G1HHMD8-nh0t_aev-zIrp{6lsP@bg+aHN2%8ZzZixCya zVJZ^q7W?H%tR+Sx?ZWa+=Z`6>f+LuY%&0l7O5H%(gn|cCPoq;J0E|Vj;qAcr5sTHO z%99bAuq4KaXTl6h&dTy+7eTqkpG_U0H`X%|K$A0MdnQJd#1vL0G745sWEcm_i&VxA zG6?NZ(PFBEs&-*xaTKJ~fC(WpVlp94PT@pht?h+(Fr8!|lrF+37%DoRnxx&7y2V!`N?eSBu*PS^i6|JY z_*l2qEBZ?nC8hx#n8Z}-z)^~d>{K(PH%;J?T>}v)wh%##OeqRja)#_!b7NS)Ni;W> z>ODl!->o^;%IQ#%(uIvzh__I-QUG?0Q=X#W83ZYRpTT3lP8u7Bt&yFU;wr%I)1RX|H#3V zNB`|ko=;kFMNOvatOj$2+}+)c7K`;NC-Mj)$tH{-{uLr5R?c!^#Po-~5lv!`#3PT& zXWvlMcyl1n;AMyt#+xCq;>|fmHH-4f7F%!BqmcJzNhGXCCK6LV8;vEIus34r*)zk1 zT!SYEH1}8vKpHC51e2m^f{DpAB0*u31Tmn}ETkD`NK;32VY7zPg2pw5JHiZiKoC@u z;F=Y!)D#dIfl%71pqm{fjDg@@VN^MXpjSoX(IoivXo_tqNu8;nPSMxqyn*)AaReag zMOyxm?_62^HSIU!?6e_u9`LA)3`%kU*{}AwarYu|2j9nC@ zB0!_n_Y4QPDjw7XlMPCF%@`OW1|6y3RQxRH7)YE+A{dPl+aK}mnv38iBq;spLFq%F zRmlvShk-eWwaA`o$#;)Ryw6)eJC_kPU(P%s$ z!fJE~D@^|rR8o@&E^@2h@+*5U?OpVWtBo7y`Y#{JO$brK9l@6o)}@7YH%gX;O?RtX zGSxfN)jMywzVG{jp=oad+B>f2Qt7el=tZu+qCqc1GBA6=?Cw&*){C#UV!x&A*s z0-4a)vKH0|b1*FQ5hB;Pqy;Iat^vDZrP)J|S+buy?I-yhrL28KqsEifQb0nlc98&J zVH>jyXGu9c<=a4-!p~5S1z~nIXSi?kB&QNzt_g%CXs@*jh^b+S4`D-mP&F^uPxDPH zrEDs!L&gAAuAGRR1>Pb^F?Co57ziU1QkclKnhOL@G?*&U_Z`u1q79XB`bF*&ppura zc^DQUtda?KrGs5d!JY>kU(!DJ{Hm`a<7-U&8n3^$;@f!7iNt$8uB0?0)Tf2|WuXzc z2t~Y2Kk+uLLckYTUUOP#UJ=A6?CMuBJnSmQpg(pv!VV)~jV-ES*2V4^kU-~Lefh~d zs2oJTMKf~RFrsXSEh>`DKU1EKn=uo@9$Tl)BT^XmP7S#iv< z!ki<_EY+{Yv-PJ_{hmc`4CCQU=TvADfqj8Z=qaANdA*<@DRa%6>)P9p`%IXr@ zH$ZnQB_LFioGhOQ1|uCV^`6%=EqEwYsW}p=<|0kDRuolf(R7koZ}DT{s2WC7Q1$5o zt)!LGqFMRMYuIn7QlR|PDiwJm0q$7>=MJGcDWmOa2t!&iXrY8DDhH{sFCs}6PiQn} zuDQ-4mNPj#izTLD`zjLnqr{&Ezc4XR~OSe6@+}6)%Nn(6hCn~OUoDrzfyV$7``bjG%XA3 zK(RC4#-Df_SwBr_U(>R0-Os)Cx!n>~-}RMUEJ;lJ#ARPASOmQpgHWuR@9k-!eOUcz=n@w}5Edu$OuDZCHc6{Lf+vyxD%u zSYG`nvj%*~5jl)W_exMSK%%FUm3tzfWJ-v6sAHFPAVslD)CD;@_E{+~uK?5WLyMo6 zh$8?q0)?B9rR#t2Vx{C2reRGIRy@Y+2;xLSnt~<_dWJX|te|}WHe}t1>WC7Z%pxBe zAl25<=VSt^ca$EU5e*AOm}x0=HCcFaCbXtoy&~2FMjX}+Q;Y>Of&h>n1v zPqT8sYihOOTx%}5L8r)HO5tIW^AvK2Nl0>*V%)vEIg z8kY~N7ITOG3#6-r%pv|ZGA46(}BS7kXnj=m8?X8?*YZfwfeAhW`v^*9QO0TCCoM z&#G;Mow9<>DIk^$jtkCNXI6}|6Jll^=6KI>uy{C9?_03c7lE!`r4vC4D4Y`L+8I%k z<0G=j1l6q7W8c1gqP~OS5tSLD4FcE^)`?~~dlXJ8Q(1oJvnzH(jVUV~p=<*KWL&q# zIRFLWm#|$*1c6qh(_O7NGORK#!mWbzC$(bYFQBstxnOT)Im&q|4-Kxa)t}MjGbTt8 z7!X6F8)3=|rj)9-o#}5-Nj-@GL_EM%R9%_AG=1fbOK)5sT`u3S>JQ$n3S4Wy+J3F) zYR`?0OI4w{;@i#Q+hcEyy*=^P#LYuX%{xFD=St?ESuL;q`nI=sy|wE`bg5y>V)>Ru zVar-jCE#J8`qu!s$7yE3{SsL%c+SxL3Z5|sNm7uT|B?VFt9hAqBrV;`yGC2e@GL+} z;xD*nov5*mYM>_@a+n1#mA_mqIZ%T;^EvtcY+at?xi}9w-KFrCzkn8OWGu-kx$LB> zSxetTc6t-oA@@&x)`*qH-)*dyzwww6x@R5GKow;*P#DE6_y>@7Y2ak4)5O%ecAdE8 zQL;kpGVM&`5gbEMU9#Dw958W~=htXYdD|J2&8mew$^pz+^W};rnpa1{OkbdRqF}?R zjS*RMGflBVDo34xE{fpT#U*8o8gZQg1rND(y;F(Vt*SXjEEZcf*3zWLlrZO>}U zhU-O8eZF1#R%s^KnGSZ|JiZ*<^3!0`y%H3E;NybLtAXIP7p}gr8XWj2@Z-9_uUkCv z>OZVY2VeV@(@|Xm-Z&7<_}kO|_M47n|7I$Dzfr#6xS3qo zz1X~eC2-*W1{&)V4(*>~zSlUI^7(J@#=(1$9Xx}2a9q+lxOT_YPEn9`;>jKz^T>h{ z*ebE?)K}Rf0{}hD0Ms!EBT-pC@0cp3cZ+d^vWZxt?vc?kFd;?Y)L=WyB4%Y6GggRZ z8Q{gZEh*&EVM?&Lkz!zN)QoFx#_TcokSsh+qJdPS9Xy#0hy+dtQ0yY7`TORC)!KCr zI7dmx+@afndf?TaZ|!`0-&_0M+p$pm?%t)qvvUVYG-3i2i7_{-SA6aF-Kem3_XrU( zl>3^Aa;@D$j`2vA3lvj7TDxfGbGB-4Q*KZ~*e4rxmz{!gmbXK>W=mOAhjKP37l`{1 z$DINxAU@%O>w=-Zab#a$p zFknp+nE9OK08(vm`o}mBcmQR2 zSmjL=$pOwk!YkCYAxgbUwO!%KvtwGZs*Es0k0-2;h>SkW`;V~+$^{fvi4YTj;$i%P z@?|8X>g`}uXRS99gkD1-=BYvGr7P|4x_M^F|LmM#C|4WP-o}i#EA8!C_V(lhXfV^V zE8Vhdsb$ZyZ!hrEQ+qQz4yAV-A}Al=)4nZp{qybDcios-ZQKBrZs`C&FRWGsu9aRb z%~Y&USFHc$@o&BQ&a2-#_0Fk<_FK;^ZRlUAI0$V33f^~86KesVkU9hWADV!Vgu>?x zN)$dOFe-lokSff?yB%r+5TY8`Us_o9%!1To4$bmemK!s89y4&|jL>C`(Dgfv(5j6QcK;S5wCZ7mFXDjx1s$*%PI(n8 z7xL<7sEp1~&dDI7kn)EJG$(8g3N1#?L19>&WHNSwOpd?>RoH}9jMG8qLV1hwcOWR_ z1{9>Fn(a1%IXedC6-QoA{y2{^eD+=i33sXHCmIDhE+ z7gw7$lEdPT>-_D;j+>QVJBkR@a0aco*|O5mx!NecedMhpnZ_;Y#w`n#D~;Rl7o)~~ zKZZaCt?sqQ2Dnu}Hvbus$Fb;7JT|+r**03N0vhu#OfQ(h(=n)(=r|9A8WPq;OhGFr zSi!r6ZvO*Pvp84zDqamusB#1GJng571k-yhUon6d57DmoqXaWWLixycy)*6YT=sUe zUEh`tZd=&B6x=`eLOwpM%e3rHx9nbO*}LM~chAlFdj8ezgh$_r5olHNwu0$dbRCuQ zgsu3q!mS{^ggu4QH8+Q!xEnAT)@@JMZC^ONRM$KAV*YN_XIl28TlOrq>|62e|JS)2 zrTT6d>MV0ZymU5971t9s<3AN{#uRNvgB?;dTKj_SZgix*9n0QLKuej%r_+s3FZ{t$ z*0y!%o$f3m$aNh zvfS;cV?C!FU{aKg=@#P-U=<410+o@*LIJ$NUWMw=VD$>fxKVp(e33NvY`i`@B z9gaofXCVNP76Yp3ILv@0F}>t8qHvj`N{E(@Byjs@5*}hybTC!i2`d05kaFx2LuCpH zfSM~BhksxnqDm#b3p6S!r3<#z#{8MD7+v3C9V#R{X`WZ;atpi9!}KalfY6*Uj^GlH z?nB8+!_zO8!2KazIMxlIF6u&aPN-uAA~EsRrd5#{Le0HG!m#NX@bEJLUg9KBVF6E zRJ#c(7k};ip4C9zJ(o~fV`)TorUUQ>S`O^JSIYTo!Ch6?-wSf3)mH{D4X*eafBlJ< ztLyo$XR&rSSS`ICsa+b{G7X*ShR((MuA8rZ_r$GW=GnpYvx7@d9bMdUZ1LFf#S^bA z9)EQ)_}ZtWkGanw_~(00H1N;&JlWPCsZU{|e;w%ab3gDmJjZiC=;jgsAz$8C;rwC6 z(|um&kBZz#`H|O+lpj?%DekZ8+u+RecOzDcAwx^6ibX7Z3fQmTQp9Jv($C4VNsg=x zVJE}`4Oqx3J4zF&0KFPxV}2u_yU$riZp|zbw3Cb^*Vzu71gGS_;EX$@q6=hAqrVqE|dC!}j?~Ehli=4ye9V5qns7yyi zSo7jATNuv!y8DG1!#xq4zXUVtF+|8bKVTNrFPcam!dmpec-fwJzB)qfog(fN!WWz2 zMcqYzSdJxh=L|*8HP~)qJuucm_c8BC&P*DP{H-jxHEZDzMZLHJ?{1i3^a=)U>>wvq z;B#PCbqaRCQE^%pF*UK3@er-nfN9Whvp*M2OsS}0T$ZqW;F&K7IeHAUYf|~0lczZD zEp&>wxX>wftLNef$Hx$iMUx1JQ*eTY*r<#E#b@tDSbb}5HYK`IS%fi+M$c>R>1cfW zwv?-9_SC6Id=Hd_PV}HT(L>68in>U-PN5HaK_~QsUbG^;msCZ^@6G=Hg;0m_*S+Zx zKYJ3*3vdUa+YRSKKAi`?2*}ZVOlve1i!p(e1XiuwxXnSRT%jvM3R4di>FS~HQ3ZjDGR+XK>`bEkIas~04n}M;31crEH`)SIEp!&| zrs=4_n`DMC^>>jEjZg(wS)Hlal&;uxbLUdU_Bl7OZN|So?O&hqZ%zBRF8R0536`e? zSvzk?-`)1Xv+qB9>*dVeBk8?ImbMQrk`44I?4G(mhF)sn8J4`~uD9&Uo=bbK@BE3k zb=6;gssE0@X0HFA{Kugz^=~w^QPM)+2hYF%{H@oPb_{&vTJj%3W?pmSw*qKxMcB8N zqa>b=A<<_rug~)2P}V1n<8H4GVjQOp>H^2)$Tg+RkcOKGbire1^@Op=Sx@evyq*4A za^a$CF5>*H^`7=s6B^A+eUUP z%R?YttsE3SU&|!Yjp)NIF`lX!3LYKd|n=z0xlqc)jYaK z7fsmo<|@X`YWRdC^Yj=o6ix+nc}=fk_CHU@_}?NM$JoPsWH+U~o0h$uw|(VTp1<_` zYE}P-C;#sB4^Dr0bn(Q=#fq0daXR3BRm7G0@90ihnW_!xstxZ%7OOhuidTj5D`l6; z=D)mHKd>wuqT}bg_2I7t=U)624%)4E%Ig-J zUP_n0v?#pvsk^}1V8GoSqW z>+jWn_rzcMzhC#gx(^R7J@w*J(@RSghjBZkrIOHOdKai}%f6JsYPN`i^F;a*dnQ`WNSnmu!Hy~&oHb-=&{DtN)2 z9h;qKXe<6%`Yp9Kr$-whRw|jz;leII`x$-NiIjY{1!mK>x$H3Oo`v4+Jx_M!FUQ%1 zAmaNA9=nSUXKXGxt=g#2eOnC{ngmFI{XB$_^r|IMm%eW7u^LtOY zUSQra!##ptR5DwmYuozuZN{MyHX>GrP!KZW7LIABRJi2R4PisX72#!sE5GfgPy?~n zx)%=Fava{Hqy{@nPO2k`9Eai#2%lCiAr&b6rsCG;JHSnjLyg78L1O@K3At)S&Z47( zDjW>yK4ff$kR0g?El+)h^dz{y#z1%JzJYO(TEA3JayKw##G0464l{-(Q@^`S%aH2; z)rko(Hk3xo1Zi`jvR=LzX8v{l?0CUa6idoX7&--w6mn-Z7tKFajoVq&qO}+_T`}dv zo!h}wC9N6dvXv(e8y`(bWZ$gu$+&kf;&yrxx3rCKGVD*au?rN$RY&MP{8Y@mevPuE z+?+(qAzrxyU=3AhMH6Sq>ro-3rFr%J4bzG#Kckdl7%3qA8h$xUomouxA<%}7>mw+o zvpgj8Y9%yu=02et00r|i6z2U0cu9mwA8I;J{2kRNCYudN`G6X6(Y$dB65c{1>}_84*Uj~>20}MGZq_esU#!}Bsqc=zmXbEy7{4)eQ(dguKG*m2 z@&Iw_FI{?RG1#}_>%XhB?eiya9Wqe&fOD5TJ=cHRUwv)o)t%S&UEOzM{j$IPc7^|% z_o{cXvG>CrD;3Y*HSEr_S7&cLe^Xkj-41;zyf4bGmR(QYIJw}OFI%a2>Yf*E-78~G z&2?#^E+ddjaz@yi7Pc;QtO&c;3e~h(AT0dDyCxYzLgDiyV={Pcms#G9i?=hqfH||s zk69PQz+#}7F4N|k1Be`FM{>^CkQS4u@ok%JyZ(&T+~S`y5*`W7~$U-qF6K z4XMa#eN9qm{xa>V&6q(ZW%2{TxNVFzU;{wFk!N#%4yp7#rGn=@$Ge6z05qdc+j(2$ zm5r&OKE0k1*CyJvME>08*Dr0ihs04OF_AkIM(?x4WPq+|6XByS z>01@Bf|0soIF^8_6rUTxH&E78$KAO&dd^ZSy;IWaGK*6?(cmOJ>}g$2g8G?aL;k=` z${)=(gfGC*_eAi`q9|Qti4zf2WLU;PfAK;xAEfuF%p4I?JX4=LkI6fmko1c%*kSN;#hEOm{3`~6L%Y0k;Sq~^xW zJ^8%mW1DCUM6r5;mmjo6`oNSIsiEg7(CMLZ8_=SM5cElmXM=^i3+Z&3zL@H1&e4ga z@=L_lXmU>>F^@`F6dad_{)wnm8v;i5rUilA zP)pbad%Cf5{k(qfFB9664()-+vl^_QE4|~bnD3`bY249=$Lirrhcmu)Y2UgVu5bC? z@nysrR!;Dg5Z8#7z`(p&o=^=y4{NqlM9cNnzp+McU>h=LvD=lU#-@@hrh_3bx< zw*ud<|6ct^JAS{|5 zW0$&6M4XY6Sr`Yq#UP82n@S@#E{asHIT|LEtjWOF5(~c8)sil6SrqioB7_`T5sn_F zr@81mHjtx#jczm-jWX1x31J4O;jrcj8@^bG`@-QbL)S_Wj5ja%Ep{glFsTr_WnVtA zzD1_&rlj(4IOqG9;jq$*RAmnZds&s-j}#~eDE$ZpFH`V)6ueGB6ahY&N1xFg0f#uA zko1cL3Cf(L;L8*!6p$O3lB8gYf-@AHr2rBorz>tHiZLWWCr$a3f*=KL6c8z8_=E+7 zSkzx3_#cxvMJ#@L;Z4Z3U1d1*mevssgJBuzJU99eS$Q8Sba2`Fu>w(2}{U62_ zg%kIjj#qgUTdX<(fJe563vOHuG~9PPyIJxke8!I@*EB6Q_bdjsEc&-zJbWi~^x~n# z(v3^5qYqrw?)rz_rS7(e%>j4I!_Ibh^TXqOz`fyKCs$N;-%;k?`p}8kJ&HXL1MXh_ zL8r^z@xWK+9^fB{{-LME-SlvPuXgW$*j?%NJlI(5KFmL? z^0><$20Pq)9-icz(9XksF1P+|H?|IWDn0Ot`Y9sv{5X|GmY<=EUxSbMHdxa<*hD3% z5}5>)|0OMM7QmIC;++KofiLj^`jA>G0rj?Tq20oue7csjd!y}4|QrVZbm=Qq#=p!L?U2k7T z*q7yWhw&{|U2#>y>cD!Uu#a5os;VNgxI)tLQl<+YCbB}jEAEWZmseH&3oE2p)QJ!A zs#-~s{2fVx(Y-xf)RXQN%gzeHpS~{n5c){iqx+=qQ!257w216-7`~^$^YF literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/_framework_compat.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/_framework_compat.py new file mode 100644 index 000000000..00d34bc7d --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/_framework_compat.py @@ -0,0 +1,54 @@ +""" +Backward compatibility for homebrew builds on macOS. +""" + +import functools +import os +import subprocess +import sys +import sysconfig + + +@functools.lru_cache +def enabled(): + """ + Only enabled for Python 3.9 framework homebrew builds + except ensurepip and venv. + """ + PY39 = (3, 9) < sys.version_info < (3, 10) + framework = sys.platform == 'darwin' and sys._framework + homebrew = "Cellar" in sysconfig.get_config_var('projectbase') + venv = sys.prefix != sys.base_prefix + ensurepip = os.environ.get("ENSUREPIP_OPTIONS") + return PY39 and framework and homebrew and not venv and not ensurepip + + +schemes = dict( + osx_framework_library=dict( + stdlib='{installed_base}/{platlibdir}/python{py_version_short}', + platstdlib='{platbase}/{platlibdir}/python{py_version_short}', + purelib='{homebrew_prefix}/lib/python{py_version_short}/site-packages', + platlib='{homebrew_prefix}/{platlibdir}/python{py_version_short}/site-packages', + include='{installed_base}/include/python{py_version_short}{abiflags}', + platinclude='{installed_platbase}/include/python{py_version_short}{abiflags}', + scripts='{homebrew_prefix}/bin', + data='{homebrew_prefix}', + ) +) + + +@functools.lru_cache +def vars(): + if not enabled(): + return {} + homebrew_prefix = subprocess.check_output(['brew', '--prefix'], text=True).strip() + return locals() + + +def scheme(name): + """ + Override the selected scheme for posix_prefix. + """ + if not enabled() or not name.endswith('_prefix'): + return name + return 'osx_framework_library' diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/bdist.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/bdist.py new file mode 100644 index 000000000..07811aab2 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/bdist.py @@ -0,0 +1,167 @@ +"""distutils.command.bdist + +Implements the Distutils 'bdist' command (create a built [binary] +distribution).""" + +from __future__ import annotations + +import os +import warnings +from collections.abc import Callable +from typing import TYPE_CHECKING, ClassVar + +from ..core import Command +from ..errors import DistutilsOptionError, DistutilsPlatformError +from ..util import get_platform + +if TYPE_CHECKING: + from typing_extensions import deprecated +else: + + def deprecated(message): + return lambda fn: fn + + +def show_formats(): + """Print list of available formats (arguments to "--format" option).""" + from ..fancy_getopt import FancyGetopt + + formats = [ + ("formats=" + format, None, bdist.format_commands[format][1]) + for format in bdist.format_commands + ] + pretty_printer = FancyGetopt(formats) + pretty_printer.print_help("List of available distribution formats:") + + +class ListCompat(dict[str, tuple[str, str]]): + # adapter to allow for Setuptools compatibility in format_commands + @deprecated("format_commands is now a dict. append is deprecated.") + def append(self, item: object) -> None: + warnings.warn( + "format_commands is now a dict. append is deprecated.", + DeprecationWarning, + stacklevel=2, + ) + + +class bdist(Command): + description = "create a built (binary) distribution" + + user_options = [ + ('bdist-base=', 'b', "temporary directory for creating built distributions"), + ( + 'plat-name=', + 'p', + "platform name to embed in generated filenames " + f"[default: {get_platform()}]", + ), + ('formats=', None, "formats for distribution (comma-separated list)"), + ( + 'dist-dir=', + 'd', + "directory to put final built distributions in [default: dist]", + ), + ('skip-build', None, "skip rebuilding everything (for testing/debugging)"), + ( + 'owner=', + 'u', + "Owner name used when creating a tar file [default: current user]", + ), + ( + 'group=', + 'g', + "Group name used when creating a tar file [default: current group]", + ), + ] + + boolean_options: ClassVar[list[str]] = ['skip-build'] + + help_options: ClassVar[list[tuple[str, str | None, str, Callable[[], object]]]] = [ + ('help-formats', None, "lists available distribution formats", show_formats), + ] + + # The following commands do not take a format option from bdist + no_format_option: ClassVar[tuple[str, ...]] = ('bdist_rpm',) + + # This won't do in reality: will need to distinguish RPM-ish Linux, + # Debian-ish Linux, Solaris, FreeBSD, ..., Windows, Mac OS. + default_format: ClassVar[dict[str, str]] = {'posix': 'gztar', 'nt': 'zip'} + + # Define commands in preferred order for the --help-formats option + format_commands = ListCompat({ + 'rpm': ('bdist_rpm', "RPM distribution"), + 'gztar': ('bdist_dumb', "gzip'ed tar file"), + 'bztar': ('bdist_dumb', "bzip2'ed tar file"), + 'xztar': ('bdist_dumb', "xz'ed tar file"), + 'ztar': ('bdist_dumb', "compressed tar file"), + 'tar': ('bdist_dumb', "tar file"), + 'zip': ('bdist_dumb', "ZIP file"), + }) + + # for compatibility until consumers only reference format_commands + format_command = format_commands + + def initialize_options(self): + self.bdist_base = None + self.plat_name = None + self.formats = None + self.dist_dir = None + self.skip_build = False + self.group = None + self.owner = None + + def finalize_options(self) -> None: + # have to finalize 'plat_name' before 'bdist_base' + if self.plat_name is None: + if self.skip_build: + self.plat_name = get_platform() + else: + self.plat_name = self.get_finalized_command('build').plat_name + + # 'bdist_base' -- parent of per-built-distribution-format + # temporary directories (eg. we'll probably have + # "build/bdist./dumb", "build/bdist./rpm", etc.) + if self.bdist_base is None: + build_base = self.get_finalized_command('build').build_base + self.bdist_base = os.path.join(build_base, 'bdist.' + self.plat_name) + + self.ensure_string_list('formats') + if self.formats is None: + try: + self.formats = [self.default_format[os.name]] + except KeyError: + raise DistutilsPlatformError( + "don't know how to create built distributions " + f"on platform {os.name}" + ) + + if self.dist_dir is None: + self.dist_dir = "dist" + + def run(self) -> None: + # Figure out which sub-commands we need to run. + commands = [] + for format in self.formats: + try: + commands.append(self.format_commands[format][0]) + except KeyError: + raise DistutilsOptionError(f"invalid format '{format}'") + + # Reinitialize and run each command. + for i in range(len(self.formats)): + cmd_name = commands[i] + sub_cmd = self.reinitialize_command(cmd_name) + if cmd_name not in self.no_format_option: + sub_cmd.format = self.formats[i] + + # passing the owner and group names for tar archiving + if cmd_name == 'bdist_dumb': + sub_cmd.owner = self.owner + sub_cmd.group = self.group + + # If we're going to need to run this command again, tell it to + # keep its temporary files around so subsequent runs go faster. + if cmd_name in commands[i + 1 :]: + sub_cmd.keep_temp = True + self.run_command(cmd_name) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/bdist_dumb.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/bdist_dumb.py new file mode 100644 index 000000000..ccad66f43 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/bdist_dumb.py @@ -0,0 +1,141 @@ +"""distutils.command.bdist_dumb + +Implements the Distutils 'bdist_dumb' command (create a "dumb" built +distribution -- i.e., just an archive to be unpacked under $prefix or +$exec_prefix).""" + +import os +from distutils._log import log +from typing import ClassVar + +from ..core import Command +from ..dir_util import ensure_relative, remove_tree +from ..errors import DistutilsPlatformError +from ..sysconfig import get_python_version +from ..util import get_platform + + +class bdist_dumb(Command): + description = "create a \"dumb\" built distribution" + + user_options = [ + ('bdist-dir=', 'd', "temporary directory for creating the distribution"), + ( + 'plat-name=', + 'p', + "platform name to embed in generated filenames " + f"[default: {get_platform()}]", + ), + ( + 'format=', + 'f', + "archive format to create (tar, gztar, bztar, xztar, ztar, zip)", + ), + ( + 'keep-temp', + 'k', + "keep the pseudo-installation tree around after creating the distribution archive", + ), + ('dist-dir=', 'd', "directory to put final built distributions in"), + ('skip-build', None, "skip rebuilding everything (for testing/debugging)"), + ( + 'relative', + None, + "build the archive using relative paths [default: false]", + ), + ( + 'owner=', + 'u', + "Owner name used when creating a tar file [default: current user]", + ), + ( + 'group=', + 'g', + "Group name used when creating a tar file [default: current group]", + ), + ] + + boolean_options: ClassVar[list[str]] = ['keep-temp', 'skip-build', 'relative'] + + default_format = {'posix': 'gztar', 'nt': 'zip'} + + def initialize_options(self): + self.bdist_dir = None + self.plat_name = None + self.format = None + self.keep_temp = False + self.dist_dir = None + self.skip_build = None + self.relative = False + self.owner = None + self.group = None + + def finalize_options(self): + if self.bdist_dir is None: + bdist_base = self.get_finalized_command('bdist').bdist_base + self.bdist_dir = os.path.join(bdist_base, 'dumb') + + if self.format is None: + try: + self.format = self.default_format[os.name] + except KeyError: + raise DistutilsPlatformError( + "don't know how to create dumb built distributions " + f"on platform {os.name}" + ) + + self.set_undefined_options( + 'bdist', + ('dist_dir', 'dist_dir'), + ('plat_name', 'plat_name'), + ('skip_build', 'skip_build'), + ) + + def run(self): + if not self.skip_build: + self.run_command('build') + + install = self.reinitialize_command('install', reinit_subcommands=True) + install.root = self.bdist_dir + install.skip_build = self.skip_build + install.warn_dir = False + + log.info("installing to %s", self.bdist_dir) + self.run_command('install') + + # And make an archive relative to the root of the + # pseudo-installation tree. + archive_basename = f"{self.distribution.get_fullname()}.{self.plat_name}" + + pseudoinstall_root = os.path.join(self.dist_dir, archive_basename) + if not self.relative: + archive_root = self.bdist_dir + else: + if self.distribution.has_ext_modules() and ( + install.install_base != install.install_platbase + ): + raise DistutilsPlatformError( + "can't make a dumb built distribution where " + f"base and platbase are different ({install.install_base!r}, {install.install_platbase!r})" + ) + else: + archive_root = os.path.join( + self.bdist_dir, ensure_relative(install.install_base) + ) + + # Make the archive + filename = self.make_archive( + pseudoinstall_root, + self.format, + root_dir=archive_root, + owner=self.owner, + group=self.group, + ) + if self.distribution.has_ext_modules(): + pyversion = get_python_version() + else: + pyversion = 'any' + self.distribution.dist_files.append(('bdist_dumb', pyversion, filename)) + + if not self.keep_temp: + remove_tree(self.bdist_dir, dry_run=self.dry_run) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/bdist_rpm.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/bdist_rpm.py new file mode 100644 index 000000000..357b4e861 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/bdist_rpm.py @@ -0,0 +1,598 @@ +"""distutils.command.bdist_rpm + +Implements the Distutils 'bdist_rpm' command (create RPM source and binary +distributions).""" + +import os +import subprocess +import sys +from distutils._log import log +from typing import ClassVar + +from ..core import Command +from ..debug import DEBUG +from ..errors import ( + DistutilsExecError, + DistutilsFileError, + DistutilsOptionError, + DistutilsPlatformError, +) +from ..file_util import write_file +from ..sysconfig import get_python_version + + +class bdist_rpm(Command): + description = "create an RPM distribution" + + user_options = [ + ('bdist-base=', None, "base directory for creating built distributions"), + ( + 'rpm-base=', + None, + "base directory for creating RPMs (defaults to \"rpm\" under " + "--bdist-base; must be specified for RPM 2)", + ), + ( + 'dist-dir=', + 'd', + "directory to put final RPM files in (and .spec files if --spec-only)", + ), + ( + 'python=', + None, + "path to Python interpreter to hard-code in the .spec file " + "[default: \"python\"]", + ), + ( + 'fix-python', + None, + "hard-code the exact path to the current Python interpreter in " + "the .spec file", + ), + ('spec-only', None, "only regenerate spec file"), + ('source-only', None, "only generate source RPM"), + ('binary-only', None, "only generate binary RPM"), + ('use-bzip2', None, "use bzip2 instead of gzip to create source distribution"), + # More meta-data: too RPM-specific to put in the setup script, + # but needs to go in the .spec file -- so we make these options + # to "bdist_rpm". The idea is that packagers would put this + # info in setup.cfg, although they are of course free to + # supply it on the command line. + ( + 'distribution-name=', + None, + "name of the (Linux) distribution to which this " + "RPM applies (*not* the name of the module distribution!)", + ), + ('group=', None, "package classification [default: \"Development/Libraries\"]"), + ('release=', None, "RPM release number"), + ('serial=', None, "RPM serial number"), + ( + 'vendor=', + None, + "RPM \"vendor\" (eg. \"Joe Blow \") " + "[default: maintainer or author from setup script]", + ), + ( + 'packager=', + None, + "RPM packager (eg. \"Jane Doe \") [default: vendor]", + ), + ('doc-files=', None, "list of documentation files (space or comma-separated)"), + ('changelog=', None, "RPM changelog"), + ('icon=', None, "name of icon file"), + ('provides=', None, "capabilities provided by this package"), + ('requires=', None, "capabilities required by this package"), + ('conflicts=', None, "capabilities which conflict with this package"), + ('build-requires=', None, "capabilities required to build this package"), + ('obsoletes=', None, "capabilities made obsolete by this package"), + ('no-autoreq', None, "do not automatically calculate dependencies"), + # Actions to take when building RPM + ('keep-temp', 'k', "don't clean up RPM build directory"), + ('no-keep-temp', None, "clean up RPM build directory [default]"), + ( + 'use-rpm-opt-flags', + None, + "compile with RPM_OPT_FLAGS when building from source RPM", + ), + ('no-rpm-opt-flags', None, "do not pass any RPM CFLAGS to compiler"), + ('rpm3-mode', None, "RPM 3 compatibility mode (default)"), + ('rpm2-mode', None, "RPM 2 compatibility mode"), + # Add the hooks necessary for specifying custom scripts + ('prep-script=', None, "Specify a script for the PREP phase of RPM building"), + ('build-script=', None, "Specify a script for the BUILD phase of RPM building"), + ( + 'pre-install=', + None, + "Specify a script for the pre-INSTALL phase of RPM building", + ), + ( + 'install-script=', + None, + "Specify a script for the INSTALL phase of RPM building", + ), + ( + 'post-install=', + None, + "Specify a script for the post-INSTALL phase of RPM building", + ), + ( + 'pre-uninstall=', + None, + "Specify a script for the pre-UNINSTALL phase of RPM building", + ), + ( + 'post-uninstall=', + None, + "Specify a script for the post-UNINSTALL phase of RPM building", + ), + ('clean-script=', None, "Specify a script for the CLEAN phase of RPM building"), + ( + 'verify-script=', + None, + "Specify a script for the VERIFY phase of the RPM build", + ), + # Allow a packager to explicitly force an architecture + ('force-arch=', None, "Force an architecture onto the RPM build process"), + ('quiet', 'q', "Run the INSTALL phase of RPM building in quiet mode"), + ] + + boolean_options: ClassVar[list[str]] = [ + 'keep-temp', + 'use-rpm-opt-flags', + 'rpm3-mode', + 'no-autoreq', + 'quiet', + ] + + negative_opt: ClassVar[dict[str, str]] = { + 'no-keep-temp': 'keep-temp', + 'no-rpm-opt-flags': 'use-rpm-opt-flags', + 'rpm2-mode': 'rpm3-mode', + } + + def initialize_options(self): + self.bdist_base = None + self.rpm_base = None + self.dist_dir = None + self.python = None + self.fix_python = None + self.spec_only = None + self.binary_only = None + self.source_only = None + self.use_bzip2 = None + + self.distribution_name = None + self.group = None + self.release = None + self.serial = None + self.vendor = None + self.packager = None + self.doc_files = None + self.changelog = None + self.icon = None + + self.prep_script = None + self.build_script = None + self.install_script = None + self.clean_script = None + self.verify_script = None + self.pre_install = None + self.post_install = None + self.pre_uninstall = None + self.post_uninstall = None + self.prep = None + self.provides = None + self.requires = None + self.conflicts = None + self.build_requires = None + self.obsoletes = None + + self.keep_temp = False + self.use_rpm_opt_flags = True + self.rpm3_mode = True + self.no_autoreq = False + + self.force_arch = None + self.quiet = False + + def finalize_options(self) -> None: + self.set_undefined_options('bdist', ('bdist_base', 'bdist_base')) + if self.rpm_base is None: + if not self.rpm3_mode: + raise DistutilsOptionError("you must specify --rpm-base in RPM 2 mode") + self.rpm_base = os.path.join(self.bdist_base, "rpm") + + if self.python is None: + if self.fix_python: + self.python = sys.executable + else: + self.python = "python3" + elif self.fix_python: + raise DistutilsOptionError( + "--python and --fix-python are mutually exclusive options" + ) + + if os.name != 'posix': + raise DistutilsPlatformError( + f"don't know how to create RPM distributions on platform {os.name}" + ) + if self.binary_only and self.source_only: + raise DistutilsOptionError( + "cannot supply both '--source-only' and '--binary-only'" + ) + + # don't pass CFLAGS to pure python distributions + if not self.distribution.has_ext_modules(): + self.use_rpm_opt_flags = False + + self.set_undefined_options('bdist', ('dist_dir', 'dist_dir')) + self.finalize_package_data() + + def finalize_package_data(self) -> None: + self.ensure_string('group', "Development/Libraries") + self.ensure_string( + 'vendor', + f"{self.distribution.get_contact()} <{self.distribution.get_contact_email()}>", + ) + self.ensure_string('packager') + self.ensure_string_list('doc_files') + if isinstance(self.doc_files, list): + for readme in ('README', 'README.txt'): + if os.path.exists(readme) and readme not in self.doc_files: + self.doc_files.append(readme) + + self.ensure_string('release', "1") + self.ensure_string('serial') # should it be an int? + + self.ensure_string('distribution_name') + + self.ensure_string('changelog') + # Format changelog correctly + self.changelog = self._format_changelog(self.changelog) + + self.ensure_filename('icon') + + self.ensure_filename('prep_script') + self.ensure_filename('build_script') + self.ensure_filename('install_script') + self.ensure_filename('clean_script') + self.ensure_filename('verify_script') + self.ensure_filename('pre_install') + self.ensure_filename('post_install') + self.ensure_filename('pre_uninstall') + self.ensure_filename('post_uninstall') + + # XXX don't forget we punted on summaries and descriptions -- they + # should be handled here eventually! + + # Now *this* is some meta-data that belongs in the setup script... + self.ensure_string_list('provides') + self.ensure_string_list('requires') + self.ensure_string_list('conflicts') + self.ensure_string_list('build_requires') + self.ensure_string_list('obsoletes') + + self.ensure_string('force_arch') + + def run(self) -> None: # noqa: C901 + if DEBUG: + print("before _get_package_data():") + print("vendor =", self.vendor) + print("packager =", self.packager) + print("doc_files =", self.doc_files) + print("changelog =", self.changelog) + + # make directories + if self.spec_only: + spec_dir = self.dist_dir + self.mkpath(spec_dir) + else: + rpm_dir = {} + for d in ('SOURCES', 'SPECS', 'BUILD', 'RPMS', 'SRPMS'): + rpm_dir[d] = os.path.join(self.rpm_base, d) + self.mkpath(rpm_dir[d]) + spec_dir = rpm_dir['SPECS'] + + # Spec file goes into 'dist_dir' if '--spec-only specified', + # build/rpm. otherwise. + spec_path = os.path.join(spec_dir, f"{self.distribution.get_name()}.spec") + self.execute( + write_file, (spec_path, self._make_spec_file()), f"writing '{spec_path}'" + ) + + if self.spec_only: # stop if requested + return + + # Make a source distribution and copy to SOURCES directory with + # optional icon. + saved_dist_files = self.distribution.dist_files[:] + sdist = self.reinitialize_command('sdist') + if self.use_bzip2: + sdist.formats = ['bztar'] + else: + sdist.formats = ['gztar'] + self.run_command('sdist') + self.distribution.dist_files = saved_dist_files + + source = sdist.get_archive_files()[0] + source_dir = rpm_dir['SOURCES'] + self.copy_file(source, source_dir) + + if self.icon: + if os.path.exists(self.icon): + self.copy_file(self.icon, source_dir) + else: + raise DistutilsFileError(f"icon file '{self.icon}' does not exist") + + # build package + log.info("building RPMs") + rpm_cmd = ['rpmbuild'] + + if self.source_only: # what kind of RPMs? + rpm_cmd.append('-bs') + elif self.binary_only: + rpm_cmd.append('-bb') + else: + rpm_cmd.append('-ba') + rpm_cmd.extend(['--define', f'__python {self.python}']) + if self.rpm3_mode: + rpm_cmd.extend(['--define', f'_topdir {os.path.abspath(self.rpm_base)}']) + if not self.keep_temp: + rpm_cmd.append('--clean') + + if self.quiet: + rpm_cmd.append('--quiet') + + rpm_cmd.append(spec_path) + # Determine the binary rpm names that should be built out of this spec + # file + # Note that some of these may not be really built (if the file + # list is empty) + nvr_string = "%{name}-%{version}-%{release}" + src_rpm = nvr_string + ".src.rpm" + non_src_rpm = "%{arch}/" + nvr_string + ".%{arch}.rpm" + q_cmd = rf"rpm -q --qf '{src_rpm} {non_src_rpm}\n' --specfile '{spec_path}'" + + out = os.popen(q_cmd) + try: + binary_rpms = [] + source_rpm = None + while True: + line = out.readline() + if not line: + break + ell = line.strip().split() + assert len(ell) == 2 + binary_rpms.append(ell[1]) + # The source rpm is named after the first entry in the spec file + if source_rpm is None: + source_rpm = ell[0] + + status = out.close() + if status: + raise DistutilsExecError(f"Failed to execute: {q_cmd!r}") + + finally: + out.close() + + self.spawn(rpm_cmd) + + if not self.dry_run: + if self.distribution.has_ext_modules(): + pyversion = get_python_version() + else: + pyversion = 'any' + + if not self.binary_only: + srpm = os.path.join(rpm_dir['SRPMS'], source_rpm) + assert os.path.exists(srpm) + self.move_file(srpm, self.dist_dir) + filename = os.path.join(self.dist_dir, source_rpm) + self.distribution.dist_files.append(('bdist_rpm', pyversion, filename)) + + if not self.source_only: + for rpm in binary_rpms: + rpm = os.path.join(rpm_dir['RPMS'], rpm) + if os.path.exists(rpm): + self.move_file(rpm, self.dist_dir) + filename = os.path.join(self.dist_dir, os.path.basename(rpm)) + self.distribution.dist_files.append(( + 'bdist_rpm', + pyversion, + filename, + )) + + def _dist_path(self, path): + return os.path.join(self.dist_dir, os.path.basename(path)) + + def _make_spec_file(self): # noqa: C901 + """Generate the text of an RPM spec file and return it as a + list of strings (one per line). + """ + # definitions and headers + spec_file = [ + '%define name ' + self.distribution.get_name(), + '%define version ' + self.distribution.get_version().replace('-', '_'), + '%define unmangled_version ' + self.distribution.get_version(), + '%define release ' + self.release.replace('-', '_'), + '', + 'Summary: ' + (self.distribution.get_description() or "UNKNOWN"), + ] + + # Workaround for #14443 which affects some RPM based systems such as + # RHEL6 (and probably derivatives) + vendor_hook = subprocess.getoutput('rpm --eval %{__os_install_post}') + # Generate a potential replacement value for __os_install_post (whilst + # normalizing the whitespace to simplify the test for whether the + # invocation of brp-python-bytecompile passes in __python): + vendor_hook = '\n'.join([ + f' {line.strip()} \\' for line in vendor_hook.splitlines() + ]) + problem = "brp-python-bytecompile \\\n" + fixed = "brp-python-bytecompile %{__python} \\\n" + fixed_hook = vendor_hook.replace(problem, fixed) + if fixed_hook != vendor_hook: + spec_file.append('# Workaround for https://bugs.python.org/issue14443') + spec_file.append('%define __os_install_post ' + fixed_hook + '\n') + + # put locale summaries into spec file + # XXX not supported for now (hard to put a dictionary + # in a config file -- arg!) + # for locale in self.summaries.keys(): + # spec_file.append('Summary(%s): %s' % (locale, + # self.summaries[locale])) + + spec_file.extend([ + 'Name: %{name}', + 'Version: %{version}', + 'Release: %{release}', + ]) + + # XXX yuck! this filename is available from the "sdist" command, + # but only after it has run: and we create the spec file before + # running "sdist", in case of --spec-only. + if self.use_bzip2: + spec_file.append('Source0: %{name}-%{unmangled_version}.tar.bz2') + else: + spec_file.append('Source0: %{name}-%{unmangled_version}.tar.gz') + + spec_file.extend([ + 'License: ' + (self.distribution.get_license() or "UNKNOWN"), + 'Group: ' + self.group, + 'BuildRoot: %{_tmppath}/%{name}-%{version}-%{release}-buildroot', + 'Prefix: %{_prefix}', + ]) + + if not self.force_arch: + # noarch if no extension modules + if not self.distribution.has_ext_modules(): + spec_file.append('BuildArch: noarch') + else: + spec_file.append(f'BuildArch: {self.force_arch}') + + for field in ( + 'Vendor', + 'Packager', + 'Provides', + 'Requires', + 'Conflicts', + 'Obsoletes', + ): + val = getattr(self, field.lower()) + if isinstance(val, list): + spec_file.append('{}: {}'.format(field, ' '.join(val))) + elif val is not None: + spec_file.append(f'{field}: {val}') + + if self.distribution.get_url(): + spec_file.append('Url: ' + self.distribution.get_url()) + + if self.distribution_name: + spec_file.append('Distribution: ' + self.distribution_name) + + if self.build_requires: + spec_file.append('BuildRequires: ' + ' '.join(self.build_requires)) + + if self.icon: + spec_file.append('Icon: ' + os.path.basename(self.icon)) + + if self.no_autoreq: + spec_file.append('AutoReq: 0') + + spec_file.extend([ + '', + '%description', + self.distribution.get_long_description() or "", + ]) + + # put locale descriptions into spec file + # XXX again, suppressed because config file syntax doesn't + # easily support this ;-( + # for locale in self.descriptions.keys(): + # spec_file.extend([ + # '', + # '%description -l ' + locale, + # self.descriptions[locale], + # ]) + + # rpm scripts + # figure out default build script + def_setup_call = f"{self.python} {os.path.basename(sys.argv[0])}" + def_build = f"{def_setup_call} build" + if self.use_rpm_opt_flags: + def_build = 'env CFLAGS="$RPM_OPT_FLAGS" ' + def_build + + # insert contents of files + + # XXX this is kind of misleading: user-supplied options are files + # that we open and interpolate into the spec file, but the defaults + # are just text that we drop in as-is. Hmmm. + + install_cmd = f'{def_setup_call} install -O1 --root=$RPM_BUILD_ROOT --record=INSTALLED_FILES' + + script_options = [ + ('prep', 'prep_script', "%setup -n %{name}-%{unmangled_version}"), + ('build', 'build_script', def_build), + ('install', 'install_script', install_cmd), + ('clean', 'clean_script', "rm -rf $RPM_BUILD_ROOT"), + ('verifyscript', 'verify_script', None), + ('pre', 'pre_install', None), + ('post', 'post_install', None), + ('preun', 'pre_uninstall', None), + ('postun', 'post_uninstall', None), + ] + + for rpm_opt, attr, default in script_options: + # Insert contents of file referred to, if no file is referred to + # use 'default' as contents of script + val = getattr(self, attr) + if val or default: + spec_file.extend([ + '', + '%' + rpm_opt, + ]) + if val: + with open(val) as f: + spec_file.extend(f.read().split('\n')) + else: + spec_file.append(default) + + # files section + spec_file.extend([ + '', + '%files -f INSTALLED_FILES', + '%defattr(-,root,root)', + ]) + + if self.doc_files: + spec_file.append('%doc ' + ' '.join(self.doc_files)) + + if self.changelog: + spec_file.extend([ + '', + '%changelog', + ]) + spec_file.extend(self.changelog) + + return spec_file + + def _format_changelog(self, changelog): + """Format the changelog correctly and convert it to a list of strings""" + if not changelog: + return changelog + new_changelog = [] + for line in changelog.strip().split('\n'): + line = line.strip() + if line[0] == '*': + new_changelog.extend(['', line]) + elif line[0] == '-': + new_changelog.append(line) + else: + new_changelog.append(' ' + line) + + # strip trailing newline inserted by first changelog entry + if not new_changelog[0]: + del new_changelog[0] + + return new_changelog diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build.py new file mode 100644 index 000000000..6a8303a95 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build.py @@ -0,0 +1,156 @@ +"""distutils.command.build + +Implements the Distutils 'build' command.""" + +from __future__ import annotations + +import os +import sys +import sysconfig +from collections.abc import Callable +from typing import ClassVar + +from ..ccompiler import show_compilers +from ..core import Command +from ..errors import DistutilsOptionError +from ..util import get_platform + + +class build(Command): + description = "build everything needed to install" + + user_options = [ + ('build-base=', 'b', "base directory for build library"), + ('build-purelib=', None, "build directory for platform-neutral distributions"), + ('build-platlib=', None, "build directory for platform-specific distributions"), + ( + 'build-lib=', + None, + "build directory for all distribution (defaults to either build-purelib or build-platlib", + ), + ('build-scripts=', None, "build directory for scripts"), + ('build-temp=', 't', "temporary build directory"), + ( + 'plat-name=', + 'p', + f"platform name to build for, if supported [default: {get_platform()}]", + ), + ('compiler=', 'c', "specify the compiler type"), + ('parallel=', 'j', "number of parallel build jobs"), + ('debug', 'g', "compile extensions and libraries with debugging information"), + ('force', 'f', "forcibly build everything (ignore file timestamps)"), + ('executable=', 'e', "specify final destination interpreter path (build.py)"), + ] + + boolean_options: ClassVar[list[str]] = ['debug', 'force'] + + help_options: ClassVar[list[tuple[str, str | None, str, Callable[[], object]]]] = [ + ('help-compiler', None, "list available compilers", show_compilers), + ] + + def initialize_options(self): + self.build_base = 'build' + # these are decided only after 'build_base' has its final value + # (unless overridden by the user or client) + self.build_purelib = None + self.build_platlib = None + self.build_lib = None + self.build_temp = None + self.build_scripts = None + self.compiler = None + self.plat_name = None + self.debug = None + self.force = False + self.executable = None + self.parallel = None + + def finalize_options(self) -> None: # noqa: C901 + if self.plat_name is None: + self.plat_name = get_platform() + else: + # plat-name only supported for windows (other platforms are + # supported via ./configure flags, if at all). Avoid misleading + # other platforms. + if os.name != 'nt': + raise DistutilsOptionError( + "--plat-name only supported on Windows (try " + "using './configure --help' on your platform)" + ) + + plat_specifier = f".{self.plat_name}-{sys.implementation.cache_tag}" + + # Python 3.13+ with --disable-gil shouldn't share build directories + if sysconfig.get_config_var('Py_GIL_DISABLED'): + plat_specifier += 't' + + # Make it so Python 2.x and Python 2.x with --with-pydebug don't + # share the same build directories. Doing so confuses the build + # process for C modules + if hasattr(sys, 'gettotalrefcount'): + plat_specifier += '-pydebug' + + # 'build_purelib' and 'build_platlib' just default to 'lib' and + # 'lib.' under the base build directory. We only use one of + # them for a given distribution, though -- + if self.build_purelib is None: + self.build_purelib = os.path.join(self.build_base, 'lib') + if self.build_platlib is None: + self.build_platlib = os.path.join(self.build_base, 'lib' + plat_specifier) + + # 'build_lib' is the actual directory that we will use for this + # particular module distribution -- if user didn't supply it, pick + # one of 'build_purelib' or 'build_platlib'. + if self.build_lib is None: + if self.distribution.has_ext_modules(): + self.build_lib = self.build_platlib + else: + self.build_lib = self.build_purelib + + # 'build_temp' -- temporary directory for compiler turds, + # "build/temp." + if self.build_temp is None: + self.build_temp = os.path.join(self.build_base, 'temp' + plat_specifier) + if self.build_scripts is None: + self.build_scripts = os.path.join( + self.build_base, + f'scripts-{sys.version_info.major}.{sys.version_info.minor}', + ) + + if self.executable is None and sys.executable: + self.executable = os.path.normpath(sys.executable) + + if isinstance(self.parallel, str): + try: + self.parallel = int(self.parallel) + except ValueError: + raise DistutilsOptionError("parallel should be an integer") + + def run(self) -> None: + # Run all relevant sub-commands. This will be some subset of: + # - build_py - pure Python modules + # - build_clib - standalone C libraries + # - build_ext - Python extensions + # - build_scripts - (Python) scripts + for cmd_name in self.get_sub_commands(): + self.run_command(cmd_name) + + # -- Predicates for the sub-command list --------------------------- + + def has_pure_modules(self): + return self.distribution.has_pure_modules() + + def has_c_libraries(self): + return self.distribution.has_c_libraries() + + def has_ext_modules(self): + return self.distribution.has_ext_modules() + + def has_scripts(self): + return self.distribution.has_scripts() + + sub_commands = [ + ('build_py', has_pure_modules), + ('build_clib', has_c_libraries), + ('build_ext', has_ext_modules), + ('build_scripts', has_scripts), + ] diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_clib.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_clib.py new file mode 100644 index 000000000..8b65b3d8e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_clib.py @@ -0,0 +1,201 @@ +"""distutils.command.build_clib + +Implements the Distutils 'build_clib' command, to build a C/C++ library +that is included in the module distribution and needed by an extension +module.""" + +# XXX this module has *lots* of code ripped-off quite transparently from +# build_ext.py -- not surprisingly really, as the work required to build +# a static library from a collection of C source files is not really all +# that different from what's required to build a shared object file from +# a collection of C source files. Nevertheless, I haven't done the +# necessary refactoring to account for the overlap in code between the +# two modules, mainly because a number of subtle details changed in the +# cut 'n paste. Sigh. +from __future__ import annotations + +import os +from collections.abc import Callable +from distutils._log import log +from typing import ClassVar + +from ..ccompiler import new_compiler, show_compilers +from ..core import Command +from ..errors import DistutilsSetupError +from ..sysconfig import customize_compiler + + +class build_clib(Command): + description = "build C/C++ libraries used by Python extensions" + + user_options: ClassVar[list[tuple[str, str, str]]] = [ + ('build-clib=', 'b', "directory to build C/C++ libraries to"), + ('build-temp=', 't', "directory to put temporary build by-products"), + ('debug', 'g', "compile with debugging information"), + ('force', 'f', "forcibly build everything (ignore file timestamps)"), + ('compiler=', 'c', "specify the compiler type"), + ] + + boolean_options: ClassVar[list[str]] = ['debug', 'force'] + + help_options: ClassVar[list[tuple[str, str | None, str, Callable[[], object]]]] = [ + ('help-compiler', None, "list available compilers", show_compilers), + ] + + def initialize_options(self): + self.build_clib = None + self.build_temp = None + + # List of libraries to build + self.libraries = None + + # Compilation options for all libraries + self.include_dirs = None + self.define = None + self.undef = None + self.debug = None + self.force = False + self.compiler = None + + def finalize_options(self) -> None: + # This might be confusing: both build-clib and build-temp default + # to build-temp as defined by the "build" command. This is because + # I think that C libraries are really just temporary build + # by-products, at least from the point of view of building Python + # extensions -- but I want to keep my options open. + self.set_undefined_options( + 'build', + ('build_temp', 'build_clib'), + ('build_temp', 'build_temp'), + ('compiler', 'compiler'), + ('debug', 'debug'), + ('force', 'force'), + ) + + self.libraries = self.distribution.libraries + if self.libraries: + self.check_library_list(self.libraries) + + if self.include_dirs is None: + self.include_dirs = self.distribution.include_dirs or [] + if isinstance(self.include_dirs, str): + self.include_dirs = self.include_dirs.split(os.pathsep) + + # XXX same as for build_ext -- what about 'self.define' and + # 'self.undef' ? + + def run(self) -> None: + if not self.libraries: + return + + self.compiler = new_compiler( + compiler=self.compiler, dry_run=self.dry_run, force=self.force + ) + customize_compiler(self.compiler) + + if self.include_dirs is not None: + self.compiler.set_include_dirs(self.include_dirs) + if self.define is not None: + # 'define' option is a list of (name,value) tuples + for name, value in self.define: + self.compiler.define_macro(name, value) + if self.undef is not None: + for macro in self.undef: + self.compiler.undefine_macro(macro) + + self.build_libraries(self.libraries) + + def check_library_list(self, libraries) -> None: + """Ensure that the list of libraries is valid. + + `library` is presumably provided as a command option 'libraries'. + This method checks that it is a list of 2-tuples, where the tuples + are (library_name, build_info_dict). + + Raise DistutilsSetupError if the structure is invalid anywhere; + just returns otherwise. + """ + if not isinstance(libraries, list): + raise DistutilsSetupError("'libraries' option must be a list of tuples") + + for lib in libraries: + if not isinstance(lib, tuple) and len(lib) != 2: + raise DistutilsSetupError("each element of 'libraries' must a 2-tuple") + + name, build_info = lib + + if not isinstance(name, str): + raise DistutilsSetupError( + "first element of each tuple in 'libraries' " + "must be a string (the library name)" + ) + + if '/' in name or (os.sep != '/' and os.sep in name): + raise DistutilsSetupError( + f"bad library name '{lib[0]}': may not contain directory separators" + ) + + if not isinstance(build_info, dict): + raise DistutilsSetupError( + "second element of each tuple in 'libraries' " + "must be a dictionary (build info)" + ) + + def get_library_names(self): + # Assume the library list is valid -- 'check_library_list()' is + # called from 'finalize_options()', so it should be! + if not self.libraries: + return None + + lib_names = [] + for lib_name, _build_info in self.libraries: + lib_names.append(lib_name) + return lib_names + + def get_source_files(self): + self.check_library_list(self.libraries) + filenames = [] + for lib_name, build_info in self.libraries: + sources = build_info.get('sources') + if sources is None or not isinstance(sources, (list, tuple)): + raise DistutilsSetupError( + f"in 'libraries' option (library '{lib_name}'), " + "'sources' must be present and must be " + "a list of source filenames" + ) + + filenames.extend(sources) + return filenames + + def build_libraries(self, libraries) -> None: + for lib_name, build_info in libraries: + sources = build_info.get('sources') + if sources is None or not isinstance(sources, (list, tuple)): + raise DistutilsSetupError( + f"in 'libraries' option (library '{lib_name}'), " + "'sources' must be present and must be " + "a list of source filenames" + ) + sources = list(sources) + + log.info("building '%s' library", lib_name) + + # First, compile the source code to object files in the library + # directory. (This should probably change to putting object + # files in a temporary build directory.) + macros = build_info.get('macros') + include_dirs = build_info.get('include_dirs') + objects = self.compiler.compile( + sources, + output_dir=self.build_temp, + macros=macros, + include_dirs=include_dirs, + debug=self.debug, + ) + + # Now "link" the object files together into a static library. + # (On Unix at least, this isn't really linking -- it just + # builds an archive. Whatever.) + self.compiler.create_static_lib( + objects, lib_name, output_dir=self.build_clib, debug=self.debug + ) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_ext.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_ext.py new file mode 100644 index 000000000..ec45b4403 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_ext.py @@ -0,0 +1,812 @@ +"""distutils.command.build_ext + +Implements the Distutils 'build_ext' command, for building extension +modules (currently limited to C extensions, should accommodate C++ +extensions ASAP).""" + +from __future__ import annotations + +import contextlib +import os +import re +import sys +from collections.abc import Callable +from distutils._log import log +from site import USER_BASE +from typing import ClassVar + +from .._modified import newer_group +from ..ccompiler import new_compiler, show_compilers +from ..core import Command +from ..errors import ( + CCompilerError, + CompileError, + DistutilsError, + DistutilsOptionError, + DistutilsPlatformError, + DistutilsSetupError, +) +from ..extension import Extension +from ..sysconfig import customize_compiler, get_config_h_filename, get_python_version +from ..util import get_platform, is_freethreaded, is_mingw + +# An extension name is just a dot-separated list of Python NAMEs (ie. +# the same as a fully-qualified module name). +extension_name_re = re.compile(r'^[a-zA-Z_][a-zA-Z_0-9]*(\.[a-zA-Z_][a-zA-Z_0-9]*)*$') + + +class build_ext(Command): + description = "build C/C++ extensions (compile/link to build directory)" + + # XXX thoughts on how to deal with complex command-line options like + # these, i.e. how to make it so fancy_getopt can suck them off the + # command line and make it look like setup.py defined the appropriate + # lists of tuples of what-have-you. + # - each command needs a callback to process its command-line options + # - Command.__init__() needs access to its share of the whole + # command line (must ultimately come from + # Distribution.parse_command_line()) + # - it then calls the current command class' option-parsing + # callback to deal with weird options like -D, which have to + # parse the option text and churn out some custom data + # structure + # - that data structure (in this case, a list of 2-tuples) + # will then be present in the command object by the time + # we get to finalize_options() (i.e. the constructor + # takes care of both command-line and client options + # in between initialize_options() and finalize_options()) + + sep_by = f" (separated by '{os.pathsep}')" + user_options = [ + ('build-lib=', 'b', "directory for compiled extension modules"), + ('build-temp=', 't', "directory for temporary files (build by-products)"), + ( + 'plat-name=', + 'p', + "platform name to cross-compile for, if supported " + f"[default: {get_platform()}]", + ), + ( + 'inplace', + 'i', + "ignore build-lib and put compiled extensions into the source " + "directory alongside your pure Python modules", + ), + ( + 'include-dirs=', + 'I', + "list of directories to search for header files" + sep_by, + ), + ('define=', 'D', "C preprocessor macros to define"), + ('undef=', 'U', "C preprocessor macros to undefine"), + ('libraries=', 'l', "external C libraries to link with"), + ( + 'library-dirs=', + 'L', + "directories to search for external C libraries" + sep_by, + ), + ('rpath=', 'R', "directories to search for shared C libraries at runtime"), + ('link-objects=', 'O', "extra explicit link objects to include in the link"), + ('debug', 'g', "compile/link with debugging information"), + ('force', 'f', "forcibly build everything (ignore file timestamps)"), + ('compiler=', 'c', "specify the compiler type"), + ('parallel=', 'j', "number of parallel build jobs"), + ('swig-cpp', None, "make SWIG create C++ files (default is C)"), + ('swig-opts=', None, "list of SWIG command line options"), + ('swig=', None, "path to the SWIG executable"), + ('user', None, "add user include, library and rpath"), + ] + + boolean_options: ClassVar[list[str]] = [ + 'inplace', + 'debug', + 'force', + 'swig-cpp', + 'user', + ] + + help_options: ClassVar[list[tuple[str, str | None, str, Callable[[], object]]]] = [ + ('help-compiler', None, "list available compilers", show_compilers), + ] + + def initialize_options(self): + self.extensions = None + self.build_lib = None + self.plat_name = None + self.build_temp = None + self.inplace = False + self.package = None + + self.include_dirs = None + self.define = None + self.undef = None + self.libraries = None + self.library_dirs = None + self.rpath = None + self.link_objects = None + self.debug = None + self.force = None + self.compiler = None + self.swig = None + self.swig_cpp = None + self.swig_opts = None + self.user = None + self.parallel = None + + @staticmethod + def _python_lib_dir(sysconfig): + """ + Resolve Python's library directory for building extensions + that rely on a shared Python library. + + See python/cpython#44264 and python/cpython#48686 + """ + if not sysconfig.get_config_var('Py_ENABLE_SHARED'): + return + + if sysconfig.python_build: + yield '.' + return + + if sys.platform == 'zos': + # On z/OS, a user is not required to install Python to + # a predetermined path, but can use Python portably + installed_dir = sysconfig.get_config_var('base') + lib_dir = sysconfig.get_config_var('platlibdir') + yield os.path.join(installed_dir, lib_dir) + else: + # building third party extensions + yield sysconfig.get_config_var('LIBDIR') + + def finalize_options(self) -> None: # noqa: C901 + from distutils import sysconfig + + self.set_undefined_options( + 'build', + ('build_lib', 'build_lib'), + ('build_temp', 'build_temp'), + ('compiler', 'compiler'), + ('debug', 'debug'), + ('force', 'force'), + ('parallel', 'parallel'), + ('plat_name', 'plat_name'), + ) + + if self.package is None: + self.package = self.distribution.ext_package + + self.extensions = self.distribution.ext_modules + + # Make sure Python's include directories (for Python.h, pyconfig.h, + # etc.) are in the include search path. + py_include = sysconfig.get_python_inc() + plat_py_include = sysconfig.get_python_inc(plat_specific=True) + if self.include_dirs is None: + self.include_dirs = self.distribution.include_dirs or [] + if isinstance(self.include_dirs, str): + self.include_dirs = self.include_dirs.split(os.pathsep) + + # If in a virtualenv, add its include directory + # Issue 16116 + if sys.exec_prefix != sys.base_exec_prefix: + self.include_dirs.append(os.path.join(sys.exec_prefix, 'include')) + + # Put the Python "system" include dir at the end, so that + # any local include dirs take precedence. + self.include_dirs.extend(py_include.split(os.path.pathsep)) + if plat_py_include != py_include: + self.include_dirs.extend(plat_py_include.split(os.path.pathsep)) + + self.ensure_string_list('libraries') + self.ensure_string_list('link_objects') + + # Life is easier if we're not forever checking for None, so + # simplify these options to empty lists if unset + if self.libraries is None: + self.libraries = [] + if self.library_dirs is None: + self.library_dirs = [] + elif isinstance(self.library_dirs, str): + self.library_dirs = self.library_dirs.split(os.pathsep) + + if self.rpath is None: + self.rpath = [] + elif isinstance(self.rpath, str): + self.rpath = self.rpath.split(os.pathsep) + + # for extensions under windows use different directories + # for Release and Debug builds. + # also Python's library directory must be appended to library_dirs + if os.name == 'nt' and not is_mingw(): + # the 'libs' directory is for binary installs - we assume that + # must be the *native* platform. But we don't really support + # cross-compiling via a binary install anyway, so we let it go. + self.library_dirs.append(os.path.join(sys.exec_prefix, 'libs')) + if sys.base_exec_prefix != sys.prefix: # Issue 16116 + self.library_dirs.append(os.path.join(sys.base_exec_prefix, 'libs')) + if self.debug: + self.build_temp = os.path.join(self.build_temp, "Debug") + else: + self.build_temp = os.path.join(self.build_temp, "Release") + + # Append the source distribution include and library directories, + # this allows distutils on windows to work in the source tree + self.include_dirs.append(os.path.dirname(get_config_h_filename())) + self.library_dirs.append(sys.base_exec_prefix) + + # Use the .lib files for the correct architecture + if self.plat_name == 'win32': + suffix = 'win32' + else: + # win-amd64 + suffix = self.plat_name[4:] + new_lib = os.path.join(sys.exec_prefix, 'PCbuild') + if suffix: + new_lib = os.path.join(new_lib, suffix) + self.library_dirs.append(new_lib) + + # For extensions under Cygwin, Python's library directory must be + # appended to library_dirs + if sys.platform[:6] == 'cygwin': + if not sysconfig.python_build: + # building third party extensions + self.library_dirs.append( + os.path.join( + sys.prefix, "lib", "python" + get_python_version(), "config" + ) + ) + else: + # building python standard extensions + self.library_dirs.append('.') + + self.library_dirs.extend(self._python_lib_dir(sysconfig)) + + # The argument parsing will result in self.define being a string, but + # it has to be a list of 2-tuples. All the preprocessor symbols + # specified by the 'define' option will be set to '1'. Multiple + # symbols can be separated with commas. + + if self.define: + defines = self.define.split(',') + self.define = [(symbol, '1') for symbol in defines] + + # The option for macros to undefine is also a string from the + # option parsing, but has to be a list. Multiple symbols can also + # be separated with commas here. + if self.undef: + self.undef = self.undef.split(',') + + if self.swig_opts is None: + self.swig_opts = [] + else: + self.swig_opts = self.swig_opts.split(' ') + + # Finally add the user include and library directories if requested + if self.user: + user_include = os.path.join(USER_BASE, "include") + user_lib = os.path.join(USER_BASE, "lib") + if os.path.isdir(user_include): + self.include_dirs.append(user_include) + if os.path.isdir(user_lib): + self.library_dirs.append(user_lib) + self.rpath.append(user_lib) + + if isinstance(self.parallel, str): + try: + self.parallel = int(self.parallel) + except ValueError: + raise DistutilsOptionError("parallel should be an integer") + + def run(self) -> None: # noqa: C901 + # 'self.extensions', as supplied by setup.py, is a list of + # Extension instances. See the documentation for Extension (in + # distutils.extension) for details. + # + # For backwards compatibility with Distutils 0.8.2 and earlier, we + # also allow the 'extensions' list to be a list of tuples: + # (ext_name, build_info) + # where build_info is a dictionary containing everything that + # Extension instances do except the name, with a few things being + # differently named. We convert these 2-tuples to Extension + # instances as needed. + + if not self.extensions: + return + + # If we were asked to build any C/C++ libraries, make sure that the + # directory where we put them is in the library search path for + # linking extensions. + if self.distribution.has_c_libraries(): + build_clib = self.get_finalized_command('build_clib') + self.libraries.extend(build_clib.get_library_names() or []) + self.library_dirs.append(build_clib.build_clib) + + # Setup the CCompiler object that we'll use to do all the + # compiling and linking + self.compiler = new_compiler( + compiler=self.compiler, + verbose=self.verbose, + dry_run=self.dry_run, + force=self.force, + ) + customize_compiler(self.compiler) + # If we are cross-compiling, init the compiler now (if we are not + # cross-compiling, init would not hurt, but people may rely on + # late initialization of compiler even if they shouldn't...) + if os.name == 'nt' and self.plat_name != get_platform(): + self.compiler.initialize(self.plat_name) + + # The official Windows free threaded Python installer doesn't set + # Py_GIL_DISABLED because its pyconfig.h is shared with the + # default build, so define it here (pypa/setuptools#4662). + if os.name == 'nt' and is_freethreaded(): + self.compiler.define_macro('Py_GIL_DISABLED', '1') + + # And make sure that any compile/link-related options (which might + # come from the command-line or from the setup script) are set in + # that CCompiler object -- that way, they automatically apply to + # all compiling and linking done here. + if self.include_dirs is not None: + self.compiler.set_include_dirs(self.include_dirs) + if self.define is not None: + # 'define' option is a list of (name,value) tuples + for name, value in self.define: + self.compiler.define_macro(name, value) + if self.undef is not None: + for macro in self.undef: + self.compiler.undefine_macro(macro) + if self.libraries is not None: + self.compiler.set_libraries(self.libraries) + if self.library_dirs is not None: + self.compiler.set_library_dirs(self.library_dirs) + if self.rpath is not None: + self.compiler.set_runtime_library_dirs(self.rpath) + if self.link_objects is not None: + self.compiler.set_link_objects(self.link_objects) + + # Now actually compile and link everything. + self.build_extensions() + + def check_extensions_list(self, extensions) -> None: # noqa: C901 + """Ensure that the list of extensions (presumably provided as a + command option 'extensions') is valid, i.e. it is a list of + Extension objects. We also support the old-style list of 2-tuples, + where the tuples are (ext_name, build_info), which are converted to + Extension instances here. + + Raise DistutilsSetupError if the structure is invalid anywhere; + just returns otherwise. + """ + if not isinstance(extensions, list): + raise DistutilsSetupError( + "'ext_modules' option must be a list of Extension instances" + ) + + for i, ext in enumerate(extensions): + if isinstance(ext, Extension): + continue # OK! (assume type-checking done + # by Extension constructor) + + if not isinstance(ext, tuple) or len(ext) != 2: + raise DistutilsSetupError( + "each element of 'ext_modules' option must be an " + "Extension instance or 2-tuple" + ) + + ext_name, build_info = ext + + log.warning( + "old-style (ext_name, build_info) tuple found in " + "ext_modules for extension '%s' " + "-- please convert to Extension instance", + ext_name, + ) + + if not (isinstance(ext_name, str) and extension_name_re.match(ext_name)): + raise DistutilsSetupError( + "first element of each tuple in 'ext_modules' " + "must be the extension name (a string)" + ) + + if not isinstance(build_info, dict): + raise DistutilsSetupError( + "second element of each tuple in 'ext_modules' " + "must be a dictionary (build info)" + ) + + # OK, the (ext_name, build_info) dict is type-safe: convert it + # to an Extension instance. + ext = Extension(ext_name, build_info['sources']) + + # Easy stuff: one-to-one mapping from dict elements to + # instance attributes. + for key in ( + 'include_dirs', + 'library_dirs', + 'libraries', + 'extra_objects', + 'extra_compile_args', + 'extra_link_args', + ): + val = build_info.get(key) + if val is not None: + setattr(ext, key, val) + + # Medium-easy stuff: same syntax/semantics, different names. + ext.runtime_library_dirs = build_info.get('rpath') + if 'def_file' in build_info: + log.warning("'def_file' element of build info dict no longer supported") + + # Non-trivial stuff: 'macros' split into 'define_macros' + # and 'undef_macros'. + macros = build_info.get('macros') + if macros: + ext.define_macros = [] + ext.undef_macros = [] + for macro in macros: + if not (isinstance(macro, tuple) and len(macro) in (1, 2)): + raise DistutilsSetupError( + "'macros' element of build info dict must be 1- or 2-tuple" + ) + if len(macro) == 1: + ext.undef_macros.append(macro[0]) + elif len(macro) == 2: + ext.define_macros.append(macro) + + extensions[i] = ext + + def get_source_files(self): + self.check_extensions_list(self.extensions) + filenames = [] + + # Wouldn't it be neat if we knew the names of header files too... + for ext in self.extensions: + filenames.extend(ext.sources) + return filenames + + def get_outputs(self): + # Sanity check the 'extensions' list -- can't assume this is being + # done in the same run as a 'build_extensions()' call (in fact, we + # can probably assume that it *isn't*!). + self.check_extensions_list(self.extensions) + + # And build the list of output (built) filenames. Note that this + # ignores the 'inplace' flag, and assumes everything goes in the + # "build" tree. + return [self.get_ext_fullpath(ext.name) for ext in self.extensions] + + def build_extensions(self) -> None: + # First, sanity-check the 'extensions' list + self.check_extensions_list(self.extensions) + if self.parallel: + self._build_extensions_parallel() + else: + self._build_extensions_serial() + + def _build_extensions_parallel(self): + workers = self.parallel + if self.parallel is True: + workers = os.cpu_count() # may return None + try: + from concurrent.futures import ThreadPoolExecutor + except ImportError: + workers = None + + if workers is None: + self._build_extensions_serial() + return + + with ThreadPoolExecutor(max_workers=workers) as executor: + futures = [ + executor.submit(self.build_extension, ext) for ext in self.extensions + ] + for ext, fut in zip(self.extensions, futures): + with self._filter_build_errors(ext): + fut.result() + + def _build_extensions_serial(self): + for ext in self.extensions: + with self._filter_build_errors(ext): + self.build_extension(ext) + + @contextlib.contextmanager + def _filter_build_errors(self, ext): + try: + yield + except (CCompilerError, DistutilsError, CompileError) as e: + if not ext.optional: + raise + self.warn(f'building extension "{ext.name}" failed: {e}') + + def build_extension(self, ext) -> None: + sources = ext.sources + if sources is None or not isinstance(sources, (list, tuple)): + raise DistutilsSetupError( + f"in 'ext_modules' option (extension '{ext.name}'), " + "'sources' must be present and must be " + "a list of source filenames" + ) + # sort to make the resulting .so file build reproducible + sources = sorted(sources) + + ext_path = self.get_ext_fullpath(ext.name) + depends = sources + ext.depends + if not (self.force or newer_group(depends, ext_path, 'newer')): + log.debug("skipping '%s' extension (up-to-date)", ext.name) + return + else: + log.info("building '%s' extension", ext.name) + + # First, scan the sources for SWIG definition files (.i), run + # SWIG on 'em to create .c files, and modify the sources list + # accordingly. + sources = self.swig_sources(sources, ext) + + # Next, compile the source code to object files. + + # XXX not honouring 'define_macros' or 'undef_macros' -- the + # CCompiler API needs to change to accommodate this, and I + # want to do one thing at a time! + + # Two possible sources for extra compiler arguments: + # - 'extra_compile_args' in Extension object + # - CFLAGS environment variable (not particularly + # elegant, but people seem to expect it and I + # guess it's useful) + # The environment variable should take precedence, and + # any sensible compiler will give precedence to later + # command line args. Hence we combine them in order: + extra_args = ext.extra_compile_args or [] + + macros = ext.define_macros[:] + for undef in ext.undef_macros: + macros.append((undef,)) + + objects = self.compiler.compile( + sources, + output_dir=self.build_temp, + macros=macros, + include_dirs=ext.include_dirs, + debug=self.debug, + extra_postargs=extra_args, + depends=ext.depends, + ) + + # XXX outdated variable, kept here in case third-part code + # needs it. + self._built_objects = objects[:] + + # Now link the object files together into a "shared object" -- + # of course, first we have to figure out all the other things + # that go into the mix. + if ext.extra_objects: + objects.extend(ext.extra_objects) + extra_args = ext.extra_link_args or [] + + # Detect target language, if not provided + language = ext.language or self.compiler.detect_language(sources) + + self.compiler.link_shared_object( + objects, + ext_path, + libraries=self.get_libraries(ext), + library_dirs=ext.library_dirs, + runtime_library_dirs=ext.runtime_library_dirs, + extra_postargs=extra_args, + export_symbols=self.get_export_symbols(ext), + debug=self.debug, + build_temp=self.build_temp, + target_lang=language, + ) + + def swig_sources(self, sources, extension): + """Walk the list of source files in 'sources', looking for SWIG + interface (.i) files. Run SWIG on all that are found, and + return a modified 'sources' list with SWIG source files replaced + by the generated C (or C++) files. + """ + new_sources = [] + swig_sources = [] + swig_targets = {} + + # XXX this drops generated C/C++ files into the source tree, which + # is fine for developers who want to distribute the generated + # source -- but there should be an option to put SWIG output in + # the temp dir. + + if self.swig_cpp: + log.warning("--swig-cpp is deprecated - use --swig-opts=-c++") + + if ( + self.swig_cpp + or ('-c++' in self.swig_opts) + or ('-c++' in extension.swig_opts) + ): + target_ext = '.cpp' + else: + target_ext = '.c' + + for source in sources: + (base, ext) = os.path.splitext(source) + if ext == ".i": # SWIG interface file + new_sources.append(base + '_wrap' + target_ext) + swig_sources.append(source) + swig_targets[source] = new_sources[-1] + else: + new_sources.append(source) + + if not swig_sources: + return new_sources + + swig = self.swig or self.find_swig() + swig_cmd = [swig, "-python"] + swig_cmd.extend(self.swig_opts) + if self.swig_cpp: + swig_cmd.append("-c++") + + # Do not override commandline arguments + if not self.swig_opts: + swig_cmd.extend(extension.swig_opts) + + for source in swig_sources: + target = swig_targets[source] + log.info("swigging %s to %s", source, target) + self.spawn(swig_cmd + ["-o", target, source]) + + return new_sources + + def find_swig(self): + """Return the name of the SWIG executable. On Unix, this is + just "swig" -- it should be in the PATH. Tries a bit harder on + Windows. + """ + if os.name == "posix": + return "swig" + elif os.name == "nt": + # Look for SWIG in its standard installation directory on + # Windows (or so I presume!). If we find it there, great; + # if not, act like Unix and assume it's in the PATH. + for vers in ("1.3", "1.2", "1.1"): + fn = os.path.join(f"c:\\swig{vers}", "swig.exe") + if os.path.isfile(fn): + return fn + else: + return "swig.exe" + else: + raise DistutilsPlatformError( + f"I don't know how to find (much less run) SWIG on platform '{os.name}'" + ) + + # -- Name generators ----------------------------------------------- + # (extension names, filenames, whatever) + def get_ext_fullpath(self, ext_name: str) -> str: + """Returns the path of the filename for a given extension. + + The file is located in `build_lib` or directly in the package + (inplace option). + """ + fullname = self.get_ext_fullname(ext_name) + modpath = fullname.split('.') + filename = self.get_ext_filename(modpath[-1]) + + if not self.inplace: + # no further work needed + # returning : + # build_dir/package/path/filename + filename = os.path.join(*modpath[:-1] + [filename]) + return os.path.join(self.build_lib, filename) + + # the inplace option requires to find the package directory + # using the build_py command for that + package = '.'.join(modpath[0:-1]) + build_py = self.get_finalized_command('build_py') + package_dir = os.path.abspath(build_py.get_package_dir(package)) + + # returning + # package_dir/filename + return os.path.join(package_dir, filename) + + def get_ext_fullname(self, ext_name: str) -> str: + """Returns the fullname of a given extension name. + + Adds the `package.` prefix""" + if self.package is None: + return ext_name + else: + return self.package + '.' + ext_name + + def get_ext_filename(self, ext_name: str) -> str: + r"""Convert the name of an extension (eg. "foo.bar") into the name + of the file from which it will be loaded (eg. "foo/bar.so", or + "foo\bar.pyd"). + """ + from ..sysconfig import get_config_var + + ext_path = ext_name.split('.') + ext_suffix = get_config_var('EXT_SUFFIX') + return os.path.join(*ext_path) + ext_suffix + + def get_export_symbols(self, ext: Extension) -> list[str]: + """Return the list of symbols that a shared extension has to + export. This either uses 'ext.export_symbols' or, if it's not + provided, "PyInit_" + module_name. Only relevant on Windows, where + the .pyd file (DLL) must export the module "PyInit_" function. + """ + name = self._get_module_name_for_symbol(ext) + try: + # Unicode module name support as defined in PEP-489 + # https://peps.python.org/pep-0489/#export-hook-name + name.encode('ascii') + except UnicodeEncodeError: + suffix = 'U_' + name.encode('punycode').replace(b'-', b'_').decode('ascii') + else: + suffix = "_" + name + + initfunc_name = "PyInit" + suffix + if initfunc_name not in ext.export_symbols: + ext.export_symbols.append(initfunc_name) + return ext.export_symbols + + def _get_module_name_for_symbol(self, ext): + # Package name should be used for `__init__` modules + # https://github.com/python/cpython/issues/80074 + # https://github.com/pypa/setuptools/issues/4826 + parts = ext.name.split(".") + if parts[-1] == "__init__" and len(parts) >= 2: + return parts[-2] + return parts[-1] + + def get_libraries(self, ext: Extension) -> list[str]: # noqa: C901 + """Return the list of libraries to link against when building a + shared extension. On most platforms, this is just 'ext.libraries'; + on Windows, we add the Python library (eg. python20.dll). + """ + # The python library is always needed on Windows. For MSVC, this + # is redundant, since the library is mentioned in a pragma in + # pyconfig.h that MSVC groks. The other Windows compilers all seem + # to need it mentioned explicitly, though, so that's what we do. + # Append '_d' to the python import library on debug builds. + if sys.platform == "win32" and not is_mingw(): + from .._msvccompiler import MSVCCompiler + + if not isinstance(self.compiler, MSVCCompiler): + template = "python%d%d" + if self.debug: + template = template + '_d' + pythonlib = template % ( + sys.hexversion >> 24, + (sys.hexversion >> 16) & 0xFF, + ) + # don't extend ext.libraries, it may be shared with other + # extensions, it is a reference to the original list + return ext.libraries + [pythonlib] + else: + # On Android only the main executable and LD_PRELOADs are considered + # to be RTLD_GLOBAL, all the dependencies of the main executable + # remain RTLD_LOCAL and so the shared libraries must be linked with + # libpython when python is built with a shared python library (issue + # bpo-21536). + # On Cygwin (and if required, other POSIX-like platforms based on + # Windows like MinGW) it is simply necessary that all symbols in + # shared libraries are resolved at link time. + from ..sysconfig import get_config_var + + link_libpython = False + if get_config_var('Py_ENABLE_SHARED'): + # A native build on an Android device or on Cygwin + if hasattr(sys, 'getandroidapilevel'): + link_libpython = True + elif sys.platform == 'cygwin' or is_mingw(): + link_libpython = True + elif '_PYTHON_HOST_PLATFORM' in os.environ: + # We are cross-compiling for one of the relevant platforms + if get_config_var('ANDROID_API_LEVEL') != 0: + link_libpython = True + elif get_config_var('MACHDEP') == 'cygwin': + link_libpython = True + + if link_libpython: + ldversion = get_config_var('LDVERSION') + return ext.libraries + ['python' + ldversion] + + return ext.libraries diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_py.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_py.py new file mode 100644 index 000000000..a20b076fe --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_py.py @@ -0,0 +1,407 @@ +"""distutils.command.build_py + +Implements the Distutils 'build_py' command.""" + +import glob +import importlib.util +import os +import sys +from distutils._log import log +from typing import ClassVar + +from ..core import Command +from ..errors import DistutilsFileError, DistutilsOptionError +from ..util import convert_path + + +class build_py(Command): + description = "\"build\" pure Python modules (copy to build directory)" + + user_options = [ + ('build-lib=', 'd', "directory to \"build\" (copy) to"), + ('compile', 'c', "compile .py to .pyc"), + ('no-compile', None, "don't compile .py files [default]"), + ( + 'optimize=', + 'O', + "also compile with optimization: -O1 for \"python -O\", " + "-O2 for \"python -OO\", and -O0 to disable [default: -O0]", + ), + ('force', 'f', "forcibly build everything (ignore file timestamps)"), + ] + + boolean_options: ClassVar[list[str]] = ['compile', 'force'] + negative_opt: ClassVar[dict[str, str]] = {'no-compile': 'compile'} + + def initialize_options(self): + self.build_lib = None + self.py_modules = None + self.package = None + self.package_data = None + self.package_dir = None + self.compile = False + self.optimize = 0 + self.force = None + + def finalize_options(self) -> None: + self.set_undefined_options( + 'build', ('build_lib', 'build_lib'), ('force', 'force') + ) + + # Get the distribution options that are aliases for build_py + # options -- list of packages and list of modules. + self.packages = self.distribution.packages + self.py_modules = self.distribution.py_modules + self.package_data = self.distribution.package_data + self.package_dir = {} + if self.distribution.package_dir: + for name, path in self.distribution.package_dir.items(): + self.package_dir[name] = convert_path(path) + self.data_files = self.get_data_files() + + # Ick, copied straight from install_lib.py (fancy_getopt needs a + # type system! Hell, *everything* needs a type system!!!) + if not isinstance(self.optimize, int): + try: + self.optimize = int(self.optimize) + assert 0 <= self.optimize <= 2 + except (ValueError, AssertionError): + raise DistutilsOptionError("optimize must be 0, 1, or 2") + + def run(self) -> None: + # XXX copy_file by default preserves atime and mtime. IMHO this is + # the right thing to do, but perhaps it should be an option -- in + # particular, a site administrator might want installed files to + # reflect the time of installation rather than the last + # modification time before the installed release. + + # XXX copy_file by default preserves mode, which appears to be the + # wrong thing to do: if a file is read-only in the working + # directory, we want it to be installed read/write so that the next + # installation of the same module distribution can overwrite it + # without problems. (This might be a Unix-specific issue.) Thus + # we turn off 'preserve_mode' when copying to the build directory, + # since the build directory is supposed to be exactly what the + # installation will look like (ie. we preserve mode when + # installing). + + # Two options control which modules will be installed: 'packages' + # and 'py_modules'. The former lets us work with whole packages, not + # specifying individual modules at all; the latter is for + # specifying modules one-at-a-time. + + if self.py_modules: + self.build_modules() + if self.packages: + self.build_packages() + self.build_package_data() + + self.byte_compile(self.get_outputs(include_bytecode=False)) + + def get_data_files(self): + """Generate list of '(package,src_dir,build_dir,filenames)' tuples""" + data = [] + if not self.packages: + return data + for package in self.packages: + # Locate package source directory + src_dir = self.get_package_dir(package) + + # Compute package build directory + build_dir = os.path.join(*([self.build_lib] + package.split('.'))) + + # Length of path to strip from found files + plen = 0 + if src_dir: + plen = len(src_dir) + 1 + + # Strip directory from globbed filenames + filenames = [file[plen:] for file in self.find_data_files(package, src_dir)] + data.append((package, src_dir, build_dir, filenames)) + return data + + def find_data_files(self, package, src_dir): + """Return filenames for package's data files in 'src_dir'""" + globs = self.package_data.get('', []) + self.package_data.get(package, []) + files = [] + for pattern in globs: + # Each pattern has to be converted to a platform-specific path + filelist = glob.glob( + os.path.join(glob.escape(src_dir), convert_path(pattern)) + ) + # Files that match more than one pattern are only added once + files.extend([ + fn for fn in filelist if fn not in files and os.path.isfile(fn) + ]) + return files + + def build_package_data(self) -> None: + """Copy data files into build directory""" + for _package, src_dir, build_dir, filenames in self.data_files: + for filename in filenames: + target = os.path.join(build_dir, filename) + self.mkpath(os.path.dirname(target)) + self.copy_file( + os.path.join(src_dir, filename), target, preserve_mode=False + ) + + def get_package_dir(self, package): + """Return the directory, relative to the top of the source + distribution, where package 'package' should be found + (at least according to the 'package_dir' option, if any).""" + path = package.split('.') + + if not self.package_dir: + if path: + return os.path.join(*path) + else: + return '' + else: + tail = [] + while path: + try: + pdir = self.package_dir['.'.join(path)] + except KeyError: + tail.insert(0, path[-1]) + del path[-1] + else: + tail.insert(0, pdir) + return os.path.join(*tail) + else: + # Oops, got all the way through 'path' without finding a + # match in package_dir. If package_dir defines a directory + # for the root (nameless) package, then fallback on it; + # otherwise, we might as well have not consulted + # package_dir at all, as we just use the directory implied + # by 'tail' (which should be the same as the original value + # of 'path' at this point). + pdir = self.package_dir.get('') + if pdir is not None: + tail.insert(0, pdir) + + if tail: + return os.path.join(*tail) + else: + return '' + + def check_package(self, package, package_dir): + # Empty dir name means current directory, which we can probably + # assume exists. Also, os.path.exists and isdir don't know about + # my "empty string means current dir" convention, so we have to + # circumvent them. + if package_dir != "": + if not os.path.exists(package_dir): + raise DistutilsFileError( + f"package directory '{package_dir}' does not exist" + ) + if not os.path.isdir(package_dir): + raise DistutilsFileError( + f"supposed package directory '{package_dir}' exists, " + "but is not a directory" + ) + + # Directories without __init__.py are namespace packages (PEP 420). + if package: + init_py = os.path.join(package_dir, "__init__.py") + if os.path.isfile(init_py): + return init_py + + # Either not in a package at all (__init__.py not expected), or + # __init__.py doesn't exist -- so don't return the filename. + return None + + def check_module(self, module, module_file): + if not os.path.isfile(module_file): + log.warning("file %s (for module %s) not found", module_file, module) + return False + else: + return True + + def find_package_modules(self, package, package_dir): + self.check_package(package, package_dir) + module_files = glob.glob(os.path.join(glob.escape(package_dir), "*.py")) + modules = [] + setup_script = os.path.abspath(self.distribution.script_name) + + for f in module_files: + abs_f = os.path.abspath(f) + if abs_f != setup_script: + module = os.path.splitext(os.path.basename(f))[0] + modules.append((package, module, f)) + else: + self.debug_print(f"excluding {setup_script}") + return modules + + def find_modules(self): + """Finds individually-specified Python modules, ie. those listed by + module name in 'self.py_modules'. Returns a list of tuples (package, + module_base, filename): 'package' is a tuple of the path through + package-space to the module; 'module_base' is the bare (no + packages, no dots) module name, and 'filename' is the path to the + ".py" file (relative to the distribution root) that implements the + module. + """ + # Map package names to tuples of useful info about the package: + # (package_dir, checked) + # package_dir - the directory where we'll find source files for + # this package + # checked - true if we have checked that the package directory + # is valid (exists, contains __init__.py, ... ?) + packages = {} + + # List of (package, module, filename) tuples to return + modules = [] + + # We treat modules-in-packages almost the same as toplevel modules, + # just the "package" for a toplevel is empty (either an empty + # string or empty list, depending on context). Differences: + # - don't check for __init__.py in directory for empty package + for module in self.py_modules: + path = module.split('.') + package = '.'.join(path[0:-1]) + module_base = path[-1] + + try: + (package_dir, checked) = packages[package] + except KeyError: + package_dir = self.get_package_dir(package) + checked = False + + if not checked: + init_py = self.check_package(package, package_dir) + packages[package] = (package_dir, 1) + if init_py: + modules.append((package, "__init__", init_py)) + + # XXX perhaps we should also check for just .pyc files + # (so greedy closed-source bastards can distribute Python + # modules too) + module_file = os.path.join(package_dir, module_base + ".py") + if not self.check_module(module, module_file): + continue + + modules.append((package, module_base, module_file)) + + return modules + + def find_all_modules(self): + """Compute the list of all modules that will be built, whether + they are specified one-module-at-a-time ('self.py_modules') or + by whole packages ('self.packages'). Return a list of tuples + (package, module, module_file), just like 'find_modules()' and + 'find_package_modules()' do.""" + modules = [] + if self.py_modules: + modules.extend(self.find_modules()) + if self.packages: + for package in self.packages: + package_dir = self.get_package_dir(package) + m = self.find_package_modules(package, package_dir) + modules.extend(m) + return modules + + def get_source_files(self): + return [module[-1] for module in self.find_all_modules()] + + def get_module_outfile(self, build_dir, package, module): + outfile_path = [build_dir] + list(package) + [module + ".py"] + return os.path.join(*outfile_path) + + def get_outputs(self, include_bytecode: bool = True) -> list[str]: + modules = self.find_all_modules() + outputs = [] + for package, module, _module_file in modules: + package = package.split('.') + filename = self.get_module_outfile(self.build_lib, package, module) + outputs.append(filename) + if include_bytecode: + if self.compile: + outputs.append( + importlib.util.cache_from_source(filename, optimization='') + ) + if self.optimize > 0: + outputs.append( + importlib.util.cache_from_source( + filename, optimization=self.optimize + ) + ) + + outputs += [ + os.path.join(build_dir, filename) + for package, src_dir, build_dir, filenames in self.data_files + for filename in filenames + ] + + return outputs + + def build_module(self, module, module_file, package): + if isinstance(package, str): + package = package.split('.') + elif not isinstance(package, (list, tuple)): + raise TypeError( + "'package' must be a string (dot-separated), list, or tuple" + ) + + # Now put the module source file into the "build" area -- this is + # easy, we just copy it somewhere under self.build_lib (the build + # directory for Python source). + outfile = self.get_module_outfile(self.build_lib, package, module) + dir = os.path.dirname(outfile) + self.mkpath(dir) + return self.copy_file(module_file, outfile, preserve_mode=False) + + def build_modules(self) -> None: + modules = self.find_modules() + for package, module, module_file in modules: + # Now "build" the module -- ie. copy the source file to + # self.build_lib (the build directory for Python source). + # (Actually, it gets copied to the directory for this package + # under self.build_lib.) + self.build_module(module, module_file, package) + + def build_packages(self) -> None: + for package in self.packages: + # Get list of (package, module, module_file) tuples based on + # scanning the package directory. 'package' is only included + # in the tuple so that 'find_modules()' and + # 'find_package_tuples()' have a consistent interface; it's + # ignored here (apart from a sanity check). Also, 'module' is + # the *unqualified* module name (ie. no dots, no package -- we + # already know its package!), and 'module_file' is the path to + # the .py file, relative to the current directory + # (ie. including 'package_dir'). + package_dir = self.get_package_dir(package) + modules = self.find_package_modules(package, package_dir) + + # Now loop over the modules we found, "building" each one (just + # copy it to self.build_lib). + for package_, module, module_file in modules: + assert package == package_ + self.build_module(module, module_file, package) + + def byte_compile(self, files) -> None: + if sys.dont_write_bytecode: + self.warn('byte-compiling is disabled, skipping.') + return + + from ..util import byte_compile + + prefix = self.build_lib + if prefix[-1] != os.sep: + prefix = prefix + os.sep + + # XXX this code is essentially the same as the 'byte_compile() + # method of the "install_lib" command, except for the determination + # of the 'prefix' string. Hmmm. + if self.compile: + byte_compile( + files, optimize=0, force=self.force, prefix=prefix, dry_run=self.dry_run + ) + if self.optimize > 0: + byte_compile( + files, + optimize=self.optimize, + force=self.force, + prefix=prefix, + dry_run=self.dry_run, + ) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_scripts.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_scripts.py new file mode 100644 index 000000000..b86ee6e6b --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/build_scripts.py @@ -0,0 +1,160 @@ +"""distutils.command.build_scripts + +Implements the Distutils 'build_scripts' command.""" + +import os +import re +import tokenize +from distutils._log import log +from stat import ST_MODE +from typing import ClassVar + +from .._modified import newer +from ..core import Command +from ..util import convert_path + +shebang_pattern = re.compile('^#!.*python[0-9.]*([ \t].*)?$') +""" +Pattern matching a Python interpreter indicated in first line of a script. +""" + +# for Setuptools compatibility +first_line_re = shebang_pattern + + +class build_scripts(Command): + description = "\"build\" scripts (copy and fixup #! line)" + + user_options: ClassVar[list[tuple[str, str, str]]] = [ + ('build-dir=', 'd', "directory to \"build\" (copy) to"), + ('force', 'f', "forcibly build everything (ignore file timestamps"), + ('executable=', 'e', "specify final destination interpreter path"), + ] + + boolean_options: ClassVar[list[str]] = ['force'] + + def initialize_options(self): + self.build_dir = None + self.scripts = None + self.force = None + self.executable = None + + def finalize_options(self): + self.set_undefined_options( + 'build', + ('build_scripts', 'build_dir'), + ('force', 'force'), + ('executable', 'executable'), + ) + self.scripts = self.distribution.scripts + + def get_source_files(self): + return self.scripts + + def run(self): + if not self.scripts: + return + self.copy_scripts() + + def copy_scripts(self): + """ + Copy each script listed in ``self.scripts``. + + If a script is marked as a Python script (first line matches + 'shebang_pattern', i.e. starts with ``#!`` and contains + "python"), then adjust in the copy the first line to refer to + the current Python interpreter. + """ + self.mkpath(self.build_dir) + outfiles = [] + updated_files = [] + for script in self.scripts: + self._copy_script(script, outfiles, updated_files) + + self._change_modes(outfiles) + + return outfiles, updated_files + + def _copy_script(self, script, outfiles, updated_files): + shebang_match = None + script = convert_path(script) + outfile = os.path.join(self.build_dir, os.path.basename(script)) + outfiles.append(outfile) + + if not self.force and not newer(script, outfile): + log.debug("not copying %s (up-to-date)", script) + return + + # Always open the file, but ignore failures in dry-run mode + # in order to attempt to copy directly. + try: + f = tokenize.open(script) + except OSError: + if not self.dry_run: + raise + f = None + else: + first_line = f.readline() + if not first_line: + self.warn(f"{script} is an empty file (skipping)") + return + + shebang_match = shebang_pattern.match(first_line) + + updated_files.append(outfile) + if shebang_match: + log.info("copying and adjusting %s -> %s", script, self.build_dir) + if not self.dry_run: + post_interp = shebang_match.group(1) or '' + shebang = "#!" + self.executable + post_interp + "\n" + self._validate_shebang(shebang, f.encoding) + with open(outfile, "w", encoding=f.encoding) as outf: + outf.write(shebang) + outf.writelines(f.readlines()) + if f: + f.close() + else: + if f: + f.close() + self.copy_file(script, outfile) + + def _change_modes(self, outfiles): + if os.name != 'posix': + return + + for file in outfiles: + self._change_mode(file) + + def _change_mode(self, file): + if self.dry_run: + log.info("changing mode of %s", file) + return + + oldmode = os.stat(file)[ST_MODE] & 0o7777 + newmode = (oldmode | 0o555) & 0o7777 + if newmode != oldmode: + log.info("changing mode of %s from %o to %o", file, oldmode, newmode) + os.chmod(file, newmode) + + @staticmethod + def _validate_shebang(shebang, encoding): + # 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 encodable to + # UTF-8. + try: + shebang.encode('utf-8') + except UnicodeEncodeError: + raise ValueError(f"The shebang ({shebang!r}) is not encodable to utf-8") + + # If the script is encoded to a custom encoding (use a + # #coding:xxx cookie), the shebang has to be encodable to + # the script encoding too. + try: + shebang.encode(encoding) + except UnicodeEncodeError: + raise ValueError( + f"The shebang ({shebang!r}) is not encodable " + f"to the script encoding ({encoding})" + ) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/check.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/check.py new file mode 100644 index 000000000..58a823dd3 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/check.py @@ -0,0 +1,152 @@ +"""distutils.command.check + +Implements the Distutils 'check' command. +""" + +import contextlib +from typing import ClassVar + +from ..core import Command +from ..errors import DistutilsSetupError + +with contextlib.suppress(ImportError): + import docutils.frontend + import docutils.nodes + import docutils.parsers.rst + import docutils.utils + + class SilentReporter(docutils.utils.Reporter): + def __init__( + self, + source, + report_level, + halt_level, + stream=None, + debug=False, + encoding='ascii', + error_handler='replace', + ): + self.messages = [] + super().__init__( + source, report_level, halt_level, stream, debug, encoding, error_handler + ) + + def system_message(self, level, message, *children, **kwargs): + self.messages.append((level, message, children, kwargs)) + return docutils.nodes.system_message( + message, *children, level=level, type=self.levels[level], **kwargs + ) + + +class check(Command): + """This command checks the meta-data of the package.""" + + description = "perform some checks on the package" + user_options: ClassVar[list[tuple[str, str, str]]] = [ + ('metadata', 'm', 'Verify meta-data'), + ( + 'restructuredtext', + 'r', + 'Checks if long string meta-data syntax are reStructuredText-compliant', + ), + ('strict', 's', 'Will exit with an error if a check fails'), + ] + + boolean_options: ClassVar[list[str]] = ['metadata', 'restructuredtext', 'strict'] + + def initialize_options(self): + """Sets default values for options.""" + self.restructuredtext = False + self.metadata = 1 + self.strict = False + self._warnings = 0 + + def finalize_options(self): + pass + + def warn(self, msg): + """Counts the number of warnings that occurs.""" + self._warnings += 1 + return Command.warn(self, msg) + + def run(self): + """Runs the command.""" + # perform the various tests + if self.metadata: + self.check_metadata() + if self.restructuredtext: + if 'docutils' in globals(): + try: + self.check_restructuredtext() + except TypeError as exc: + raise DistutilsSetupError(str(exc)) + elif self.strict: + raise DistutilsSetupError('The docutils package is needed.') + + # let's raise an error in strict mode, if we have at least + # one warning + if self.strict and self._warnings > 0: + raise DistutilsSetupError('Please correct your package.') + + def check_metadata(self): + """Ensures that all required elements of meta-data are supplied. + + Required fields: + name, version + + Warns if any are missing. + """ + metadata = self.distribution.metadata + + missing = [ + attr for attr in ('name', 'version') if not getattr(metadata, attr, None) + ] + + if missing: + self.warn("missing required meta-data: {}".format(', '.join(missing))) + + def check_restructuredtext(self): + """Checks if the long string fields are reST-compliant.""" + data = self.distribution.get_long_description() + for warning in self._check_rst_data(data): + line = warning[-1].get('line') + if line is None: + warning = warning[1] + else: + warning = f'{warning[1]} (line {line})' + self.warn(warning) + + def _check_rst_data(self, data): + """Returns warnings when the provided data doesn't compile.""" + # the include and csv_table directives need this to be a path + source_path = self.distribution.script_name or 'setup.py' + parser = docutils.parsers.rst.Parser() + settings = docutils.frontend.OptionParser( + components=(docutils.parsers.rst.Parser,) + ).get_default_values() + settings.tab_width = 4 + settings.pep_references = None + settings.rfc_references = None + reporter = SilentReporter( + source_path, + settings.report_level, + settings.halt_level, + stream=settings.warning_stream, + debug=settings.debug, + encoding=settings.error_encoding, + error_handler=settings.error_encoding_error_handler, + ) + + document = docutils.nodes.document(settings, reporter, source=source_path) + document.note_source(source_path, -1) + try: + parser.parse(data, document) + except (AttributeError, TypeError) as e: + reporter.messages.append(( + -1, + f'Could not finish the parsing: {e}.', + '', + {}, + )) + + return reporter.messages diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/clean.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/clean.py new file mode 100644 index 000000000..23427aba2 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/clean.py @@ -0,0 +1,77 @@ +"""distutils.command.clean + +Implements the Distutils 'clean' command.""" + +# contributed by Bastian Kleineidam , added 2000-03-18 + +import os +from distutils._log import log +from typing import ClassVar + +from ..core import Command +from ..dir_util import remove_tree + + +class clean(Command): + description = "clean up temporary files from 'build' command" + user_options = [ + ('build-base=', 'b', "base build directory [default: 'build.build-base']"), + ( + 'build-lib=', + None, + "build directory for all modules [default: 'build.build-lib']", + ), + ('build-temp=', 't', "temporary build directory [default: 'build.build-temp']"), + ( + 'build-scripts=', + None, + "build directory for scripts [default: 'build.build-scripts']", + ), + ('bdist-base=', None, "temporary directory for built distributions"), + ('all', 'a', "remove all build output, not just temporary by-products"), + ] + + boolean_options: ClassVar[list[str]] = ['all'] + + def initialize_options(self): + self.build_base = None + self.build_lib = None + self.build_temp = None + self.build_scripts = None + self.bdist_base = None + self.all = None + + def finalize_options(self): + self.set_undefined_options( + 'build', + ('build_base', 'build_base'), + ('build_lib', 'build_lib'), + ('build_scripts', 'build_scripts'), + ('build_temp', 'build_temp'), + ) + self.set_undefined_options('bdist', ('bdist_base', 'bdist_base')) + + def run(self): + # remove the build/temp. directory (unless it's already + # gone) + if os.path.exists(self.build_temp): + remove_tree(self.build_temp, dry_run=self.dry_run) + else: + log.debug("'%s' does not exist -- can't clean it", self.build_temp) + + if self.all: + # remove build directories + for directory in (self.build_lib, self.bdist_base, self.build_scripts): + if os.path.exists(directory): + remove_tree(directory, dry_run=self.dry_run) + else: + log.warning("'%s' does not exist -- can't clean it", directory) + + # just for the heck of it, try to remove the base build directory: + # we might have emptied it right now, but if not we don't care + if not self.dry_run: + try: + os.rmdir(self.build_base) + log.info("removing '%s'", self.build_base) + except OSError: + pass diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/config.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/config.py new file mode 100644 index 000000000..c825765c8 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/config.py @@ -0,0 +1,358 @@ +"""distutils.command.config + +Implements the Distutils 'config' command, a (mostly) empty command class +that exists mainly to be sub-classed by specific module distributions and +applications. The idea is that while every "config" command is different, +at least they're all named the same, and users always see "config" in the +list of standard commands. Also, this is a good place to put common +configure-like tasks: "try to compile this C code", or "figure out where +this header file lives". +""" + +from __future__ import annotations + +import os +import pathlib +import re +from collections.abc import Sequence +from distutils._log import log + +from ..ccompiler import CCompiler, CompileError, LinkError, new_compiler +from ..core import Command +from ..errors import DistutilsExecError +from ..sysconfig import customize_compiler + +LANG_EXT = {"c": ".c", "c++": ".cxx"} + + +class config(Command): + description = "prepare to build" + + user_options = [ + ('compiler=', None, "specify the compiler type"), + ('cc=', None, "specify the compiler executable"), + ('include-dirs=', 'I', "list of directories to search for header files"), + ('define=', 'D', "C preprocessor macros to define"), + ('undef=', 'U', "C preprocessor macros to undefine"), + ('libraries=', 'l', "external C libraries to link with"), + ('library-dirs=', 'L', "directories to search for external C libraries"), + ('noisy', None, "show every action (compile, link, run, ...) taken"), + ( + 'dump-source', + None, + "dump generated source files before attempting to compile them", + ), + ] + + # The three standard command methods: since the "config" command + # does nothing by default, these are empty. + + def initialize_options(self): + self.compiler = None + self.cc = None + self.include_dirs = None + self.libraries = None + self.library_dirs = None + + # maximal output for now + self.noisy = 1 + self.dump_source = 1 + + # list of temporary files generated along-the-way that we have + # to clean at some point + self.temp_files = [] + + def finalize_options(self): + if self.include_dirs is None: + self.include_dirs = self.distribution.include_dirs or [] + elif isinstance(self.include_dirs, str): + self.include_dirs = self.include_dirs.split(os.pathsep) + + if self.libraries is None: + self.libraries = [] + elif isinstance(self.libraries, str): + self.libraries = [self.libraries] + + if self.library_dirs is None: + self.library_dirs = [] + elif isinstance(self.library_dirs, str): + self.library_dirs = self.library_dirs.split(os.pathsep) + + def run(self): + pass + + # Utility methods for actual "config" commands. The interfaces are + # loosely based on Autoconf macros of similar names. Sub-classes + # may use these freely. + + def _check_compiler(self): + """Check that 'self.compiler' really is a CCompiler object; + if not, make it one. + """ + if not isinstance(self.compiler, CCompiler): + self.compiler = new_compiler( + compiler=self.compiler, dry_run=self.dry_run, force=True + ) + customize_compiler(self.compiler) + if self.include_dirs: + self.compiler.set_include_dirs(self.include_dirs) + if self.libraries: + self.compiler.set_libraries(self.libraries) + if self.library_dirs: + self.compiler.set_library_dirs(self.library_dirs) + + def _gen_temp_sourcefile(self, body, headers, lang): + filename = "_configtest" + LANG_EXT[lang] + with open(filename, "w", encoding='utf-8') as file: + if headers: + for header in headers: + file.write(f"#include <{header}>\n") + file.write("\n") + file.write(body) + if body[-1] != "\n": + file.write("\n") + return filename + + def _preprocess(self, body, headers, include_dirs, lang): + src = self._gen_temp_sourcefile(body, headers, lang) + out = "_configtest.i" + self.temp_files.extend([src, out]) + self.compiler.preprocess(src, out, include_dirs=include_dirs) + return (src, out) + + def _compile(self, body, headers, include_dirs, lang): + src = self._gen_temp_sourcefile(body, headers, lang) + if self.dump_source: + dump_file(src, f"compiling '{src}':") + (obj,) = self.compiler.object_filenames([src]) + self.temp_files.extend([src, obj]) + self.compiler.compile([src], include_dirs=include_dirs) + return (src, obj) + + def _link(self, body, headers, include_dirs, libraries, library_dirs, lang): + (src, obj) = self._compile(body, headers, include_dirs, lang) + prog = os.path.splitext(os.path.basename(src))[0] + self.compiler.link_executable( + [obj], + prog, + libraries=libraries, + library_dirs=library_dirs, + target_lang=lang, + ) + + if self.compiler.exe_extension is not None: + prog = prog + self.compiler.exe_extension + self.temp_files.append(prog) + + return (src, obj, prog) + + def _clean(self, *filenames): + if not filenames: + filenames = self.temp_files + self.temp_files = [] + log.info("removing: %s", ' '.join(filenames)) + for filename in filenames: + try: + os.remove(filename) + except OSError: + pass + + # XXX these ignore the dry-run flag: what to do, what to do? even if + # you want a dry-run build, you still need some sort of configuration + # info. My inclination is to make it up to the real config command to + # consult 'dry_run', and assume a default (minimal) configuration if + # true. The problem with trying to do it here is that you'd have to + # return either true or false from all the 'try' methods, neither of + # which is correct. + + # XXX need access to the header search path and maybe default macros. + + def try_cpp(self, body=None, headers=None, include_dirs=None, lang="c"): + """Construct a source file from 'body' (a string containing lines + of C/C++ code) and 'headers' (a list of header files to include) + and run it through the preprocessor. Return true if the + preprocessor succeeded, false if there were any errors. + ('body' probably isn't of much use, but what the heck.) + """ + self._check_compiler() + ok = True + try: + self._preprocess(body, headers, include_dirs, lang) + except CompileError: + ok = False + + self._clean() + return ok + + def search_cpp(self, pattern, body=None, headers=None, include_dirs=None, lang="c"): + """Construct a source file (just like 'try_cpp()'), run it through + the preprocessor, and return true if any line of the output matches + 'pattern'. 'pattern' should either be a compiled regex object or a + string containing a regex. If both 'body' and 'headers' are None, + preprocesses an empty file -- which can be useful to determine the + symbols the preprocessor and compiler set by default. + """ + self._check_compiler() + src, out = self._preprocess(body, headers, include_dirs, lang) + + if isinstance(pattern, str): + pattern = re.compile(pattern) + + with open(out, encoding='utf-8') as file: + match = any(pattern.search(line) for line in file) + + self._clean() + return match + + def try_compile(self, body, headers=None, include_dirs=None, lang="c"): + """Try to compile a source file built from 'body' and 'headers'. + Return true on success, false otherwise. + """ + self._check_compiler() + try: + self._compile(body, headers, include_dirs, lang) + ok = True + except CompileError: + ok = False + + log.info(ok and "success!" or "failure.") + self._clean() + return ok + + def try_link( + self, + body, + headers=None, + include_dirs=None, + libraries=None, + library_dirs=None, + lang="c", + ): + """Try to compile and link a source file, built from 'body' and + 'headers', to executable form. Return true on success, false + otherwise. + """ + self._check_compiler() + try: + self._link(body, headers, include_dirs, libraries, library_dirs, lang) + ok = True + except (CompileError, LinkError): + ok = False + + log.info(ok and "success!" or "failure.") + self._clean() + return ok + + def try_run( + self, + body, + headers=None, + include_dirs=None, + libraries=None, + library_dirs=None, + lang="c", + ): + """Try to compile, link to an executable, and run a program + built from 'body' and 'headers'. Return true on success, false + otherwise. + """ + self._check_compiler() + try: + src, obj, exe = self._link( + body, headers, include_dirs, libraries, library_dirs, lang + ) + self.spawn([exe]) + ok = True + except (CompileError, LinkError, DistutilsExecError): + ok = False + + log.info(ok and "success!" or "failure.") + self._clean() + return ok + + # -- High-level methods -------------------------------------------- + # (these are the ones that are actually likely to be useful + # when implementing a real-world config command!) + + def check_func( + self, + func, + headers=None, + include_dirs=None, + libraries=None, + library_dirs=None, + decl=False, + call=False, + ): + """Determine if function 'func' is available by constructing a + source file that refers to 'func', and compiles and links it. + If everything succeeds, returns true; otherwise returns false. + + The constructed source file starts out by including the header + files listed in 'headers'. If 'decl' is true, it then declares + 'func' (as "int func()"); you probably shouldn't supply 'headers' + and set 'decl' true in the same call, or you might get errors about + a conflicting declarations for 'func'. Finally, the constructed + 'main()' function either references 'func' or (if 'call' is true) + calls it. 'libraries' and 'library_dirs' are used when + linking. + """ + self._check_compiler() + body = [] + if decl: + body.append(f"int {func} ();") + body.append("int main () {") + if call: + body.append(f" {func}();") + else: + body.append(f" {func};") + body.append("}") + body = "\n".join(body) + "\n" + + return self.try_link(body, headers, include_dirs, libraries, library_dirs) + + def check_lib( + self, + library, + library_dirs=None, + headers=None, + include_dirs=None, + other_libraries: Sequence[str] = [], + ): + """Determine if 'library' is available to be linked against, + without actually checking that any particular symbols are provided + by it. 'headers' will be used in constructing the source file to + be compiled, but the only effect of this is to check if all the + header files listed are available. Any libraries listed in + 'other_libraries' will be included in the link, in case 'library' + has symbols that depend on other libraries. + """ + self._check_compiler() + return self.try_link( + "int main (void) { }", + headers, + include_dirs, + [library] + list(other_libraries), + library_dirs, + ) + + def check_header(self, header, include_dirs=None, library_dirs=None, lang="c"): + """Determine if the system header file named by 'header_file' + exists and can be found by the preprocessor; return true if so, + false otherwise. + """ + return self.try_cpp( + body="/* No body */", headers=[header], include_dirs=include_dirs + ) + + +def dump_file(filename, head=None): + """Dumps a file content into log.info. + + If head is not None, will be dumped before the file content. + """ + if head is None: + log.info('%s', filename) + else: + log.info(head) + log.info(pathlib.Path(filename).read_text(encoding='utf-8')) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install.py new file mode 100644 index 000000000..dc17e56a8 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install.py @@ -0,0 +1,805 @@ +"""distutils.command.install + +Implements the Distutils 'install' command.""" + +from __future__ import annotations + +import collections +import contextlib +import itertools +import os +import sys +import sysconfig +from distutils._log import log +from site import USER_BASE, USER_SITE +from typing import ClassVar + +from ..core import Command +from ..debug import DEBUG +from ..errors import DistutilsOptionError, DistutilsPlatformError +from ..file_util import write_file +from ..sysconfig import get_config_vars +from ..util import change_root, convert_path, get_platform, subst_vars +from . import _framework_compat as fw + +HAS_USER_SITE = True + +WINDOWS_SCHEME = { + 'purelib': '{base}/Lib/site-packages', + 'platlib': '{base}/Lib/site-packages', + 'headers': '{base}/Include/{dist_name}', + 'scripts': '{base}/Scripts', + 'data': '{base}', +} + +INSTALL_SCHEMES = { + 'posix_prefix': { + 'purelib': '{base}/lib/{implementation_lower}{py_version_short}/site-packages', + 'platlib': '{platbase}/{platlibdir}/{implementation_lower}' + '{py_version_short}/site-packages', + 'headers': '{base}/include/{implementation_lower}' + '{py_version_short}{abiflags}/{dist_name}', + 'scripts': '{base}/bin', + 'data': '{base}', + }, + 'posix_home': { + 'purelib': '{base}/lib/{implementation_lower}', + 'platlib': '{base}/{platlibdir}/{implementation_lower}', + 'headers': '{base}/include/{implementation_lower}/{dist_name}', + 'scripts': '{base}/bin', + 'data': '{base}', + }, + 'nt': WINDOWS_SCHEME, + 'pypy': { + 'purelib': '{base}/site-packages', + 'platlib': '{base}/site-packages', + 'headers': '{base}/include/{dist_name}', + 'scripts': '{base}/bin', + 'data': '{base}', + }, + 'pypy_nt': { + 'purelib': '{base}/site-packages', + 'platlib': '{base}/site-packages', + 'headers': '{base}/include/{dist_name}', + 'scripts': '{base}/Scripts', + 'data': '{base}', + }, +} + +# user site schemes +if HAS_USER_SITE: + INSTALL_SCHEMES['nt_user'] = { + 'purelib': '{usersite}', + 'platlib': '{usersite}', + 'headers': '{userbase}/{implementation}{py_version_nodot_plat}' + '/Include/{dist_name}', + 'scripts': '{userbase}/{implementation}{py_version_nodot_plat}/Scripts', + 'data': '{userbase}', + } + + INSTALL_SCHEMES['posix_user'] = { + 'purelib': '{usersite}', + 'platlib': '{usersite}', + 'headers': '{userbase}/include/{implementation_lower}' + '{py_version_short}{abiflags}/{dist_name}', + 'scripts': '{userbase}/bin', + 'data': '{userbase}', + } + + +INSTALL_SCHEMES.update(fw.schemes) + + +# The keys to an installation scheme; if any new types of files are to be +# installed, be sure to add an entry to every installation scheme above, +# and to SCHEME_KEYS here. +SCHEME_KEYS = ('purelib', 'platlib', 'headers', 'scripts', 'data') + + +def _load_sysconfig_schemes(): + with contextlib.suppress(AttributeError): + return { + scheme: sysconfig.get_paths(scheme, expand=False) + for scheme in sysconfig.get_scheme_names() + } + + +def _load_schemes(): + """ + Extend default schemes with schemes from sysconfig. + """ + + sysconfig_schemes = _load_sysconfig_schemes() or {} + + return { + scheme: { + **INSTALL_SCHEMES.get(scheme, {}), + **sysconfig_schemes.get(scheme, {}), + } + for scheme in set(itertools.chain(INSTALL_SCHEMES, sysconfig_schemes)) + } + + +def _get_implementation(): + if hasattr(sys, 'pypy_version_info'): + return 'PyPy' + else: + return 'Python' + + +def _select_scheme(ob, name): + scheme = _inject_headers(name, _load_scheme(_resolve_scheme(name))) + vars(ob).update(_remove_set(ob, _scheme_attrs(scheme))) + + +def _remove_set(ob, attrs): + """ + Include only attrs that are None in ob. + """ + return {key: value for key, value in attrs.items() if getattr(ob, key) is None} + + +def _resolve_scheme(name): + os_name, sep, key = name.partition('_') + try: + resolved = sysconfig.get_preferred_scheme(key) + except Exception: + resolved = fw.scheme(name) + return resolved + + +def _load_scheme(name): + return _load_schemes()[name] + + +def _inject_headers(name, scheme): + """ + Given a scheme name and the resolved scheme, + if the scheme does not include headers, resolve + the fallback scheme for the name and use headers + from it. pypa/distutils#88 + """ + # Bypass the preferred scheme, which may not + # have defined headers. + fallback = _load_scheme(name) + scheme.setdefault('headers', fallback['headers']) + return scheme + + +def _scheme_attrs(scheme): + """Resolve install directories by applying the install schemes.""" + return {f'install_{key}': scheme[key] for key in SCHEME_KEYS} + + +class install(Command): + description = "install everything from build directory" + + user_options = [ + # Select installation scheme and set base director(y|ies) + ('prefix=', None, "installation prefix"), + ('exec-prefix=', None, "(Unix only) prefix for platform-specific files"), + ('home=', None, "(Unix only) home directory to install under"), + # Or, just set the base director(y|ies) + ( + 'install-base=', + None, + "base installation directory (instead of --prefix or --home)", + ), + ( + 'install-platbase=', + None, + "base installation directory for platform-specific files (instead of --exec-prefix or --home)", + ), + ('root=', None, "install everything relative to this alternate root directory"), + # Or, explicitly set the installation scheme + ( + 'install-purelib=', + None, + "installation directory for pure Python module distributions", + ), + ( + 'install-platlib=', + None, + "installation directory for non-pure module distributions", + ), + ( + 'install-lib=', + None, + "installation directory for all module distributions (overrides --install-purelib and --install-platlib)", + ), + ('install-headers=', None, "installation directory for C/C++ headers"), + ('install-scripts=', None, "installation directory for Python scripts"), + ('install-data=', None, "installation directory for data files"), + # Byte-compilation options -- see install_lib.py for details, as + # these are duplicated from there (but only install_lib does + # anything with them). + ('compile', 'c', "compile .py to .pyc [default]"), + ('no-compile', None, "don't compile .py files"), + ( + 'optimize=', + 'O', + "also compile with optimization: -O1 for \"python -O\", " + "-O2 for \"python -OO\", and -O0 to disable [default: -O0]", + ), + # Miscellaneous control options + ('force', 'f', "force installation (overwrite any existing files)"), + ('skip-build', None, "skip rebuilding everything (for testing/debugging)"), + # Where to install documentation (eventually!) + # ('doc-format=', None, "format of documentation to generate"), + # ('install-man=', None, "directory for Unix man pages"), + # ('install-html=', None, "directory for HTML documentation"), + # ('install-info=', None, "directory for GNU info files"), + ('record=', None, "filename in which to record list of installed files"), + ] + + boolean_options: ClassVar[list[str]] = ['compile', 'force', 'skip-build'] + + if HAS_USER_SITE: + user_options.append(( + 'user', + None, + f"install in user site-package '{USER_SITE}'", + )) + boolean_options.append('user') + + negative_opt: ClassVar[dict[str, str]] = {'no-compile': 'compile'} + + def initialize_options(self) -> None: + """Initializes options.""" + # High-level options: these select both an installation base + # and scheme. + self.prefix: str | None = None + self.exec_prefix: str | None = None + self.home: str | None = None + self.user = False + + # These select only the installation base; it's up to the user to + # specify the installation scheme (currently, that means supplying + # the --install-{platlib,purelib,scripts,data} options). + self.install_base = None + self.install_platbase = None + self.root: str | None = None + + # These options are the actual installation directories; if not + # supplied by the user, they are filled in using the installation + # scheme implied by prefix/exec-prefix/home and the contents of + # that installation scheme. + self.install_purelib = None # for pure module distributions + self.install_platlib = None # non-pure (dists w/ extensions) + self.install_headers = None # for C/C++ headers + self.install_lib: str | None = None # set to either purelib or platlib + self.install_scripts = None + self.install_data = None + self.install_userbase = USER_BASE + self.install_usersite = USER_SITE + + self.compile = None + self.optimize = None + + # Deprecated + # These two are for putting non-packagized distributions into their + # own directory and creating a .pth file if it makes sense. + # 'extra_path' comes from the setup file; 'install_path_file' can + # be turned off if it makes no sense to install a .pth file. (But + # better to install it uselessly than to guess wrong and not + # install it when it's necessary and would be used!) Currently, + # 'install_path_file' is always true unless some outsider meddles + # with it. + self.extra_path = None + self.install_path_file = True + + # 'force' forces installation, even if target files are not + # out-of-date. 'skip_build' skips running the "build" command, + # handy if you know it's not necessary. 'warn_dir' (which is *not* + # a user option, it's just there so the bdist_* commands can turn + # it off) determines whether we warn about installing to a + # directory not in sys.path. + self.force = False + self.skip_build = False + self.warn_dir = True + + # These are only here as a conduit from the 'build' command to the + # 'install_*' commands that do the real work. ('build_base' isn't + # actually used anywhere, but it might be useful in future.) They + # are not user options, because if the user told the install + # command where the build directory is, that wouldn't affect the + # build command. + self.build_base = None + self.build_lib = None + + # Not defined yet because we don't know anything about + # documentation yet. + # self.install_man = None + # self.install_html = None + # self.install_info = None + + self.record = None + + # -- Option finalizing methods ------------------------------------- + # (This is rather more involved than for most commands, + # because this is where the policy for installing third- + # party Python modules on various platforms given a wide + # array of user input is decided. Yes, it's quite complex!) + + def finalize_options(self) -> None: # noqa: C901 + """Finalizes options.""" + # This method (and its helpers, like 'finalize_unix()', + # 'finalize_other()', and 'select_scheme()') is where the default + # installation directories for modules, extension modules, and + # anything else we care to install from a Python module + # distribution. Thus, this code makes a pretty important policy + # statement about how third-party stuff is added to a Python + # installation! Note that the actual work of installation is done + # by the relatively simple 'install_*' commands; they just take + # their orders from the installation directory options determined + # here. + + # Check for errors/inconsistencies in the options; first, stuff + # that's wrong on any platform. + + if (self.prefix or self.exec_prefix or self.home) and ( + self.install_base or self.install_platbase + ): + raise DistutilsOptionError( + "must supply either prefix/exec-prefix/home or install-base/install-platbase -- not both" + ) + + if self.home and (self.prefix or self.exec_prefix): + raise DistutilsOptionError( + "must supply either home or prefix/exec-prefix -- not both" + ) + + if self.user and ( + self.prefix + or self.exec_prefix + or self.home + or self.install_base + or self.install_platbase + ): + raise DistutilsOptionError( + "can't combine user with prefix, " + "exec_prefix/home, or install_(plat)base" + ) + + # Next, stuff that's wrong (or dubious) only on certain platforms. + if os.name != "posix": + if self.exec_prefix: + self.warn("exec-prefix option ignored on this platform") + self.exec_prefix = None + + # Now the interesting logic -- so interesting that we farm it out + # to other methods. The goal of these methods is to set the final + # values for the install_{lib,scripts,data,...} options, using as + # input a heady brew of prefix, exec_prefix, home, install_base, + # install_platbase, user-supplied versions of + # install_{purelib,platlib,lib,scripts,data,...}, and the + # install schemes. Phew! + + self.dump_dirs("pre-finalize_{unix,other}") + + if os.name == 'posix': + self.finalize_unix() + else: + self.finalize_other() + + self.dump_dirs("post-finalize_{unix,other}()") + + # Expand configuration variables, tilde, etc. in self.install_base + # and self.install_platbase -- that way, we can use $base or + # $platbase in the other installation directories and not worry + # about needing recursive variable expansion (shudder). + + py_version = sys.version.split()[0] + (prefix, exec_prefix) = get_config_vars('prefix', 'exec_prefix') + try: + abiflags = sys.abiflags + except AttributeError: + # sys.abiflags may not be defined on all platforms. + abiflags = '' + local_vars = { + 'dist_name': self.distribution.get_name(), + 'dist_version': self.distribution.get_version(), + 'dist_fullname': self.distribution.get_fullname(), + 'py_version': py_version, + 'py_version_short': f'{sys.version_info.major}.{sys.version_info.minor}', + 'py_version_nodot': f'{sys.version_info.major}{sys.version_info.minor}', + 'sys_prefix': prefix, + 'prefix': prefix, + 'sys_exec_prefix': exec_prefix, + 'exec_prefix': exec_prefix, + 'abiflags': abiflags, + 'platlibdir': getattr(sys, 'platlibdir', 'lib'), + 'implementation_lower': _get_implementation().lower(), + 'implementation': _get_implementation(), + } + + # vars for compatibility on older Pythons + compat_vars = dict( + # Python 3.9 and earlier + py_version_nodot_plat=getattr(sys, 'winver', '').replace('.', ''), + ) + + if HAS_USER_SITE: + local_vars['userbase'] = self.install_userbase + local_vars['usersite'] = self.install_usersite + + self.config_vars = collections.ChainMap( + local_vars, + sysconfig.get_config_vars(), + compat_vars, + fw.vars(), + ) + + self.expand_basedirs() + + self.dump_dirs("post-expand_basedirs()") + + # Now define config vars for the base directories so we can expand + # everything else. + local_vars['base'] = self.install_base + local_vars['platbase'] = self.install_platbase + + if DEBUG: + from pprint import pprint + + print("config vars:") + pprint(dict(self.config_vars)) + + # Expand "~" and configuration variables in the installation + # directories. + self.expand_dirs() + + self.dump_dirs("post-expand_dirs()") + + # Create directories in the home dir: + if self.user: + self.create_home_path() + + # Pick the actual directory to install all modules to: either + # install_purelib or install_platlib, depending on whether this + # module distribution is pure or not. Of course, if the user + # already specified install_lib, use their selection. + if self.install_lib is None: + if self.distribution.has_ext_modules(): # has extensions: non-pure + self.install_lib = self.install_platlib + else: + self.install_lib = self.install_purelib + + # Convert directories from Unix /-separated syntax to the local + # convention. + self.convert_paths( + 'lib', + 'purelib', + 'platlib', + 'scripts', + 'data', + 'headers', + 'userbase', + 'usersite', + ) + + # Deprecated + # Well, we're not actually fully completely finalized yet: we still + # have to deal with 'extra_path', which is the hack for allowing + # non-packagized module distributions (hello, Numerical Python!) to + # get their own directories. + self.handle_extra_path() + self.install_libbase = self.install_lib # needed for .pth file + self.install_lib = os.path.join(self.install_lib, self.extra_dirs) + + # If a new root directory was supplied, make all the installation + # dirs relative to it. + if self.root is not None: + self.change_roots( + 'libbase', 'lib', 'purelib', 'platlib', 'scripts', 'data', 'headers' + ) + + self.dump_dirs("after prepending root") + + # Find out the build directories, ie. where to install from. + self.set_undefined_options( + 'build', ('build_base', 'build_base'), ('build_lib', 'build_lib') + ) + + # Punt on doc directories for now -- after all, we're punting on + # documentation completely! + + def dump_dirs(self, msg) -> None: + """Dumps the list of user options.""" + if not DEBUG: + return + from ..fancy_getopt import longopt_xlate + + log.debug(msg + ":") + for opt in self.user_options: + opt_name = opt[0] + if opt_name[-1] == "=": + opt_name = opt_name[0:-1] + if opt_name in self.negative_opt: + opt_name = self.negative_opt[opt_name] + opt_name = opt_name.translate(longopt_xlate) + val = not getattr(self, opt_name) + else: + opt_name = opt_name.translate(longopt_xlate) + val = getattr(self, opt_name) + log.debug(" %s: %s", opt_name, val) + + def finalize_unix(self) -> None: + """Finalizes options for posix platforms.""" + if self.install_base is not None or self.install_platbase is not None: + incomplete_scheme = ( + ( + self.install_lib is None + and self.install_purelib is None + and self.install_platlib is None + ) + or self.install_headers is None + or self.install_scripts is None + or self.install_data is None + ) + if incomplete_scheme: + raise DistutilsOptionError( + "install-base or install-platbase supplied, but " + "installation scheme is incomplete" + ) + return + + if self.user: + if self.install_userbase is None: + raise DistutilsPlatformError("User base directory is not specified") + self.install_base = self.install_platbase = self.install_userbase + self.select_scheme("posix_user") + elif self.home is not None: + self.install_base = self.install_platbase = self.home + self.select_scheme("posix_home") + else: + if self.prefix is None: + if self.exec_prefix is not None: + raise DistutilsOptionError( + "must not supply exec-prefix without prefix" + ) + + # Allow Fedora to add components to the prefix + _prefix_addition = getattr(sysconfig, '_prefix_addition', "") + + self.prefix = os.path.normpath(sys.prefix) + _prefix_addition + self.exec_prefix = os.path.normpath(sys.exec_prefix) + _prefix_addition + + else: + if self.exec_prefix is None: + self.exec_prefix = self.prefix + + self.install_base = self.prefix + self.install_platbase = self.exec_prefix + self.select_scheme("posix_prefix") + + def finalize_other(self) -> None: + """Finalizes options for non-posix platforms""" + if self.user: + if self.install_userbase is None: + raise DistutilsPlatformError("User base directory is not specified") + self.install_base = self.install_platbase = self.install_userbase + self.select_scheme(os.name + "_user") + elif self.home is not None: + self.install_base = self.install_platbase = self.home + self.select_scheme("posix_home") + else: + if self.prefix is None: + self.prefix = os.path.normpath(sys.prefix) + + self.install_base = self.install_platbase = self.prefix + try: + self.select_scheme(os.name) + except KeyError: + raise DistutilsPlatformError( + f"I don't know how to install stuff on '{os.name}'" + ) + + def select_scheme(self, name) -> None: + _select_scheme(self, name) + + def _expand_attrs(self, attrs): + for attr in attrs: + val = getattr(self, attr) + if val is not None: + if os.name in ('posix', 'nt'): + val = os.path.expanduser(val) + val = subst_vars(val, self.config_vars) + setattr(self, attr, val) + + def expand_basedirs(self) -> None: + """Calls `os.path.expanduser` on install_base, install_platbase and + root.""" + self._expand_attrs(['install_base', 'install_platbase', 'root']) + + def expand_dirs(self) -> None: + """Calls `os.path.expanduser` on install dirs.""" + self._expand_attrs([ + 'install_purelib', + 'install_platlib', + 'install_lib', + 'install_headers', + 'install_scripts', + 'install_data', + ]) + + def convert_paths(self, *names) -> None: + """Call `convert_path` over `names`.""" + for name in names: + attr = "install_" + name + setattr(self, attr, convert_path(getattr(self, attr))) + + def handle_extra_path(self) -> None: + """Set `path_file` and `extra_dirs` using `extra_path`.""" + if self.extra_path is None: + self.extra_path = self.distribution.extra_path + + if self.extra_path is not None: + log.warning( + "Distribution option extra_path is deprecated. " + "See issue27919 for details." + ) + if isinstance(self.extra_path, str): + self.extra_path = self.extra_path.split(',') + + if len(self.extra_path) == 1: + path_file = extra_dirs = self.extra_path[0] + elif len(self.extra_path) == 2: + path_file, extra_dirs = self.extra_path + else: + raise DistutilsOptionError( + "'extra_path' option must be a list, tuple, or " + "comma-separated string with 1 or 2 elements" + ) + + # convert to local form in case Unix notation used (as it + # should be in setup scripts) + extra_dirs = convert_path(extra_dirs) + else: + path_file = None + extra_dirs = '' + + # XXX should we warn if path_file and not extra_dirs? (in which + # case the path file would be harmless but pointless) + self.path_file = path_file + self.extra_dirs = extra_dirs + + def change_roots(self, *names) -> None: + """Change the install directories pointed by name using root.""" + for name in names: + attr = "install_" + name + setattr(self, attr, change_root(self.root, getattr(self, attr))) + + def create_home_path(self) -> None: + """Create directories under ~.""" + if not self.user: + return + home = convert_path(os.path.expanduser("~")) + for path in self.config_vars.values(): + if str(path).startswith(home) and not os.path.isdir(path): + self.debug_print(f"os.makedirs('{path}', 0o700)") + os.makedirs(path, 0o700) + + # -- Command execution methods ------------------------------------- + + def run(self): + """Runs the command.""" + # Obviously have to build before we can install + if not self.skip_build: + self.run_command('build') + # If we built for any other platform, we can't install. + build_plat = self.distribution.get_command_obj('build').plat_name + # check warn_dir - it is a clue that the 'install' is happening + # internally, and not to sys.path, so we don't check the platform + # matches what we are running. + if self.warn_dir and build_plat != get_platform(): + raise DistutilsPlatformError("Can't install when cross-compiling") + + # Run all sub-commands (at least those that need to be run) + for cmd_name in self.get_sub_commands(): + self.run_command(cmd_name) + + if self.path_file: + self.create_path_file() + + # write list of installed files, if requested. + if self.record: + outputs = self.get_outputs() + if self.root: # strip any package prefix + root_len = len(self.root) + for counter in range(len(outputs)): + outputs[counter] = outputs[counter][root_len:] + self.execute( + write_file, + (self.record, outputs), + f"writing list of installed files to '{self.record}'", + ) + + sys_path = map(os.path.normpath, sys.path) + sys_path = map(os.path.normcase, sys_path) + install_lib = os.path.normcase(os.path.normpath(self.install_lib)) + if ( + self.warn_dir + and not (self.path_file and self.install_path_file) + and install_lib not in sys_path + ): + log.debug( + ( + "modules installed to '%s', which is not in " + "Python's module search path (sys.path) -- " + "you'll have to change the search path yourself" + ), + self.install_lib, + ) + + def create_path_file(self): + """Creates the .pth file""" + filename = os.path.join(self.install_libbase, self.path_file + ".pth") + if self.install_path_file: + self.execute( + write_file, (filename, [self.extra_dirs]), f"creating {filename}" + ) + else: + self.warn(f"path file '{filename}' not created") + + # -- Reporting methods --------------------------------------------- + + def get_outputs(self): + """Assembles the outputs of all the sub-commands.""" + outputs = [] + for cmd_name in self.get_sub_commands(): + cmd = self.get_finalized_command(cmd_name) + # Add the contents of cmd.get_outputs(), ensuring + # that outputs doesn't contain duplicate entries + for filename in cmd.get_outputs(): + if filename not in outputs: + outputs.append(filename) + + if self.path_file and self.install_path_file: + outputs.append(os.path.join(self.install_libbase, self.path_file + ".pth")) + + return outputs + + def get_inputs(self): + """Returns the inputs of all the sub-commands""" + # XXX gee, this looks familiar ;-( + inputs = [] + for cmd_name in self.get_sub_commands(): + cmd = self.get_finalized_command(cmd_name) + inputs.extend(cmd.get_inputs()) + + return inputs + + # -- Predicates for sub-command list ------------------------------- + + def has_lib(self): + """Returns true if the current distribution has any Python + modules to install.""" + return ( + self.distribution.has_pure_modules() or self.distribution.has_ext_modules() + ) + + def has_headers(self): + """Returns true if the current distribution has any headers to + install.""" + return self.distribution.has_headers() + + def has_scripts(self): + """Returns true if the current distribution has any scripts to. + install.""" + return self.distribution.has_scripts() + + def has_data(self): + """Returns true if the current distribution has any data to. + install.""" + return self.distribution.has_data_files() + + # 'sub_commands': a list of commands this command might have to run to + # get its work done. See cmd.py for more info. + sub_commands = [ + ('install_lib', has_lib), + ('install_headers', has_headers), + ('install_scripts', has_scripts), + ('install_data', has_data), + ('install_egg_info', lambda self: True), + ] diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_data.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_data.py new file mode 100644 index 000000000..4ad186e8e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_data.py @@ -0,0 +1,94 @@ +"""distutils.command.install_data + +Implements the Distutils 'install_data' command, for installing +platform-independent data files.""" + +# contributed by Bastian Kleineidam + +from __future__ import annotations + +import functools +import os +from collections.abc import Iterable +from typing import ClassVar + +from ..core import Command +from ..util import change_root, convert_path + + +class install_data(Command): + description = "install data files" + + user_options = [ + ( + 'install-dir=', + 'd', + "base directory for installing data files [default: installation base dir]", + ), + ('root=', None, "install everything relative to this alternate root directory"), + ('force', 'f', "force installation (overwrite existing files)"), + ] + + boolean_options: ClassVar[list[str]] = ['force'] + + def initialize_options(self): + self.install_dir = None + self.outfiles = [] + self.root = None + self.force = False + self.data_files = self.distribution.data_files + self.warn_dir = True + + def finalize_options(self) -> None: + self.set_undefined_options( + 'install', + ('install_data', 'install_dir'), + ('root', 'root'), + ('force', 'force'), + ) + + def run(self) -> None: + self.mkpath(self.install_dir) + for f in self.data_files: + self._copy(f) + + @functools.singledispatchmethod + def _copy(self, f: tuple[str | os.PathLike, Iterable[str | os.PathLike]]): + # it's a tuple with path to install to and a list of files + dir = convert_path(f[0]) + if not os.path.isabs(dir): + dir = os.path.join(self.install_dir, dir) + elif self.root: + dir = change_root(self.root, dir) + self.mkpath(dir) + + if f[1] == []: + # If there are no files listed, the user must be + # trying to create an empty directory, so add the + # directory to the list of output files. + self.outfiles.append(dir) + else: + # Copy files, adding them to the list of output files. + for data in f[1]: + data = convert_path(data) + (out, _) = self.copy_file(data, dir) + self.outfiles.append(out) + + @_copy.register(str) + @_copy.register(os.PathLike) + def _(self, f: str | os.PathLike): + # it's a simple file, so copy it + f = convert_path(f) + if self.warn_dir: + self.warn( + "setup script did not provide a directory for " + f"'{f}' -- installing right in '{self.install_dir}'" + ) + (out, _) = self.copy_file(f, self.install_dir) + self.outfiles.append(out) + + def get_inputs(self): + return self.data_files or [] + + def get_outputs(self): + return self.outfiles diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_egg_info.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_egg_info.py new file mode 100644 index 000000000..230e94ab4 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_egg_info.py @@ -0,0 +1,91 @@ +""" +distutils.command.install_egg_info + +Implements the Distutils 'install_egg_info' command, for installing +a package's PKG-INFO metadata. +""" + +import os +import re +import sys +from typing import ClassVar + +from .. import dir_util +from .._log import log +from ..cmd import Command + + +class install_egg_info(Command): + """Install an .egg-info file for the package""" + + description = "Install package's PKG-INFO metadata as an .egg-info file" + user_options: ClassVar[list[tuple[str, str, str]]] = [ + ('install-dir=', 'd', "directory to install to"), + ] + + def initialize_options(self): + self.install_dir = None + + @property + def basename(self): + """ + Allow basename to be overridden by child class. + Ref pypa/distutils#2. + """ + name = to_filename(safe_name(self.distribution.get_name())) + version = to_filename(safe_version(self.distribution.get_version())) + return f"{name}-{version}-py{sys.version_info.major}.{sys.version_info.minor}.egg-info" + + def finalize_options(self): + self.set_undefined_options('install_lib', ('install_dir', 'install_dir')) + self.target = os.path.join(self.install_dir, self.basename) + self.outputs = [self.target] + + def run(self): + target = self.target + if os.path.isdir(target) and not os.path.islink(target): + dir_util.remove_tree(target, dry_run=self.dry_run) + elif os.path.exists(target): + self.execute(os.unlink, (self.target,), "Removing " + target) + elif not os.path.isdir(self.install_dir): + self.execute( + os.makedirs, (self.install_dir,), "Creating " + self.install_dir + ) + log.info("Writing %s", target) + if not self.dry_run: + with open(target, 'w', encoding='UTF-8') as f: + self.distribution.metadata.write_pkg_file(f) + + def get_outputs(self): + return self.outputs + + +# The following routines are taken from setuptools' pkg_resources module and +# can be replaced by importing them from pkg_resources once it is included +# in the stdlib. + + +def safe_name(name): + """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): + """Convert an arbitrary string to a standard version string + + Spaces become dots, and all other non-alphanumeric characters become + dashes, with runs of multiple dashes condensed to a single dash. + """ + version = version.replace(' ', '.') + return re.sub('[^A-Za-z0-9.]+', '-', version) + + +def to_filename(name): + """Convert a project or version name to its filename-escaped form + + Any '-' characters are currently replaced with '_'. + """ + return name.replace('-', '_') diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_headers.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_headers.py new file mode 100644 index 000000000..97af1371e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_headers.py @@ -0,0 +1,46 @@ +"""distutils.command.install_headers + +Implements the Distutils 'install_headers' command, to install C/C++ header +files to the Python include directory.""" + +from typing import ClassVar + +from ..core import Command + + +# XXX force is never used +class install_headers(Command): + description = "install C/C++ header files" + + user_options: ClassVar[list[tuple[str, str, str]]] = [ + ('install-dir=', 'd', "directory to install header files to"), + ('force', 'f', "force installation (overwrite existing files)"), + ] + + boolean_options: ClassVar[list[str]] = ['force'] + + def initialize_options(self): + self.install_dir = None + self.force = False + self.outfiles = [] + + def finalize_options(self): + self.set_undefined_options( + 'install', ('install_headers', 'install_dir'), ('force', 'force') + ) + + def run(self): + headers = self.distribution.headers + if not headers: + return + + self.mkpath(self.install_dir) + for header in headers: + (out, _) = self.copy_file(header, self.install_dir) + self.outfiles.append(out) + + def get_inputs(self): + return self.distribution.headers or [] + + def get_outputs(self): + return self.outfiles diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_lib.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_lib.py new file mode 100644 index 000000000..2aababf80 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_lib.py @@ -0,0 +1,238 @@ +"""distutils.command.install_lib + +Implements the Distutils 'install_lib' command +(install all Python modules).""" + +from __future__ import annotations + +import importlib.util +import os +import sys +from typing import Any, ClassVar + +from ..core import Command +from ..errors import DistutilsOptionError + +# Extension for Python source files. +PYTHON_SOURCE_EXTENSION = ".py" + + +class install_lib(Command): + description = "install all Python modules (extensions and pure Python)" + + # The byte-compilation options are a tad confusing. Here are the + # possible scenarios: + # 1) no compilation at all (--no-compile --no-optimize) + # 2) compile .pyc only (--compile --no-optimize; default) + # 3) compile .pyc and "opt-1" .pyc (--compile --optimize) + # 4) compile "opt-1" .pyc only (--no-compile --optimize) + # 5) compile .pyc and "opt-2" .pyc (--compile --optimize-more) + # 6) compile "opt-2" .pyc only (--no-compile --optimize-more) + # + # The UI for this is two options, 'compile' and 'optimize'. + # 'compile' is strictly boolean, and only decides whether to + # generate .pyc files. 'optimize' is three-way (0, 1, or 2), and + # decides both whether to generate .pyc files and what level of + # optimization to use. + + user_options = [ + ('install-dir=', 'd', "directory to install to"), + ('build-dir=', 'b', "build directory (where to install from)"), + ('force', 'f', "force installation (overwrite existing files)"), + ('compile', 'c', "compile .py to .pyc [default]"), + ('no-compile', None, "don't compile .py files"), + ( + 'optimize=', + 'O', + "also compile with optimization: -O1 for \"python -O\", " + "-O2 for \"python -OO\", and -O0 to disable [default: -O0]", + ), + ('skip-build', None, "skip the build steps"), + ] + + boolean_options: ClassVar[list[str]] = ['force', 'compile', 'skip-build'] + negative_opt: ClassVar[dict[str, str]] = {'no-compile': 'compile'} + + def initialize_options(self): + # let the 'install' command dictate our installation directory + self.install_dir = None + self.build_dir = None + self.force = False + self.compile = None + self.optimize = None + self.skip_build = None + + def finalize_options(self) -> None: + # Get all the information we need to install pure Python modules + # from the umbrella 'install' command -- build (source) directory, + # install (target) directory, and whether to compile .py files. + self.set_undefined_options( + 'install', + ('build_lib', 'build_dir'), + ('install_lib', 'install_dir'), + ('force', 'force'), + ('compile', 'compile'), + ('optimize', 'optimize'), + ('skip_build', 'skip_build'), + ) + + if self.compile is None: + self.compile = True + if self.optimize is None: + self.optimize = False + + if not isinstance(self.optimize, int): + try: + self.optimize = int(self.optimize) + except ValueError: + pass + if self.optimize not in (0, 1, 2): + raise DistutilsOptionError("optimize must be 0, 1, or 2") + + def run(self) -> None: + # Make sure we have built everything we need first + self.build() + + # Install everything: simply dump the entire contents of the build + # directory to the installation directory (that's the beauty of + # having a build directory!) + outfiles = self.install() + + # (Optionally) compile .py to .pyc + if outfiles is not None and self.distribution.has_pure_modules(): + self.byte_compile(outfiles) + + # -- Top-level worker functions ------------------------------------ + # (called from 'run()') + + def build(self) -> None: + if not self.skip_build: + if self.distribution.has_pure_modules(): + self.run_command('build_py') + if self.distribution.has_ext_modules(): + self.run_command('build_ext') + + # Any: https://typing.readthedocs.io/en/latest/guides/writing_stubs.html#the-any-trick + def install(self) -> list[str] | Any: + if os.path.isdir(self.build_dir): + outfiles = self.copy_tree(self.build_dir, self.install_dir) + else: + self.warn( + f"'{self.build_dir}' does not exist -- no Python modules to install" + ) + return + return outfiles + + def byte_compile(self, files) -> None: + if sys.dont_write_bytecode: + self.warn('byte-compiling is disabled, skipping.') + return + + from ..util import byte_compile + + # Get the "--root" directory supplied to the "install" command, + # and use it as a prefix to strip off the purported filename + # encoded in bytecode files. This is far from complete, but it + # should at least generate usable bytecode in RPM distributions. + install_root = self.get_finalized_command('install').root + + if self.compile: + byte_compile( + files, + optimize=0, + force=self.force, + prefix=install_root, + dry_run=self.dry_run, + ) + if self.optimize > 0: + byte_compile( + files, + optimize=self.optimize, + force=self.force, + prefix=install_root, + verbose=self.verbose, + dry_run=self.dry_run, + ) + + # -- Utility methods ----------------------------------------------- + + def _mutate_outputs(self, has_any, build_cmd, cmd_option, output_dir): + if not has_any: + return [] + + build_cmd = self.get_finalized_command(build_cmd) + build_files = build_cmd.get_outputs() + build_dir = getattr(build_cmd, cmd_option) + + prefix_len = len(build_dir) + len(os.sep) + outputs = [os.path.join(output_dir, file[prefix_len:]) for file in build_files] + + return outputs + + def _bytecode_filenames(self, py_filenames): + bytecode_files = [] + for py_file in py_filenames: + # Since build_py handles package data installation, the + # list of outputs can contain more than just .py files. + # Make sure we only report bytecode for the .py files. + ext = os.path.splitext(os.path.normcase(py_file))[1] + if ext != PYTHON_SOURCE_EXTENSION: + continue + if self.compile: + bytecode_files.append( + importlib.util.cache_from_source(py_file, optimization='') + ) + if self.optimize > 0: + bytecode_files.append( + importlib.util.cache_from_source( + py_file, optimization=self.optimize + ) + ) + + return bytecode_files + + # -- External interface -------------------------------------------- + # (called by outsiders) + + def get_outputs(self): + """Return the list of files that would be installed if this command + were actually run. Not affected by the "dry-run" flag or whether + modules have actually been built yet. + """ + pure_outputs = self._mutate_outputs( + self.distribution.has_pure_modules(), + 'build_py', + 'build_lib', + self.install_dir, + ) + if self.compile: + bytecode_outputs = self._bytecode_filenames(pure_outputs) + else: + bytecode_outputs = [] + + ext_outputs = self._mutate_outputs( + self.distribution.has_ext_modules(), + 'build_ext', + 'build_lib', + self.install_dir, + ) + + return pure_outputs + bytecode_outputs + ext_outputs + + def get_inputs(self): + """Get the list of files that are input to this command, ie. the + files that get installed as they are named in the build tree. + The files in this list correspond one-to-one to the output + filenames returned by 'get_outputs()'. + """ + inputs = [] + + if self.distribution.has_pure_modules(): + build_py = self.get_finalized_command('build_py') + inputs.extend(build_py.get_outputs()) + + if self.distribution.has_ext_modules(): + build_ext = self.get_finalized_command('build_ext') + inputs.extend(build_ext.get_outputs()) + + return inputs diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_scripts.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_scripts.py new file mode 100644 index 000000000..92e869411 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/install_scripts.py @@ -0,0 +1,62 @@ +"""distutils.command.install_scripts + +Implements the Distutils 'install_scripts' command, for installing +Python scripts.""" + +# contributed by Bastian Kleineidam + +import os +from distutils._log import log +from stat import ST_MODE +from typing import ClassVar + +from ..core import Command + + +class install_scripts(Command): + description = "install scripts (Python or otherwise)" + + user_options = [ + ('install-dir=', 'd', "directory to install scripts to"), + ('build-dir=', 'b', "build directory (where to install from)"), + ('force', 'f', "force installation (overwrite existing files)"), + ('skip-build', None, "skip the build steps"), + ] + + boolean_options: ClassVar[list[str]] = ['force', 'skip-build'] + + def initialize_options(self): + self.install_dir = None + self.force = False + self.build_dir = None + self.skip_build = None + + def finalize_options(self) -> None: + self.set_undefined_options('build', ('build_scripts', 'build_dir')) + self.set_undefined_options( + 'install', + ('install_scripts', 'install_dir'), + ('force', 'force'), + ('skip_build', 'skip_build'), + ) + + def run(self) -> None: + if not self.skip_build: + self.run_command('build_scripts') + self.outfiles = self.copy_tree(self.build_dir, self.install_dir) + if os.name == 'posix': + # Set the executable bits (owner, group, and world) on + # all the scripts we just installed. + for file in self.get_outputs(): + if self.dry_run: + log.info("changing mode of %s", file) + else: + mode = ((os.stat(file)[ST_MODE]) | 0o555) & 0o7777 + log.info("changing mode of %s to %o", file, mode) + os.chmod(file, mode) + + def get_inputs(self): + return self.distribution.scripts or [] + + def get_outputs(self): + return self.outfiles or [] diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/sdist.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/sdist.py new file mode 100644 index 000000000..b3bf0c326 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/command/sdist.py @@ -0,0 +1,521 @@ +"""distutils.command.sdist + +Implements the Distutils 'sdist' command (create a source distribution).""" + +from __future__ import annotations + +import os +import sys +from collections.abc import Callable +from distutils import archive_util, dir_util, file_util +from distutils._log import log +from glob import glob +from itertools import filterfalse +from typing import ClassVar + +from ..core import Command +from ..errors import DistutilsOptionError, DistutilsTemplateError +from ..filelist import FileList +from ..text_file import TextFile +from ..util import convert_path + + +def show_formats(): + """Print all possible values for the 'formats' option (used by + the "--help-formats" command-line option). + """ + from ..archive_util import ARCHIVE_FORMATS + from ..fancy_getopt import FancyGetopt + + formats = sorted( + ("formats=" + format, None, ARCHIVE_FORMATS[format][2]) + for format in ARCHIVE_FORMATS.keys() + ) + FancyGetopt(formats).print_help("List of available source distribution formats:") + + +class sdist(Command): + description = "create a source distribution (tarball, zip file, etc.)" + + def checking_metadata(self) -> bool: + """Callable used for the check sub-command. + + Placed here so user_options can view it""" + return self.metadata_check + + user_options = [ + ('template=', 't', "name of manifest template file [default: MANIFEST.in]"), + ('manifest=', 'm', "name of manifest file [default: MANIFEST]"), + ( + 'use-defaults', + None, + "include the default file set in the manifest " + "[default; disable with --no-defaults]", + ), + ('no-defaults', None, "don't include the default file set"), + ( + 'prune', + None, + "specifically exclude files/directories that should not be " + "distributed (build tree, RCS/CVS dirs, etc.) " + "[default; disable with --no-prune]", + ), + ('no-prune', None, "don't automatically exclude anything"), + ( + 'manifest-only', + 'o', + "just regenerate the manifest and then stop (implies --force-manifest)", + ), + ( + 'force-manifest', + 'f', + "forcibly regenerate the manifest and carry on as usual. " + "Deprecated: now the manifest is always regenerated.", + ), + ('formats=', None, "formats for source distribution (comma-separated list)"), + ( + 'keep-temp', + 'k', + "keep the distribution tree around after creating " + "archive file(s)", + ), + ( + 'dist-dir=', + 'd', + "directory to put the source distribution archive(s) in [default: dist]", + ), + ( + 'metadata-check', + None, + "Ensure that all required elements of meta-data " + "are supplied. Warn if any missing. [default]", + ), + ( + 'owner=', + 'u', + "Owner name used when creating a tar file [default: current user]", + ), + ( + 'group=', + 'g', + "Group name used when creating a tar file [default: current group]", + ), + ] + + boolean_options: ClassVar[list[str]] = [ + 'use-defaults', + 'prune', + 'manifest-only', + 'force-manifest', + 'keep-temp', + 'metadata-check', + ] + + help_options: ClassVar[list[tuple[str, str | None, str, Callable[[], object]]]] = [ + ('help-formats', None, "list available distribution formats", show_formats), + ] + + negative_opt: ClassVar[dict[str, str]] = { + 'no-defaults': 'use-defaults', + 'no-prune': 'prune', + } + + sub_commands = [('check', checking_metadata)] + + READMES: ClassVar[tuple[str, ...]] = ('README', 'README.txt', 'README.rst') + + def initialize_options(self): + # 'template' and 'manifest' are, respectively, the names of + # the manifest template and manifest file. + self.template = None + self.manifest = None + + # 'use_defaults': if true, we will include the default file set + # in the manifest + self.use_defaults = True + self.prune = True + + self.manifest_only = False + self.force_manifest = False + + self.formats = ['gztar'] + self.keep_temp = False + self.dist_dir = None + + self.archive_files = None + self.metadata_check = True + self.owner = None + self.group = None + + def finalize_options(self) -> None: + if self.manifest is None: + self.manifest = "MANIFEST" + if self.template is None: + self.template = "MANIFEST.in" + + self.ensure_string_list('formats') + + bad_format = archive_util.check_archive_formats(self.formats) + if bad_format: + raise DistutilsOptionError(f"unknown archive format '{bad_format}'") + + if self.dist_dir is None: + self.dist_dir = "dist" + + def run(self) -> None: + # 'filelist' contains the list of files that will make up the + # manifest + self.filelist = FileList() + + # Run sub commands + for cmd_name in self.get_sub_commands(): + self.run_command(cmd_name) + + # Do whatever it takes to get the list of files to process + # (process the manifest template, read an existing manifest, + # whatever). File list is accumulated in 'self.filelist'. + self.get_file_list() + + # If user just wanted us to regenerate the manifest, stop now. + if self.manifest_only: + return + + # Otherwise, go ahead and create the source distribution tarball, + # or zipfile, or whatever. + self.make_distribution() + + def get_file_list(self) -> None: + """Figure out the list of files to include in the source + distribution, and put it in 'self.filelist'. This might involve + reading the manifest template (and writing the manifest), or just + reading the manifest, or just using the default file set -- it all + depends on the user's options. + """ + # new behavior when using a template: + # the file list is recalculated every time because + # even if MANIFEST.in or setup.py are not changed + # the user might have added some files in the tree that + # need to be included. + # + # This makes --force the default and only behavior with templates. + template_exists = os.path.isfile(self.template) + if not template_exists and self._manifest_is_not_generated(): + self.read_manifest() + self.filelist.sort() + self.filelist.remove_duplicates() + return + + if not template_exists: + self.warn( + ("manifest template '%s' does not exist " + "(using default file list)") + % self.template + ) + self.filelist.findall() + + if self.use_defaults: + self.add_defaults() + + if template_exists: + self.read_template() + + if self.prune: + self.prune_file_list() + + self.filelist.sort() + self.filelist.remove_duplicates() + self.write_manifest() + + def add_defaults(self) -> None: + """Add all the default files to self.filelist: + - README or README.txt + - setup.py + - tests/test*.py and test/test*.py + - all pure Python modules mentioned in setup script + - all files pointed by package_data (build_py) + - all files defined in data_files. + - all files defined as scripts. + - all C sources listed as part of extensions or C libraries + in the setup script (doesn't catch C headers!) + Warns if (README or README.txt) or setup.py are missing; everything + else is optional. + """ + self._add_defaults_standards() + self._add_defaults_optional() + self._add_defaults_python() + self._add_defaults_data_files() + self._add_defaults_ext() + self._add_defaults_c_libs() + self._add_defaults_scripts() + + @staticmethod + def _cs_path_exists(fspath): + """ + Case-sensitive path existence check + + >>> sdist._cs_path_exists(__file__) + True + >>> sdist._cs_path_exists(__file__.upper()) + False + """ + if not os.path.exists(fspath): + return False + # make absolute so we always have a directory + abspath = os.path.abspath(fspath) + directory, filename = os.path.split(abspath) + return filename in os.listdir(directory) + + def _add_defaults_standards(self): + standards = [self.READMES, self.distribution.script_name] + for fn in standards: + if isinstance(fn, tuple): + alts = fn + got_it = False + for fn in alts: + if self._cs_path_exists(fn): + got_it = True + self.filelist.append(fn) + break + + if not got_it: + self.warn( + "standard file not found: should have one of " + ', '.join(alts) + ) + else: + if self._cs_path_exists(fn): + self.filelist.append(fn) + else: + self.warn(f"standard file '{fn}' not found") + + def _add_defaults_optional(self): + optional = ['tests/test*.py', 'test/test*.py', 'setup.cfg'] + for pattern in optional: + files = filter(os.path.isfile, glob(pattern)) + self.filelist.extend(files) + + def _add_defaults_python(self): + # build_py is used to get: + # - python modules + # - files defined in package_data + build_py = self.get_finalized_command('build_py') + + # getting python files + if self.distribution.has_pure_modules(): + self.filelist.extend(build_py.get_source_files()) + + # getting package_data files + # (computed in build_py.data_files by build_py.finalize_options) + for _pkg, src_dir, _build_dir, filenames in build_py.data_files: + for filename in filenames: + self.filelist.append(os.path.join(src_dir, filename)) + + def _add_defaults_data_files(self): + # getting distribution.data_files + if self.distribution.has_data_files(): + for item in self.distribution.data_files: + if isinstance(item, str): + # plain file + item = convert_path(item) + if os.path.isfile(item): + self.filelist.append(item) + else: + # a (dirname, filenames) tuple + dirname, filenames = item + for f in filenames: + f = convert_path(f) + if os.path.isfile(f): + self.filelist.append(f) + + def _add_defaults_ext(self): + if self.distribution.has_ext_modules(): + build_ext = self.get_finalized_command('build_ext') + self.filelist.extend(build_ext.get_source_files()) + + def _add_defaults_c_libs(self): + if self.distribution.has_c_libraries(): + build_clib = self.get_finalized_command('build_clib') + self.filelist.extend(build_clib.get_source_files()) + + def _add_defaults_scripts(self): + if self.distribution.has_scripts(): + build_scripts = self.get_finalized_command('build_scripts') + self.filelist.extend(build_scripts.get_source_files()) + + def read_template(self) -> None: + """Read and parse manifest template file named by self.template. + + (usually "MANIFEST.in") The parsing and processing is done by + 'self.filelist', which updates itself accordingly. + """ + log.info("reading manifest template '%s'", self.template) + template = TextFile( + self.template, + strip_comments=True, + skip_blanks=True, + join_lines=True, + lstrip_ws=True, + rstrip_ws=True, + collapse_join=True, + ) + + try: + while True: + line = template.readline() + if line is None: # end of file + break + + try: + self.filelist.process_template_line(line) + # the call above can raise a DistutilsTemplateError for + # malformed lines, or a ValueError from the lower-level + # convert_path function + except (DistutilsTemplateError, ValueError) as msg: + self.warn( + f"{template.filename}, line {int(template.current_line)}: {msg}" + ) + finally: + template.close() + + def prune_file_list(self) -> None: + """Prune off branches that might slip into the file list as created + by 'read_template()', but really don't belong there: + * the build tree (typically "build") + * the release tree itself (only an issue if we ran "sdist" + previously with --keep-temp, or it aborted) + * any RCS, CVS, .svn, .hg, .git, .bzr, _darcs directories + """ + build = self.get_finalized_command('build') + base_dir = self.distribution.get_fullname() + + self.filelist.exclude_pattern(None, prefix=os.fspath(build.build_base)) + self.filelist.exclude_pattern(None, prefix=base_dir) + + if sys.platform == 'win32': + seps = r'/|\\' + else: + seps = '/' + + vcs_dirs = ['RCS', 'CVS', r'\.svn', r'\.hg', r'\.git', r'\.bzr', '_darcs'] + vcs_ptrn = r'(^|{})({})({}).*'.format(seps, '|'.join(vcs_dirs), seps) + self.filelist.exclude_pattern(vcs_ptrn, is_regex=True) + + def write_manifest(self) -> None: + """Write the file list in 'self.filelist' (presumably as filled in + by 'add_defaults()' and 'read_template()') to the manifest file + named by 'self.manifest'. + """ + if self._manifest_is_not_generated(): + log.info( + f"not writing to manually maintained manifest file '{self.manifest}'" + ) + return + + content = self.filelist.files[:] + content.insert(0, '# file GENERATED by distutils, do NOT edit') + self.execute( + file_util.write_file, + (self.manifest, content), + f"writing manifest file '{self.manifest}'", + ) + + def _manifest_is_not_generated(self): + # check for special comment used in 3.1.3 and higher + if not os.path.isfile(self.manifest): + return False + + with open(self.manifest, encoding='utf-8') as fp: + first_line = next(fp) + return first_line != '# file GENERATED by distutils, do NOT edit\n' + + def read_manifest(self) -> None: + """Read the manifest file (named by 'self.manifest') and use it to + fill in 'self.filelist', the list of files to include in the source + distribution. + """ + log.info("reading manifest file '%s'", self.manifest) + with open(self.manifest, encoding='utf-8') as lines: + self.filelist.extend( + # ignore comments and blank lines + filter(None, filterfalse(is_comment, map(str.strip, lines))) + ) + + def make_release_tree(self, base_dir, files) -> None: + """Create the directory tree that will become the source + distribution archive. All directories implied by the filenames in + 'files' are created under 'base_dir', and then we hard link or copy + (if hard linking is unavailable) those files into place. + Essentially, this duplicates the developer's source tree, but in a + directory named after the distribution, containing only the files + to be distributed. + """ + # Create all the directories under 'base_dir' necessary to + # put 'files' there; the 'mkpath()' is just so we don't die + # if the manifest happens to be empty. + self.mkpath(base_dir) + dir_util.create_tree(base_dir, files, dry_run=self.dry_run) + + # And walk over the list of files, either making a hard link (if + # os.link exists) to each one that doesn't already exist in its + # corresponding location under 'base_dir', or copying each file + # that's out-of-date in 'base_dir'. (Usually, all files will be + # out-of-date, because by default we blow away 'base_dir' when + # we're done making the distribution archives.) + + if hasattr(os, 'link'): # can make hard links on this system + link = 'hard' + msg = f"making hard links in {base_dir}..." + else: # nope, have to copy + link = None + msg = f"copying files to {base_dir}..." + + if not files: + log.warning("no files to distribute -- empty manifest?") + else: + log.info(msg) + for file in files: + if not os.path.isfile(file): + log.warning("'%s' not a regular file -- skipping", file) + else: + dest = os.path.join(base_dir, file) + self.copy_file(file, dest, link=link) + + self.distribution.metadata.write_pkg_info(base_dir) + + def make_distribution(self) -> None: + """Create the source distribution(s). First, we create the release + tree with 'make_release_tree()'; then, we create all required + archive files (according to 'self.formats') from the release tree. + Finally, we clean up by blowing away the release tree (unless + 'self.keep_temp' is true). The list of archive files created is + stored so it can be retrieved later by 'get_archive_files()'. + """ + # Don't warn about missing meta-data here -- should be (and is!) + # done elsewhere. + base_dir = self.distribution.get_fullname() + base_name = os.path.join(self.dist_dir, base_dir) + + self.make_release_tree(base_dir, self.filelist.files) + archive_files = [] # remember names of files we create + # tar archive must be created last to avoid overwrite and remove + if 'tar' in self.formats: + self.formats.append(self.formats.pop(self.formats.index('tar'))) + + for fmt in self.formats: + file = self.make_archive( + base_name, fmt, base_dir=base_dir, owner=self.owner, group=self.group + ) + archive_files.append(file) + self.distribution.dist_files.append(('sdist', '', file)) + + self.archive_files = archive_files + + if not self.keep_temp: + dir_util.remove_tree(base_dir, dry_run=self.dry_run) + + def get_archive_files(self): + """Return the list of archive files created when the command + was run, or None if the command hasn't run yet. + """ + return self.archive_files + + +def is_comment(line: str) -> bool: + return line.startswith('#') diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compat/__init__.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compat/__init__.py new file mode 100644 index 000000000..2c43729b0 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compat/__init__.py @@ -0,0 +1,18 @@ +from __future__ import annotations + +from collections.abc import Iterable +from typing import TypeVar + +_IterableT = TypeVar("_IterableT", bound="Iterable[str]") + + +def consolidate_linker_args(args: _IterableT) -> _IterableT | str: + """ + Ensure the return value is a string for backward compatibility. + + Retain until at least 2025-04-31. See pypa/distutils#246 + """ + + if not all(arg.startswith('-Wl,') for arg in args): + return args + return '-Wl,' + ','.join(arg.removeprefix('-Wl,') for arg in args) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compat/__pycache__/__init__.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compat/__pycache__/__init__.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..7147f7f5f45710f30cd9b3008c9ed2e986e35de1 GIT binary patch literal 1340 zcmcIk&u<$=6rNeHoy4w_7J>?GB1QxbM)hufw3d*fTu4nTL{!xkNQP<|d&lvn_Rjn)r>#pkKDGaBk^b<`tc z>Y@r1;-}WY@9*N<|LoNP!wM>-J0E8W$i+~#B_q1Yh-A7gLvoYyHY0%|lt8jUxJnvA zk{YewSf|n_b} zQP&TYZiAVcnLl6ZJO70Q)3XIb!V-Wt5e6c<==yUAeSo`oZAi(}VtsT>#}{}DI{WEq z8^!pm)H>d=dUo+0er^Tm&MHl%R_lRo?pTTC%qA%+SC#28A-#{>rf4yja<<{V6BM zjkFM4x!$mRcfh0Tc|jOx&vT-r984GYri^E9G#c|>b{=bA203a zO7|z8y_372J9YQ=j78{ zfOO436-MD^@EUEHHRgHJOl~q!7o5YHGuMejYjtTFmSl7s!T3pYG4zA>v)n=QjM*?u z_C^<5!f$i7Bnd1{p~`^YQyAk1=%q*K}_nU zx3v&E;kv7wMbClx<~PH9@VyNN8;t7pMb=L=Kl)`^$sf#j2_BhZid*LRl)Ge_aMmVS z`qlqrNw-rdeJvXsiwc}KRtN01mRM9)B961P+g_e9Kh8^uI;7+eD!a8N*)VN9VopR1U+31~(!Yb`Q D?RQ?X literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compat/__pycache__/py39.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compat/__pycache__/py39.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..935473b7cc8716c3e0408d81c73887a31da492c9 GIT binary patch literal 2729 zcmaJ?U2Gd!6~1?7{O=_GOWG~l$TTHeLlfs`#cE--P^IZAsS=`1OS%?lH1S*~lZAUqJ66 z)q4x6J`#8+Hd!-4)emJI`Y9eQ{iWP zIh)0NY7Gfy{`SE&Am9W)XvFrXjOpE~l*#=6H(*Rj~-?;ZIU8$Z&$d z*kWPaMo{b3W_sDoleD6fwe(DBj+!eZYq9j?{M^v2sgmYu>f$B&eRI*Y(x973HAPPk zcUHQ#m@bs8Wz!fR9vw?F%_2huCA+FD!Pksf#e!v;I!ntP)6!WpUr;RgYW(ftLdl6L zswyAqCXc^OIivu>h>Zi;KnH&0iTpL%yBj@Mi=Nwwesz1a79HA{u1o%pF5kRdkDqS% zQMj)W0=9o5ug7};pP`iSjGOt4W7zR6XohOuV8<}Pxm*lzFx*Ea^eLYG6s0f?z@Blm zBxwlfEB`yXl3!GncWDB)C;2T8%S}YPV9LV3Gq^lH4w67V0;vS?{DRyPDkz6ld@GO< zE08}KX&ymwC&me7*mFdTF>V^EB|VH-Ws|K=tmCidYZDs-gaR zxThMQsU{|O<1@AR%pY%5;|sO$LS^Fb{;u1;n*Zch{LlW=ZVYJ*zD{|#nud}mvg`z9 zId7^(ov*{P%wyENaW!(fTKZ;*u7gpS_H!M$W53lh^qL$H~iE=wE`z)BhX+ zX}-$uk3o``l>zu4{20h(gaJTSr);&$P#Ifon4uN!t^XP}AjHNRzKbuS?|;cHSOTmf zuo7+2#zj!{j^E-L=8m@9O)LRAeva>BjP9J403E*+Z{UjZL|u3uO5B7yLE%|%`& zoB-rHb+g+Et!o8YHw{R7%QYI<+-n!oj!(`jbQMtGf!tp-9T7ye!`w_UCn0kYZYs!2 z#DHXgQbW&!euMC5?*sV<5AR-g;^XCw_x7TvcB6x}=-_ss8lC*zLM=MEk0ei`;;F|^ z?js>ET$!l%#O^Kq?+vsj zet;mR(yZH9o^iPVUXIa}*AXG#od7Y4dG3GWM$!=>Fizk~sX*M)#KD>)Xci!4Vyzd_U>06bH^`7{>^_`wCLwFx&ol6N8oAu2o49JyUyUW~2Ls-;4XVre7eK_7h&5*iUrf xbmI()_wB~c)M95IEIf^!-wj{@{{FjpScl1O1 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 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/__pycache__/cygwin.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/__pycache__/cygwin.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5151792c6ccd13a0ba8a97590052e6619d073f2f GIT binary patch literal 11833 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 N!CCh@(6*3n|1YtWT$lg= literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/__pycache__/errors.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/__pycache__/errors.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..9c01e5bf6178d200d66803f36aa8971b1bcebeff GIT binary patch literal 1543 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 P-`}o%t6jf;yYc@4Vay`1 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/__pycache__/unix.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/__pycache__/unix.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8bc2874a3526fc38bdd7f6d9081fb0f7887d66d8 GIT binary patch literal 15983 zcmb_@d2Ae4nqT#OUu@oINhC$K#KSTrOO_?s5=qIjWZF7>wdM3QyP8x}eQ>Lq64}%A zYIX&f%+5v>W_LyH4q$pSh&i!?Wr77(Ie>WVAR{3EbgN~s-6LaVtOLYA5YUna>rwtl ze&4I3n^ZgFAStq6y?XC^-#hBN-uJ%xFD{pz!}Xv4efYx9Uf{TYpa=Cb$r;^4PRDUK zIDrdtf=sV-n19d%_WP zu)HPiOt^wBmbb>;2~W_&^0v4);S2g$-X5<>_=A3ycf@NGb-_C1oq`K^>Vx$x?~d0e z8iEap#$aQjDcHoyJb-NuHYZwwEs54(E6TiAxnP^%L)tFXAnnj|$2q}&l@n^C^;0jX z(=OjXGRXNLKW7Nkg`d@PoDh@JGwE1d8kkAOW+RbQVmcO&igx>ODwz()k`kZ35anM( z-SDtd$4BB}N$TUnyfib;@_cH7FIT58gwy|3q^27AVIzC|M`JH?s91&9zFGMF$EAW?N=?i@SNHUy=zJ2IYI6f17rxI)? zxf$>^0%QQOWF$T#M0qJ179$sUAtpv6>693YO1v~3jl?Em8uk;YWNqTHaWPyKBpydy z1p%1t0$G}sbE@+PK&8XRFc$kG;t2gq{r}; ztfyk*a?W-NowIC&I#DkpGMJg};Sw?sBD#59TCL-zz)@STDMjp5mS@qf2?ZZ1m<9dC zUXBy%1;adqOP0&B+Dn}1%0eh*TpYKhT=!EKaG0{XW{#i*Q!_WAKg$Kong7KI)RzpAgita~ z$1bJP5;f!b$L|eZNF}0!;dpd*@a4Hz#ncoehBP>O_SOEeln|A3Cq|Bi&ZNdu=|RX& zh?8)9a6rp}>ISFh(ic+6p@H2`4@$9gw0}Arxfq^AYblzZnNFutacMB5iQYk#8>GSE zK@!6Q({m+zd2z)KjBOu&QUu8rZljiSxvz}gv)JCd{FBS;mWI5gVcD>JFzO*p9VcQ5#?FW6hO18XKSIq7?*A9X&+9Ph^B$&|AD6E){LGfQmMhX zIONBP^Li3)Sv>@k zjtMn=R-c5GHE)2Rf^F5zK};FK7NBA8>D&_nhM$pU!f|M*@#rKOAWRX`3szq_YljE2 zA1V}DVkVxBO+#}=QD zRFW52450Q60(%Mx_XxEQ6FEm) z&e$gNJsN5kX;NIehwp;R-vj4Ixu6dFC%vGUD&v+@)Y_Uk!OkRyS#V71qDH}S5S5eIBmK1wyDwMJD!79-!4tF# z-k?M91)W08tS;!n&mHtcJwfmH;Px}DR-rcN6Y9{q9<3XKo&|0~Cp2EQ25W4b`X_X% zxy^T>OK7@k3i^d+?6+!doX{<_T-62ZHbcoz!j30Pg&v_5?dyd$v~LjFkv0mwLdR8O zuu0(Y)EsRQwq4~uQWhoHDg=b>=%H!^&oVEk=pyze-&|zuKn4hA#Y`KK87BprJ;*P9w%C-dr zkAnUqMOTV-S-`=}_hk)Jjwd0rMio-0jA+6@+B4I0CYpfWp-o>Bt6AQyk%`MQBS&P` zuKCo7qa!EIWUS0|#)<{ZC6hEWjd$Xry%*af(e_GYuf{zYO^4*oS_lfRWJd>LS|SaM zcgXq#0;3d-PY_Kg8|9Ky&d$N46{S+GIFn4r6100G0HxH7Csdbgp%C*KghCQ^Ng|BD z!i1Q31kagzmAD5sjqd~0NmEF^yTX0F|Ioj+HHybYKt2~=*%Wo;S4V9)ABf7U)#IT8he46R9xoIoTd(Udi1 z?E;9bh0B^jSXJ9)%@u@YuSTS0gAQ1^DdtpDI#q77I;jSAdV!mPXp)>dE{%Pvd=dL- zvvXt}l5P%=;s7vtRG9KT?N#$rHEOPWpQn?M%hPSxOx`1KqvA#dWc9#Kn$;XIO5tGb6 zA<`s7Qnw{@bT%DL3MF%RdYbMgSeTKhNTQ%*PFy6$6loA5xd2KQa0Ts0!I#tF%Sn;s zfapUKaEYS?V3txdXkT)qX42C$Y4jYA0uOVMm7I!;OJ+S6dKSav=OCUgxs}Hhu`!X4ij$;*4Ko*K(`BL51|+ zkzlJ@!__yh*X_#J?OGjK+i|O}PGjxCR@?8>zafJeV@G!~nC7LG3+T{^vR@(V|k3UTl?xA!8>*5R-Rky%5^@2+<)l)#C+RPIB;&k{)Go^YrdjB zyw^@Hp8UD~ealVD`<|PgRY#$5&t2!<4Wq%uTb1z&11hViAXLYmk%@ulru+a|sg2QV`66q0~Nv{L?QO7{l%PeL{jZc*fk{E&GXf|E4L?SXzzeUjJDbY}hAv{VnR+Sr6 z8{7)b$(-03pT-nw(OqivF_J6Xz51?|bL-uE^WA&bE`QRV-}g$P{?!G?z2@H4+V#Mp zeBjWn%eUL}&%aS@Iq1Z`iNfi?zfnwf$@U zHR0B9?x`2@wJ&^fIA44Ew+6khX2Z()>IiK4xz&bz%TsH^w`y-mxuM~F%kU@3e9O7d zy|4YBNSZbpf4lprk^9w-Hl&{#ZAaS-pSm1J8x5Z}nvjoF8bO+Ne8A`$)S%D?uxJ-F zgF&U_^U!}VtKb-z()6MR2wKY;KGvzQ^JYM4##aTD4!TUyqvD?crV5p(i741rO^;1! zT1$ljooo70r97qutLQHDsA;dt_LDlsBXY`B(`$^UHSPhP+H!j}CvIb$TfN^Z@L99m zZ+X;n;LEaxn`%`tm+#n)DRAvKAFH(~y>TEt@zIdsw@oq@dIu zH%b>}-vr++@x3$C{pnOcx%C49Psz&^DA>wlSF*^6B(|rJ*_$j0k%*yW5~AZXlL0GZbumFjZe^6{l6n#^5O9)e9Hc2> z1e3rhc`7t6gJZl;)THvhy!-Y=pm1?qA)mpJ-J5CFM8FeuU!lG9ITENxGuP3%-aeFX zA6h$pD_CfMF>h^Iuq-v-Z*E_29?UlnuDNd?$TbfZnqOb=+;@1cJ-_(;^1hWqtqp$e zJo?=u3)i?4iqO}4uX+2*&|mfEYI{fz`g&zO_-S{?a2xkon{D_R!)H4j!@CWi?KUAF zabw!*MK4FzgV15$XH7#2Xm&D_7y5aek5rWxrmPwCsYsG}ch=49ZqvMZ-csJS!3hbd ztmz{~Z_aztn#9N&%aS6kZN~)dlx9M+X(dNlJC!$mf27MAf5NA=IaZSlQ+{>&=nAB5l-kY_FW^&MEz1SHTu`{q^pJ3OX z9M~s#r!+1vW6L^JerNJevy{sazh}0jLAG3&ha&aVJG0$&X>ww-Yl>Gg6}PGF6%R_5 z+&S~UtV=MlTus&|HfL)@CswBGN$6xZ%6C*LZ&KO-+tw@TK%1RgOKFcMaLwGjA1zaW z=z9`EjHCzE(yU*dDWl-p`MUIOt*&lUUHyDRMZ2n)H^Dc~H*JEiGVd+$&FLYn?}lu% zMt3dQ+H5_eo+g&IFv{_#_iE7otXG5fW7c#cwdKkJhT5rpl0HcvQh}xptGV)BFqi3C z(LQu!!7iqKTGP*|&)HTLFVjA)@3vNGAIn&#yQi#tdiVtSrN^UunEA+)ljQmzOC_Vs zQq1W4C)r+3HXdW>BEXANxG^t;NE)|fk4ZRxfQtp2F9RIyB_jeEq9xlor0ih0tdL5^ zsT5pVaY8^EMjWGrDJ`a|$i@(NAt~8M-y9u&?c9;0r$$AZsYuHxK0^sDwMcJ=9r&>` z9OlTCjasJdnB__$gsC>BvI1?g4XbJ{oJ2(AG5i6+G1YdAa>pro5ee-J>F_rs%_YWh z6v@ztZ&EcGyd^t3{s^U`iD_|~N`q8tg<4Z~ia3g5D%+`^lZ43qXIE4wISk?Lp_6-& zB$?(tOkx>vI8}ZQmvo^DXCoRy<7*y9awFo=thlt9?j?Dm>fWk%Ss@##`;1G|!Swh$ zG?kn%6`^+d?@_zOx~BEIo;+ORwzY$~Bd-1+S?l|8GixqT;Zzg6(R zv0%ODX#u1r9zv34sBlFwqpFy`GGTE-?uuOuitlT&nF$Z1E=%#rx%WY;i)ZlbS_UU zS(f$7z9q*Op4MXfuJTh`(c5steciqM?p^P|_u2&;`X*O5wgmjHkA=TU{4%jVa4e7i zj$=#CVjFf9`L^9l_HWHxW7oF^u7BUsx%Il?~*>z2&lI=R~Rm9F*eLwB|h-RmA)GZ(t|T_0N-UT&f%TcP`a@)Q_a z8(H5on%^^82pr4T?pQjq^oRF)cCU41^OSh0;? z8M^t_YDd0p|E*{8ZAX@lecc3q-I}G)w13HbU)~5UKeKW?-?Hm-Z{H(p6>Ft-2douW z_r3a#6~oVxId2zPE3WRx5-Gj^#0~eoXyk4iZ7;SNZo3>WHX3d>nvmag_DP!zX0AAq zp}>zUGw$J!)st)J)Gv`yc9Y}=C2)0TSfiS@s8AwLGA$Lvskup&%0p0)52>3g9JYQ- zk;P2T+9dKQ*mNkbZMgm=YAR1-tA(MI%@hQz7}0=T)x6l%8~|l=sM@Jb*;y#)X+c#n zJ&%*2to{WIDITSSd@0O3CN?7n&)5aT zV~~Rkp)3J|yvk;5(&3{PNtH@u^+6uU+;0iRq!8itYHO^Nynuz3P5>6$a9^|HBkn5r z1{cit{B<|>UEjCv@67u zVhu{jajY0n6n!|UzX%6~Xc8O%-R5BeOd+pRn$uJj{GW85sKQ^-nhwDdx zTfdMFPf9X;|CxXdR>hoDva0bdCASt5G(a(#;xhUdZ&LCXl$7~{#v3p(J`n$usx-)w z?}^DuG%+xT${x*C&SzAq)TwdI_XCX*6MX@kI9G1woSth37Y~wN$~jt=XYV+A{@!`= zD}HZ*-p)@r*5A5`Pg;qni1ZxCF#0- z!(^y+Z*T^e`;nV-)~!1_^N!Ay;{`|Gn(2;X?>+y{`(DIGwXGQP-p&n+vCsXGGuC=G zIHSu0cX4ei26H&)-1a0>6E%IG@P{oK7k>%>P5wjNZ<7Bw7?nl59F3T1&{lbKMFJ}; zUIV5lWj(!nHh>9PswfhGtIpZwb4Xoz>sw9MlRH;4>hBorin_xD1XR9*)zI!fZIx#9%P73buzIW~w-|DG+Uf6HL-nAKN1L=rS- z79y4`g0)$5v7g0Qpr>r%H7vQEu?`XzPl@0pioA)0lS%~f96~1fa2)YCNw|Rcvm++~ zf_R*s{ur2BOr_F20~(6qa6B@DXf`>XhF}SRk4^9h(Tr6DB`e`G)b&`3frk;x7G|+P zZ$=P^$nWdpk4#gv6R^m^L^!vlh;2R%7d8T@uf~9N_tLXe$pZqQod5PB|6V zFhnlU2$kS)^n^L%z$%H8FA))26!SHMg+RC}#t{i)tr7B|Tky3Fe0pM!LG^T^`;{_r5oh>s$&&l^FGcNfg zdGbbLI@)9|Mx)a-@dO}g>EtjdiZ4Yhlro#TO%Cqd24RiuG@0W129^>`xZ~Vr|2XvFl?i`wF$Y?$n-M8~(eoe?9iep~9Zixu;HVI5?aC+ZyiK zVck!~YnK-U+t(!wIWBfXsF5nipA<76J>2?Dm!+ktQf(Tt9;y8ZAVkh zHm$%{?a0Sec2sK`)tuI}(eLT6>S2zC$CB0p8?qKba~4BK88g4pDF18}DnRI$gGPz> zWhaa*4_T<`3_gOv_Zwx#!f{NPz9gAMWNh*Pe|&ft(h|~^%5b0$A;g5pCc!^PLDgEP zT6`$P-%d!+o$Mo@iZ6Qb8Ba=%gC!}!q7FzNL7XJ1zaEL-j!%N<44 zi~M@{ctyMj%!t6$4?HDaLRS12l#C)#IQEJhsr1-(5TBF4i6$P-^lP@<6AEMCV4P%% zba+4m|4U-x01$rn-zbvl0cWVQ!-IjSe3x(Cxh?P9w$iy~gbBLt-21HomA_*>|8X0y z%d|5&$Ip`b$5GSFxEi%AuijX|DgGHSBW5E!Ev`|{hHno<_O(ID0wAdL>8&Em0#z!^ zMA9WQv=E>vcm-eC;A;uYFRdJ!m5k)kkXIwg5JND9=tK+i127Q9a}nTdVG=<=R|htFAgCdA;ZpbKkz4r9sG!wt-5`II#9 zDlDc`v5V2SQSy%X8dbJcuLL~vJHJja{y0|mZTTyuchs6UQ1f^@t08PC##bV7hPsa* z7#Pq1-y{?`ClrT5IFDUmRl9E#%N+OD{jReN>;-^&ZQerG4(Re%*f?RtEr4ks5dqED} z+J!7Tj*zJ0*QojKDp#y+zVb2xwwl`D28Z9Zv32QEv8jF8Qf%F}ysuc_ynG^8x1-qH zvC@=l+Er|5S(+%e@GF5_a~~Qk?_GKs@mt?EIQ`};CpTI-tK+@wPqGxImBZ&r`|nsf zi`xP#_65fh4!PSNc)9xLuZ-c``O3@1mX4gU5x6LA-kviy6g#?e#@6EVFXoK+ucNdv zkn1~GZ0*Y#n~D}YLp^)P(ot+|UvL#WdU95{#Jh6VmSPLi#z#h{>Cnb@?wJF{9XpH9 zJzv~8P#hfE@N}BG?t6D^m~e*~R6n#~p&Y_wx;AW-vvUp4Za66C zzB95U?l2G*>8{keu<}t@K~uy?frSHq)St#Kuqe=CfA&X=Y>*u&K!Dx-$e%1bZL0m* zbB7Pnin1;ii@l=GoO|v$_nvbf=bU^0Eg1A8DF6D;!puLlBlPd2QY-E%^5kCtxs4<= zi6lyLsnjGT(GsJ&vh*ZPA;8@#lXXwJ0ryB=pnE1g4$cDIJL#p+G?ILuQULu9417vS z+{g4JyN4dE(tSV=5l;9LK0kcJQe@gyg@hJxp^Hdr`T$AIvS&6{Q+oG%kFMa8+@dSd zB796CBq@eDXDX_Z%Ik(G>e-y4%GmE8)-_X5G$U@#$ZF1To$h7Y7F7 zHGU%wZTa+-iB$aU85zrQ0sam7hKvQ(FDX+~K-0{)_-%o~xS*=lZnKVR{Z^ zD}(76!|;AxljE8!OQ4e;&&Y9cMmJo6>WM~rE`A&rPtq#52uI0vN0XUujHWnQO%Tb4l9Nnzbt6ebHcP- zw>Ewvb0|o7|9gIYux^?$ZCy$ zMHVeV**;^@5Or-znTAU9NNwFl7i4i1V;z45t4a8nIZauBFE?CSOs6ry7oHEx5Fi`34?+m3{LA) zQ#*cATga)3_8#EZr*-HyBV&S-5zZ@`3H@CY2S+YnP6V(I%);bI;s6000YL&n1cV8Q z5YR+GGXT)}x(Z9B-cZlW3#NGXY=YkLE17IkhXq|wcLD@oP({MDWyS0lAPGm@-H zvUF?#=GvW{5{zuV*_k}BN1n!lDN9Mg$oq)($>fEJ3wdWElF5r##>VnsusSHIs$;GQ zR@6)N%%UeVK>7#pIx+%pgC@P5>g=mbKyqgxK@sWuSupq(;y!N(4(p*N=x0Do|#P6V1Bn zXdRiY`QJJPAq(c>UX^!&D!A~WhCVzEj8$}&?591&a^0(H`JwCPD1!<#XhL?IQ!KjH zD!Jb42eYU}T0sRyVn)!9!J>j&qAkX9zYN?reGHP^b-L#ny0=be8|fCauU)j{B6BLy zHR~o|mMHiyQ1d9^8&A--Yk1hEhu?kIW-pISym8^`=m;h=fm;B;s`<#)c6NE*+42qw zK47;pFpv+{nFa=iPTB4Xzt{OdGwUG9#GPSr70$)t0O=8UeLOdUUwHWX7%<^=IQ5)9IY zY|iCOU001XUk|70x+3Y}H0YShE!u57n9MgS>==h)tL+g>DRS$rtZWIjPy0~(&#B~L(Z2*V`G90W)iboOZ`sSb+S3x{Y>E_6lR6pF_JvSuQxA zRUb(q3+;E7?p1rV5MSj)$gKN;StsAC4O;nHsCMQlv$8(zPhD?gfsXhS?qrT z`p*{O*M060_q}p3vN}>~?JvSF*zZUjDMpVpO3d6bOGjQR!ms=6L+;#ncJ(D0?s>v& zbBS#)vh8a}9y(cizME}0Y4Y=6o zE(q>88*-9K7HCmqBSO~cY@^Gc0a9H{Nx=qTkH;%3&;c&fRI)M;5g9{H009@1RfMgU zKRjH$y{5jK>DSPgL577@3b(9^EBSS{9iIn+Sa%grA-4)g!xTU#^3=1~{T!b})s99X zv>T&l8)F%CND6*w*BS2T3TNwCXN8|Y^M4+@p1VR88u}%Ym|xX1#zI*8tN-)y+%;RD zqnD?~*Ps`fQz(V-bF?D&yFJAU*ZRXzD}bA=z${s%J!O}RLKR1~^5S`mcl*v6`HDcGWWTLi2Na+0UNlnmq<}bIfwjlKbnPVl~xx zAhX%u-g++-qR>sqKW>@~;oT<$?7DUc5p8>hg6gwj*sQ-Ft+YU{b-I>ok(-Owv{{@ZjK9f2p*Wo z^MNe!YaRPwN%<76p!VA2M7`8{q z!BtZxbMa0fvJsfoOXnjF4-B9oFYecuwM{ z;9<b$6rLc0-l`sUQ%#{d7baI!gGBgh zSZn-L)6ERD=7V)tO6KPuiIf3e2vW_bz34!9sdcc}I(YYo8?9%TeVc*SQlRJaK+k5^ zp---TbnTNLee|QvNP8*LUyStM?cRvIRBk@Fc4_TDTiol3 zvm23fyTY9tk)daVy-as#dHgAdxX`ULD`#%KvhvDW>R}-9hj3Rp(p`$YSd6@QM|%`G z{pAbC)_abxh8}wm7cWN#wvi{;y-Jr4^?%m1W^E&PQ}^n{&Hkgm@qXt04fh#$f8xQl z2bX?(^+9T*|I&Kvi<{B*+w&jJ-+uqY_t*Q*Jc_n7CV;HG9jx9%L|IjNK0#Hs42eLmRjwl> zAH)PG@NfJzfNwrP_JNV5al7s0(iKQsR;QM(Y%>SlW7OB@X!pRjzscRZ-AB1Qwj!uC zR&H)9A80Rk^#Er%)KYHiAV^EJ+#35+*K3s9{}>VI*zJsy2-;qrmvj+sT;#mlsNxws zGI{khDhVLD%Q#se9wpf81dI_N5a8&1m0%>&J9g}_FIOh*75ukABL*5j1pv7WMLl)} zDCS8AqWu4f+P^^kU!dkMP<-3tZt-k$fmY9UjEi_4ABl6WC3bs^+Di_)mV7`)EpJlg zmILK*(_=3~Xj>r!)z+@H8|y87 None: + self.dry_run = dry_run + self.force = force + self.verbose = verbose + + # 'output_dir': a common output directory for object, library, + # shared object, and shared library files + self.output_dir: str | None = None + + # 'macros': a list of macro definitions (or undefinitions). A + # macro definition is a 2-tuple (name, value), where the value is + # either a string or None (no explicit value). A macro + # undefinition is a 1-tuple (name,). + self.macros: list[_Macro] = [] + + # 'include_dirs': a list of directories to search for include files + self.include_dirs = [] + + # 'libraries': a list of libraries to include in any link + # (library names, not filenames: eg. "foo" not "libfoo.a") + self.libraries: list[str] = [] + + # 'library_dirs': a list of directories to search for libraries + self.library_dirs = [] + + # 'runtime_library_dirs': a list of directories to search for + # shared libraries/objects at runtime + self.runtime_library_dirs: list[str] = [] + + # 'objects': a list of object files (or similar, such as explicitly + # named library files) to include on any link + self.objects: list[str] = [] + + for key in self.executables.keys(): + self.set_executable(key, self.executables[key]) + + def set_executables(self, **kwargs: str) -> None: + """Define the executables (and options for them) that will be run + to perform the various stages of compilation. The exact set of + executables that may be specified here depends on the compiler + class (via the 'executables' class attribute), but most will have: + compiler the C/C++ compiler + linker_so linker used to create shared objects and libraries + linker_exe linker used to create binary executables + archiver static library creator + + On platforms with a command-line (Unix, DOS/Windows), each of these + is a string that will be split into executable name and (optional) + list of arguments. (Splitting the string is done similarly to how + Unix shells operate: words are delimited by spaces, but quotes and + backslashes can override this. See + 'distutils.util.split_quoted()'.) + """ + + # Note that some CCompiler implementation classes will define class + # attributes 'cpp', 'cc', etc. with hard-coded executable names; + # this is appropriate when a compiler class is for exactly one + # compiler/OS combination (eg. MSVCCompiler). Other compiler + # classes (UnixCCompiler, in particular) are driven by information + # discovered at run-time, since there are many different ways to do + # basically the same things with Unix C compilers. + + for key in kwargs: + if key not in self.executables: + raise ValueError( + f"unknown executable '{key}' for class {self.__class__.__name__}" + ) + self.set_executable(key, kwargs[key]) + + def set_executable(self, key, value): + if isinstance(value, str): + setattr(self, key, split_quoted(value)) + else: + setattr(self, key, value) + + def _find_macro(self, name): + i = 0 + for defn in self.macros: + if defn[0] == name: + return i + i += 1 + return None + + def _check_macro_definitions(self, definitions): + """Ensure that every element of 'definitions' is valid.""" + for defn in definitions: + self._check_macro_definition(*defn) + + def _check_macro_definition(self, defn): + """ + Raise a TypeError if defn is not valid. + + A valid definition is either a (name, value) 2-tuple or a (name,) tuple. + """ + if not isinstance(defn, tuple) or not self._is_valid_macro(*defn): + raise TypeError( + f"invalid macro definition '{defn}': " + "must be tuple (string,), (string, string), or (string, None)" + ) + + @staticmethod + def _is_valid_macro(name, value=None): + """ + A valid macro is a ``name : str`` and a ``value : str | None``. + + >>> Compiler._is_valid_macro('foo', None) + True + """ + return isinstance(name, str) and isinstance(value, (str, type(None))) + + # -- Bookkeeping methods ------------------------------------------- + + def define_macro(self, name: str, value: str | None = None) -> None: + """Define a preprocessor macro for all compilations driven by this + compiler object. The optional parameter 'value' should be a + string; if it is not supplied, then the macro will be defined + without an explicit value and the exact outcome depends on the + compiler used (XXX true? does ANSI say anything about this?) + """ + # Delete from the list of macro definitions/undefinitions if + # already there (so that this one will take precedence). + i = self._find_macro(name) + if i is not None: + del self.macros[i] + + self.macros.append((name, value)) + + def undefine_macro(self, name: str) -> None: + """Undefine a preprocessor macro for all compilations driven by + this compiler object. If the same macro is defined by + 'define_macro()' and undefined by 'undefine_macro()' the last call + takes precedence (including multiple redefinitions or + undefinitions). If the macro is redefined/undefined on a + per-compilation basis (ie. in the call to 'compile()'), then that + takes precedence. + """ + # Delete from the list of macro definitions/undefinitions if + # already there (so that this one will take precedence). + i = self._find_macro(name) + if i is not None: + del self.macros[i] + + undefn = (name,) + self.macros.append(undefn) + + def add_include_dir(self, dir: str) -> None: + """Add 'dir' to the list of directories that will be searched for + header files. The compiler is instructed to search directories in + the order in which they are supplied by successive calls to + 'add_include_dir()'. + """ + self.include_dirs.append(dir) + + def set_include_dirs(self, dirs: list[str]) -> None: + """Set the list of directories that will be searched to 'dirs' (a + list of strings). Overrides any preceding calls to + 'add_include_dir()'; subsequence calls to 'add_include_dir()' add + to the list passed to 'set_include_dirs()'. This does not affect + any list of standard include directories that the compiler may + search by default. + """ + self.include_dirs = dirs[:] + + def add_library(self, libname: str) -> None: + """Add 'libname' to the list of libraries that will be included in + all links driven by this compiler object. Note that 'libname' + should *not* be the name of a file containing a library, but the + name of the library itself: the actual filename will be inferred by + the linker, the compiler, or the compiler class (depending on the + platform). + + The linker will be instructed to link against libraries in the + order they were supplied to 'add_library()' and/or + 'set_libraries()'. It is perfectly valid to duplicate library + names; the linker will be instructed to link against libraries as + many times as they are mentioned. + """ + self.libraries.append(libname) + + def set_libraries(self, libnames: list[str]) -> None: + """Set the list of libraries to be included in all links driven by + this compiler object to 'libnames' (a list of strings). This does + not affect any standard system libraries that the linker may + include by default. + """ + self.libraries = libnames[:] + + def add_library_dir(self, dir: str) -> None: + """Add 'dir' to the list of directories that will be searched for + libraries specified to 'add_library()' and 'set_libraries()'. The + linker will be instructed to search for libraries in the order they + are supplied to 'add_library_dir()' and/or 'set_library_dirs()'. + """ + self.library_dirs.append(dir) + + def set_library_dirs(self, dirs: list[str]) -> None: + """Set the list of library search directories to 'dirs' (a list of + strings). This does not affect any standard library search path + that the linker may search by default. + """ + self.library_dirs = dirs[:] + + def add_runtime_library_dir(self, dir: str) -> None: + """Add 'dir' to the list of directories that will be searched for + shared libraries at runtime. + """ + self.runtime_library_dirs.append(dir) + + def set_runtime_library_dirs(self, dirs: list[str]) -> None: + """Set the list of directories to search for shared libraries at + runtime to 'dirs' (a list of strings). This does not affect any + standard search path that the runtime linker may search by + default. + """ + self.runtime_library_dirs = dirs[:] + + def add_link_object(self, object: str) -> None: + """Add 'object' to the list of object files (or analogues, such as + explicitly named library files or the output of "resource + compilers") to be included in every link driven by this compiler + object. + """ + self.objects.append(object) + + def set_link_objects(self, objects: list[str]) -> None: + """Set the list of object files (or analogues) to be included in + every link to 'objects'. This does not affect any standard object + files that the linker may include by default (such as system + libraries). + """ + self.objects = objects[:] + + # -- Private utility methods -------------------------------------- + # (here for the convenience of subclasses) + + # Helper method to prep compiler in subclass compile() methods + + def _setup_compile( + self, + outdir: str | None, + macros: list[_Macro] | None, + incdirs: list[str] | tuple[str, ...] | None, + sources, + depends, + extra, + ): + """Process arguments and decide which source files to compile.""" + outdir, macros, incdirs = self._fix_compile_args(outdir, macros, incdirs) + + if extra is None: + extra = [] + + # Get the list of expected output (object) files + objects = self.object_filenames(sources, strip_dir=False, output_dir=outdir) + assert len(objects) == len(sources) + + pp_opts = gen_preprocess_options(macros, incdirs) + + build = {} + for i in range(len(sources)): + src = sources[i] + obj = objects[i] + ext = os.path.splitext(src)[1] + self.mkpath(os.path.dirname(obj)) + build[obj] = (src, ext) + + return macros, objects, extra, pp_opts, build + + def _get_cc_args(self, pp_opts, debug, before): + # works for unixccompiler, cygwinccompiler + cc_args = pp_opts + ['-c'] + if debug: + cc_args[:0] = ['-g'] + if before: + cc_args[:0] = before + return cc_args + + def _fix_compile_args( + self, + output_dir: str | None, + macros: list[_Macro] | None, + include_dirs: list[str] | tuple[str, ...] | None, + ) -> tuple[str, list[_Macro], list[str]]: + """Typecheck and fix-up some of the arguments to the 'compile()' + method, and return fixed-up values. Specifically: if 'output_dir' + is None, replaces it with 'self.output_dir'; ensures that 'macros' + is a list, and augments it with 'self.macros'; ensures that + 'include_dirs' is a list, and augments it with 'self.include_dirs'. + Guarantees that the returned values are of the correct type, + i.e. for 'output_dir' either string or None, and for 'macros' and + 'include_dirs' either list or None. + """ + if output_dir is None: + output_dir = self.output_dir + elif not isinstance(output_dir, str): + raise TypeError("'output_dir' must be a string or None") + + if macros is None: + macros = list(self.macros) + elif isinstance(macros, list): + macros = macros + (self.macros or []) + else: + raise TypeError("'macros' (if supplied) must be a list of tuples") + + if include_dirs is None: + include_dirs = list(self.include_dirs) + elif isinstance(include_dirs, (list, tuple)): + include_dirs = list(include_dirs) + (self.include_dirs or []) + else: + raise TypeError("'include_dirs' (if supplied) must be a list of strings") + + # add include dirs for class + include_dirs += self.__class__.include_dirs + + return output_dir, macros, include_dirs + + def _prep_compile(self, sources, output_dir, depends=None): + """Decide which source files must be recompiled. + + Determine the list of object files corresponding to 'sources', + and figure out which ones really need to be recompiled. + Return a list of all object files and a dictionary telling + which source files can be skipped. + """ + # Get the list of expected output (object) files + objects = self.object_filenames(sources, output_dir=output_dir) + assert len(objects) == len(sources) + + # Return an empty dict for the "which source files can be skipped" + # return value to preserve API compatibility. + return objects, {} + + def _fix_object_args( + self, objects: list[str] | tuple[str, ...], output_dir: str | None + ) -> tuple[list[str], str]: + """Typecheck and fix up some arguments supplied to various methods. + Specifically: ensure that 'objects' is a list; if output_dir is + None, replace with self.output_dir. Return fixed versions of + 'objects' and 'output_dir'. + """ + if not isinstance(objects, (list, tuple)): + raise TypeError("'objects' must be a list or tuple of strings") + objects = list(objects) + + if output_dir is None: + output_dir = self.output_dir + elif not isinstance(output_dir, str): + raise TypeError("'output_dir' must be a string or None") + + return (objects, output_dir) + + def _fix_lib_args( + self, + libraries: list[str] | tuple[str, ...] | None, + library_dirs: list[str] | tuple[str, ...] | None, + runtime_library_dirs: list[str] | tuple[str, ...] | None, + ) -> tuple[list[str], list[str], list[str]]: + """Typecheck and fix up some of the arguments supplied to the + 'link_*' methods. Specifically: ensure that all arguments are + lists, and augment them with their permanent versions + (eg. 'self.libraries' augments 'libraries'). Return a tuple with + fixed versions of all arguments. + """ + if libraries is None: + libraries = list(self.libraries) + elif isinstance(libraries, (list, tuple)): + libraries = list(libraries) + (self.libraries or []) + else: + raise TypeError("'libraries' (if supplied) must be a list of strings") + + if library_dirs is None: + library_dirs = list(self.library_dirs) + elif isinstance(library_dirs, (list, tuple)): + library_dirs = list(library_dirs) + (self.library_dirs or []) + else: + raise TypeError("'library_dirs' (if supplied) must be a list of strings") + + # add library dirs for class + library_dirs += self.__class__.library_dirs + + if runtime_library_dirs is None: + runtime_library_dirs = list(self.runtime_library_dirs) + elif isinstance(runtime_library_dirs, (list, tuple)): + runtime_library_dirs = list(runtime_library_dirs) + ( + self.runtime_library_dirs or [] + ) + else: + raise TypeError( + "'runtime_library_dirs' (if supplied) must be a list of strings" + ) + + return (libraries, library_dirs, runtime_library_dirs) + + def _need_link(self, objects, output_file): + """Return true if we need to relink the files listed in 'objects' + to recreate 'output_file'. + """ + if self.force: + return True + else: + if self.dry_run: + newer = newer_group(objects, output_file, missing='newer') + else: + newer = newer_group(objects, output_file) + return newer + + def detect_language(self, sources: str | list[str]) -> str | None: + """Detect the language of a given file, or list of files. Uses + language_map, and language_order to do the job. + """ + if not isinstance(sources, list): + sources = [sources] + lang = None + index = len(self.language_order) + for source in sources: + base, ext = os.path.splitext(source) + extlang = self.language_map.get(ext) + try: + extindex = self.language_order.index(extlang) + if extindex < index: + lang = extlang + index = extindex + except ValueError: + pass + return lang + + # -- Worker methods ------------------------------------------------ + # (must be implemented by subclasses) + + def preprocess( + self, + source: str | os.PathLike[str], + output_file: str | os.PathLike[str] | None = None, + macros: list[_Macro] | None = None, + include_dirs: list[str] | tuple[str, ...] | None = None, + extra_preargs: list[str] | None = None, + extra_postargs: Iterable[str] | None = None, + ): + """Preprocess a single C/C++ source file, named in 'source'. + Output will be written to file named 'output_file', or stdout if + 'output_file' not supplied. 'macros' is a list of macro + definitions as for 'compile()', which will augment the macros set + with 'define_macro()' and 'undefine_macro()'. 'include_dirs' is a + list of directory names that will be added to the default list. + + Raises PreprocessError on failure. + """ + pass + + def compile( + self, + sources: Sequence[str | os.PathLike[str]], + output_dir: str | None = None, + macros: list[_Macro] | None = None, + include_dirs: list[str] | tuple[str, ...] | None = None, + debug: bool = False, + extra_preargs: list[str] | None = None, + extra_postargs: list[str] | None = None, + depends: list[str] | tuple[str, ...] | None = None, + ) -> list[str]: + """Compile one or more source files. + + 'sources' must be a list of filenames, most likely C/C++ + files, but in reality anything that can be handled by a + particular compiler and compiler class (eg. MSVCCompiler can + handle resource files in 'sources'). Return a list of object + filenames, one per source filename in 'sources'. Depending on + the implementation, not all source files will necessarily be + compiled, but all corresponding object filenames will be + returned. + + If 'output_dir' is given, object files will be put under it, while + retaining their original path component. That is, "foo/bar.c" + normally compiles to "foo/bar.o" (for a Unix implementation); if + 'output_dir' is "build", then it would compile to + "build/foo/bar.o". + + 'macros', if given, must be a list of macro definitions. A macro + definition is either a (name, value) 2-tuple or a (name,) 1-tuple. + The former defines a macro; if the value is None, the macro is + defined without an explicit value. The 1-tuple case undefines a + macro. Later definitions/redefinitions/ undefinitions take + precedence. + + 'include_dirs', if given, must be a list of strings, the + directories to add to the default include file search path for this + compilation only. + + 'debug' is a boolean; if true, the compiler will be instructed to + output debug symbols in (or alongside) the object file(s). + + 'extra_preargs' and 'extra_postargs' are implementation- dependent. + On platforms that have the notion of a command-line (e.g. Unix, + DOS/Windows), they are most likely lists of strings: extra + command-line arguments to prepend/append to the compiler command + line. On other platforms, consult the implementation class + documentation. In any event, they are intended as an escape hatch + for those occasions when the abstract compiler framework doesn't + cut the mustard. + + 'depends', if given, is a list of filenames that all targets + depend on. If a source file is older than any file in + depends, then the source file will be recompiled. This + supports dependency tracking, but only at a coarse + granularity. + + Raises CompileError on failure. + """ + # A concrete compiler class can either override this method + # entirely or implement _compile(). + macros, objects, extra_postargs, pp_opts, build = self._setup_compile( + output_dir, macros, include_dirs, sources, depends, extra_postargs + ) + cc_args = self._get_cc_args(pp_opts, debug, extra_preargs) + + for obj in objects: + try: + src, ext = build[obj] + except KeyError: + continue + self._compile(obj, src, ext, cc_args, extra_postargs, pp_opts) + + # Return *all* object filenames, not just the ones we just built. + return objects + + def _compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts): + """Compile 'src' to product 'obj'.""" + # A concrete compiler class that does not override compile() + # should implement _compile(). + pass + + def create_static_lib( + self, + objects: list[str] | tuple[str, ...], + output_libname: str, + output_dir: str | None = None, + debug: bool = False, + target_lang: str | None = None, + ) -> None: + """Link a bunch of stuff together to create a static library file. + The "bunch of stuff" consists of the list of object files supplied + as 'objects', the extra object files supplied to + 'add_link_object()' and/or 'set_link_objects()', the libraries + supplied to 'add_library()' and/or 'set_libraries()', and the + libraries supplied as 'libraries' (if any). + + 'output_libname' should be a library name, not a filename; the + filename will be inferred from the library name. 'output_dir' is + the directory where the library file will be put. + + 'debug' is a boolean; if true, debugging information will be + included in the library (note that on most platforms, it is the + compile step where this matters: the 'debug' flag is included here + just for consistency). + + 'target_lang' is the target language for which the given objects + are being compiled. This allows specific linkage time treatment of + certain languages. + + Raises LibError on failure. + """ + pass + + # values for target_desc parameter in link() + SHARED_OBJECT = "shared_object" + SHARED_LIBRARY = "shared_library" + EXECUTABLE = "executable" + + def link( + self, + target_desc: str, + objects: list[str] | tuple[str, ...], + output_filename: str, + output_dir: str | None = None, + libraries: list[str] | tuple[str, ...] | None = None, + library_dirs: list[str] | tuple[str, ...] | None = None, + runtime_library_dirs: list[str] | tuple[str, ...] | None = None, + export_symbols: Iterable[str] | None = None, + debug: bool = False, + extra_preargs: list[str] | None = None, + extra_postargs: list[str] | None = None, + build_temp: str | os.PathLike[str] | None = None, + target_lang: str | None = None, + ): + """Link a bunch of stuff together to create an executable or + shared library file. + + The "bunch of stuff" consists of the list of object files supplied + as 'objects'. 'output_filename' should be a filename. If + 'output_dir' is supplied, 'output_filename' is relative to it + (i.e. 'output_filename' can provide directory components if + needed). + + 'libraries' is a list of libraries to link against. These are + library names, not filenames, since they're translated into + filenames in a platform-specific way (eg. "foo" becomes "libfoo.a" + on Unix and "foo.lib" on DOS/Windows). However, they can include a + directory component, which means the linker will look in that + specific directory rather than searching all the normal locations. + + 'library_dirs', if supplied, should be a list of directories to + search for libraries that were specified as bare library names + (ie. no directory component). These are on top of the system + default and those supplied to 'add_library_dir()' and/or + 'set_library_dirs()'. 'runtime_library_dirs' is a list of + directories that will be embedded into the shared library and used + to search for other shared libraries that *it* depends on at + run-time. (This may only be relevant on Unix.) + + 'export_symbols' is a list of symbols that the shared library will + export. (This appears to be relevant only on Windows.) + + 'debug' is as for 'compile()' and 'create_static_lib()', with the + slight distinction that it actually matters on most platforms (as + opposed to 'create_static_lib()', which includes a 'debug' flag + mostly for form's sake). + + 'extra_preargs' and 'extra_postargs' are as for 'compile()' (except + of course that they supply command-line arguments for the + particular linker being used). + + 'target_lang' is the target language for which the given objects + are being compiled. This allows specific linkage time treatment of + certain languages. + + Raises LinkError on failure. + """ + raise NotImplementedError + + # Old 'link_*()' methods, rewritten to use the new 'link()' method. + + def link_shared_lib( + self, + objects: list[str] | tuple[str, ...], + output_libname: str, + output_dir: str | None = None, + libraries: list[str] | tuple[str, ...] | None = None, + library_dirs: list[str] | tuple[str, ...] | None = None, + runtime_library_dirs: list[str] | tuple[str, ...] | None = None, + export_symbols: Iterable[str] | None = None, + debug: bool = False, + extra_preargs: list[str] | None = None, + extra_postargs: list[str] | None = None, + build_temp: str | os.PathLike[str] | None = None, + target_lang: str | None = None, + ): + self.link( + Compiler.SHARED_LIBRARY, + objects, + self.library_filename(output_libname, lib_type='shared'), + output_dir, + libraries, + library_dirs, + runtime_library_dirs, + export_symbols, + debug, + extra_preargs, + extra_postargs, + build_temp, + target_lang, + ) + + def link_shared_object( + self, + objects: list[str] | tuple[str, ...], + output_filename: str, + output_dir: str | None = None, + libraries: list[str] | tuple[str, ...] | None = None, + library_dirs: list[str] | tuple[str, ...] | None = None, + runtime_library_dirs: list[str] | tuple[str, ...] | None = None, + export_symbols: Iterable[str] | None = None, + debug: bool = False, + extra_preargs: list[str] | None = None, + extra_postargs: list[str] | None = None, + build_temp: str | os.PathLike[str] | None = None, + target_lang: str | None = None, + ): + self.link( + Compiler.SHARED_OBJECT, + objects, + output_filename, + output_dir, + libraries, + library_dirs, + runtime_library_dirs, + export_symbols, + debug, + extra_preargs, + extra_postargs, + build_temp, + target_lang, + ) + + def link_executable( + self, + objects: list[str] | tuple[str, ...], + output_progname: str, + output_dir: str | None = None, + libraries: list[str] | tuple[str, ...] | None = None, + library_dirs: list[str] | tuple[str, ...] | None = None, + runtime_library_dirs: list[str] | tuple[str, ...] | None = None, + debug: bool = False, + extra_preargs: list[str] | None = None, + extra_postargs: list[str] | None = None, + target_lang: str | None = None, + ): + self.link( + Compiler.EXECUTABLE, + objects, + self.executable_filename(output_progname), + output_dir, + libraries, + library_dirs, + runtime_library_dirs, + None, + debug, + extra_preargs, + extra_postargs, + None, + target_lang, + ) + + # -- Miscellaneous methods ----------------------------------------- + # These are all used by the 'gen_lib_options() function; there is + # no appropriate default implementation so subclasses should + # implement all of these. + + def library_dir_option(self, dir: str) -> str: + """Return the compiler option to add 'dir' to the list of + directories searched for libraries. + """ + raise NotImplementedError + + def runtime_library_dir_option(self, dir: str) -> str: + """Return the compiler option to add 'dir' to the list of + directories searched for runtime libraries. + """ + raise NotImplementedError + + def library_option(self, lib: str) -> str: + """Return the compiler option to add 'lib' to the list of libraries + linked into the shared library or executable. + """ + raise NotImplementedError + + def has_function( # noqa: C901 + self, + funcname: str, + includes: Iterable[str] | None = None, + include_dirs: list[str] | tuple[str, ...] | None = None, + libraries: list[str] | None = None, + library_dirs: list[str] | tuple[str, ...] | None = None, + ) -> bool: + """Return a boolean indicating whether funcname is provided as + a symbol on the current platform. The optional arguments can + be used to augment the compilation environment. + + The libraries argument is a list of flags to be passed to the + linker to make additional symbol definitions available for + linking. + + The includes and include_dirs arguments are deprecated. + Usually, supplying include files with function declarations + will cause function detection to fail even in cases where the + symbol is available for linking. + + """ + # this can't be included at module scope because it tries to + # import math which might not be available at that point - maybe + # the necessary logic should just be inlined? + import tempfile + + if includes is None: + includes = [] + else: + warnings.warn("includes is deprecated", DeprecationWarning) + if include_dirs is None: + include_dirs = [] + else: + warnings.warn("include_dirs is deprecated", DeprecationWarning) + if libraries is None: + libraries = [] + if library_dirs is None: + library_dirs = [] + fd, fname = tempfile.mkstemp(".c", funcname, text=True) + with os.fdopen(fd, "w", encoding='utf-8') as f: + for incl in includes: + f.write(f"""#include "{incl}"\n""") + if not includes: + # Use "char func(void);" as the prototype to follow + # what autoconf does. This prototype does not match + # any well-known function the compiler might recognize + # as a builtin, so this ends up as a true link test. + # Without a fake prototype, the test would need to + # know the exact argument types, and the has_function + # interface does not provide that level of information. + f.write( + f"""\ +#ifdef __cplusplus +extern "C" +#endif +char {funcname}(void); +""" + ) + f.write( + f"""\ +int main (int argc, char **argv) {{ + {funcname}(); + return 0; +}} +""" + ) + + try: + objects = self.compile([fname], include_dirs=include_dirs) + except CompileError: + return False + finally: + os.remove(fname) + + try: + self.link_executable( + objects, "a.out", libraries=libraries, library_dirs=library_dirs + ) + except (LinkError, TypeError): + return False + else: + os.remove( + self.executable_filename("a.out", output_dir=self.output_dir or '') + ) + finally: + for fn in objects: + os.remove(fn) + return True + + def find_library_file( + self, dirs: Iterable[str], lib: str, debug: bool = False + ) -> str | None: + """Search the specified list of directories for a static or shared + library file 'lib' and return the full path to that file. If + 'debug' true, look for a debugging version (if that makes sense on + the current platform). Return None if 'lib' wasn't found in any of + the specified directories. + """ + raise NotImplementedError + + # -- Filename generation methods ----------------------------------- + + # The default implementation of the filename generating methods are + # prejudiced towards the Unix/DOS/Windows view of the world: + # * object files are named by replacing the source file extension + # (eg. .c/.cpp -> .o/.obj) + # * library files (shared or static) are named by plugging the + # library name and extension into a format string, eg. + # "lib%s.%s" % (lib_name, ".a") for Unix static libraries + # * executables are named by appending an extension (possibly + # empty) to the program name: eg. progname + ".exe" for + # Windows + # + # To reduce redundant code, these methods expect to find + # several attributes in the current object (presumably defined + # as class attributes): + # * src_extensions - + # list of C/C++ source file extensions, eg. ['.c', '.cpp'] + # * obj_extension - + # object file extension, eg. '.o' or '.obj' + # * static_lib_extension - + # extension for static library files, eg. '.a' or '.lib' + # * shared_lib_extension - + # extension for shared library/object files, eg. '.so', '.dll' + # * static_lib_format - + # format string for generating static library filenames, + # eg. 'lib%s.%s' or '%s.%s' + # * shared_lib_format + # format string for generating shared library filenames + # (probably same as static_lib_format, since the extension + # is one of the intended parameters to the format string) + # * exe_extension - + # extension for executable files, eg. '' or '.exe' + + def object_filenames( + self, + source_filenames: Iterable[str | os.PathLike[str]], + strip_dir: bool = False, + output_dir: str | os.PathLike[str] | None = '', + ) -> list[str]: + if output_dir is None: + output_dir = '' + return list( + self._make_out_path(output_dir, strip_dir, src_name) + for src_name in source_filenames + ) + + @property + def out_extensions(self): + return dict.fromkeys(self.src_extensions, self.obj_extension) + + def _make_out_path(self, output_dir, strip_dir, src_name): + return self._make_out_path_exts( + output_dir, strip_dir, src_name, self.out_extensions + ) + + @classmethod + def _make_out_path_exts(cls, output_dir, strip_dir, src_name, extensions): + r""" + >>> exts = {'.c': '.o'} + >>> Compiler._make_out_path_exts('.', False, '/foo/bar.c', exts).replace('\\', '/') + './foo/bar.o' + >>> Compiler._make_out_path_exts('.', True, '/foo/bar.c', exts).replace('\\', '/') + './bar.o' + """ + src = pathlib.PurePath(src_name) + # Ensure base is relative to honor output_dir (python/cpython#37775). + base = cls._make_relative(src) + try: + new_ext = extensions[src.suffix] + except LookupError: + raise UnknownFileType(f"unknown file type '{src.suffix}' (from '{src}')") + if strip_dir: + base = pathlib.PurePath(base.name) + return os.path.join(output_dir, base.with_suffix(new_ext)) + + @staticmethod + def _make_relative(base: pathlib.Path): + return base.relative_to(base.anchor) + + @overload + def shared_object_filename( + self, + basename: str, + strip_dir: Literal[False] = False, + output_dir: str | os.PathLike[str] = "", + ) -> str: ... + @overload + def shared_object_filename( + self, + basename: str | os.PathLike[str], + strip_dir: Literal[True], + output_dir: str | os.PathLike[str] = "", + ) -> str: ... + def shared_object_filename( + self, + basename: str | os.PathLike[str], + strip_dir: bool = False, + output_dir: str | os.PathLike[str] = '', + ) -> str: + assert output_dir is not None + if strip_dir: + basename = os.path.basename(basename) + return os.path.join(output_dir, basename + self.shared_lib_extension) + + @overload + def executable_filename( + self, + basename: str, + strip_dir: Literal[False] = False, + output_dir: str | os.PathLike[str] = "", + ) -> str: ... + @overload + def executable_filename( + self, + basename: str | os.PathLike[str], + strip_dir: Literal[True], + output_dir: str | os.PathLike[str] = "", + ) -> str: ... + def executable_filename( + self, + basename: str | os.PathLike[str], + strip_dir: bool = False, + output_dir: str | os.PathLike[str] = '', + ) -> str: + assert output_dir is not None + if strip_dir: + basename = os.path.basename(basename) + return os.path.join(output_dir, basename + (self.exe_extension or '')) + + def library_filename( + self, + libname: str, + lib_type: str = "static", + strip_dir: bool = False, + output_dir: str | os.PathLike[str] = "", # or 'shared' + ): + assert output_dir is not None + expected = '"static", "shared", "dylib", "xcode_stub"' + if lib_type not in eval(expected): + raise ValueError(f"'lib_type' must be {expected}") + fmt = getattr(self, lib_type + "_lib_format") + ext = getattr(self, lib_type + "_lib_extension") + + dir, base = os.path.split(libname) + filename = fmt % (base, ext) + if strip_dir: + dir = '' + + return os.path.join(output_dir, dir, filename) + + # -- Utility methods ----------------------------------------------- + + def announce(self, msg: object, level: int = 1) -> None: + log.debug(msg) + + def debug_print(self, msg: object) -> None: + from distutils.debug import DEBUG + + if DEBUG: + print(msg) + + def warn(self, msg: object) -> None: + sys.stderr.write(f"warning: {msg}\n") + + def execute( + self, + func: Callable[[Unpack[_Ts]], object], + args: tuple[Unpack[_Ts]], + msg: object = None, + level: int = 1, + ) -> None: + execute(func, args, msg, self.dry_run) + + def spawn( + self, cmd: MutableSequence[bytes | str | os.PathLike[str]], **kwargs + ) -> None: + spawn(cmd, dry_run=self.dry_run, **kwargs) + + @overload + def move_file( + self, src: str | os.PathLike[str], dst: _StrPathT + ) -> _StrPathT | str: ... + @overload + def move_file( + self, src: bytes | os.PathLike[bytes], dst: _BytesPathT + ) -> _BytesPathT | bytes: ... + def move_file( + self, + src: str | os.PathLike[str] | bytes | os.PathLike[bytes], + dst: str | os.PathLike[str] | bytes | os.PathLike[bytes], + ) -> str | os.PathLike[str] | bytes | os.PathLike[bytes]: + return move_file(src, dst, dry_run=self.dry_run) + + def mkpath(self, name, mode=0o777): + mkpath(name, mode, dry_run=self.dry_run) + + +# Map a sys.platform/os.name ('posix', 'nt') to the default compiler +# type for that platform. Keys are interpreted as re match +# patterns. Order is important; platform mappings are preferred over +# OS names. +_default_compilers = ( + # Platform string mappings + # on a cygwin built python we can use gcc like an ordinary UNIXish + # compiler + ('cygwin.*', 'unix'), + ('zos', 'zos'), + # OS name mappings + ('posix', 'unix'), + ('nt', 'msvc'), +) + + +def get_default_compiler(osname: str | None = None, platform: str | None = None) -> str: + """Determine the default compiler to use for the given platform. + + osname should be one of the standard Python OS names (i.e. the + ones returned by os.name) and platform the common value + returned by sys.platform for the platform in question. + + The default values are os.name and sys.platform in case the + parameters are not given. + """ + if osname is None: + osname = os.name + if platform is None: + platform = sys.platform + # Mingw is a special case where sys.platform is 'win32' but we + # want to use the 'mingw32' compiler, so check it first + if is_mingw(): + return 'mingw32' + for pattern, compiler in _default_compilers: + if ( + re.match(pattern, platform) is not None + or re.match(pattern, osname) is not None + ): + return compiler + # Default to Unix compiler + return 'unix' + + +# Map compiler types to (module_name, class_name) pairs -- ie. where to +# find the code that implements an interface to this compiler. (The module +# is assumed to be in the 'distutils' package.) +compiler_class = { + 'unix': ('unixccompiler', 'UnixCCompiler', "standard UNIX-style compiler"), + 'msvc': ('_msvccompiler', 'MSVCCompiler', "Microsoft Visual C++"), + 'cygwin': ( + 'cygwinccompiler', + 'CygwinCCompiler', + "Cygwin port of GNU C Compiler for Win32", + ), + 'mingw32': ( + 'cygwinccompiler', + 'Mingw32CCompiler', + "Mingw32 port of GNU C Compiler for Win32", + ), + 'bcpp': ('bcppcompiler', 'BCPPCompiler', "Borland C++ Compiler"), + 'zos': ('zosccompiler', 'zOSCCompiler', 'IBM XL C/C++ Compilers'), +} + + +def show_compilers() -> None: + """Print list of available compilers (used by the "--help-compiler" + options to "build", "build_ext", "build_clib"). + """ + # XXX this "knows" that the compiler option it's describing is + # "--compiler", which just happens to be the case for the three + # commands that use it. + from distutils.fancy_getopt import FancyGetopt + + compilers = sorted( + ("compiler=" + compiler, None, compiler_class[compiler][2]) + for compiler in compiler_class.keys() + ) + pretty_printer = FancyGetopt(compilers) + pretty_printer.print_help("List of available compilers:") + + +def new_compiler( + plat: str | None = None, + compiler: str | None = None, + verbose: bool = False, + dry_run: bool = False, + force: bool = False, +) -> Compiler: + """Generate an instance of some CCompiler subclass for the supplied + platform/compiler combination. 'plat' defaults to 'os.name' + (eg. 'posix', 'nt'), and 'compiler' defaults to the default compiler + for that platform. Currently only 'posix' and 'nt' are supported, and + the default compilers are "traditional Unix interface" (UnixCCompiler + class) and Visual C++ (MSVCCompiler class). Note that it's perfectly + possible to ask for a Unix compiler object under Windows, and a + Microsoft compiler object under Unix -- if you supply a value for + 'compiler', 'plat' is ignored. + """ + if plat is None: + plat = os.name + + try: + if compiler is None: + compiler = get_default_compiler(plat) + + (module_name, class_name, long_description) = compiler_class[compiler] + except KeyError: + msg = f"don't know how to compile C/C++ code on platform '{plat}'" + if compiler is not None: + msg = msg + f" with '{compiler}' compiler" + raise DistutilsPlatformError(msg) + + try: + module_name = "distutils." + module_name + __import__(module_name) + module = sys.modules[module_name] + klass = vars(module)[class_name] + except ImportError: + raise DistutilsModuleError( + f"can't compile C/C++ code: unable to load module '{module_name}'" + ) + except KeyError: + raise DistutilsModuleError( + f"can't compile C/C++ code: unable to find class '{class_name}' " + f"in module '{module_name}'" + ) + + # XXX The None is necessary to preserve backwards compatibility + # with classes that expect verbose to be the first positional + # argument. + return klass(None, dry_run, force) + + +def gen_preprocess_options( + macros: Iterable[_Macro], include_dirs: Iterable[str] +) -> list[str]: + """Generate C pre-processor options (-D, -U, -I) as used by at least + two types of compilers: the typical Unix compiler and Visual C++. + 'macros' is the usual thing, a list of 1- or 2-tuples, where (name,) + means undefine (-U) macro 'name', and (name,value) means define (-D) + macro 'name' to 'value'. 'include_dirs' is just a list of directory + names to be added to the header file search path (-I). Returns a list + of command-line options suitable for either Unix compilers or Visual + C++. + """ + # XXX it would be nice (mainly aesthetic, and so we don't generate + # stupid-looking command lines) to go over 'macros' and eliminate + # redundant definitions/undefinitions (ie. ensure that only the + # latest mention of a particular macro winds up on the command + # line). I don't think it's essential, though, since most (all?) + # Unix C compilers only pay attention to the latest -D or -U + # mention of a macro on their command line. Similar situation for + # 'include_dirs'. I'm punting on both for now. Anyways, weeding out + # redundancies like this should probably be the province of + # CCompiler, since the data structures used are inherited from it + # and therefore common to all CCompiler classes. + pp_opts = [] + for macro in macros: + if not (isinstance(macro, tuple) and 1 <= len(macro) <= 2): + raise TypeError( + f"bad macro definition '{macro}': " + "each element of 'macros' list must be a 1- or 2-tuple" + ) + + if len(macro) == 1: # undefine this macro + pp_opts.append(f"-U{macro[0]}") + elif len(macro) == 2: + if macro[1] is None: # define with no explicit value + pp_opts.append(f"-D{macro[0]}") + else: + # XXX *don't* need to be clever about quoting the + # macro value here, because we're going to avoid the + # shell at all costs when we spawn the command! + pp_opts.append("-D{}={}".format(*macro)) + + pp_opts.extend(f"-I{dir}" for dir in include_dirs) + return pp_opts + + +def gen_lib_options( + compiler: Compiler, + library_dirs: Iterable[str], + runtime_library_dirs: Iterable[str], + libraries: Iterable[str], +) -> list[str]: + """Generate linker options for searching library directories and + linking with specific libraries. 'libraries' and 'library_dirs' are, + respectively, lists of library names (not filenames!) and search + directories. Returns a list of command-line options suitable for use + with some compiler (depending on the two format strings passed in). + """ + lib_opts = [compiler.library_dir_option(dir) for dir in library_dirs] + + for dir in runtime_library_dirs: + lib_opts.extend(always_iterable(compiler.runtime_library_dir_option(dir))) + + # XXX it's important that we *not* remove redundant library mentions! + # sometimes you really do have to say "-lfoo -lbar -lfoo" in order to + # resolve all symbols. I just hope we never have to say "-lfoo obj.o + # -lbar" to get things to work -- that's certainly a possibility, but a + # pretty nasty way to arrange your C code. + + for lib in libraries: + (lib_dir, lib_name) = os.path.split(lib) + if lib_dir: + lib_file = compiler.find_library_file([lib_dir], lib_name) + if lib_file: + lib_opts.append(lib_file) + else: + compiler.warn( + f"no library file corresponding to '{lib}' found (skipping)" + ) + else: + lib_opts.append(compiler.library_option(lib)) + return lib_opts diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/cygwin.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/cygwin.py new file mode 100644 index 000000000..bfabbb306 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/cygwin.py @@ -0,0 +1,340 @@ +"""distutils.cygwinccompiler + +Provides the CygwinCCompiler class, a subclass of UnixCCompiler that +handles the Cygwin port of the GNU C compiler to Windows. It also contains +the Mingw32CCompiler class which handles the mingw32 port of GCC (same as +cygwin in no-cygwin mode). +""" + +import copy +import os +import pathlib +import shlex +import sys +import warnings +from subprocess import check_output + +from ...errors import ( + DistutilsExecError, + DistutilsPlatformError, +) +from ...file_util import write_file +from ...sysconfig import get_config_vars +from ...version import LooseVersion, suppress_known_deprecation +from . import unix +from .errors import ( + CompileError, + Error, +) + + +def get_msvcr(): + """No longer needed, but kept for backward compatibility.""" + return [] + + +_runtime_library_dirs_msg = ( + "Unable to set runtime library search path on Windows, " + "usually indicated by `runtime_library_dirs` parameter to Extension" +) + + +class Compiler(unix.Compiler): + """Handles the Cygwin port of the GNU C compiler to Windows.""" + + compiler_type = 'cygwin' + obj_extension = ".o" + static_lib_extension = ".a" + shared_lib_extension = ".dll.a" + dylib_lib_extension = ".dll" + static_lib_format = "lib%s%s" + shared_lib_format = "lib%s%s" + dylib_lib_format = "cyg%s%s" + exe_extension = ".exe" + + def __init__(self, verbose=False, dry_run=False, force=False): + super().__init__(verbose, dry_run, force) + + status, details = check_config_h() + self.debug_print(f"Python's GCC status: {status} (details: {details})") + if status is not CONFIG_H_OK: + self.warn( + "Python's pyconfig.h doesn't seem to support your compiler. " + f"Reason: {details}. " + "Compiling may fail because of undefined preprocessor macros." + ) + + self.cc, self.cxx = get_config_vars('CC', 'CXX') + + # Override 'CC' and 'CXX' environment variables for + # building using MINGW compiler for MSVC python. + self.cc = os.environ.get('CC', self.cc or 'gcc') + self.cxx = os.environ.get('CXX', self.cxx or 'g++') + + self.linker_dll = self.cc + self.linker_dll_cxx = self.cxx + shared_option = "-shared" + + self.set_executables( + compiler=f'{self.cc} -mcygwin -O -Wall', + compiler_so=f'{self.cc} -mcygwin -mdll -O -Wall', + compiler_cxx=f'{self.cxx} -mcygwin -O -Wall', + compiler_so_cxx=f'{self.cxx} -mcygwin -mdll -O -Wall', + linker_exe=f'{self.cc} -mcygwin', + linker_so=f'{self.linker_dll} -mcygwin {shared_option}', + linker_exe_cxx=f'{self.cxx} -mcygwin', + linker_so_cxx=f'{self.linker_dll_cxx} -mcygwin {shared_option}', + ) + + self.dll_libraries = get_msvcr() + + @property + def gcc_version(self): + # Older numpy depended on this existing to check for ancient + # gcc versions. This doesn't make much sense with clang etc so + # just hardcode to something recent. + # https://github.com/numpy/numpy/pull/20333 + warnings.warn( + "gcc_version attribute of CygwinCCompiler is deprecated. " + "Instead of returning actual gcc version a fixed value 11.2.0 is returned.", + DeprecationWarning, + stacklevel=2, + ) + with suppress_known_deprecation(): + return LooseVersion("11.2.0") + + def _compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts): + """Compiles the source by spawning GCC and windres if needed.""" + if ext in ('.rc', '.res'): + # gcc needs '.res' and '.rc' compiled to object files !!! + try: + self.spawn(["windres", "-i", src, "-o", obj]) + except DistutilsExecError as msg: + raise CompileError(msg) + else: # for other files use the C-compiler + try: + if self.detect_language(src) == 'c++': + self.spawn( + self.compiler_so_cxx + + cc_args + + [src, '-o', obj] + + extra_postargs + ) + else: + self.spawn( + self.compiler_so + cc_args + [src, '-o', obj] + extra_postargs + ) + except DistutilsExecError as msg: + raise CompileError(msg) + + def link( + self, + target_desc, + objects, + output_filename, + output_dir=None, + libraries=None, + library_dirs=None, + runtime_library_dirs=None, + export_symbols=None, + debug=False, + extra_preargs=None, + extra_postargs=None, + build_temp=None, + target_lang=None, + ): + """Link the objects.""" + # use separate copies, so we can modify the lists + extra_preargs = copy.copy(extra_preargs or []) + libraries = copy.copy(libraries or []) + objects = copy.copy(objects or []) + + if runtime_library_dirs: + self.warn(_runtime_library_dirs_msg) + + # Additional libraries + libraries.extend(self.dll_libraries) + + # handle export symbols by creating a def-file + # with executables this only works with gcc/ld as linker + if (export_symbols is not None) and ( + target_desc != self.EXECUTABLE or self.linker_dll == "gcc" + ): + # (The linker doesn't do anything if output is up-to-date. + # So it would probably better to check if we really need this, + # but for this we had to insert some unchanged parts of + # UnixCCompiler, and this is not what we want.) + + # we want to put some files in the same directory as the + # object files are, build_temp doesn't help much + # where are the object files + temp_dir = os.path.dirname(objects[0]) + # name of dll to give the helper files the same base name + (dll_name, dll_extension) = os.path.splitext( + os.path.basename(output_filename) + ) + + # generate the filenames for these files + def_file = os.path.join(temp_dir, dll_name + ".def") + + # Generate .def file + contents = [f"LIBRARY {os.path.basename(output_filename)}", "EXPORTS"] + contents.extend(export_symbols) + self.execute(write_file, (def_file, contents), f"writing {def_file}") + + # next add options for def-file + + # for gcc/ld the def-file is specified as any object files + objects.append(def_file) + + # end: if ((export_symbols is not None) and + # (target_desc != self.EXECUTABLE or self.linker_dll == "gcc")): + + # who wants symbols and a many times larger output file + # should explicitly switch the debug mode on + # otherwise we let ld strip the output file + # (On my machine: 10KiB < stripped_file < ??100KiB + # unstripped_file = stripped_file + XXX KiB + # ( XXX=254 for a typical python extension)) + if not debug: + extra_preargs.append("-s") + + super().link( + target_desc, + objects, + output_filename, + output_dir, + libraries, + library_dirs, + runtime_library_dirs, + None, # export_symbols, we do this in our def-file + debug, + extra_preargs, + extra_postargs, + build_temp, + target_lang, + ) + + def runtime_library_dir_option(self, dir): + # cygwin doesn't support rpath. While in theory we could error + # out like MSVC does, code might expect it to work like on Unix, so + # just warn and hope for the best. + self.warn(_runtime_library_dirs_msg) + return [] + + # -- Miscellaneous methods ----------------------------------------- + + def _make_out_path(self, output_dir, strip_dir, src_name): + # use normcase to make sure '.rc' is really '.rc' and not '.RC' + norm_src_name = os.path.normcase(src_name) + return super()._make_out_path(output_dir, strip_dir, norm_src_name) + + @property + def out_extensions(self): + """ + Add support for rc and res files. + """ + return { + **super().out_extensions, + **{ext: ext + self.obj_extension for ext in ('.res', '.rc')}, + } + + +# the same as cygwin plus some additional parameters +class MinGW32Compiler(Compiler): + """Handles the Mingw32 port of the GNU C compiler to Windows.""" + + compiler_type = 'mingw32' + + def __init__(self, verbose=False, dry_run=False, force=False): + super().__init__(verbose, dry_run, force) + + shared_option = "-shared" + + if is_cygwincc(self.cc): + raise Error('Cygwin gcc cannot be used with --compiler=mingw32') + + self.set_executables( + compiler=f'{self.cc} -O -Wall', + compiler_so=f'{self.cc} -shared -O -Wall', + compiler_so_cxx=f'{self.cxx} -shared -O -Wall', + compiler_cxx=f'{self.cxx} -O -Wall', + linker_exe=f'{self.cc}', + linker_so=f'{self.linker_dll} {shared_option}', + linker_exe_cxx=f'{self.cxx}', + linker_so_cxx=f'{self.linker_dll_cxx} {shared_option}', + ) + + def runtime_library_dir_option(self, dir): + raise DistutilsPlatformError(_runtime_library_dirs_msg) + + +# Because these compilers aren't configured in Python's pyconfig.h file by +# default, we should at least warn the user if he is using an unmodified +# version. + +CONFIG_H_OK = "ok" +CONFIG_H_NOTOK = "not ok" +CONFIG_H_UNCERTAIN = "uncertain" + + +def check_config_h(): + """Check if the current Python installation appears amenable to building + extensions with GCC. + + Returns a tuple (status, details), where 'status' is one of the following + constants: + + - CONFIG_H_OK: all is well, go ahead and compile + - CONFIG_H_NOTOK: doesn't look good + - CONFIG_H_UNCERTAIN: not sure -- unable to read pyconfig.h + + 'details' is a human-readable string explaining the situation. + + Note there are two ways to conclude "OK": either 'sys.version' contains + the string "GCC" (implying that this Python was built with GCC), or the + installed "pyconfig.h" contains the string "__GNUC__". + """ + + # XXX since this function also checks sys.version, it's not strictly a + # "pyconfig.h" check -- should probably be renamed... + + from distutils import sysconfig + + # if sys.version contains GCC then python was compiled with GCC, and the + # pyconfig.h file should be OK + if "GCC" in sys.version: + return CONFIG_H_OK, "sys.version mentions 'GCC'" + + # Clang would also work + if "Clang" in sys.version: + return CONFIG_H_OK, "sys.version mentions 'Clang'" + + # let's see if __GNUC__ is mentioned in python.h + fn = sysconfig.get_config_h_filename() + try: + config_h = pathlib.Path(fn).read_text(encoding='utf-8') + except OSError as exc: + return (CONFIG_H_UNCERTAIN, f"couldn't read '{fn}': {exc.strerror}") + else: + substring = '__GNUC__' + if substring in config_h: + code = CONFIG_H_OK + mention_inflected = 'mentions' + else: + code = CONFIG_H_NOTOK + mention_inflected = 'does not mention' + return code, f"{fn!r} {mention_inflected} {substring!r}" + + +def is_cygwincc(cc): + """Try to determine if the compiler that would be used is from cygwin.""" + out_string = check_output(shlex.split(cc) + ['-dumpmachine']) + return out_string.strip().endswith(b'cygwin') + + +get_versions = None +""" +A stand-in for the previous get_versions() function to prevent failures +when monkeypatched. See pypa/setuptools#2969. +""" diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/errors.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/errors.py new file mode 100644 index 000000000..01328592b --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/errors.py @@ -0,0 +1,24 @@ +class Error(Exception): + """Some compile/link operation failed.""" + + +class PreprocessError(Error): + """Failure to preprocess one or more C/C++ files.""" + + +class CompileError(Error): + """Failure to compile one or more C/C++ source files.""" + + +class LibError(Error): + """Failure to create a static library from one or more C/C++ object + files.""" + + +class LinkError(Error): + """Failure to link one or more C/C++ object files into an executable + or shared library file.""" + + +class UnknownFileType(Error): + """Attempt to process an unknown file type.""" diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/msvc.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/msvc.py new file mode 100644 index 000000000..6db062a9e --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/msvc.py @@ -0,0 +1,614 @@ +"""distutils._msvccompiler + +Contains MSVCCompiler, an implementation of the abstract CCompiler class +for Microsoft Visual Studio 2015. + +This module requires VS 2015 or later. +""" + +# Written by Perry Stoll +# hacked by Robin Becker and Thomas Heller to do a better job of +# finding DevStudio (through the registry) +# ported to VS 2005 and VS 2008 by Christian Heimes +# ported to VS 2015 by Steve Dower +from __future__ import annotations + +import contextlib +import os +import subprocess +import unittest.mock as mock +import warnings +from collections.abc import Iterable + +with contextlib.suppress(ImportError): + import winreg + +from itertools import count + +from ..._log import log +from ...errors import ( + DistutilsExecError, + DistutilsPlatformError, +) +from ...util import get_host_platform, get_platform +from . import base +from .base import gen_lib_options +from .errors import ( + CompileError, + LibError, + LinkError, +) + + +def _find_vc2015(): + try: + key = winreg.OpenKeyEx( + winreg.HKEY_LOCAL_MACHINE, + r"Software\Microsoft\VisualStudio\SxS\VC7", + access=winreg.KEY_READ | winreg.KEY_WOW64_32KEY, + ) + except OSError: + log.debug("Visual C++ is not registered") + return None, None + + best_version = 0 + best_dir = None + with key: + for i in count(): + try: + v, vc_dir, vt = winreg.EnumValue(key, i) + except OSError: + break + if v and vt == winreg.REG_SZ and os.path.isdir(vc_dir): + try: + version = int(float(v)) + except (ValueError, TypeError): + continue + if version >= 14 and version > best_version: + best_version, best_dir = version, vc_dir + return best_version, best_dir + + +def _find_vc2017(): + """Returns "15, path" based on the result of invoking vswhere.exe + If no install is found, returns "None, None" + + The version is returned to avoid unnecessarily changing the function + result. It may be ignored when the path is not None. + + If vswhere.exe is not available, by definition, VS 2017 is not + installed. + """ + root = os.environ.get("ProgramFiles(x86)") or os.environ.get("ProgramFiles") + if not root: + return None, None + + variant = 'arm64' if get_platform() == 'win-arm64' else 'x86.x64' + suitable_components = ( + f"Microsoft.VisualStudio.Component.VC.Tools.{variant}", + "Microsoft.VisualStudio.Workload.WDExpress", + ) + + for component in suitable_components: + # Workaround for `-requiresAny` (only available on VS 2017 > 15.6) + with contextlib.suppress( + subprocess.CalledProcessError, OSError, UnicodeDecodeError + ): + path = ( + subprocess.check_output([ + os.path.join( + root, "Microsoft Visual Studio", "Installer", "vswhere.exe" + ), + "-latest", + "-prerelease", + "-requires", + component, + "-property", + "installationPath", + "-products", + "*", + ]) + .decode(encoding="mbcs", errors="strict") + .strip() + ) + + path = os.path.join(path, "VC", "Auxiliary", "Build") + if os.path.isdir(path): + return 15, path + + return None, None # no suitable component found + + +PLAT_SPEC_TO_RUNTIME = { + 'x86': 'x86', + 'x86_amd64': 'x64', + 'x86_arm': 'arm', + 'x86_arm64': 'arm64', +} + + +def _find_vcvarsall(plat_spec): + # bpo-38597: Removed vcruntime return value + _, best_dir = _find_vc2017() + + if not best_dir: + best_version, best_dir = _find_vc2015() + + if not best_dir: + log.debug("No suitable Visual C++ version found") + return None, None + + vcvarsall = os.path.join(best_dir, "vcvarsall.bat") + if not os.path.isfile(vcvarsall): + log.debug("%s cannot be found", vcvarsall) + return None, None + + return vcvarsall, None + + +def _get_vc_env(plat_spec): + if os.getenv("DISTUTILS_USE_SDK"): + return {key.lower(): value for key, value in os.environ.items()} + + vcvarsall, _ = _find_vcvarsall(plat_spec) + if not vcvarsall: + raise DistutilsPlatformError( + 'Microsoft Visual C++ 14.0 or greater is required. ' + 'Get it with "Microsoft C++ Build Tools": ' + 'https://visualstudio.microsoft.com/visual-cpp-build-tools/' + ) + + try: + out = subprocess.check_output( + f'cmd /u /c "{vcvarsall}" {plat_spec} && set', + stderr=subprocess.STDOUT, + ).decode('utf-16le', errors='replace') + except subprocess.CalledProcessError as exc: + log.error(exc.output) + raise DistutilsPlatformError(f"Error executing {exc.cmd}") + + env = { + key.lower(): value + for key, _, value in (line.partition('=') for line in out.splitlines()) + if key and value + } + + return env + + +def _find_exe(exe, paths=None): + """Return path to an MSVC executable program. + + Tries to find the program in several places: first, one of the + MSVC program search paths from the registry; next, the directories + in the PATH environment variable. If any of those work, return an + absolute path that is known to exist. If none of them work, just + return the original program name, 'exe'. + """ + if not paths: + paths = os.getenv('path').split(os.pathsep) + for p in paths: + fn = os.path.join(os.path.abspath(p), exe) + if os.path.isfile(fn): + return fn + return exe + + +_vcvars_names = { + 'win32': 'x86', + 'win-amd64': 'amd64', + 'win-arm32': 'arm', + 'win-arm64': 'arm64', +} + + +def _get_vcvars_spec(host_platform, platform): + """ + Given a host platform and platform, determine the spec for vcvarsall. + + Uses the native MSVC host if the host platform would need expensive + emulation for x86. + + >>> _get_vcvars_spec('win-arm64', 'win32') + 'arm64_x86' + >>> _get_vcvars_spec('win-arm64', 'win-amd64') + 'arm64_amd64' + + Otherwise, always cross-compile from x86 to work with the + lighter-weight MSVC installs that do not include native 64-bit tools. + + >>> _get_vcvars_spec('win32', 'win32') + 'x86' + >>> _get_vcvars_spec('win-arm32', 'win-arm32') + 'x86_arm' + >>> _get_vcvars_spec('win-amd64', 'win-arm64') + 'x86_arm64' + """ + if host_platform != 'win-arm64': + host_platform = 'win32' + vc_hp = _vcvars_names[host_platform] + vc_plat = _vcvars_names[platform] + return vc_hp if vc_hp == vc_plat else f'{vc_hp}_{vc_plat}' + + +class Compiler(base.Compiler): + """Concrete class that implements an interface to Microsoft Visual C++, + as defined by the CCompiler abstract class.""" + + compiler_type = 'msvc' + + # Just set this so CCompiler's constructor doesn't barf. We currently + # don't use the 'set_executables()' bureaucracy provided by CCompiler, + # as it really isn't necessary for this sort of single-compiler class. + # Would be nice to have a consistent interface with UnixCCompiler, + # though, so it's worth thinking about. + executables = {} + + # Private class data (need to distinguish C from C++ source for compiler) + _c_extensions = ['.c'] + _cpp_extensions = ['.cc', '.cpp', '.cxx'] + _rc_extensions = ['.rc'] + _mc_extensions = ['.mc'] + + # Needed for the filename generation methods provided by the + # base class, CCompiler. + src_extensions = _c_extensions + _cpp_extensions + _rc_extensions + _mc_extensions + res_extension = '.res' + obj_extension = '.obj' + static_lib_extension = '.lib' + shared_lib_extension = '.dll' + static_lib_format = shared_lib_format = '%s%s' + exe_extension = '.exe' + + def __init__(self, verbose=False, dry_run=False, force=False) -> None: + super().__init__(verbose, dry_run, force) + # target platform (.plat_name is consistent with 'bdist') + self.plat_name = None + self.initialized = False + + @classmethod + def _configure(cls, vc_env): + """ + Set class-level include/lib dirs. + """ + cls.include_dirs = cls._parse_path(vc_env.get('include', '')) + cls.library_dirs = cls._parse_path(vc_env.get('lib', '')) + + @staticmethod + def _parse_path(val): + return [dir.rstrip(os.sep) for dir in val.split(os.pathsep) if dir] + + def initialize(self, plat_name: str | None = None) -> None: + # multi-init means we would need to check platform same each time... + assert not self.initialized, "don't init multiple times" + if plat_name is None: + plat_name = get_platform() + # sanity check for platforms to prevent obscure errors later. + if plat_name not in _vcvars_names: + raise DistutilsPlatformError( + f"--plat-name must be one of {tuple(_vcvars_names)}" + ) + + plat_spec = _get_vcvars_spec(get_host_platform(), plat_name) + + vc_env = _get_vc_env(plat_spec) + if not vc_env: + raise DistutilsPlatformError( + "Unable to find a compatible Visual Studio installation." + ) + self._configure(vc_env) + + self._paths = vc_env.get('path', '') + paths = self._paths.split(os.pathsep) + self.cc = _find_exe("cl.exe", paths) + self.linker = _find_exe("link.exe", paths) + self.lib = _find_exe("lib.exe", paths) + self.rc = _find_exe("rc.exe", paths) # resource compiler + self.mc = _find_exe("mc.exe", paths) # message compiler + self.mt = _find_exe("mt.exe", paths) # message compiler + + self.preprocess_options = None + # bpo-38597: Always compile with dynamic linking + # Future releases of Python 3.x will include all past + # versions of vcruntime*.dll for compatibility. + self.compile_options = ['/nologo', '/O2', '/W3', '/GL', '/DNDEBUG', '/MD'] + + self.compile_options_debug = [ + '/nologo', + '/Od', + '/MDd', + '/Zi', + '/W3', + '/D_DEBUG', + ] + + ldflags = ['/nologo', '/INCREMENTAL:NO', '/LTCG'] + + ldflags_debug = ['/nologo', '/INCREMENTAL:NO', '/LTCG', '/DEBUG:FULL'] + + self.ldflags_exe = [*ldflags, '/MANIFEST:EMBED,ID=1'] + self.ldflags_exe_debug = [*ldflags_debug, '/MANIFEST:EMBED,ID=1'] + self.ldflags_shared = [ + *ldflags, + '/DLL', + '/MANIFEST:EMBED,ID=2', + '/MANIFESTUAC:NO', + ] + self.ldflags_shared_debug = [ + *ldflags_debug, + '/DLL', + '/MANIFEST:EMBED,ID=2', + '/MANIFESTUAC:NO', + ] + self.ldflags_static = [*ldflags] + self.ldflags_static_debug = [*ldflags_debug] + + self._ldflags = { + (base.Compiler.EXECUTABLE, None): self.ldflags_exe, + (base.Compiler.EXECUTABLE, False): self.ldflags_exe, + (base.Compiler.EXECUTABLE, True): self.ldflags_exe_debug, + (base.Compiler.SHARED_OBJECT, None): self.ldflags_shared, + (base.Compiler.SHARED_OBJECT, False): self.ldflags_shared, + (base.Compiler.SHARED_OBJECT, True): self.ldflags_shared_debug, + (base.Compiler.SHARED_LIBRARY, None): self.ldflags_static, + (base.Compiler.SHARED_LIBRARY, False): self.ldflags_static, + (base.Compiler.SHARED_LIBRARY, True): self.ldflags_static_debug, + } + + self.initialized = True + + # -- Worker methods ------------------------------------------------ + + @property + def out_extensions(self) -> dict[str, str]: + return { + **super().out_extensions, + **{ + ext: self.res_extension + for ext in self._rc_extensions + self._mc_extensions + }, + } + + def compile( # noqa: C901 + self, + sources, + output_dir=None, + macros=None, + include_dirs=None, + debug=False, + extra_preargs=None, + extra_postargs=None, + depends=None, + ): + if not self.initialized: + self.initialize() + compile_info = self._setup_compile( + output_dir, macros, include_dirs, sources, depends, extra_postargs + ) + macros, objects, extra_postargs, pp_opts, build = compile_info + + compile_opts = extra_preargs or [] + compile_opts.append('/c') + if debug: + compile_opts.extend(self.compile_options_debug) + else: + compile_opts.extend(self.compile_options) + + add_cpp_opts = False + + for obj in objects: + try: + src, ext = build[obj] + except KeyError: + continue + if debug: + # pass the full pathname to MSVC in debug mode, + # this allows the debugger to find the source file + # without asking the user to browse for it + src = os.path.abspath(src) + + if ext in self._c_extensions: + input_opt = f"/Tc{src}" + elif ext in self._cpp_extensions: + input_opt = f"/Tp{src}" + add_cpp_opts = True + elif ext in self._rc_extensions: + # compile .RC to .RES file + input_opt = src + output_opt = "/fo" + obj + try: + self.spawn([self.rc] + pp_opts + [output_opt, input_opt]) + except DistutilsExecError as msg: + raise CompileError(msg) + continue + elif ext in self._mc_extensions: + # Compile .MC to .RC file to .RES file. + # * '-h dir' specifies the directory for the + # generated include file + # * '-r dir' specifies the target directory of the + # generated RC file and the binary message resource + # it includes + # + # For now (since there are no options to change this), + # we use the source-directory for the include file and + # the build directory for the RC file and message + # resources. This works at least for win32all. + h_dir = os.path.dirname(src) + rc_dir = os.path.dirname(obj) + try: + # first compile .MC to .RC and .H file + self.spawn([self.mc, '-h', h_dir, '-r', rc_dir, src]) + base, _ = os.path.splitext(os.path.basename(src)) + rc_file = os.path.join(rc_dir, base + '.rc') + # then compile .RC to .RES file + self.spawn([self.rc, "/fo" + obj, rc_file]) + + except DistutilsExecError as msg: + raise CompileError(msg) + continue + else: + # how to handle this file? + raise CompileError(f"Don't know how to compile {src} to {obj}") + + args = [self.cc] + compile_opts + pp_opts + if add_cpp_opts: + args.append('/EHsc') + args.extend((input_opt, "/Fo" + obj)) + args.extend(extra_postargs) + + try: + self.spawn(args) + except DistutilsExecError as msg: + raise CompileError(msg) + + return objects + + def create_static_lib( + self, + objects: list[str] | tuple[str, ...], + output_libname: str, + output_dir: str | None = None, + debug: bool = False, + target_lang: str | None = None, + ) -> None: + if not self.initialized: + self.initialize() + objects, output_dir = self._fix_object_args(objects, output_dir) + output_filename = self.library_filename(output_libname, output_dir=output_dir) + + if self._need_link(objects, output_filename): + lib_args = objects + ['/OUT:' + output_filename] + if debug: + pass # XXX what goes here? + try: + log.debug('Executing "%s" %s', self.lib, ' '.join(lib_args)) + self.spawn([self.lib] + lib_args) + except DistutilsExecError as msg: + raise LibError(msg) + else: + log.debug("skipping %s (up-to-date)", output_filename) + + def link( + self, + target_desc: str, + objects: list[str] | tuple[str, ...], + output_filename: str, + output_dir: str | None = None, + libraries: list[str] | tuple[str, ...] | None = None, + library_dirs: list[str] | tuple[str, ...] | None = None, + runtime_library_dirs: list[str] | tuple[str, ...] | None = None, + export_symbols: Iterable[str] | None = None, + debug: bool = False, + extra_preargs: list[str] | None = None, + extra_postargs: Iterable[str] | None = None, + build_temp: str | os.PathLike[str] | None = None, + target_lang: str | None = None, + ) -> None: + if not self.initialized: + self.initialize() + objects, output_dir = self._fix_object_args(objects, output_dir) + fixed_args = self._fix_lib_args(libraries, library_dirs, runtime_library_dirs) + libraries, library_dirs, runtime_library_dirs = fixed_args + + if runtime_library_dirs: + self.warn( + "I don't know what to do with 'runtime_library_dirs': " + + str(runtime_library_dirs) + ) + + lib_opts = gen_lib_options(self, library_dirs, runtime_library_dirs, libraries) + if output_dir is not None: + output_filename = os.path.join(output_dir, output_filename) + + if self._need_link(objects, output_filename): + ldflags = self._ldflags[target_desc, debug] + + export_opts = ["/EXPORT:" + sym for sym in (export_symbols or [])] + + ld_args = ( + ldflags + lib_opts + export_opts + objects + ['/OUT:' + output_filename] + ) + + # The MSVC linker generates .lib and .exp files, which cannot be + # suppressed by any linker switches. The .lib files may even be + # needed! Make sure they are generated in the temporary build + # directory. Since they have different names for debug and release + # builds, they can go into the same directory. + build_temp = os.path.dirname(objects[0]) + if export_symbols is not None: + (dll_name, dll_ext) = os.path.splitext( + os.path.basename(output_filename) + ) + implib_file = os.path.join(build_temp, self.library_filename(dll_name)) + ld_args.append('/IMPLIB:' + implib_file) + + if extra_preargs: + ld_args[:0] = extra_preargs + if extra_postargs: + ld_args.extend(extra_postargs) + + output_dir = os.path.dirname(os.path.abspath(output_filename)) + self.mkpath(output_dir) + try: + log.debug('Executing "%s" %s', self.linker, ' '.join(ld_args)) + self.spawn([self.linker] + ld_args) + except DistutilsExecError as msg: + raise LinkError(msg) + else: + log.debug("skipping %s (up-to-date)", output_filename) + + def spawn(self, cmd): + env = dict(os.environ, PATH=self._paths) + with self._fallback_spawn(cmd, env) as fallback: + return super().spawn(cmd, env=env) + return fallback.value + + @contextlib.contextmanager + def _fallback_spawn(self, cmd, env): + """ + Discovered in pypa/distutils#15, some tools monkeypatch the compiler, + so the 'env' kwarg causes a TypeError. Detect this condition and + restore the legacy, unsafe behavior. + """ + bag = type('Bag', (), {})() + try: + yield bag + except TypeError as exc: + if "unexpected keyword argument 'env'" not in str(exc): + raise + else: + return + warnings.warn("Fallback spawn triggered. Please update distutils monkeypatch.") + with mock.patch.dict('os.environ', env): + bag.value = super().spawn(cmd) + + # -- Miscellaneous methods ----------------------------------------- + # These are all used by the 'gen_lib_options() function, in + # ccompiler.py. + + def library_dir_option(self, dir): + return "/LIBPATH:" + dir + + def runtime_library_dir_option(self, dir): + raise DistutilsPlatformError( + "don't know how to set runtime library search path for MSVC" + ) + + def library_option(self, lib): + return self.library_filename(lib) + + def find_library_file(self, dirs, lib, debug=False): + # Prefer a debugging library if found (and requested), but deal + # with it if we don't have one. + if debug: + try_names = [lib + "_d", lib] + else: + try_names = [lib] + for dir in dirs: + for name in try_names: + libfile = os.path.join(dir, self.library_filename(name)) + if os.path.isfile(libfile): + return libfile + else: + # Oops, didn't find it in *any* of 'dirs' + return None diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/__pycache__/test_base.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/__pycache__/test_base.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6355495e4c92e5b889aeff8929c8e69f203310f7 GIT binary patch literal 4077 zcmd57(25q|r}CAp+2k(6XNu(Y-0Sac-Ps$n2b6t#xrNVXb5Xn?p;P%Kv5M{?;U zm)KoOB0~X85TFoJz-|t;fV6;)4(tLx8tAEY(MvC6#6rTxKn`mp6LhaVT<|NN zPtby(@IV8K7ih3V#eCn8^|^0opfSp37iAOMQL|Vm7}zwWf^21^oSaW{KymA&&NE2HP*8JoYM<`sR}gh}6Ws~gYkQU2$y_9CdV1Gj@_ z5#?O(FTlg#azXg#aMizKenZ`%DDLKhKB*NIERL7y3IE&|C`Q|K z{DSStU|GS2N$e2Cz0VREJ%+tSbUMcqnR zMN2nSSxdw_JxyIq6dao_#>ak?FjWhW7UbkjISso_Y!wTZu4`sOQdAQ*snAX8xq_;J z5{b!#g-tk*P>Fb3yinTnji+%QuM~`l@~Nbh0?zojrYB|1oQQXpBA~x{3dq0Ef2!!q zzS#%wt)Jg`Z)4`}WaH$8df)7SP2!dxcZI3)n|`s~2HVzmCYE$n5$8+S@~S1lD;g%_ znE2sphoS6s_msJ!l^T5=;=+sbNnKI%>6q8{7BtyP=|;}>m?hJ~Ih)PuYTou*c*R;a zmeIBV*C4eOw*9IpwY|g+ zkTW|gf~;ws0q^qj1-Yc@vSN}DaLqS}R~zKk970lyc?(DtJqh-#^Y!3B_3iEOKy~(U z_o+JrzaH4^KC_|LyA##x+mRn`T(3vs)t_#MPj3Y3;gRa>_KEN<8b75?)}`c16F9Rb(!VnH@6HCfbTV?=Z#aMUc|q?%Hbuxe#G!t=T% zE@Dw%!iJ$L;Jqy&Hs3yDF6J>vblHJCUY1;8whtm8spnH_+V-VEBS)s)byzu@Z}0em zaoo`Mb|iROnZzXT8l2YgSG&i_4u_=}uK~{)_?c-SRrJ)4x}sYlu^tjPLuaZpkAuBi zL9rebH-l$3F4u#j;M#0pi#=UuPp>bnXBzA|XB@4w(c7upKX0)8O%LLN$8-FR?Kea? zD+#|&BYx$0=6T4dFYK9skw;=$$J0#uI{KJ8hKqLnvBmX0c*orDlm?doK#q|~DO{Sm z-@&(*WFIL~;BOz#UdmbY!Ltm<*5}VUM$-;{xAwghjd;cTto6rfR6>Jj44Kq2O`-SU zE&+7cR+#tEGWFcNbo6`)wdP~KIh&Igb;Gh*yrNp=-gam?p{rmhxRSDk6+jy^Mhv)3Qo6N+@D(QrpWQ7L4BgVLQUM#6fNzX!xBxpK6uk#S5#lNk z-4evQAa3+EgjkJ@)r8o#5NXf#HiY3CJ6scnANxXEzJa=Lp!VuS!}sHF5zSqto`m|g zLPPb?(8i62{s)y>Xs8jIs(GjCp{ZStFg*1D#vI-^Lp_PSvK1MwM~3hAK78ZhNG&ql zh)mbK)3wlaEiz5E&QMKI^<+zW?d(q)p({1^N=>-(oE{A4-*&}q2hKgX{NS}FgQBsg zh>rT3i1rcEMM%`Y%K om;)>cJ$?y>N`7_xq^90xU9 z_1h%4GE`|U+KIWMW~l`Yi%^>Sybcm(h?I|jyc9s(4^b$rzZ6Dl>_|-*ISiXeaMgto2P$JH zj4n{7Wj-m{jf+5R)T$oXoNU~*g`$a5>WWo_OSb*3jN~lv?b%krO5ol}G>)AH`P_Dn zaB74-?|4pEiW;6UCSZZ&Epr}7lc6Z;D-`+)bpibv1^i?DwQ{f#3g1Je0-<=Oo1K;&WDgRDfphle&{|8GLmKy*7 literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/__pycache__/test_cygwin.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/__pycache__/test_cygwin.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..c28d95646e1884f3245e6b892f381d840e8b8149 GIT binary patch literal 4592 zcmbtXUu+Xc8lU}RdmYDFAR!5Xh9!k2<`O$GklaPkK$0c}im52Qaz>|>0a*XUhW=j!YR2uD%}b7p>HYBmpqK zc5NyiV9_*Enyw-xpnB7tbqR;M&Dm5uSY$)ZrGpn$!!)E>9ZQO4m<3bI7~y1bZb8c> zlX^C8HIda$L3co%tGI5i(MpBiGryY3^iF>j4nw` zL;6ozVB@3~`yCkkRE|LIG*w%h?`qSx~Z+-gKO530I{bAo9yYF_b zwH;rcyn1ef7uWfYD&O&2f92KDdz0(O->V*f?*V_QKEd7k#U1W1fz`mj_@hriH%gMq zDNZauk!bX*2mk>QFu021oXV#uq&UoW+bBX6*17gSK!$T<6uu4>&i#n{et;%-b;VQH z6c-dPoWig8pl*68ZNf9!0!4qQ$!aCQG(mxAVxk5_$r|EO^AMWCNf!{?!O1&ll>y+w zcDXA&kr zX;wOLLh7+2ucy?X(@jZ-Nw}q9brDe3=+a*4&O||NQIS5CYW82{B9{ca^ck=R9cf8a=9(9ZRn7P`rH-}9Eh;| z87((2Q&bHSGBJ};sRo0XkYJb{AXYm;5}0{zp~f-On3v# zny}H-s%HWMjr_P%Wb`g%hp^#Ex|_S{0*rhu6f>do%aNlNI4)RXq8k8Qq(>3Ftx0 zXo51k$OKPlG2Q!@c5jz6hujoRVM#=oL?bPY?qA*1kVQC*=tr;A;Ek!T1o>Elj0i^E zoXFh>Qg{bZ81#~-Zjf8O zCM9WDiVhC`v|kz;9z7ZzjShvRrpwb46VlP}AmKli&u3JLJYWS=#r@LhTrw=p6ts*Y z9Xm2I82Tke%2Kxh36q)9a&yvx25Dfyl+2VW9R@`UI#w)hadEM<11d?Dr(^F<$g%{T zkRP{#Q)t?TNyu3($&{L$caujeFmXOMb$VKUQ$Byz+U0iMjZM69;o_;&F{^0-LvCfG zCvl0@;xfg~Up#*n?}x!>o=mHiUbU^ulzO+llUo`4iL!q}wTw0eCOGnxL;mKE15caK zj`nr&U{yT0Ccd_Er7DK*{Cs_2tU54uUmU9lV-<01(~CMrKIVYg+mLyxIxux#oT>;@ z6>$of{lOdJb@3Me``~YaD}@Kbz(aBOi%X1G2Wse95yzjCs`UQsfiT)otiH3VIQAl1 zkjIaL?l2HHk?A5ty7ngm!)|e2@vQ)hyMZCZ+FtdOls#*_pTsY?qlLP|oiFul>j{@< z5;PkGgO(9J-2SS#e@#5Fa^b$%TM>GzV()jHXcXkW=NWO44OnZ%&N<*FanC#(TON!c zPck3_#PapiiaxVP(>K3ibK>8 zu~4%m$TVA!WvfY+v$|4%d_lIFW%)`Wks*16EYoDt^1@#Wqzo3HP2hRUYs_nTZ5ICo zmckKIjgX2M5ubo+710&!WON@HCDm^DjL)FDiXO9!=M{)cZ}Uf&KfJu|>8N@-DxJ|a z&yfvJ;Mt+6HP7_dtl*hoo^Z(fCasTd@?>DMt%3O0Eblp01((i z5r`7qM=53Ro9s5!V));8TPZ*+K4`)fUYH zR_PC#)pF7PwLC}vG%>Xco+L6P+olHlRyb~Z;&pr$#>gcz2(igA4D)Yv_!08|2Q__x z_J4t1eT0HvqTO&XcE@u2N8KNG-{K!IufR!|V{j(6dy`O4TSl1Zt={#n!D`pwHwZd( GvHt^W(Ext{ literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/__pycache__/test_mingw.cpython-312.pyc b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/__pycache__/test_mingw.cpython-312.pyc new file mode 100644 index 0000000000000000000000000000000000000000..cad9b62bf0ec705293b2a546a214cf1d9011f336 GIT binary patch literal 3919 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 J;T!3g{{?+WsG0x( literal 0 HcmV?d00001 diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_base.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_base.py new file mode 100644 index 000000000..a762e2b64 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_base.py @@ -0,0 +1,83 @@ +import platform +import sysconfig +import textwrap + +import pytest + +from .. import base + +pytestmark = pytest.mark.usefixtures('suppress_path_mangle') + + +@pytest.fixture +def c_file(tmp_path): + c_file = tmp_path / 'foo.c' + gen_headers = ('Python.h',) + is_windows = platform.system() == "Windows" + plat_headers = ('windows.h',) * is_windows + all_headers = gen_headers + plat_headers + headers = '\n'.join(f'#include <{header}>\n' for header in all_headers) + payload = ( + textwrap.dedent( + """ + #headers + void PyInit_foo(void) {} + """ + ) + .lstrip() + .replace('#headers', headers) + ) + c_file.write_text(payload, encoding='utf-8') + return c_file + + +def test_set_include_dirs(c_file): + """ + Extensions should build even if set_include_dirs is invoked. + In particular, compiler-specific paths should not be overridden. + """ + compiler = base.new_compiler() + python = sysconfig.get_paths()['include'] + compiler.set_include_dirs([python]) + compiler.compile([c_file]) + + # do it again, setting include dirs after any initialization + compiler.set_include_dirs([python]) + compiler.compile([c_file]) + + +def test_has_function_prototype(): + # Issue https://github.com/pypa/setuptools/issues/3648 + # Test prototype-generating behavior. + + compiler = base.new_compiler() + + # Every C implementation should have these. + assert compiler.has_function('abort') + assert compiler.has_function('exit') + with pytest.deprecated_call(match='includes is deprecated'): + # abort() is a valid expression with the prototype. + assert compiler.has_function('abort', includes=['stdlib.h']) + with pytest.deprecated_call(match='includes is deprecated'): + # But exit() is not valid with the actual prototype in scope. + assert not compiler.has_function('exit', includes=['stdlib.h']) + # And setuptools_does_not_exist is not declared or defined at all. + assert not compiler.has_function('setuptools_does_not_exist') + with pytest.deprecated_call(match='includes is deprecated'): + assert not compiler.has_function( + 'setuptools_does_not_exist', includes=['stdio.h'] + ) + + +def test_include_dirs_after_multiple_compile_calls(c_file): + """ + Calling compile multiple times should not change the include dirs + (regression test for setuptools issue #3591). + """ + compiler = base.new_compiler() + python = sysconfig.get_paths()['include'] + compiler.set_include_dirs([python]) + compiler.compile([c_file]) + assert compiler.include_dirs == [python] + compiler.compile([c_file]) + assert compiler.include_dirs == [python] diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_cygwin.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_cygwin.py new file mode 100644 index 000000000..9adf6b8eb --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_cygwin.py @@ -0,0 +1,76 @@ +"""Tests for distutils.cygwinccompiler.""" + +import os +import sys +from distutils import sysconfig +from distutils.tests import support + +import pytest + +from .. import cygwin + + +@pytest.fixture(autouse=True) +def stuff(request, monkeypatch, distutils_managed_tempdir): + self = request.instance + self.python_h = os.path.join(self.mkdtemp(), 'python.h') + monkeypatch.setattr(sysconfig, 'get_config_h_filename', self._get_config_h_filename) + monkeypatch.setattr(sys, 'version', sys.version) + + +class TestCygwinCCompiler(support.TempdirManager): + def _get_config_h_filename(self): + return self.python_h + + @pytest.mark.skipif('sys.platform != "cygwin"') + @pytest.mark.skipif('not os.path.exists("/usr/lib/libbash.dll.a")') + def test_find_library_file(self): + from distutils.cygwinccompiler import CygwinCCompiler + + compiler = CygwinCCompiler() + link_name = "bash" + linkable_file = compiler.find_library_file(["/usr/lib"], link_name) + assert linkable_file is not None + assert os.path.exists(linkable_file) + assert linkable_file == f"/usr/lib/lib{link_name:s}.dll.a" + + @pytest.mark.skipif('sys.platform != "cygwin"') + def test_runtime_library_dir_option(self): + from distutils.cygwinccompiler import CygwinCCompiler + + compiler = CygwinCCompiler() + assert compiler.runtime_library_dir_option('/foo') == [] + + def test_check_config_h(self): + # check_config_h looks for "GCC" in sys.version first + # returns CONFIG_H_OK if found + sys.version = ( + '2.6.1 (r261:67515, Dec 6 2008, 16:42:21) \n[GCC ' + '4.0.1 (Apple Computer, Inc. build 5370)]' + ) + + assert cygwin.check_config_h()[0] == cygwin.CONFIG_H_OK + + # then it tries to see if it can find "__GNUC__" in pyconfig.h + sys.version = 'something without the *CC word' + + # if the file doesn't exist it returns CONFIG_H_UNCERTAIN + assert cygwin.check_config_h()[0] == cygwin.CONFIG_H_UNCERTAIN + + # if it exists but does not contain __GNUC__, it returns CONFIG_H_NOTOK + self.write_file(self.python_h, 'xxx') + assert cygwin.check_config_h()[0] == cygwin.CONFIG_H_NOTOK + + # and CONFIG_H_OK if __GNUC__ is found + self.write_file(self.python_h, 'xxx __GNUC__ xxx') + assert cygwin.check_config_h()[0] == cygwin.CONFIG_H_OK + + def test_get_msvcr(self): + assert cygwin.get_msvcr() == [] + + @pytest.mark.skipif('sys.platform != "cygwin"') + def test_dll_libraries_not_none(self): + from distutils.cygwinccompiler import CygwinCCompiler + + compiler = CygwinCCompiler() + assert compiler.dll_libraries is not None diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_mingw.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_mingw.py new file mode 100644 index 000000000..dc45687a9 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_mingw.py @@ -0,0 +1,48 @@ +from distutils import sysconfig +from distutils.errors import DistutilsPlatformError +from distutils.util import is_mingw, split_quoted + +import pytest + +from .. import cygwin, errors + + +class TestMinGW32Compiler: + @pytest.mark.skipif(not is_mingw(), reason='not on mingw') + def test_compiler_type(self): + compiler = cygwin.MinGW32Compiler() + assert compiler.compiler_type == 'mingw32' + + @pytest.mark.skipif(not is_mingw(), reason='not on mingw') + def test_set_executables(self, monkeypatch): + monkeypatch.setenv('CC', 'cc') + monkeypatch.setenv('CXX', 'c++') + + compiler = cygwin.MinGW32Compiler() + + assert compiler.compiler == split_quoted('cc -O -Wall') + assert compiler.compiler_so == split_quoted('cc -shared -O -Wall') + assert compiler.compiler_cxx == split_quoted('c++ -O -Wall') + assert compiler.linker_exe == split_quoted('cc') + assert compiler.linker_so == split_quoted('cc -shared') + + @pytest.mark.skipif(not is_mingw(), reason='not on mingw') + def test_runtime_library_dir_option(self): + compiler = cygwin.MinGW32Compiler() + with pytest.raises(DistutilsPlatformError): + compiler.runtime_library_dir_option('/usr/lib') + + @pytest.mark.skipif(not is_mingw(), reason='not on mingw') + def test_cygwincc_error(self, monkeypatch): + monkeypatch.setattr(cygwin, 'is_cygwincc', lambda _: True) + + with pytest.raises(errors.Error): + cygwin.MinGW32Compiler() + + @pytest.mark.skipif('sys.platform == "cygwin"') + def test_customize_compiler_with_msvc_python(self): + # In case we have an MSVC Python build, but still want to use + # MinGW32Compiler, then customize_compiler() shouldn't fail at least. + # https://github.com/pypa/setuptools/issues/4456 + compiler = cygwin.MinGW32Compiler() + sysconfig.customize_compiler(compiler) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_msvc.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_msvc.py new file mode 100644 index 000000000..eca831996 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_msvc.py @@ -0,0 +1,136 @@ +import os +import sys +import sysconfig +import threading +import unittest.mock as mock +from distutils.errors import DistutilsPlatformError +from distutils.tests import support +from distutils.util import get_platform + +import pytest + +from .. import msvc + +needs_winreg = pytest.mark.skipif('not hasattr(msvc, "winreg")') + + +class Testmsvccompiler(support.TempdirManager): + def test_no_compiler(self, monkeypatch): + # makes sure query_vcvarsall raises + # a DistutilsPlatformError if the compiler + # is not found + def _find_vcvarsall(plat_spec): + return None, None + + monkeypatch.setattr(msvc, '_find_vcvarsall', _find_vcvarsall) + + with pytest.raises(DistutilsPlatformError): + msvc._get_vc_env( + 'wont find this version', + ) + + @pytest.mark.skipif( + not sysconfig.get_platform().startswith("win"), + reason="Only run test for non-mingw Windows platforms", + ) + @pytest.mark.parametrize( + "plat_name, expected", + [ + ("win-arm64", "win-arm64"), + ("win-amd64", "win-amd64"), + (None, get_platform()), + ], + ) + def test_cross_platform_compilation_paths(self, monkeypatch, plat_name, expected): + """ + Ensure a specified target platform is passed to _get_vcvars_spec. + """ + compiler = msvc.Compiler() + + def _get_vcvars_spec(host_platform, platform): + assert platform == expected + + monkeypatch.setattr(msvc, '_get_vcvars_spec', _get_vcvars_spec) + compiler.initialize(plat_name) + + @needs_winreg + def test_get_vc_env_unicode(self): + test_var = 'ṰḖṤṪ┅ṼẨṜ' + test_value = '₃⁴₅' + + # Ensure we don't early exit from _get_vc_env + old_distutils_use_sdk = os.environ.pop('DISTUTILS_USE_SDK', None) + os.environ[test_var] = test_value + try: + env = msvc._get_vc_env('x86') + assert test_var.lower() in env + assert test_value == env[test_var.lower()] + finally: + os.environ.pop(test_var) + if old_distutils_use_sdk: + os.environ['DISTUTILS_USE_SDK'] = old_distutils_use_sdk + + @needs_winreg + @pytest.mark.parametrize('ver', (2015, 2017)) + def test_get_vc(self, ver): + # This function cannot be mocked, so pass if VC is found + # and skip otherwise. + lookup = getattr(msvc, f'_find_vc{ver}') + expected_version = {2015: 14, 2017: 15}[ver] + version, path = lookup() + if not version: + pytest.skip(f"VS {ver} is not installed") + assert version >= expected_version + assert os.path.isdir(path) + + +class CheckThread(threading.Thread): + exc_info = None + + def run(self): + try: + super().run() + except Exception: + self.exc_info = sys.exc_info() + + def __bool__(self): + return not self.exc_info + + +class TestSpawn: + def test_concurrent_safe(self): + """ + Concurrent calls to spawn should have consistent results. + """ + compiler = msvc.Compiler() + compiler._paths = "expected" + inner_cmd = 'import os; assert os.environ["PATH"] == "expected"' + command = [sys.executable, '-c', inner_cmd] + + threads = [ + CheckThread(target=compiler.spawn, args=[command]) for n in range(100) + ] + for thread in threads: + thread.start() + for thread in threads: + thread.join() + assert all(threads) + + def test_concurrent_safe_fallback(self): + """ + If CCompiler.spawn has been monkey-patched without support + for an env, it should still execute. + """ + from distutils import ccompiler + + compiler = msvc.Compiler() + compiler._paths = "expected" + + def CCompiler_spawn(self, cmd): + "A spawn without an env argument." + assert os.environ["PATH"] == "expected" + + with mock.patch.object(ccompiler.CCompiler, 'spawn', CCompiler_spawn): + compiler.spawn(["n/a"]) + + assert os.environ.get("PATH") != "expected" diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_unix.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_unix.py new file mode 100644 index 000000000..35b6b0e05 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/tests/test_unix.py @@ -0,0 +1,413 @@ +"""Tests for distutils.unixccompiler.""" + +import os +import sys +import unittest.mock as mock +from distutils import sysconfig +from distutils.compat import consolidate_linker_args +from distutils.errors import DistutilsPlatformError +from distutils.tests import support +from distutils.tests.compat.py39 import EnvironmentVarGuard +from distutils.util import _clear_cached_macosx_ver + +import pytest + +from .. import unix + + +@pytest.fixture(autouse=True) +def save_values(monkeypatch): + monkeypatch.setattr(sys, 'platform', sys.platform) + monkeypatch.setattr(sysconfig, 'get_config_var', sysconfig.get_config_var) + monkeypatch.setattr(sysconfig, 'get_config_vars', sysconfig.get_config_vars) + + +@pytest.fixture(autouse=True) +def compiler_wrapper(request): + class CompilerWrapper(unix.Compiler): + def rpath_foo(self): + return self.runtime_library_dir_option('/foo') + + request.instance.cc = CompilerWrapper() + + +class TestUnixCCompiler(support.TempdirManager): + @pytest.mark.skipif('platform.system == "Windows"') + def test_runtime_libdir_option(self): # noqa: C901 + # Issue #5900; GitHub Issue #37 + # + # Ensure RUNPATH is added to extension modules with RPATH if + # GNU ld is used + + # darwin + sys.platform = 'darwin' + darwin_ver_var = 'MACOSX_DEPLOYMENT_TARGET' + darwin_rpath_flag = '-Wl,-rpath,/foo' + darwin_lib_flag = '-L/foo' + + # (macOS version from syscfg, macOS version from env var) -> flag + # Version value of None generates two tests: as None and as empty string + # Expected flag value of None means an mismatch exception is expected + darwin_test_cases = [ + ((None, None), darwin_lib_flag), + ((None, '11'), darwin_rpath_flag), + (('10', None), darwin_lib_flag), + (('10.3', None), darwin_lib_flag), + (('10.3.1', None), darwin_lib_flag), + (('10.5', None), darwin_rpath_flag), + (('10.5.1', None), darwin_rpath_flag), + (('10.3', '10.3'), darwin_lib_flag), + (('10.3', '10.5'), darwin_rpath_flag), + (('10.5', '10.3'), darwin_lib_flag), + (('10.5', '11'), darwin_rpath_flag), + (('10.4', '10'), None), + ] + + def make_darwin_gcv(syscfg_macosx_ver): + def gcv(var): + if var == darwin_ver_var: + return syscfg_macosx_ver + return "xxx" + + return gcv + + def do_darwin_test(syscfg_macosx_ver, env_macosx_ver, expected_flag): + env = os.environ + msg = f"macOS version = (sysconfig={syscfg_macosx_ver!r}, env={env_macosx_ver!r})" + + # Save + old_gcv = sysconfig.get_config_var + old_env_macosx_ver = env.get(darwin_ver_var) + + # Setup environment + _clear_cached_macosx_ver() + sysconfig.get_config_var = make_darwin_gcv(syscfg_macosx_ver) + if env_macosx_ver is not None: + env[darwin_ver_var] = env_macosx_ver + elif darwin_ver_var in env: + env.pop(darwin_ver_var) + + # Run the test + if expected_flag is not None: + assert self.cc.rpath_foo() == expected_flag, msg + else: + with pytest.raises( + DistutilsPlatformError, match=darwin_ver_var + r' mismatch' + ): + self.cc.rpath_foo() + + # Restore + if old_env_macosx_ver is not None: + env[darwin_ver_var] = old_env_macosx_ver + elif darwin_ver_var in env: + env.pop(darwin_ver_var) + sysconfig.get_config_var = old_gcv + _clear_cached_macosx_ver() + + for macosx_vers, expected_flag in darwin_test_cases: + syscfg_macosx_ver, env_macosx_ver = macosx_vers + do_darwin_test(syscfg_macosx_ver, env_macosx_ver, expected_flag) + # Bonus test cases with None interpreted as empty string + if syscfg_macosx_ver is None: + do_darwin_test("", env_macosx_ver, expected_flag) + if env_macosx_ver is None: + do_darwin_test(syscfg_macosx_ver, "", expected_flag) + if syscfg_macosx_ver is None and env_macosx_ver is None: + do_darwin_test("", "", expected_flag) + + old_gcv = sysconfig.get_config_var + + # hp-ux + sys.platform = 'hp-ux' + + def gcv(v): + return 'xxx' + + sysconfig.get_config_var = gcv + assert self.cc.rpath_foo() == ['+s', '-L/foo'] + + def gcv(v): + return 'gcc' + + sysconfig.get_config_var = gcv + assert self.cc.rpath_foo() == ['-Wl,+s', '-L/foo'] + + def gcv(v): + return 'g++' + + sysconfig.get_config_var = gcv + assert self.cc.rpath_foo() == ['-Wl,+s', '-L/foo'] + + sysconfig.get_config_var = old_gcv + + # GCC GNULD + sys.platform = 'bar' + + def gcv(v): + if v == 'CC': + return 'gcc' + elif v == 'GNULD': + return 'yes' + + sysconfig.get_config_var = gcv + assert self.cc.rpath_foo() == consolidate_linker_args([ + '-Wl,--enable-new-dtags', + '-Wl,-rpath,/foo', + ]) + + def gcv(v): + if v == 'CC': + return 'gcc -pthread -B /bar' + elif v == 'GNULD': + return 'yes' + + sysconfig.get_config_var = gcv + assert self.cc.rpath_foo() == consolidate_linker_args([ + '-Wl,--enable-new-dtags', + '-Wl,-rpath,/foo', + ]) + + # GCC non-GNULD + sys.platform = 'bar' + + def gcv(v): + if v == 'CC': + return 'gcc' + elif v == 'GNULD': + return 'no' + + sysconfig.get_config_var = gcv + assert self.cc.rpath_foo() == '-Wl,-R/foo' + + # GCC GNULD with fully qualified configuration prefix + # see #7617 + sys.platform = 'bar' + + def gcv(v): + if v == 'CC': + return 'x86_64-pc-linux-gnu-gcc-4.4.2' + elif v == 'GNULD': + return 'yes' + + sysconfig.get_config_var = gcv + assert self.cc.rpath_foo() == consolidate_linker_args([ + '-Wl,--enable-new-dtags', + '-Wl,-rpath,/foo', + ]) + + # non-GCC GNULD + sys.platform = 'bar' + + def gcv(v): + if v == 'CC': + return 'cc' + elif v == 'GNULD': + return 'yes' + + sysconfig.get_config_var = gcv + assert self.cc.rpath_foo() == consolidate_linker_args([ + '-Wl,--enable-new-dtags', + '-Wl,-rpath,/foo', + ]) + + # non-GCC non-GNULD + sys.platform = 'bar' + + def gcv(v): + if v == 'CC': + return 'cc' + elif v == 'GNULD': + return 'no' + + sysconfig.get_config_var = gcv + assert self.cc.rpath_foo() == '-Wl,-R/foo' + + @pytest.mark.skipif('platform.system == "Windows"') + def test_cc_overrides_ldshared(self): + # Issue #18080: + # ensure that setting CC env variable also changes default linker + def gcv(v): + if v == 'LDSHARED': + return 'gcc-4.2 -bundle -undefined dynamic_lookup ' + return 'gcc-4.2' + + def gcvs(*args, _orig=sysconfig.get_config_vars): + if args: + return list(map(sysconfig.get_config_var, args)) + return _orig() + + sysconfig.get_config_var = gcv + sysconfig.get_config_vars = gcvs + with EnvironmentVarGuard() as env: + env['CC'] = 'my_cc' + del env['LDSHARED'] + sysconfig.customize_compiler(self.cc) + assert self.cc.linker_so[0] == 'my_cc' + + @pytest.mark.skipif('platform.system == "Windows"') + def test_cxx_commands_used_are_correct(self): + def gcv(v): + if v == 'LDSHARED': + return 'ccache gcc-4.2 -bundle -undefined dynamic_lookup' + elif v == 'LDCXXSHARED': + return 'ccache g++-4.2 -bundle -undefined dynamic_lookup' + elif v == 'CXX': + return 'ccache g++-4.2' + elif v == 'CC': + return 'ccache gcc-4.2' + return '' + + def gcvs(*args, _orig=sysconfig.get_config_vars): + if args: + return list(map(sysconfig.get_config_var, args)) + return _orig() # pragma: no cover + + sysconfig.get_config_var = gcv + sysconfig.get_config_vars = gcvs + with ( + mock.patch.object(self.cc, 'spawn', return_value=None) as mock_spawn, + mock.patch.object(self.cc, '_need_link', return_value=True), + mock.patch.object(self.cc, 'mkpath', return_value=None), + EnvironmentVarGuard() as env, + ): + # override environment overrides in case they're specified by CI + del env['CXX'] + del env['LDCXXSHARED'] + + sysconfig.customize_compiler(self.cc) + assert self.cc.linker_so_cxx[0:2] == ['ccache', 'g++-4.2'] + assert self.cc.linker_exe_cxx[0:2] == ['ccache', 'g++-4.2'] + self.cc.link(None, [], 'a.out', target_lang='c++') + call_args = mock_spawn.call_args[0][0] + expected = ['ccache', 'g++-4.2', '-bundle', '-undefined', 'dynamic_lookup'] + assert call_args[:5] == expected + + self.cc.link_executable([], 'a.out', target_lang='c++') + call_args = mock_spawn.call_args[0][0] + expected = ['ccache', 'g++-4.2', '-o', self.cc.executable_filename('a.out')] + assert call_args[:4] == expected + + env['LDCXXSHARED'] = 'wrapper g++-4.2 -bundle -undefined dynamic_lookup' + env['CXX'] = 'wrapper g++-4.2' + sysconfig.customize_compiler(self.cc) + assert self.cc.linker_so_cxx[0:2] == ['wrapper', 'g++-4.2'] + assert self.cc.linker_exe_cxx[0:2] == ['wrapper', 'g++-4.2'] + self.cc.link(None, [], 'a.out', target_lang='c++') + call_args = mock_spawn.call_args[0][0] + expected = ['wrapper', 'g++-4.2', '-bundle', '-undefined', 'dynamic_lookup'] + assert call_args[:5] == expected + + self.cc.link_executable([], 'a.out', target_lang='c++') + call_args = mock_spawn.call_args[0][0] + expected = [ + 'wrapper', + 'g++-4.2', + '-o', + self.cc.executable_filename('a.out'), + ] + assert call_args[:4] == expected + + @pytest.mark.skipif('platform.system == "Windows"') + @pytest.mark.usefixtures('disable_macos_customization') + def test_cc_overrides_ldshared_for_cxx_correctly(self): + """ + Ensure that setting CC env variable also changes default linker + correctly when building C++ extensions. + + pypa/distutils#126 + """ + + def gcv(v): + if v == 'LDSHARED': + return 'gcc-4.2 -bundle -undefined dynamic_lookup ' + elif v == 'LDCXXSHARED': + return 'g++-4.2 -bundle -undefined dynamic_lookup ' + elif v == 'CXX': + return 'g++-4.2' + elif v == 'CC': + return 'gcc-4.2' + return '' + + def gcvs(*args, _orig=sysconfig.get_config_vars): + if args: + return list(map(sysconfig.get_config_var, args)) + return _orig() + + sysconfig.get_config_var = gcv + sysconfig.get_config_vars = gcvs + with ( + mock.patch.object(self.cc, 'spawn', return_value=None) as mock_spawn, + mock.patch.object(self.cc, '_need_link', return_value=True), + mock.patch.object(self.cc, 'mkpath', return_value=None), + EnvironmentVarGuard() as env, + ): + env['CC'] = 'ccache my_cc' + env['CXX'] = 'my_cxx' + del env['LDSHARED'] + sysconfig.customize_compiler(self.cc) + assert self.cc.linker_so[0:2] == ['ccache', 'my_cc'] + self.cc.link(None, [], 'a.out', target_lang='c++') + call_args = mock_spawn.call_args[0][0] + expected = ['my_cxx', '-bundle', '-undefined', 'dynamic_lookup'] + assert call_args[:4] == expected + + @pytest.mark.skipif('platform.system == "Windows"') + def test_explicit_ldshared(self): + # Issue #18080: + # ensure that setting CC env variable does not change + # explicit LDSHARED setting for linker + def gcv(v): + if v == 'LDSHARED': + return 'gcc-4.2 -bundle -undefined dynamic_lookup ' + return 'gcc-4.2' + + def gcvs(*args, _orig=sysconfig.get_config_vars): + if args: + return list(map(sysconfig.get_config_var, args)) + return _orig() + + sysconfig.get_config_var = gcv + sysconfig.get_config_vars = gcvs + with EnvironmentVarGuard() as env: + env['CC'] = 'my_cc' + env['LDSHARED'] = 'my_ld -bundle -dynamic' + sysconfig.customize_compiler(self.cc) + assert self.cc.linker_so[0] == 'my_ld' + + def test_has_function(self): + # Issue https://github.com/pypa/distutils/issues/64: + # ensure that setting output_dir does not raise + # FileNotFoundError: [Errno 2] No such file or directory: 'a.out' + self.cc.output_dir = 'scratch' + os.chdir(self.mkdtemp()) + self.cc.has_function('abort') + + def test_find_library_file(self, monkeypatch): + compiler = unix.Compiler() + compiler._library_root = lambda dir: dir + monkeypatch.setattr(os.path, 'exists', lambda d: 'existing' in d) + + libname = 'libabc.dylib' if sys.platform != 'cygwin' else 'cygabc.dll' + dirs = ('/foo/bar/missing', '/foo/bar/existing') + assert ( + compiler.find_library_file(dirs, 'abc').replace('\\', '/') + == f'/foo/bar/existing/{libname}' + ) + assert ( + compiler.find_library_file(reversed(dirs), 'abc').replace('\\', '/') + == f'/foo/bar/existing/{libname}' + ) + + monkeypatch.setattr( + os.path, + 'exists', + lambda d: 'existing' in d and '.a' in d and '.dll.a' not in d, + ) + assert ( + compiler.find_library_file(dirs, 'abc').replace('\\', '/') + == '/foo/bar/existing/libabc.a' + ) + assert ( + compiler.find_library_file(reversed(dirs), 'abc').replace('\\', '/') + == '/foo/bar/existing/libabc.a' + ) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/unix.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/unix.py new file mode 100644 index 000000000..1231b32d2 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/unix.py @@ -0,0 +1,422 @@ +"""distutils.unixccompiler + +Contains the UnixCCompiler class, a subclass of CCompiler that handles +the "typical" Unix-style command-line C compiler: + * macros defined with -Dname[=value] + * macros undefined with -Uname + * include search directories specified with -Idir + * libraries specified with -lllib + * library search directories specified with -Ldir + * compile handled by 'cc' (or similar) executable with -c option: + compiles .c to .o + * link static library handled by 'ar' command (possibly with 'ranlib') + * link shared library handled by 'cc -shared' +""" + +from __future__ import annotations + +import itertools +import os +import re +import shlex +import sys +from collections.abc import Iterable + +from ... import sysconfig +from ..._log import log +from ..._macos_compat import compiler_fixup +from ..._modified import newer +from ...compat import consolidate_linker_args +from ...errors import DistutilsExecError +from . import base +from .base import _Macro, gen_lib_options, gen_preprocess_options +from .errors import ( + CompileError, + LibError, + LinkError, +) + +# XXX Things not currently handled: +# * optimization/debug/warning flags; we just use whatever's in Python's +# Makefile and live with it. Is this adequate? If not, we might +# have to have a bunch of subclasses GNUCCompiler, SGICCompiler, +# SunCCompiler, and I suspect down that road lies madness. +# * even if we don't know a warning flag from an optimization flag, +# we need some way for outsiders to feed preprocessor/compiler/linker +# flags in to us -- eg. a sysadmin might want to mandate certain flags +# via a site config file, or a user might want to set something for +# compiling this module distribution only via the setup.py command +# line, whatever. As long as these options come from something on the +# current system, they can be as system-dependent as they like, and we +# should just happily stuff them into the preprocessor/compiler/linker +# options and carry on. + + +def _split_env(cmd): + """ + For macOS, split command into 'env' portion (if any) + and the rest of the linker command. + + >>> _split_env(['a', 'b', 'c']) + ([], ['a', 'b', 'c']) + >>> _split_env(['/usr/bin/env', 'A=3', 'gcc']) + (['/usr/bin/env', 'A=3'], ['gcc']) + """ + pivot = 0 + if os.path.basename(cmd[0]) == "env": + pivot = 1 + while '=' in cmd[pivot]: + pivot += 1 + return cmd[:pivot], cmd[pivot:] + + +def _split_aix(cmd): + """ + AIX platforms prefix the compiler with the ld_so_aix + script, so split that from the linker command. + + >>> _split_aix(['a', 'b', 'c']) + ([], ['a', 'b', 'c']) + >>> _split_aix(['/bin/foo/ld_so_aix', 'gcc']) + (['/bin/foo/ld_so_aix'], ['gcc']) + """ + pivot = os.path.basename(cmd[0]) == 'ld_so_aix' + return cmd[:pivot], cmd[pivot:] + + +def _linker_params(linker_cmd, compiler_cmd): + """ + The linker command usually begins with the compiler + command (possibly multiple elements), followed by zero or more + params for shared library building. + + If the LDSHARED env variable overrides the linker command, + however, the commands may not match. + + Return the best guess of the linker parameters by stripping + the linker command. If the compiler command does not + match the linker command, assume the linker command is + just the first element. + + >>> _linker_params('gcc foo bar'.split(), ['gcc']) + ['foo', 'bar'] + >>> _linker_params('gcc foo bar'.split(), ['other']) + ['foo', 'bar'] + >>> _linker_params('ccache gcc foo bar'.split(), 'ccache gcc'.split()) + ['foo', 'bar'] + >>> _linker_params(['gcc'], ['gcc']) + [] + """ + c_len = len(compiler_cmd) + pivot = c_len if linker_cmd[:c_len] == compiler_cmd else 1 + return linker_cmd[pivot:] + + +class Compiler(base.Compiler): + compiler_type = 'unix' + + # These are used by CCompiler in two places: the constructor sets + # instance attributes 'preprocessor', 'compiler', etc. from them, and + # 'set_executable()' allows any of these to be set. The defaults here + # are pretty generic; they will probably have to be set by an outsider + # (eg. using information discovered by the sysconfig about building + # Python extensions). + executables = { + 'preprocessor': None, + 'compiler': ["cc"], + 'compiler_so': ["cc"], + 'compiler_cxx': ["c++"], + 'compiler_so_cxx': ["c++"], + 'linker_so': ["cc", "-shared"], + 'linker_so_cxx': ["c++", "-shared"], + 'linker_exe': ["cc"], + 'linker_exe_cxx': ["c++", "-shared"], + 'archiver': ["ar", "-cr"], + 'ranlib': None, + } + + if sys.platform[:6] == "darwin": + executables['ranlib'] = ["ranlib"] + + # Needed for the filename generation methods provided by the base + # class, CCompiler. NB. whoever instantiates/uses a particular + # UnixCCompiler instance should set 'shared_lib_ext' -- we set a + # reasonable common default here, but it's not necessarily used on all + # Unices! + + src_extensions = [".c", ".C", ".cc", ".cxx", ".cpp", ".m"] + obj_extension = ".o" + static_lib_extension = ".a" + shared_lib_extension = ".so" + dylib_lib_extension = ".dylib" + xcode_stub_lib_extension = ".tbd" + static_lib_format = shared_lib_format = dylib_lib_format = "lib%s%s" + xcode_stub_lib_format = dylib_lib_format + if sys.platform == "cygwin": + exe_extension = ".exe" + shared_lib_extension = ".dll.a" + dylib_lib_extension = ".dll" + dylib_lib_format = "cyg%s%s" + + def _fix_lib_args(self, libraries, library_dirs, runtime_library_dirs): + """Remove standard library path from rpath""" + libraries, library_dirs, runtime_library_dirs = super()._fix_lib_args( + libraries, library_dirs, runtime_library_dirs + ) + libdir = sysconfig.get_config_var('LIBDIR') + if ( + runtime_library_dirs + and libdir.startswith("/usr/lib") + and (libdir in runtime_library_dirs) + ): + runtime_library_dirs.remove(libdir) + return libraries, library_dirs, runtime_library_dirs + + def preprocess( + self, + source: str | os.PathLike[str], + output_file: str | os.PathLike[str] | None = None, + macros: list[_Macro] | None = None, + include_dirs: list[str] | tuple[str, ...] | None = None, + extra_preargs: list[str] | None = None, + extra_postargs: Iterable[str] | None = None, + ): + fixed_args = self._fix_compile_args(None, macros, include_dirs) + ignore, macros, include_dirs = fixed_args + pp_opts = gen_preprocess_options(macros, include_dirs) + pp_args = self.preprocessor + pp_opts + if output_file: + pp_args.extend(['-o', output_file]) + if extra_preargs: + pp_args[:0] = extra_preargs + if extra_postargs: + pp_args.extend(extra_postargs) + pp_args.append(source) + + # reasons to preprocess: + # - force is indicated + # - output is directed to stdout + # - source file is newer than the target + preprocess = self.force or output_file is None or newer(source, output_file) + if not preprocess: + return + + if output_file: + self.mkpath(os.path.dirname(output_file)) + + try: + self.spawn(pp_args) + except DistutilsExecError as msg: + raise CompileError(msg) + + def _compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts): + compiler_so = compiler_fixup(self.compiler_so, cc_args + extra_postargs) + compiler_so_cxx = compiler_fixup(self.compiler_so_cxx, cc_args + extra_postargs) + try: + if self.detect_language(src) == 'c++': + self.spawn( + compiler_so_cxx + cc_args + [src, '-o', obj] + extra_postargs + ) + else: + self.spawn(compiler_so + cc_args + [src, '-o', obj] + extra_postargs) + except DistutilsExecError as msg: + raise CompileError(msg) + + def create_static_lib( + self, objects, output_libname, output_dir=None, debug=False, target_lang=None + ): + objects, output_dir = self._fix_object_args(objects, output_dir) + + output_filename = self.library_filename(output_libname, output_dir=output_dir) + + if self._need_link(objects, output_filename): + self.mkpath(os.path.dirname(output_filename)) + self.spawn(self.archiver + [output_filename] + objects + self.objects) + + # Not many Unices required ranlib anymore -- SunOS 4.x is, I + # think the only major Unix that does. Maybe we need some + # platform intelligence here to skip ranlib if it's not + # needed -- or maybe Python's configure script took care of + # it for us, hence the check for leading colon. + if self.ranlib: + try: + self.spawn(self.ranlib + [output_filename]) + except DistutilsExecError as msg: + raise LibError(msg) + else: + log.debug("skipping %s (up-to-date)", output_filename) + + def link( + self, + target_desc, + objects: list[str] | tuple[str, ...], + output_filename, + output_dir: str | None = None, + libraries: list[str] | tuple[str, ...] | None = None, + library_dirs: list[str] | tuple[str, ...] | None = None, + runtime_library_dirs: list[str] | tuple[str, ...] | None = None, + export_symbols=None, + debug=False, + extra_preargs=None, + extra_postargs=None, + build_temp=None, + target_lang=None, + ): + objects, output_dir = self._fix_object_args(objects, output_dir) + fixed_args = self._fix_lib_args(libraries, library_dirs, runtime_library_dirs) + libraries, library_dirs, runtime_library_dirs = fixed_args + + lib_opts = gen_lib_options(self, library_dirs, runtime_library_dirs, libraries) + if not isinstance(output_dir, (str, type(None))): + raise TypeError("'output_dir' must be a string or None") + if output_dir is not None: + output_filename = os.path.join(output_dir, output_filename) + + if self._need_link(objects, output_filename): + ld_args = objects + self.objects + lib_opts + ['-o', output_filename] + if debug: + ld_args[:0] = ['-g'] + if extra_preargs: + ld_args[:0] = extra_preargs + if extra_postargs: + ld_args.extend(extra_postargs) + self.mkpath(os.path.dirname(output_filename)) + try: + # Select a linker based on context: linker_exe when + # building an executable or linker_so (with shared options) + # when building a shared library. + building_exe = target_desc == base.Compiler.EXECUTABLE + target_cxx = target_lang == "c++" + linker = ( + (self.linker_exe_cxx if target_cxx else self.linker_exe) + if building_exe + else (self.linker_so_cxx if target_cxx else self.linker_so) + )[:] + + if target_cxx and self.compiler_cxx: + env, linker_ne = _split_env(linker) + aix, linker_na = _split_aix(linker_ne) + _, compiler_cxx_ne = _split_env(self.compiler_cxx) + _, linker_exe_ne = _split_env(self.linker_exe_cxx) + + params = _linker_params(linker_na, linker_exe_ne) + linker = env + aix + compiler_cxx_ne + params + + linker = compiler_fixup(linker, ld_args) + + self.spawn(linker + ld_args) + except DistutilsExecError as msg: + raise LinkError(msg) + else: + log.debug("skipping %s (up-to-date)", output_filename) + + # -- Miscellaneous methods ----------------------------------------- + # These are all used by the 'gen_lib_options() function, in + # ccompiler.py. + + def library_dir_option(self, dir): + return "-L" + dir + + def _is_gcc(self): + cc_var = sysconfig.get_config_var("CC") + compiler = os.path.basename(shlex.split(cc_var)[0]) + return "gcc" in compiler or "g++" in compiler + + def runtime_library_dir_option(self, dir: str) -> str | list[str]: # type: ignore[override] # Fixed in pypa/distutils#339 + # XXX Hackish, at the very least. See Python bug #445902: + # https://bugs.python.org/issue445902 + # Linkers on different platforms need different options to + # specify that directories need to be added to the list of + # directories searched for dependencies when a dynamic library + # is sought. GCC on GNU systems (Linux, FreeBSD, ...) has to + # be told to pass the -R option through to the linker, whereas + # other compilers and gcc on other systems just know this. + # Other compilers may need something slightly different. At + # this time, there's no way to determine this information from + # the configuration data stored in the Python installation, so + # we use this hack. + if sys.platform[:6] == "darwin": + from distutils.util import get_macosx_target_ver, split_version + + macosx_target_ver = get_macosx_target_ver() + if macosx_target_ver and split_version(macosx_target_ver) >= [10, 5]: + return "-Wl,-rpath," + dir + else: # no support for -rpath on earlier macOS versions + return "-L" + dir + elif sys.platform[:7] == "freebsd": + return "-Wl,-rpath=" + dir + elif sys.platform[:5] == "hp-ux": + return [ + "-Wl,+s" if self._is_gcc() else "+s", + "-L" + dir, + ] + + # For all compilers, `-Wl` is the presumed way to pass a + # compiler option to the linker + if sysconfig.get_config_var("GNULD") == "yes": + return consolidate_linker_args([ + # Force RUNPATH instead of RPATH + "-Wl,--enable-new-dtags", + "-Wl,-rpath," + dir, + ]) + else: + return "-Wl,-R" + dir + + def library_option(self, lib): + return "-l" + lib + + @staticmethod + def _library_root(dir): + """ + macOS users can specify an alternate SDK using'-isysroot'. + Calculate the SDK root if it is specified. + + Note that, as of Xcode 7, Apple SDKs may contain textual stub + libraries with .tbd extensions rather than the normal .dylib + shared libraries installed in /. The Apple compiler tool + chain handles this transparently but it can cause problems + for programs that are being built with an SDK and searching + for specific libraries. Callers of find_library_file need to + keep in mind that the base filename of the returned SDK library + file might have a different extension from that of the library + file installed on the running system, for example: + /Applications/Xcode.app/Contents/Developer/Platforms/ + MacOSX.platform/Developer/SDKs/MacOSX10.11.sdk/ + usr/lib/libedit.tbd + vs + /usr/lib/libedit.dylib + """ + cflags = sysconfig.get_config_var('CFLAGS') + match = re.search(r'-isysroot\s*(\S+)', cflags) + + apply_root = ( + sys.platform == 'darwin' + and match + and ( + dir.startswith('/System/') + or (dir.startswith('/usr/') and not dir.startswith('/usr/local/')) + ) + ) + + return os.path.join(match.group(1), dir[1:]) if apply_root else dir + + def find_library_file(self, dirs, lib, debug=False): + """ + Second-guess the linker with not much hard + data to go on: GCC seems to prefer the shared library, so + assume that *all* Unix C compilers do, + ignoring even GCC's "-static" option. + """ + lib_names = ( + self.library_filename(lib, lib_type=type) + for type in 'dylib xcode_stub shared static'.split() + ) + + roots = map(self._library_root, dirs) + + searched = itertools.starmap(os.path.join, itertools.product(roots, lib_names)) + + found = filter(os.path.exists, searched) + + # Return None if it could not be found in any dir. + return next(found, None) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/zos.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/zos.py new file mode 100644 index 000000000..82d017fc9 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/compilers/C/zos.py @@ -0,0 +1,230 @@ +"""distutils.zosccompiler + +Contains the selection of the c & c++ compilers on z/OS. There are several +different c compilers on z/OS, all of them are optional, so the correct +one needs to be chosen based on the users input. This is compatible with +the following compilers: + +IBM C/C++ For Open Enterprise Languages on z/OS 2.0 +IBM Open XL C/C++ 1.1 for z/OS +IBM XL C/C++ V2.4.1 for z/OS 2.4 and 2.5 +IBM z/OS XL C/C++ +""" + +import os + +from ... import sysconfig +from ...errors import DistutilsExecError +from . import unix +from .errors import CompileError + +_cc_args = { + 'ibm-openxl': [ + '-m64', + '-fvisibility=default', + '-fzos-le-char-mode=ascii', + '-fno-short-enums', + ], + 'ibm-xlclang': [ + '-q64', + '-qexportall', + '-qascii', + '-qstrict', + '-qnocsect', + '-Wa,asa,goff', + '-Wa,xplink', + '-qgonumber', + '-qenum=int', + '-Wc,DLL', + ], + 'ibm-xlc': [ + '-q64', + '-qexportall', + '-qascii', + '-qstrict', + '-qnocsect', + '-Wa,asa,goff', + '-Wa,xplink', + '-qgonumber', + '-qenum=int', + '-Wc,DLL', + '-qlanglvl=extc99', + ], +} + +_cxx_args = { + 'ibm-openxl': [ + '-m64', + '-fvisibility=default', + '-fzos-le-char-mode=ascii', + '-fno-short-enums', + ], + 'ibm-xlclang': [ + '-q64', + '-qexportall', + '-qascii', + '-qstrict', + '-qnocsect', + '-Wa,asa,goff', + '-Wa,xplink', + '-qgonumber', + '-qenum=int', + '-Wc,DLL', + ], + 'ibm-xlc': [ + '-q64', + '-qexportall', + '-qascii', + '-qstrict', + '-qnocsect', + '-Wa,asa,goff', + '-Wa,xplink', + '-qgonumber', + '-qenum=int', + '-Wc,DLL', + '-qlanglvl=extended0x', + ], +} + +_asm_args = { + 'ibm-openxl': ['-fasm', '-fno-integrated-as', '-Wa,--ASA', '-Wa,--GOFF'], + 'ibm-xlclang': [], + 'ibm-xlc': [], +} + +_ld_args = { + 'ibm-openxl': [], + 'ibm-xlclang': ['-Wl,dll', '-q64'], + 'ibm-xlc': ['-Wl,dll', '-q64'], +} + + +# Python on z/OS is built with no compiler specific options in it's CFLAGS. +# But each compiler requires it's own specific options to build successfully, +# though some of the options are common between them +class Compiler(unix.Compiler): + src_extensions = ['.c', '.C', '.cc', '.cxx', '.cpp', '.m', '.s'] + _cpp_extensions = ['.cc', '.cpp', '.cxx', '.C'] + _asm_extensions = ['.s'] + + def _get_zos_compiler_name(self): + zos_compiler_names = [ + os.path.basename(binary) + for envvar in ('CC', 'CXX', 'LDSHARED') + if (binary := os.environ.get(envvar, None)) + ] + if len(zos_compiler_names) == 0: + return 'ibm-openxl' + + zos_compilers = {} + for compiler in ( + 'ibm-clang', + 'ibm-clang64', + 'ibm-clang++', + 'ibm-clang++64', + 'clang', + 'clang++', + 'clang-14', + ): + zos_compilers[compiler] = 'ibm-openxl' + + for compiler in ('xlclang', 'xlclang++', 'njsc', 'njsc++'): + zos_compilers[compiler] = 'ibm-xlclang' + + for compiler in ('xlc', 'xlC', 'xlc++'): + zos_compilers[compiler] = 'ibm-xlc' + + return zos_compilers.get(zos_compiler_names[0], 'ibm-openxl') + + def __init__(self, verbose=False, dry_run=False, force=False): + super().__init__(verbose, dry_run, force) + self.zos_compiler = self._get_zos_compiler_name() + sysconfig.customize_compiler(self) + + def _compile(self, obj, src, ext, cc_args, extra_postargs, pp_opts): + local_args = [] + if ext in self._cpp_extensions: + compiler = self.compiler_cxx + local_args.extend(_cxx_args[self.zos_compiler]) + elif ext in self._asm_extensions: + compiler = self.compiler_so + local_args.extend(_cc_args[self.zos_compiler]) + local_args.extend(_asm_args[self.zos_compiler]) + else: + compiler = self.compiler_so + local_args.extend(_cc_args[self.zos_compiler]) + local_args.extend(cc_args) + + try: + self.spawn(compiler + local_args + [src, '-o', obj] + extra_postargs) + except DistutilsExecError as msg: + raise CompileError(msg) + + def runtime_library_dir_option(self, dir): + return '-L' + dir + + def link( + self, + target_desc, + objects, + output_filename, + output_dir=None, + libraries=None, + library_dirs=None, + runtime_library_dirs=None, + export_symbols=None, + debug=False, + extra_preargs=None, + extra_postargs=None, + build_temp=None, + target_lang=None, + ): + # For a built module to use functions from cpython, it needs to use Pythons + # side deck file. The side deck is located beside the libpython3.xx.so + ldversion = sysconfig.get_config_var('LDVERSION') + if sysconfig.python_build: + side_deck_path = os.path.join( + sysconfig.get_config_var('abs_builddir'), + f'libpython{ldversion}.x', + ) + else: + side_deck_path = os.path.join( + sysconfig.get_config_var('installed_base'), + sysconfig.get_config_var('platlibdir'), + f'libpython{ldversion}.x', + ) + + if os.path.exists(side_deck_path): + if extra_postargs: + extra_postargs.append(side_deck_path) + else: + extra_postargs = [side_deck_path] + + # Check and replace libraries included side deck files + if runtime_library_dirs: + for dir in runtime_library_dirs: + for library in libraries[:]: + library_side_deck = os.path.join(dir, f'{library}.x') + if os.path.exists(library_side_deck): + libraries.remove(library) + extra_postargs.append(library_side_deck) + break + + # Any required ld args for the given compiler + extra_postargs.extend(_ld_args[self.zos_compiler]) + + super().link( + target_desc, + objects, + output_filename, + output_dir, + libraries, + library_dirs, + runtime_library_dirs, + export_symbols, + debug, + extra_preargs, + extra_postargs, + build_temp, + target_lang, + ) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/core.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/core.py new file mode 100644 index 000000000..bd62546bd --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/core.py @@ -0,0 +1,289 @@ +"""distutils.core + +The only module that needs to be imported to use the Distutils; provides +the 'setup' function (which is to be called from the setup script). Also +indirectly provides the Distribution and Command classes, although they are +really defined in distutils.dist and distutils.cmd. +""" + +from __future__ import annotations + +import os +import sys +import tokenize +from collections.abc import Iterable + +from .cmd import Command +from .debug import DEBUG + +# Mainly import these so setup scripts can "from distutils.core import" them. +from .dist import Distribution +from .errors import ( + CCompilerError, + DistutilsArgError, + DistutilsError, + DistutilsSetupError, +) +from .extension import Extension + +__all__ = ['Distribution', 'Command', 'Extension', 'setup'] + +# This is a barebones help message generated displayed when the user +# runs the setup script with no arguments at all. More useful help +# is generated with various --help options: global help, list commands, +# and per-command help. +USAGE = """\ +usage: %(script)s [global_opts] cmd1 [cmd1_opts] [cmd2 [cmd2_opts] ...] + or: %(script)s --help [cmd1 cmd2 ...] + or: %(script)s --help-commands + or: %(script)s cmd --help +""" + + +def gen_usage(script_name): + script = os.path.basename(script_name) + return USAGE % locals() + + +# Some mild magic to control the behaviour of 'setup()' from 'run_setup()'. +_setup_stop_after = None +_setup_distribution = None + +# Legal keyword arguments for the setup() function +setup_keywords = ( + 'distclass', + 'script_name', + 'script_args', + 'options', + 'name', + 'version', + 'author', + 'author_email', + 'maintainer', + 'maintainer_email', + 'url', + 'license', + 'description', + 'long_description', + 'keywords', + 'platforms', + 'classifiers', + 'download_url', + 'requires', + 'provides', + 'obsoletes', +) + +# Legal keyword arguments for the Extension constructor +extension_keywords = ( + 'name', + 'sources', + 'include_dirs', + 'define_macros', + 'undef_macros', + 'library_dirs', + 'libraries', + 'runtime_library_dirs', + 'extra_objects', + 'extra_compile_args', + 'extra_link_args', + 'swig_opts', + 'export_symbols', + 'depends', + 'language', +) + + +def setup(**attrs): # noqa: C901 + """The gateway to the Distutils: do everything your setup script needs + to do, in a highly flexible and user-driven way. Briefly: create a + Distribution instance; find and parse config files; parse the command + line; run each Distutils command found there, customized by the options + supplied to 'setup()' (as keyword arguments), in config files, and on + the command line. + + The Distribution instance might be an instance of a class supplied via + the 'distclass' keyword argument to 'setup'; if no such class is + supplied, then the Distribution class (in dist.py) is instantiated. + All other arguments to 'setup' (except for 'cmdclass') are used to set + attributes of the Distribution instance. + + The 'cmdclass' argument, if supplied, is a dictionary mapping command + names to command classes. Each command encountered on the command line + will be turned into a command class, which is in turn instantiated; any + class found in 'cmdclass' is used in place of the default, which is + (for command 'foo_bar') class 'foo_bar' in module + 'distutils.command.foo_bar'. The command class must provide a + 'user_options' attribute which is a list of option specifiers for + 'distutils.fancy_getopt'. Any command-line options between the current + and the next command are used to set attributes of the current command + object. + + When the entire command-line has been successfully parsed, calls the + 'run()' method on each command object in turn. This method will be + driven entirely by the Distribution object (which each command object + has a reference to, thanks to its constructor), and the + command-specific options that became attributes of each command + object. + """ + + global _setup_stop_after, _setup_distribution + + # Determine the distribution class -- either caller-supplied or + # our Distribution (see below). + klass = attrs.get('distclass') + if klass: + attrs.pop('distclass') + else: + klass = Distribution + + if 'script_name' not in attrs: + attrs['script_name'] = os.path.basename(sys.argv[0]) + if 'script_args' not in attrs: + attrs['script_args'] = sys.argv[1:] + + # Create the Distribution instance, using the remaining arguments + # (ie. everything except distclass) to initialize it + try: + _setup_distribution = dist = klass(attrs) + except DistutilsSetupError as msg: + if 'name' not in attrs: + raise SystemExit(f"error in setup command: {msg}") + else: + raise SystemExit("error in {} setup command: {}".format(attrs['name'], msg)) + + if _setup_stop_after == "init": + return dist + + # Find and parse the config file(s): they will override options from + # the setup script, but be overridden by the command line. + dist.parse_config_files() + + if DEBUG: + print("options (after parsing config files):") + dist.dump_option_dicts() + + if _setup_stop_after == "config": + return dist + + # Parse the command line and override config files; any + # command-line errors are the end user's fault, so turn them into + # SystemExit to suppress tracebacks. + try: + ok = dist.parse_command_line() + except DistutilsArgError as msg: + raise SystemExit(gen_usage(dist.script_name) + f"\nerror: {msg}") + + if DEBUG: + print("options (after parsing command line):") + dist.dump_option_dicts() + + if _setup_stop_after == "commandline": + return dist + + # And finally, run all the commands found on the command line. + if ok: + return run_commands(dist) + + return dist + + +# setup () + + +def run_commands(dist): + """Given a Distribution object run all the commands, + raising ``SystemExit`` errors in the case of failure. + + This function assumes that either ``sys.argv`` or ``dist.script_args`` + is already set accordingly. + """ + try: + dist.run_commands() + except KeyboardInterrupt: + raise SystemExit("interrupted") + except OSError as exc: + if DEBUG: + sys.stderr.write(f"error: {exc}\n") + raise + else: + raise SystemExit(f"error: {exc}") + + except (DistutilsError, CCompilerError) as msg: + if DEBUG: + raise + else: + raise SystemExit("error: " + str(msg)) + + return dist + + +def run_setup(script_name, script_args: Iterable[str] | None = None, stop_after="run"): + """Run a setup script in a somewhat controlled environment, and + return the Distribution instance that drives things. This is useful + if you need to find out the distribution meta-data (passed as + keyword args from 'script' to 'setup()', or the contents of the + config files or command-line. + + 'script_name' is a file that will be read and run with 'exec()'; + 'sys.argv[0]' will be replaced with 'script' for the duration of the + call. 'script_args' is a list of strings; if supplied, + 'sys.argv[1:]' will be replaced by 'script_args' for the duration of + the call. + + 'stop_after' tells 'setup()' when to stop processing; possible + values: + init + stop after the Distribution instance has been created and + populated with the keyword arguments to 'setup()' + config + stop after config files have been parsed (and their data + stored in the Distribution instance) + commandline + stop after the command-line ('sys.argv[1:]' or 'script_args') + have been parsed (and the data stored in the Distribution) + run [default] + stop after all commands have been run (the same as if 'setup()' + had been called in the usual way + + Returns the Distribution instance, which provides all information + used to drive the Distutils. + """ + if stop_after not in ('init', 'config', 'commandline', 'run'): + raise ValueError(f"invalid value for 'stop_after': {stop_after!r}") + + global _setup_stop_after, _setup_distribution + _setup_stop_after = stop_after + + save_argv = sys.argv.copy() + g = {'__file__': script_name, '__name__': '__main__'} + try: + try: + sys.argv[0] = script_name + if script_args is not None: + sys.argv[1:] = script_args + # tokenize.open supports automatic encoding detection + with tokenize.open(script_name) as f: + code = f.read().replace(r'\r\n', r'\n') + exec(code, g) + finally: + sys.argv = save_argv + _setup_stop_after = None + except SystemExit: + # Hmm, should we do something if exiting with a non-zero code + # (ie. error)? + pass + + if _setup_distribution is None: + raise RuntimeError( + "'distutils.core.setup()' was never called -- " + f"perhaps '{script_name}' is not a Distutils setup script?" + ) + + # I wonder if the setup script's namespace -- g and l -- would be of + # any interest to callers? + # print "_setup_distribution:", _setup_distribution + return _setup_distribution + + +# run_setup () diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/cygwinccompiler.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/cygwinccompiler.py new file mode 100644 index 000000000..de89e3cd8 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/cygwinccompiler.py @@ -0,0 +1,31 @@ +from .compilers.C import cygwin +from .compilers.C.cygwin import ( + CONFIG_H_NOTOK, + CONFIG_H_OK, + CONFIG_H_UNCERTAIN, + check_config_h, + get_msvcr, + is_cygwincc, +) + +__all__ = [ + 'CONFIG_H_NOTOK', + 'CONFIG_H_OK', + 'CONFIG_H_UNCERTAIN', + 'CygwinCCompiler', + 'Mingw32CCompiler', + 'check_config_h', + 'get_msvcr', + 'is_cygwincc', +] + + +CygwinCCompiler = cygwin.Compiler +Mingw32CCompiler = cygwin.MinGW32Compiler + + +get_versions = None +""" +A stand-in for the previous get_versions() function to prevent failures +when monkeypatched. See pypa/setuptools#2969. +""" diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/debug.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/debug.py new file mode 100644 index 000000000..daf1660f0 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/debug.py @@ -0,0 +1,5 @@ +import os + +# If DISTUTILS_DEBUG is anything other than the empty string, we run in +# debug mode. +DEBUG = os.environ.get('DISTUTILS_DEBUG') diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/dep_util.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/dep_util.py new file mode 100644 index 000000000..09a8a2e12 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/dep_util.py @@ -0,0 +1,14 @@ +import warnings + +from . import _modified + + +def __getattr__(name): + if name not in ['newer', 'newer_group', 'newer_pairwise']: + raise AttributeError(name) + warnings.warn( + "dep_util is Deprecated. Use functions from setuptools instead.", + DeprecationWarning, + stacklevel=2, + ) + return getattr(_modified, name) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/dir_util.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/dir_util.py new file mode 100644 index 000000000..d9782602c --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/dir_util.py @@ -0,0 +1,244 @@ +"""distutils.dir_util + +Utility functions for manipulating directories and directory trees.""" + +import functools +import itertools +import os +import pathlib + +from . import file_util +from ._log import log +from .errors import DistutilsFileError, DistutilsInternalError + + +class SkipRepeatAbsolutePaths(set): + """ + Cache for mkpath. + + In addition to cheapening redundant calls, eliminates redundant + "creating /foo/bar/baz" messages in dry-run mode. + """ + + def __init__(self): + SkipRepeatAbsolutePaths.instance = self + + @classmethod + def clear(cls): + super(cls, cls.instance).clear() + + def wrap(self, func): + @functools.wraps(func) + def wrapper(path, *args, **kwargs): + if path.absolute() in self: + return + result = func(path, *args, **kwargs) + self.add(path.absolute()) + return result + + return wrapper + + +# Python 3.8 compatibility +wrapper = SkipRepeatAbsolutePaths().wrap + + +@functools.singledispatch +@wrapper +def mkpath(name: pathlib.Path, mode=0o777, verbose=True, dry_run=False) -> None: + """Create a directory and any missing ancestor directories. + + If the directory already exists (or if 'name' is the empty string, which + means the current directory, which of course exists), then do nothing. + Raise DistutilsFileError if unable to create some directory along the way + (eg. some sub-path exists, but is a file rather than a directory). + If 'verbose' is true, log the directory created. + """ + if verbose and not name.is_dir(): + log.info("creating %s", name) + + try: + dry_run or name.mkdir(mode=mode, parents=True, exist_ok=True) + except OSError as exc: + raise DistutilsFileError(f"could not create '{name}': {exc.args[-1]}") + + +@mkpath.register +def _(name: str, *args, **kwargs): + return mkpath(pathlib.Path(name), *args, **kwargs) + + +@mkpath.register +def _(name: None, *args, **kwargs): + """ + Detect a common bug -- name is None. + """ + raise DistutilsInternalError(f"mkpath: 'name' must be a string (got {name!r})") + + +def create_tree(base_dir, files, mode=0o777, verbose=True, dry_run=False): + """Create all the empty directories under 'base_dir' needed to put 'files' + there. + + 'base_dir' is just the name of a directory which doesn't necessarily + exist yet; 'files' is a list of filenames to be interpreted relative to + 'base_dir'. 'base_dir' + the directory portion of every file in 'files' + will be created if it doesn't already exist. 'mode', 'verbose' and + 'dry_run' flags are as for 'mkpath()'. + """ + # First get the list of directories to create + need_dir = set(os.path.join(base_dir, os.path.dirname(file)) for file in files) + + # Now create them + for dir in sorted(need_dir): + mkpath(dir, mode, verbose=verbose, dry_run=dry_run) + + +def copy_tree( + src, + dst, + preserve_mode=True, + preserve_times=True, + preserve_symlinks=False, + update=False, + verbose=True, + dry_run=False, +): + """Copy an entire directory tree 'src' to a new location 'dst'. + + Both 'src' and 'dst' must be directory names. If 'src' is not a + directory, raise DistutilsFileError. If 'dst' does not exist, it is + created with 'mkpath()'. The end result of the copy is that every + file in 'src' is copied to 'dst', and directories under 'src' are + recursively copied to 'dst'. Return the list of files that were + copied or might have been copied, using their output name. The + return value is unaffected by 'update' or 'dry_run': it is simply + the list of all files under 'src', with the names changed to be + under 'dst'. + + 'preserve_mode' and 'preserve_times' are the same as for + 'copy_file'; note that they only apply to regular files, not to + directories. If 'preserve_symlinks' is true, symlinks will be + copied as symlinks (on platforms that support them!); otherwise + (the default), the destination of the symlink will be copied. + 'update' and 'verbose' are the same as for 'copy_file'. + """ + if not dry_run and not os.path.isdir(src): + raise DistutilsFileError(f"cannot copy tree '{src}': not a directory") + try: + names = os.listdir(src) + except OSError as e: + if dry_run: + names = [] + else: + raise DistutilsFileError(f"error listing files in '{src}': {e.strerror}") + + if not dry_run: + mkpath(dst, verbose=verbose) + + copy_one = functools.partial( + _copy_one, + src=src, + dst=dst, + preserve_symlinks=preserve_symlinks, + verbose=verbose, + dry_run=dry_run, + preserve_mode=preserve_mode, + preserve_times=preserve_times, + update=update, + ) + return list(itertools.chain.from_iterable(map(copy_one, names))) + + +def _copy_one( + name, + *, + src, + dst, + preserve_symlinks, + verbose, + dry_run, + preserve_mode, + preserve_times, + update, +): + src_name = os.path.join(src, name) + dst_name = os.path.join(dst, name) + + if name.startswith('.nfs'): + # skip NFS rename files + return + + if preserve_symlinks and os.path.islink(src_name): + link_dest = os.readlink(src_name) + if verbose >= 1: + log.info("linking %s -> %s", dst_name, link_dest) + if not dry_run: + os.symlink(link_dest, dst_name) + yield dst_name + + elif os.path.isdir(src_name): + yield from copy_tree( + src_name, + dst_name, + preserve_mode, + preserve_times, + preserve_symlinks, + update, + verbose=verbose, + dry_run=dry_run, + ) + else: + file_util.copy_file( + src_name, + dst_name, + preserve_mode, + preserve_times, + update, + verbose=verbose, + dry_run=dry_run, + ) + yield dst_name + + +def _build_cmdtuple(path, cmdtuples): + """Helper for remove_tree().""" + for f in os.listdir(path): + real_f = os.path.join(path, f) + if os.path.isdir(real_f) and not os.path.islink(real_f): + _build_cmdtuple(real_f, cmdtuples) + else: + cmdtuples.append((os.remove, real_f)) + cmdtuples.append((os.rmdir, path)) + + +def remove_tree(directory, verbose=True, dry_run=False): + """Recursively remove an entire directory tree. + + Any errors are ignored (apart from being reported to stdout if 'verbose' + is true). + """ + if verbose >= 1: + log.info("removing '%s' (and everything under it)", directory) + if dry_run: + return + cmdtuples = [] + _build_cmdtuple(directory, cmdtuples) + for cmd in cmdtuples: + try: + cmd[0](cmd[1]) + # Clear the cache + SkipRepeatAbsolutePaths.clear() + except OSError as exc: + log.warning("error removing %s: %s", directory, exc) + + +def ensure_relative(path): + """Take the full path 'path', and make it a relative path. + + This is useful to make 'path' the second argument to os.path.join(). + """ + drive, path = os.path.splitdrive(path) + if path[0:1] == os.sep: + path = drive + path[1:] + return path diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/dist.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/dist.py new file mode 100644 index 000000000..37b788df9 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/dist.py @@ -0,0 +1,1386 @@ +"""distutils.dist + +Provides the Distribution class, which represents the module distribution +being built/installed/distributed. +""" + +from __future__ import annotations + +import contextlib +import logging +import os +import pathlib +import re +import sys +import warnings +from collections.abc import Iterable, MutableMapping +from email import message_from_file +from typing import ( + IO, + TYPE_CHECKING, + Any, + ClassVar, + Literal, + TypeVar, + Union, + overload, +) + +from packaging.utils import canonicalize_name, canonicalize_version + +from ._log import log +from .debug import DEBUG +from .errors import ( + DistutilsArgError, + DistutilsClassError, + DistutilsModuleError, + DistutilsOptionError, +) +from .fancy_getopt import FancyGetopt, translate_longopt +from .util import check_environ, rfc822_escape, strtobool + +if TYPE_CHECKING: + from _typeshed import SupportsWrite + from typing_extensions import TypeAlias + + # type-only import because of mutual dependence between these modules + from .cmd import Command + +_CommandT = TypeVar("_CommandT", bound="Command") +_OptionsList: TypeAlias = list[ + Union[tuple[str, Union[str, None], str, int], tuple[str, Union[str, None], str]] +] + + +# Regex to define acceptable Distutils command names. This is not *quite* +# the same as a Python NAME -- I don't allow leading underscores. The fact +# that they're very similar is no coincidence; the default naming scheme is +# to look for a Python module named after the command. +command_re = re.compile(r'^[a-zA-Z]([a-zA-Z0-9_]*)$') + + +def _ensure_list(value: str | Iterable[str], fieldname) -> str | list[str]: + if isinstance(value, str): + # a string containing comma separated values is okay. It will + # be converted to a list by Distribution.finalize_options(). + pass + elif not isinstance(value, list): + # passing a tuple or an iterator perhaps, warn and convert + typename = type(value).__name__ + msg = "Warning: '{fieldname}' should be a list, got type '{typename}'" + msg = msg.format(**locals()) + log.warning(msg) + value = list(value) + return value + + +class Distribution: + """The core of the Distutils. Most of the work hiding behind 'setup' + is really done within a Distribution instance, which farms the work out + to the Distutils commands specified on the command line. + + Setup scripts will almost never instantiate Distribution directly, + unless the 'setup()' function is totally inadequate to their needs. + However, it is conceivable that a setup script might wish to subclass + Distribution for some specialized purpose, and then pass the subclass + to 'setup()' as the 'distclass' keyword argument. If so, it is + necessary to respect the expectations that 'setup' has of Distribution. + See the code for 'setup()', in core.py, for details. + """ + + # 'global_options' describes the command-line options that may be + # supplied to the setup script prior to any actual commands. + # Eg. "./setup.py -n" or "./setup.py --quiet" both take advantage of + # these global options. This list should be kept to a bare minimum, + # since every global option is also valid as a command option -- and we + # don't want to pollute the commands with too many options that they + # have minimal control over. + # The fourth entry for verbose means that it can be repeated. + global_options: ClassVar[_OptionsList] = [ + ('verbose', 'v', "run verbosely (default)", 1), + ('quiet', 'q', "run quietly (turns verbosity off)"), + ('dry-run', 'n', "don't actually do anything"), + ('help', 'h', "show detailed help message"), + ('no-user-cfg', None, 'ignore pydistutils.cfg in your home directory'), + ] + + # 'common_usage' is a short (2-3 line) string describing the common + # usage of the setup script. + common_usage: ClassVar[str] = """\ +Common commands: (see '--help-commands' for more) + + setup.py build will build the package underneath 'build/' + setup.py install will install the package +""" + + # options that are not propagated to the commands + display_options: ClassVar[_OptionsList] = [ + ('help-commands', None, "list all available commands"), + ('name', None, "print package name"), + ('version', 'V', "print package version"), + ('fullname', None, "print -"), + ('author', None, "print the author's name"), + ('author-email', None, "print the author's email address"), + ('maintainer', None, "print the maintainer's name"), + ('maintainer-email', None, "print the maintainer's email address"), + ('contact', None, "print the maintainer's name if known, else the author's"), + ( + 'contact-email', + None, + "print the maintainer's email address if known, else the author's", + ), + ('url', None, "print the URL for this package"), + ('license', None, "print the license of the package"), + ('licence', None, "alias for --license"), + ('description', None, "print the package description"), + ('long-description', None, "print the long package description"), + ('platforms', None, "print the list of platforms"), + ('classifiers', None, "print the list of classifiers"), + ('keywords', None, "print the list of keywords"), + ('provides', None, "print the list of packages/modules provided"), + ('requires', None, "print the list of packages/modules required"), + ('obsoletes', None, "print the list of packages/modules made obsolete"), + ] + display_option_names: ClassVar[list[str]] = [ + translate_longopt(x[0]) for x in display_options + ] + + # negative options are options that exclude other options + negative_opt: ClassVar[dict[str, str]] = {'quiet': 'verbose'} + + # -- Creation/initialization methods ------------------------------- + + # Can't Unpack a TypedDict with optional properties, so using Any instead + def __init__(self, attrs: MutableMapping[str, Any] | None = None) -> None: # noqa: C901 + """Construct a new Distribution instance: initialize all the + attributes of a Distribution, and then use 'attrs' (a dictionary + mapping attribute names to values) to assign some of those + attributes their "real" values. (Any attributes not mentioned in + 'attrs' will be assigned to some null value: 0, None, an empty list + or dictionary, etc.) Most importantly, initialize the + 'command_obj' attribute to the empty dictionary; this will be + filled in with real command objects by 'parse_command_line()'. + """ + + # Default values for our command-line options + self.verbose = True + self.dry_run = False + self.help = False + for attr in self.display_option_names: + setattr(self, attr, False) + + # Store the distribution meta-data (name, version, author, and so + # forth) in a separate object -- we're getting to have enough + # information here (and enough command-line options) that it's + # worth it. Also delegate 'get_XXX()' methods to the 'metadata' + # object in a sneaky and underhanded (but efficient!) way. + self.metadata = DistributionMetadata() + for basename in self.metadata._METHOD_BASENAMES: + method_name = "get_" + basename + setattr(self, method_name, getattr(self.metadata, method_name)) + + # 'cmdclass' maps command names to class objects, so we + # can 1) quickly figure out which class to instantiate when + # we need to create a new command object, and 2) have a way + # for the setup script to override command classes + self.cmdclass: dict[str, type[Command]] = {} + + # 'command_packages' is a list of packages in which commands + # are searched for. The factory for command 'foo' is expected + # to be named 'foo' in the module 'foo' in one of the packages + # named here. This list is searched from the left; an error + # is raised if no named package provides the command being + # searched for. (Always access using get_command_packages().) + self.command_packages: str | list[str] | None = None + + # 'script_name' and 'script_args' are usually set to sys.argv[0] + # and sys.argv[1:], but they can be overridden when the caller is + # not necessarily a setup script run from the command-line. + self.script_name: str | os.PathLike[str] | None = None + self.script_args: list[str] | None = None + + # 'command_options' is where we store command options between + # parsing them (from config files, the command-line, etc.) and when + # they are actually needed -- ie. when the command in question is + # instantiated. It is a dictionary of dictionaries of 2-tuples: + # command_options = { command_name : { option : (source, value) } } + self.command_options: dict[str, dict[str, tuple[str, str]]] = {} + + # 'dist_files' is the list of (command, pyversion, file) that + # have been created by any dist commands run so far. This is + # filled regardless of whether the run is dry or not. pyversion + # gives sysconfig.get_python_version() if the dist file is + # specific to a Python version, 'any' if it is good for all + # Python versions on the target platform, and '' for a source + # file. pyversion should not be used to specify minimum or + # maximum required Python versions; use the metainfo for that + # instead. + self.dist_files: list[tuple[str, str, str]] = [] + + # These options are really the business of various commands, rather + # than of the Distribution itself. We provide aliases for them in + # Distribution as a convenience to the developer. + self.packages = None + self.package_data: dict[str, list[str]] = {} + self.package_dir = None + self.py_modules = None + self.libraries = None + self.headers = None + self.ext_modules = None + self.ext_package = None + self.include_dirs = None + self.extra_path = None + self.scripts = None + self.data_files = None + self.password = '' + + # And now initialize bookkeeping stuff that can't be supplied by + # the caller at all. 'command_obj' maps command names to + # Command instances -- that's how we enforce that every command + # class is a singleton. + self.command_obj: dict[str, Command] = {} + + # 'have_run' maps command names to boolean values; it keeps track + # of whether we have actually run a particular command, to make it + # cheap to "run" a command whenever we think we might need to -- if + # it's already been done, no need for expensive filesystem + # operations, we just check the 'have_run' dictionary and carry on. + # It's only safe to query 'have_run' for a command class that has + # been instantiated -- a false value will be inserted when the + # command object is created, and replaced with a true value when + # the command is successfully run. Thus it's probably best to use + # '.get()' rather than a straight lookup. + self.have_run: dict[str, bool] = {} + + # Now we'll use the attrs dictionary (ultimately, keyword args from + # the setup script) to possibly override any or all of these + # distribution options. + + if attrs: + # Pull out the set of command options and work on them + # specifically. Note that this order guarantees that aliased + # command options will override any supplied redundantly + # through the general options dictionary. + options = attrs.get('options') + if options is not None: + del attrs['options'] + for command, cmd_options in options.items(): + opt_dict = self.get_option_dict(command) + for opt, val in cmd_options.items(): + opt_dict[opt] = ("setup script", val) + + if 'licence' in attrs: + attrs['license'] = attrs['licence'] + del attrs['licence'] + msg = "'licence' distribution option is deprecated; use 'license'" + warnings.warn(msg) + + # Now work on the rest of the attributes. Any attribute that's + # not already defined is invalid! + for key, val in attrs.items(): + if hasattr(self.metadata, "set_" + key): + getattr(self.metadata, "set_" + key)(val) + elif hasattr(self.metadata, key): + setattr(self.metadata, key, val) + elif hasattr(self, key): + setattr(self, key, val) + else: + msg = f"Unknown distribution option: {key!r}" + warnings.warn(msg) + + # no-user-cfg is handled before other command line args + # because other args override the config files, and this + # one is needed before we can load the config files. + # If attrs['script_args'] wasn't passed, assume false. + # + # This also make sure we just look at the global options + self.want_user_cfg = True + + if self.script_args is not None: + # Coerce any possible iterable from attrs into a list + self.script_args = list(self.script_args) + for arg in self.script_args: + if not arg.startswith('-'): + break + if arg == '--no-user-cfg': + self.want_user_cfg = False + break + + self.finalize_options() + + def get_option_dict(self, command): + """Get the option dictionary for a given command. If that + command's option dictionary hasn't been created yet, then create it + and return the new dictionary; otherwise, return the existing + option dictionary. + """ + dict = self.command_options.get(command) + if dict is None: + dict = self.command_options[command] = {} + return dict + + def dump_option_dicts(self, header=None, commands=None, indent: str = "") -> None: + from pprint import pformat + + if commands is None: # dump all command option dicts + commands = sorted(self.command_options.keys()) + + if header is not None: + self.announce(indent + header) + indent = indent + " " + + if not commands: + self.announce(indent + "no commands known yet") + return + + for cmd_name in commands: + opt_dict = self.command_options.get(cmd_name) + if opt_dict is None: + self.announce(indent + f"no option dict for '{cmd_name}' command") + else: + self.announce(indent + f"option dict for '{cmd_name}' command:") + out = pformat(opt_dict) + for line in out.split('\n'): + self.announce(indent + " " + line) + + # -- Config file finding/parsing methods --------------------------- + + def find_config_files(self): + """Find as many configuration files as should be processed for this + platform, and return a list of filenames in the order in which they + should be parsed. The filenames returned are guaranteed to exist + (modulo nasty race conditions). + + There are multiple possible config files: + - distutils.cfg in the Distutils installation directory (i.e. + where the top-level Distutils __inst__.py file lives) + - a file in the user's home directory named .pydistutils.cfg + on Unix and pydistutils.cfg on Windows/Mac; may be disabled + with the ``--no-user-cfg`` option + - setup.cfg in the current directory + - a file named by an environment variable + """ + check_environ() + files = [str(path) for path in self._gen_paths() if os.path.isfile(path)] + + if DEBUG: + self.announce("using config files: {}".format(', '.join(files))) + + return files + + def _gen_paths(self): + # The system-wide Distutils config file + sys_dir = pathlib.Path(sys.modules['distutils'].__file__).parent + yield sys_dir / "distutils.cfg" + + # The per-user config file + prefix = '.' * (os.name == 'posix') + filename = prefix + 'pydistutils.cfg' + if self.want_user_cfg: + with contextlib.suppress(RuntimeError): + yield pathlib.Path('~').expanduser() / filename + + # All platforms support local setup.cfg + yield pathlib.Path('setup.cfg') + + # Additional config indicated in the environment + with contextlib.suppress(TypeError): + yield pathlib.Path(os.getenv("DIST_EXTRA_CONFIG")) + + def parse_config_files(self, filenames=None): # noqa: C901 + from configparser import ConfigParser + + # Ignore install directory options if we have a venv + if sys.prefix != sys.base_prefix: + ignore_options = [ + 'install-base', + 'install-platbase', + 'install-lib', + 'install-platlib', + 'install-purelib', + 'install-headers', + 'install-scripts', + 'install-data', + 'prefix', + 'exec-prefix', + 'home', + 'user', + 'root', + ] + else: + ignore_options = [] + + ignore_options = frozenset(ignore_options) + + if filenames is None: + filenames = self.find_config_files() + + if DEBUG: + self.announce("Distribution.parse_config_files():") + + parser = ConfigParser() + for filename in filenames: + if DEBUG: + self.announce(f" reading {filename}") + parser.read(filename, encoding='utf-8') + for section in parser.sections(): + options = parser.options(section) + opt_dict = self.get_option_dict(section) + + for opt in options: + if opt != '__name__' and opt not in ignore_options: + val = parser.get(section, opt) + opt = opt.replace('-', '_') + opt_dict[opt] = (filename, val) + + # Make the ConfigParser forget everything (so we retain + # the original filenames that options come from) + parser.__init__() + + # If there was a "global" section in the config file, use it + # to set Distribution options. + + if 'global' in self.command_options: + for opt, (_src, val) in self.command_options['global'].items(): + alias = self.negative_opt.get(opt) + try: + if alias: + setattr(self, alias, not strtobool(val)) + elif opt in ('verbose', 'dry_run'): # ugh! + setattr(self, opt, strtobool(val)) + else: + setattr(self, opt, val) + except ValueError as msg: + raise DistutilsOptionError(msg) + + # -- Command-line parsing methods ---------------------------------- + + def parse_command_line(self): + """Parse the setup script's command line, taken from the + 'script_args' instance attribute (which defaults to 'sys.argv[1:]' + -- see 'setup()' in core.py). This list is first processed for + "global options" -- options that set attributes of the Distribution + instance. Then, it is alternately scanned for Distutils commands + and options for that command. Each new command terminates the + options for the previous command. The allowed options for a + command are determined by the 'user_options' attribute of the + command class -- thus, we have to be able to load command classes + in order to parse the command line. Any error in that 'options' + attribute raises DistutilsGetoptError; any error on the + command-line raises DistutilsArgError. If no Distutils commands + were found on the command line, raises DistutilsArgError. Return + true if command-line was successfully parsed and we should carry + on with executing commands; false if no errors but we shouldn't + execute commands (currently, this only happens if user asks for + help). + """ + # + # We now have enough information to show the Macintosh dialog + # that allows the user to interactively specify the "command line". + # + toplevel_options = self._get_toplevel_options() + + # We have to parse the command line a bit at a time -- global + # options, then the first command, then its options, and so on -- + # because each command will be handled by a different class, and + # the options that are valid for a particular class aren't known + # until we have loaded the command class, which doesn't happen + # until we know what the command is. + + self.commands = [] + parser = FancyGetopt(toplevel_options + self.display_options) + parser.set_negative_aliases(self.negative_opt) + parser.set_aliases({'licence': 'license'}) + args = parser.getopt(args=self.script_args, object=self) + option_order = parser.get_option_order() + logging.getLogger().setLevel(logging.WARN - 10 * self.verbose) + + # for display options we return immediately + if self.handle_display_options(option_order): + return + while args: + args = self._parse_command_opts(parser, args) + if args is None: # user asked for help (and got it) + return + + # Handle the cases of --help as a "global" option, ie. + # "setup.py --help" and "setup.py --help command ...". For the + # former, we show global options (--verbose, --dry-run, etc.) + # and display-only options (--name, --version, etc.); for the + # latter, we omit the display-only options and show help for + # each command listed on the command line. + if self.help: + self._show_help( + parser, display_options=len(self.commands) == 0, commands=self.commands + ) + return + + # Oops, no commands found -- an end-user error + if not self.commands: + raise DistutilsArgError("no commands supplied") + + # All is well: return true + return True + + def _get_toplevel_options(self): + """Return the non-display options recognized at the top level. + + This includes options that are recognized *only* at the top + level as well as options recognized for commands. + """ + return self.global_options + [ + ( + "command-packages=", + None, + "list of packages that provide distutils commands", + ), + ] + + def _parse_command_opts(self, parser, args): # noqa: C901 + """Parse the command-line options for a single command. + 'parser' must be a FancyGetopt instance; 'args' must be the list + of arguments, starting with the current command (whose options + we are about to parse). Returns a new version of 'args' with + the next command at the front of the list; will be the empty + list if there are no more commands on the command line. Returns + None if the user asked for help on this command. + """ + # late import because of mutual dependence between these modules + from distutils.cmd import Command + + # Pull the current command from the head of the command line + command = args[0] + if not command_re.match(command): + raise SystemExit(f"invalid command name '{command}'") + self.commands.append(command) + + # Dig up the command class that implements this command, so we + # 1) know that it's a valid command, and 2) know which options + # it takes. + try: + cmd_class = self.get_command_class(command) + except DistutilsModuleError as msg: + raise DistutilsArgError(msg) + + # Require that the command class be derived from Command -- want + # to be sure that the basic "command" interface is implemented. + if not issubclass(cmd_class, Command): + raise DistutilsClassError( + f"command class {cmd_class} must subclass Command" + ) + + # Also make sure that the command object provides a list of its + # known options. + if not ( + hasattr(cmd_class, 'user_options') + and isinstance(cmd_class.user_options, list) + ): + msg = ( + "command class %s must provide " + "'user_options' attribute (a list of tuples)" + ) + raise DistutilsClassError(msg % cmd_class) + + # If the command class has a list of negative alias options, + # merge it in with the global negative aliases. + negative_opt = self.negative_opt + if hasattr(cmd_class, 'negative_opt'): + negative_opt = negative_opt.copy() + negative_opt.update(cmd_class.negative_opt) + + # Check for help_options in command class. They have a different + # format (tuple of four) so we need to preprocess them here. + if hasattr(cmd_class, 'help_options') and isinstance( + cmd_class.help_options, list + ): + help_options = fix_help_options(cmd_class.help_options) + else: + help_options = [] + + # All commands support the global options too, just by adding + # in 'global_options'. + parser.set_option_table( + self.global_options + cmd_class.user_options + help_options + ) + parser.set_negative_aliases(negative_opt) + (args, opts) = parser.getopt(args[1:]) + if hasattr(opts, 'help') and opts.help: + self._show_help(parser, display_options=False, commands=[cmd_class]) + return + + if hasattr(cmd_class, 'help_options') and isinstance( + cmd_class.help_options, list + ): + help_option_found = 0 + for help_option, _short, _desc, func in cmd_class.help_options: + if hasattr(opts, parser.get_attr_name(help_option)): + help_option_found = 1 + if callable(func): + func() + else: + raise DistutilsClassError( + f"invalid help function {func!r} for help option '{help_option}': " + "must be a callable object (function, etc.)" + ) + + if help_option_found: + return + + # Put the options from the command-line into their official + # holding pen, the 'command_options' dictionary. + opt_dict = self.get_option_dict(command) + for name, value in vars(opts).items(): + opt_dict[name] = ("command line", value) + + return args + + def finalize_options(self) -> None: + """Set final values for all the options on the Distribution + instance, analogous to the .finalize_options() method of Command + objects. + """ + for attr in ('keywords', 'platforms'): + value = getattr(self.metadata, attr) + if value is None: + continue + if isinstance(value, str): + value = [elm.strip() for elm in value.split(',')] + setattr(self.metadata, attr, value) + + def _show_help( + self, parser, global_options=True, display_options=True, commands: Iterable = () + ): + """Show help for the setup script command-line in the form of + several lists of command-line options. 'parser' should be a + FancyGetopt instance; do not expect it to be returned in the + same state, as its option table will be reset to make it + generate the correct help text. + + If 'global_options' is true, lists the global options: + --verbose, --dry-run, etc. If 'display_options' is true, lists + the "display-only" options: --name, --version, etc. Finally, + lists per-command help for every command name or command class + in 'commands'. + """ + # late import because of mutual dependence between these modules + from distutils.cmd import Command + from distutils.core import gen_usage + + if global_options: + if display_options: + options = self._get_toplevel_options() + else: + options = self.global_options + parser.set_option_table(options) + parser.print_help(self.common_usage + "\nGlobal options:") + print() + + if display_options: + parser.set_option_table(self.display_options) + parser.print_help( + "Information display options (just display information, ignore any commands)" + ) + print() + + for command in commands: + if isinstance(command, type) and issubclass(command, Command): + klass = command + else: + klass = self.get_command_class(command) + if hasattr(klass, 'help_options') and isinstance(klass.help_options, list): + parser.set_option_table( + klass.user_options + fix_help_options(klass.help_options) + ) + else: + parser.set_option_table(klass.user_options) + parser.print_help(f"Options for '{klass.__name__}' command:") + print() + + print(gen_usage(self.script_name)) + + def handle_display_options(self, option_order): + """If there were any non-global "display-only" options + (--help-commands or the metadata display options) on the command + line, display the requested info and return true; else return + false. + """ + from distutils.core import gen_usage + + # User just wants a list of commands -- we'll print it out and stop + # processing now (ie. if they ran "setup --help-commands foo bar", + # we ignore "foo bar"). + if self.help_commands: + self.print_commands() + print() + print(gen_usage(self.script_name)) + return 1 + + # If user supplied any of the "display metadata" options, then + # display that metadata in the order in which the user supplied the + # metadata options. + any_display_options = 0 + is_display_option = set() + for option in self.display_options: + is_display_option.add(option[0]) + + for opt, val in option_order: + if val and opt in is_display_option: + opt = translate_longopt(opt) + value = getattr(self.metadata, "get_" + opt)() + if opt in ('keywords', 'platforms'): + print(','.join(value)) + elif opt in ('classifiers', 'provides', 'requires', 'obsoletes'): + print('\n'.join(value)) + else: + print(value) + any_display_options = 1 + + return any_display_options + + def print_command_list(self, commands, header, max_length) -> None: + """Print a subset of the list of all commands -- used by + 'print_commands()'. + """ + print(header + ":") + + for cmd in commands: + klass = self.cmdclass.get(cmd) + if not klass: + klass = self.get_command_class(cmd) + try: + description = klass.description + except AttributeError: + description = "(no description available)" + + print(f" {cmd:<{max_length}} {description}") + + def print_commands(self) -> None: + """Print out a help message listing all available commands with a + description of each. The list is divided into "standard commands" + (listed in distutils.command.__all__) and "extra commands" + (mentioned in self.cmdclass, but not a standard command). The + descriptions come from the command class attribute + 'description'. + """ + import distutils.command + + std_commands = distutils.command.__all__ + is_std = set(std_commands) + + extra_commands = [cmd for cmd in self.cmdclass.keys() if cmd not in is_std] + + max_length = 0 + for cmd in std_commands + extra_commands: + if len(cmd) > max_length: + max_length = len(cmd) + + self.print_command_list(std_commands, "Standard commands", max_length) + if extra_commands: + print() + self.print_command_list(extra_commands, "Extra commands", max_length) + + def get_command_list(self): + """Get a list of (command, description) tuples. + The list is divided into "standard commands" (listed in + distutils.command.__all__) and "extra commands" (mentioned in + self.cmdclass, but not a standard command). The descriptions come + from the command class attribute 'description'. + """ + # Currently this is only used on Mac OS, for the Mac-only GUI + # Distutils interface (by Jack Jansen) + import distutils.command + + std_commands = distutils.command.__all__ + is_std = set(std_commands) + + extra_commands = [cmd for cmd in self.cmdclass.keys() if cmd not in is_std] + + rv = [] + for cmd in std_commands + extra_commands: + klass = self.cmdclass.get(cmd) + if not klass: + klass = self.get_command_class(cmd) + try: + description = klass.description + except AttributeError: + description = "(no description available)" + rv.append((cmd, description)) + return rv + + # -- Command class/object methods ---------------------------------- + + def get_command_packages(self): + """Return a list of packages from which commands are loaded.""" + pkgs = self.command_packages + if not isinstance(pkgs, list): + if pkgs is None: + pkgs = '' + pkgs = [pkg.strip() for pkg in pkgs.split(',') if pkg != ''] + if "distutils.command" not in pkgs: + pkgs.insert(0, "distutils.command") + self.command_packages = pkgs + return pkgs + + def get_command_class(self, command: str) -> type[Command]: + """Return the class that implements the Distutils command named by + 'command'. First we check the 'cmdclass' dictionary; if the + command is mentioned there, we fetch the class object from the + dictionary and return it. Otherwise we load the command module + ("distutils.command." + command) and fetch the command class from + the module. The loaded class is also stored in 'cmdclass' + to speed future calls to 'get_command_class()'. + + Raises DistutilsModuleError if the expected module could not be + found, or if that module does not define the expected class. + """ + klass = self.cmdclass.get(command) + if klass: + return klass + + for pkgname in self.get_command_packages(): + module_name = f"{pkgname}.{command}" + klass_name = command + + try: + __import__(module_name) + module = sys.modules[module_name] + except ImportError: + continue + + try: + klass = getattr(module, klass_name) + except AttributeError: + raise DistutilsModuleError( + f"invalid command '{command}' (no class '{klass_name}' in module '{module_name}')" + ) + + self.cmdclass[command] = klass + return klass + + raise DistutilsModuleError(f"invalid command '{command}'") + + @overload + def get_command_obj( + self, command: str, create: Literal[True] = True + ) -> Command: ... + @overload + def get_command_obj( + self, command: str, create: Literal[False] + ) -> Command | None: ... + def get_command_obj(self, command: str, create: bool = True) -> Command | None: + """Return the command object for 'command'. Normally this object + is cached on a previous call to 'get_command_obj()'; if no command + object for 'command' is in the cache, then we either create and + return it (if 'create' is true) or return None. + """ + cmd_obj = self.command_obj.get(command) + if not cmd_obj and create: + if DEBUG: + self.announce( + "Distribution.get_command_obj(): " + f"creating '{command}' command object" + ) + + klass = self.get_command_class(command) + cmd_obj = self.command_obj[command] = klass(self) + self.have_run[command] = False + + # Set any options that were supplied in config files + # or on the command line. (NB. support for error + # reporting is lame here: any errors aren't reported + # until 'finalize_options()' is called, which means + # we won't report the source of the error.) + options = self.command_options.get(command) + if options: + self._set_command_options(cmd_obj, options) + + return cmd_obj + + def _set_command_options(self, command_obj, option_dict=None): # noqa: C901 + """Set the options for 'command_obj' from 'option_dict'. Basically + this means copying elements of a dictionary ('option_dict') to + attributes of an instance ('command'). + + 'command_obj' must be a Command instance. If 'option_dict' is not + supplied, uses the standard option dictionary for this command + (from 'self.command_options'). + """ + command_name = command_obj.get_command_name() + if option_dict is None: + option_dict = self.get_option_dict(command_name) + + if DEBUG: + self.announce(f" setting options for '{command_name}' command:") + for option, (source, value) in option_dict.items(): + if DEBUG: + self.announce(f" {option} = {value} (from {source})") + try: + bool_opts = [translate_longopt(o) for o in command_obj.boolean_options] + except AttributeError: + bool_opts = [] + try: + neg_opt = command_obj.negative_opt + except AttributeError: + neg_opt = {} + + try: + is_string = isinstance(value, str) + if option in neg_opt and is_string: + setattr(command_obj, neg_opt[option], not strtobool(value)) + elif option in bool_opts and is_string: + setattr(command_obj, option, strtobool(value)) + elif hasattr(command_obj, option): + setattr(command_obj, option, value) + else: + raise DistutilsOptionError( + f"error in {source}: command '{command_name}' has no such option '{option}'" + ) + except ValueError as msg: + raise DistutilsOptionError(msg) + + @overload + def reinitialize_command( + self, command: str, reinit_subcommands: bool = False + ) -> Command: ... + @overload + def reinitialize_command( + self, command: _CommandT, reinit_subcommands: bool = False + ) -> _CommandT: ... + def reinitialize_command( + self, command: str | Command, reinit_subcommands=False + ) -> Command: + """Reinitializes a command to the state it was in when first + returned by 'get_command_obj()': ie., initialized but not yet + finalized. This provides the opportunity to sneak option + values in programmatically, overriding or supplementing + user-supplied values from the config files and command line. + You'll have to re-finalize the command object (by calling + 'finalize_options()' or 'ensure_finalized()') before using it for + real. + + 'command' should be a command name (string) or command object. If + 'reinit_subcommands' is true, also reinitializes the command's + sub-commands, as declared by the 'sub_commands' class attribute (if + it has one). See the "install" command for an example. Only + reinitializes the sub-commands that actually matter, ie. those + whose test predicates return true. + + Returns the reinitialized command object. + """ + from distutils.cmd import Command + + if not isinstance(command, Command): + command_name = command + command = self.get_command_obj(command_name) + else: + command_name = command.get_command_name() + + if not command.finalized: + return command + command.initialize_options() + command.finalized = False + self.have_run[command_name] = False + self._set_command_options(command) + + if reinit_subcommands: + for sub in command.get_sub_commands(): + self.reinitialize_command(sub, reinit_subcommands) + + return command + + # -- Methods that operate on the Distribution ---------------------- + + def announce(self, msg, level: int = logging.INFO) -> None: + log.log(level, msg) + + def run_commands(self) -> None: + """Run each command that was seen on the setup script command line. + Uses the list of commands found and cache of command objects + created by 'get_command_obj()'. + """ + for cmd in self.commands: + self.run_command(cmd) + + # -- Methods that operate on its Commands -------------------------- + + def run_command(self, command: str) -> None: + """Do whatever it takes to run a command (including nothing at all, + if the command has already been run). Specifically: if we have + already created and run the command named by 'command', return + silently without doing anything. If the command named by 'command' + doesn't even have a command object yet, create one. Then invoke + 'run()' on that command object (or an existing one). + """ + # Already been here, done that? then return silently. + if self.have_run.get(command): + return + + log.info("running %s", command) + cmd_obj = self.get_command_obj(command) + cmd_obj.ensure_finalized() + cmd_obj.run() + self.have_run[command] = True + + # -- Distribution query methods ------------------------------------ + + def has_pure_modules(self) -> bool: + return len(self.packages or self.py_modules or []) > 0 + + def has_ext_modules(self) -> bool: + return self.ext_modules and len(self.ext_modules) > 0 + + def has_c_libraries(self) -> bool: + return self.libraries and len(self.libraries) > 0 + + def has_modules(self) -> bool: + return self.has_pure_modules() or self.has_ext_modules() + + def has_headers(self) -> bool: + return self.headers and len(self.headers) > 0 + + def has_scripts(self) -> bool: + return self.scripts and len(self.scripts) > 0 + + def has_data_files(self) -> bool: + return self.data_files and len(self.data_files) > 0 + + def is_pure(self) -> bool: + return ( + self.has_pure_modules() + and not self.has_ext_modules() + and not self.has_c_libraries() + ) + + # -- Metadata query methods ---------------------------------------- + + # If you're looking for 'get_name()', 'get_version()', and so forth, + # they are defined in a sneaky way: the constructor binds self.get_XXX + # to self.metadata.get_XXX. The actual code is in the + # DistributionMetadata class, below. + if TYPE_CHECKING: + # Unfortunately this means we need to specify them manually or not expose statically + def _(self) -> None: + self.get_name = self.metadata.get_name + self.get_version = self.metadata.get_version + self.get_fullname = self.metadata.get_fullname + self.get_author = self.metadata.get_author + self.get_author_email = self.metadata.get_author_email + self.get_maintainer = self.metadata.get_maintainer + self.get_maintainer_email = self.metadata.get_maintainer_email + self.get_contact = self.metadata.get_contact + self.get_contact_email = self.metadata.get_contact_email + self.get_url = self.metadata.get_url + self.get_license = self.metadata.get_license + self.get_licence = self.metadata.get_licence + self.get_description = self.metadata.get_description + self.get_long_description = self.metadata.get_long_description + self.get_keywords = self.metadata.get_keywords + self.get_platforms = self.metadata.get_platforms + self.get_classifiers = self.metadata.get_classifiers + self.get_download_url = self.metadata.get_download_url + self.get_requires = self.metadata.get_requires + self.get_provides = self.metadata.get_provides + self.get_obsoletes = self.metadata.get_obsoletes + + # Default attributes generated in __init__ from self.display_option_names + help_commands: bool + name: str | Literal[False] + version: str | Literal[False] + fullname: str | Literal[False] + author: str | Literal[False] + author_email: str | Literal[False] + maintainer: str | Literal[False] + maintainer_email: str | Literal[False] + contact: str | Literal[False] + contact_email: str | Literal[False] + url: str | Literal[False] + license: str | Literal[False] + licence: str | Literal[False] + description: str | Literal[False] + long_description: str | Literal[False] + platforms: str | list[str] | Literal[False] + classifiers: str | list[str] | Literal[False] + keywords: str | list[str] | Literal[False] + provides: list[str] | Literal[False] + requires: list[str] | Literal[False] + obsoletes: list[str] | Literal[False] + + +class DistributionMetadata: + """Dummy class to hold the distribution meta-data: name, version, + author, and so forth. + """ + + _METHOD_BASENAMES = ( + "name", + "version", + "author", + "author_email", + "maintainer", + "maintainer_email", + "url", + "license", + "description", + "long_description", + "keywords", + "platforms", + "fullname", + "contact", + "contact_email", + "classifiers", + "download_url", + # PEP 314 + "provides", + "requires", + "obsoletes", + ) + + def __init__( + self, path: str | bytes | os.PathLike[str] | os.PathLike[bytes] | None = None + ) -> None: + if path is not None: + self.read_pkg_file(open(path)) + else: + self.name: str | None = None + self.version: str | None = None + self.author: str | None = None + self.author_email: str | None = None + self.maintainer: str | None = None + self.maintainer_email: str | None = None + self.url: str | None = None + self.license: str | None = None + self.description: str | None = None + self.long_description: str | None = None + self.keywords: str | list[str] | None = None + self.platforms: str | list[str] | None = None + self.classifiers: str | list[str] | None = None + self.download_url: str | None = None + # PEP 314 + self.provides: str | list[str] | None = None + self.requires: str | list[str] | None = None + self.obsoletes: str | list[str] | None = None + + def read_pkg_file(self, file: IO[str]) -> None: + """Reads the metadata values from a file object.""" + msg = message_from_file(file) + + def _read_field(name: str) -> str | None: + value = msg[name] + if value and value != "UNKNOWN": + return value + return None + + def _read_list(name): + values = msg.get_all(name, None) + if values == []: + return None + return values + + metadata_version = msg['metadata-version'] + self.name = _read_field('name') + self.version = _read_field('version') + self.description = _read_field('summary') + # we are filling author only. + self.author = _read_field('author') + self.maintainer = None + self.author_email = _read_field('author-email') + self.maintainer_email = None + self.url = _read_field('home-page') + self.license = _read_field('license') + + if 'download-url' in msg: + self.download_url = _read_field('download-url') + else: + self.download_url = None + + self.long_description = _read_field('description') + self.description = _read_field('summary') + + if 'keywords' in msg: + self.keywords = _read_field('keywords').split(',') + + self.platforms = _read_list('platform') + self.classifiers = _read_list('classifier') + + # PEP 314 - these fields only exist in 1.1 + if metadata_version == '1.1': + self.requires = _read_list('requires') + self.provides = _read_list('provides') + self.obsoletes = _read_list('obsoletes') + else: + self.requires = None + self.provides = None + self.obsoletes = None + + def write_pkg_info(self, base_dir: str | os.PathLike[str]) -> None: + """Write the PKG-INFO file into the release tree.""" + with open( + os.path.join(base_dir, 'PKG-INFO'), 'w', encoding='UTF-8' + ) as pkg_info: + self.write_pkg_file(pkg_info) + + def write_pkg_file(self, file: SupportsWrite[str]) -> None: + """Write the PKG-INFO format data to a file object.""" + version = '1.0' + if ( + self.provides + or self.requires + or self.obsoletes + or self.classifiers + or self.download_url + ): + version = '1.1' + + # required fields + file.write(f'Metadata-Version: {version}\n') + file.write(f'Name: {self.get_name()}\n') + file.write(f'Version: {self.get_version()}\n') + + def maybe_write(header, val): + if val: + file.write(f"{header}: {val}\n") + + # optional fields + maybe_write("Summary", self.get_description()) + maybe_write("Home-page", self.get_url()) + maybe_write("Author", self.get_contact()) + maybe_write("Author-email", self.get_contact_email()) + maybe_write("License", self.get_license()) + maybe_write("Download-URL", self.download_url) + maybe_write("Description", rfc822_escape(self.get_long_description() or "")) + maybe_write("Keywords", ",".join(self.get_keywords())) + + self._write_list(file, 'Platform', self.get_platforms()) + self._write_list(file, 'Classifier', self.get_classifiers()) + + # PEP 314 + self._write_list(file, 'Requires', self.get_requires()) + self._write_list(file, 'Provides', self.get_provides()) + self._write_list(file, 'Obsoletes', self.get_obsoletes()) + + def _write_list(self, file, name, values): + values = values or [] + for value in values: + file.write(f'{name}: {value}\n') + + # -- Metadata query methods ---------------------------------------- + + def get_name(self) -> str: + return self.name or "UNKNOWN" + + def get_version(self) -> str: + return self.version or "0.0.0" + + def get_fullname(self) -> str: + return self._fullname(self.get_name(), self.get_version()) + + @staticmethod + def _fullname(name: str, version: str) -> str: + """ + >>> DistributionMetadata._fullname('setup.tools', '1.0-2') + 'setup_tools-1.0.post2' + >>> DistributionMetadata._fullname('setup-tools', '1.2post2') + 'setup_tools-1.2.post2' + >>> DistributionMetadata._fullname('setup-tools', '1.0-r2') + 'setup_tools-1.0.post2' + >>> DistributionMetadata._fullname('setup.tools', '1.0.post') + 'setup_tools-1.0.post0' + >>> DistributionMetadata._fullname('setup.tools', '1.0+ubuntu-1') + 'setup_tools-1.0+ubuntu.1' + """ + return "{}-{}".format( + canonicalize_name(name).replace('-', '_'), + canonicalize_version(version, strip_trailing_zero=False), + ) + + def get_author(self) -> str | None: + return self.author + + def get_author_email(self) -> str | None: + return self.author_email + + def get_maintainer(self) -> str | None: + return self.maintainer + + def get_maintainer_email(self) -> str | None: + return self.maintainer_email + + def get_contact(self) -> str | None: + return self.maintainer or self.author + + def get_contact_email(self) -> str | None: + return self.maintainer_email or self.author_email + + def get_url(self) -> str | None: + return self.url + + def get_license(self) -> str | None: + return self.license + + get_licence = get_license + + def get_description(self) -> str | None: + return self.description + + def get_long_description(self) -> str | None: + return self.long_description + + def get_keywords(self) -> str | list[str]: + return self.keywords or [] + + def set_keywords(self, value: str | Iterable[str]) -> None: + self.keywords = _ensure_list(value, 'keywords') + + def get_platforms(self) -> str | list[str] | None: + return self.platforms + + def set_platforms(self, value: str | Iterable[str]) -> None: + self.platforms = _ensure_list(value, 'platforms') + + def get_classifiers(self) -> str | list[str]: + return self.classifiers or [] + + def set_classifiers(self, value: str | Iterable[str]) -> None: + self.classifiers = _ensure_list(value, 'classifiers') + + def get_download_url(self) -> str | None: + return self.download_url + + # PEP 314 + def get_requires(self) -> str | list[str]: + return self.requires or [] + + def set_requires(self, value: Iterable[str]) -> None: + import distutils.versionpredicate + + for v in value: + distutils.versionpredicate.VersionPredicate(v) + self.requires = list(value) + + def get_provides(self) -> str | list[str]: + return self.provides or [] + + def set_provides(self, value: Iterable[str]) -> None: + value = [v.strip() for v in value] + for v in value: + import distutils.versionpredicate + + distutils.versionpredicate.split_provision(v) + self.provides = value + + def get_obsoletes(self) -> str | list[str]: + return self.obsoletes or [] + + def set_obsoletes(self, value: Iterable[str]) -> None: + import distutils.versionpredicate + + for v in value: + distutils.versionpredicate.VersionPredicate(v) + self.obsoletes = list(value) + + +def fix_help_options(options): + """Convert a 4-tuple 'help_options' list as found in various command + classes to the 3-tuple form required by FancyGetopt. + """ + return [opt[0:3] for opt in options] diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/errors.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/errors.py new file mode 100644 index 000000000..409d21faa --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/errors.py @@ -0,0 +1,108 @@ +""" +Exceptions used by the Distutils modules. + +Distutils modules may raise these or standard exceptions, +including :exc:`SystemExit`. +""" + +# compiler exceptions aliased for compatibility +from .compilers.C.errors import CompileError as CompileError +from .compilers.C.errors import Error as _Error +from .compilers.C.errors import LibError as LibError +from .compilers.C.errors import LinkError as LinkError +from .compilers.C.errors import PreprocessError as PreprocessError +from .compilers.C.errors import UnknownFileType as _UnknownFileType + +CCompilerError = _Error +UnknownFileError = _UnknownFileType + + +class DistutilsError(Exception): + """The root of all Distutils evil.""" + + pass + + +class DistutilsModuleError(DistutilsError): + """Unable to load an expected module, or to find an expected class + within some module (in particular, command modules and classes).""" + + pass + + +class DistutilsClassError(DistutilsError): + """Some command class (or possibly distribution class, if anyone + feels a need to subclass Distribution) is found not to be holding + up its end of the bargain, ie. implementing some part of the + "command "interface.""" + + pass + + +class DistutilsGetoptError(DistutilsError): + """The option table provided to 'fancy_getopt()' is bogus.""" + + pass + + +class DistutilsArgError(DistutilsError): + """Raised by fancy_getopt in response to getopt.error -- ie. an + error in the command line usage.""" + + pass + + +class DistutilsFileError(DistutilsError): + """Any problems in the filesystem: expected file not found, etc. + Typically this is for problems that we detect before OSError + could be raised.""" + + pass + + +class DistutilsOptionError(DistutilsError): + """Syntactic/semantic errors in command options, such as use of + mutually conflicting options, or inconsistent options, + badly-spelled values, etc. No distinction is made between option + values originating in the setup script, the command line, config + files, or what-have-you -- but if we *know* something originated in + the setup script, we'll raise DistutilsSetupError instead.""" + + pass + + +class DistutilsSetupError(DistutilsError): + """For errors that can be definitely blamed on the setup script, + such as invalid keyword arguments to 'setup()'.""" + + pass + + +class DistutilsPlatformError(DistutilsError): + """We don't know how to do something on the current platform (but + we do know how to do it on some platform) -- eg. trying to compile + C files on a platform not supported by a CCompiler subclass.""" + + pass + + +class DistutilsExecError(DistutilsError): + """Any problems executing an external program (such as the C + compiler, when compiling C files).""" + + pass + + +class DistutilsInternalError(DistutilsError): + """Internal inconsistencies or impossibilities (obviously, this + should never be seen if the code is working!).""" + + pass + + +class DistutilsTemplateError(DistutilsError): + """Syntax error in a file list template.""" + + +class DistutilsByteCompileError(DistutilsError): + """Byte compile error.""" diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/extension.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/extension.py new file mode 100644 index 000000000..f51411266 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/extension.py @@ -0,0 +1,258 @@ +"""distutils.extension + +Provides the Extension class, used to describe C/C++ extension +modules in setup scripts.""" + +from __future__ import annotations + +import os +import warnings +from collections.abc import Iterable + +# This class is really only used by the "build_ext" command, so it might +# make sense to put it in distutils.command.build_ext. However, that +# module is already big enough, and I want to make this class a bit more +# complex to simplify some common cases ("foo" module in "foo.c") and do +# better error-checking ("foo.c" actually exists). +# +# Also, putting this in build_ext.py means every setup script would have to +# import that large-ish module (indirectly, through distutils.core) in +# order to do anything. + + +class Extension: + """Just a collection of attributes that describes an extension + module and everything needed to build it (hopefully in a portable + way, but there are hooks that let you be as unportable as you need). + + Instance attributes: + name : string + the full name of the extension, including any packages -- ie. + *not* a filename or pathname, but Python dotted name + sources : Iterable[string | os.PathLike] + iterable of source filenames (except strings, which could be misinterpreted + as a single filename), relative to the distribution root (where the setup + script lives), in Unix form (slash-separated) for portability. Can be any + non-string iterable (list, tuple, set, etc.) containing strings or + PathLike objects. Source files may be C, C++, SWIG (.i), platform-specific + resource files, or whatever else is recognized by the "build_ext" command + as source for a Python extension. + include_dirs : [string] + list of directories to search for C/C++ header files (in Unix + form for portability) + define_macros : [(name : string, value : string|None)] + list of macros to define; each macro is defined using a 2-tuple, + where 'value' is either the string to define it to or None to + define it without a particular value (equivalent of "#define + FOO" in source or -DFOO on Unix C compiler command line) + undef_macros : [string] + list of macros to undefine explicitly + library_dirs : [string] + list of directories to search for C/C++ libraries at link time + libraries : [string] + list of library names (not filenames or paths) to link against + runtime_library_dirs : [string] + list of directories to search for C/C++ libraries at run time + (for shared extensions, this is when the extension is loaded) + extra_objects : [string] + list of extra files to link with (eg. object files not implied + by 'sources', static library that must be explicitly specified, + binary resource files, etc.) + extra_compile_args : [string] + any extra platform- and compiler-specific information to use + when compiling the source files in 'sources'. For platforms and + compilers where "command line" makes sense, this is typically a + list of command-line arguments, but for other platforms it could + be anything. + extra_link_args : [string] + any extra platform- and compiler-specific information to use + when linking object files together to create the extension (or + to create a new static Python interpreter). Similar + interpretation as for 'extra_compile_args'. + export_symbols : [string] + list of symbols to be exported from a shared extension. Not + used on all platforms, and not generally necessary for Python + extensions, which typically export exactly one symbol: "init" + + extension_name. + swig_opts : [string] + any extra options to pass to SWIG if a source file has the .i + extension. + depends : [string] + list of files that the extension depends on + language : string + extension language (i.e. "c", "c++", "objc"). Will be detected + from the source extensions if not provided. + optional : boolean + specifies that a build failure in the extension should not abort the + build process, but simply not install the failing extension. + """ + + # When adding arguments to this constructor, be sure to update + # setup_keywords in core.py. + def __init__( + self, + name: str, + sources: Iterable[str | os.PathLike[str]], + include_dirs: list[str] | None = None, + define_macros: list[tuple[str, str | None]] | None = None, + undef_macros: list[str] | None = None, + library_dirs: list[str] | None = None, + libraries: list[str] | None = None, + runtime_library_dirs: list[str] | None = None, + extra_objects: list[str] | None = None, + extra_compile_args: list[str] | None = None, + extra_link_args: list[str] | None = None, + export_symbols: list[str] | None = None, + swig_opts: list[str] | None = None, + depends: list[str] | None = None, + language: str | None = None, + optional: bool | None = None, + **kw, # To catch unknown keywords + ): + if not isinstance(name, str): + raise TypeError("'name' must be a string") + + # handle the string case first; since strings are iterable, disallow them + if isinstance(sources, str): + raise TypeError( + "'sources' must be an iterable of strings or PathLike objects, not a string" + ) + + # now we check if it's iterable and contains valid types + try: + self.sources = list(map(os.fspath, sources)) + except TypeError: + raise TypeError( + "'sources' must be an iterable of strings or PathLike objects" + ) + + self.name = name + self.include_dirs = include_dirs or [] + self.define_macros = define_macros or [] + self.undef_macros = undef_macros or [] + self.library_dirs = library_dirs or [] + self.libraries = libraries or [] + self.runtime_library_dirs = runtime_library_dirs or [] + self.extra_objects = extra_objects or [] + self.extra_compile_args = extra_compile_args or [] + self.extra_link_args = extra_link_args or [] + self.export_symbols = export_symbols or [] + self.swig_opts = swig_opts or [] + self.depends = depends or [] + self.language = language + self.optional = optional + + # If there are unknown keyword options, warn about them + if len(kw) > 0: + options = [repr(option) for option in kw] + options = ', '.join(sorted(options)) + msg = f"Unknown Extension options: {options}" + warnings.warn(msg) + + def __repr__(self): + return f'<{self.__class__.__module__}.{self.__class__.__qualname__}({self.name!r}) at {id(self):#x}>' + + +def read_setup_file(filename): # noqa: C901 + """Reads a Setup file and returns Extension instances.""" + from distutils.sysconfig import _variable_rx, expand_makefile_vars, parse_makefile + from distutils.text_file import TextFile + from distutils.util import split_quoted + + # First pass over the file to gather "VAR = VALUE" assignments. + vars = parse_makefile(filename) + + # Second pass to gobble up the real content: lines of the form + # ... [ ...] [ ...] [ ...] + file = TextFile( + filename, + strip_comments=True, + skip_blanks=True, + join_lines=True, + lstrip_ws=True, + rstrip_ws=True, + ) + try: + extensions = [] + + while True: + line = file.readline() + if line is None: # eof + break + if _variable_rx.match(line): # VAR=VALUE, handled in first pass + continue + + if line[0] == line[-1] == "*": + file.warn(f"'{line}' lines not handled yet") + continue + + line = expand_makefile_vars(line, vars) + words = split_quoted(line) + + # NB. this parses a slightly different syntax than the old + # makesetup script: here, there must be exactly one extension per + # line, and it must be the first word of the line. I have no idea + # why the old syntax supported multiple extensions per line, as + # they all wind up being the same. + + module = words[0] + ext = Extension(module, []) + append_next_word = None + + for word in words[1:]: + if append_next_word is not None: + append_next_word.append(word) + append_next_word = None + continue + + suffix = os.path.splitext(word)[1] + switch = word[0:2] + value = word[2:] + + if suffix in (".c", ".cc", ".cpp", ".cxx", ".c++", ".m", ".mm"): + # hmm, should we do something about C vs. C++ sources? + # or leave it up to the CCompiler implementation to + # worry about? + ext.sources.append(word) + elif switch == "-I": + ext.include_dirs.append(value) + elif switch == "-D": + equals = value.find("=") + if equals == -1: # bare "-DFOO" -- no value + ext.define_macros.append((value, None)) + else: # "-DFOO=blah" + ext.define_macros.append((value[0:equals], value[equals + 2 :])) + elif switch == "-U": + ext.undef_macros.append(value) + elif switch == "-C": # only here 'cause makesetup has it! + ext.extra_compile_args.append(word) + elif switch == "-l": + ext.libraries.append(value) + elif switch == "-L": + ext.library_dirs.append(value) + elif switch == "-R": + ext.runtime_library_dirs.append(value) + elif word == "-rpath": + append_next_word = ext.runtime_library_dirs + elif word == "-Xlinker": + append_next_word = ext.extra_link_args + elif word == "-Xcompiler": + append_next_word = ext.extra_compile_args + elif switch == "-u": + ext.extra_link_args.append(word) + if not value: + append_next_word = ext.extra_link_args + elif suffix in (".a", ".so", ".sl", ".o", ".dylib"): + # NB. a really faithful emulation of makesetup would + # append a .o file to extra_objects only if it + # had a slash in it; otherwise, it would s/.o/.c/ + # and append it to sources. Hmmmm. + ext.extra_objects.append(word) + else: + file.warn(f"unrecognized argument '{word}'") + + extensions.append(ext) + finally: + file.close() + + return extensions diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/fancy_getopt.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/fancy_getopt.py new file mode 100644 index 000000000..1a1d3a05d --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/fancy_getopt.py @@ -0,0 +1,471 @@ +"""distutils.fancy_getopt + +Wrapper around the standard getopt module that provides the following +additional features: + * short and long options are tied together + * options have help strings, so fancy_getopt could potentially + create a complete usage summary + * options set attributes of a passed-in object +""" + +from __future__ import annotations + +import getopt +import re +import string +import sys +from collections.abc import Sequence +from typing import Any + +from .errors import DistutilsArgError, DistutilsGetoptError + +# Much like command_re in distutils.core, this is close to but not quite +# the same as a Python NAME -- except, in the spirit of most GNU +# utilities, we use '-' in place of '_'. (The spirit of LISP lives on!) +# The similarities to NAME are again not a coincidence... +longopt_pat = r'[a-zA-Z](?:[a-zA-Z0-9-]*)' +longopt_re = re.compile(rf'^{longopt_pat}$') + +# For recognizing "negative alias" options, eg. "quiet=!verbose" +neg_alias_re = re.compile(f"^({longopt_pat})=!({longopt_pat})$") + +# This is used to translate long options to legitimate Python identifiers +# (for use as attributes of some object). +longopt_xlate = str.maketrans('-', '_') + + +class FancyGetopt: + """Wrapper around the standard 'getopt()' module that provides some + handy extra functionality: + * short and long options are tied together + * options have help strings, and help text can be assembled + from them + * options set attributes of a passed-in object + * boolean options can have "negative aliases" -- eg. if + --quiet is the "negative alias" of --verbose, then "--quiet" + on the command line sets 'verbose' to false + """ + + def __init__(self, option_table=None): + # The option table is (currently) a list of tuples. The + # tuples may have 3 or four values: + # (long_option, short_option, help_string [, repeatable]) + # if an option takes an argument, its long_option should have '=' + # appended; short_option should just be a single character, no ':' + # in any case. If a long_option doesn't have a corresponding + # short_option, short_option should be None. All option tuples + # must have long options. + self.option_table = option_table + + # 'option_index' maps long option names to entries in the option + # table (ie. those 3-tuples). + self.option_index = {} + if self.option_table: + self._build_index() + + # 'alias' records (duh) alias options; {'foo': 'bar'} means + # --foo is an alias for --bar + self.alias = {} + + # 'negative_alias' keeps track of options that are the boolean + # opposite of some other option + self.negative_alias = {} + + # These keep track of the information in the option table. We + # don't actually populate these structures until we're ready to + # parse the command-line, since the 'option_table' passed in here + # isn't necessarily the final word. + self.short_opts = [] + self.long_opts = [] + self.short2long = {} + self.attr_name = {} + self.takes_arg = {} + + # And 'option_order' is filled up in 'getopt()'; it records the + # original order of options (and their values) on the command-line, + # but expands short options, converts aliases, etc. + self.option_order = [] + + def _build_index(self): + self.option_index.clear() + for option in self.option_table: + self.option_index[option[0]] = option + + def set_option_table(self, option_table): + self.option_table = option_table + self._build_index() + + def add_option(self, long_option, short_option=None, help_string=None): + if long_option in self.option_index: + raise DistutilsGetoptError( + f"option conflict: already an option '{long_option}'" + ) + else: + option = (long_option, short_option, help_string) + self.option_table.append(option) + self.option_index[long_option] = option + + def has_option(self, long_option): + """Return true if the option table for this parser has an + option with long name 'long_option'.""" + return long_option in self.option_index + + def get_attr_name(self, long_option): + """Translate long option name 'long_option' to the form it + has as an attribute of some object: ie., translate hyphens + to underscores.""" + return long_option.translate(longopt_xlate) + + def _check_alias_dict(self, aliases, what): + assert isinstance(aliases, dict) + for alias, opt in aliases.items(): + if alias not in self.option_index: + raise DistutilsGetoptError( + f"invalid {what} '{alias}': option '{alias}' not defined" + ) + if opt not in self.option_index: + raise DistutilsGetoptError( + f"invalid {what} '{alias}': aliased option '{opt}' not defined" + ) + + def set_aliases(self, alias): + """Set the aliases for this option parser.""" + self._check_alias_dict(alias, "alias") + self.alias = alias + + def set_negative_aliases(self, negative_alias): + """Set the negative aliases for this option parser. + 'negative_alias' should be a dictionary mapping option names to + option names, both the key and value must already be defined + in the option table.""" + self._check_alias_dict(negative_alias, "negative alias") + self.negative_alias = negative_alias + + def _grok_option_table(self): # noqa: C901 + """Populate the various data structures that keep tabs on the + option table. Called by 'getopt()' before it can do anything + worthwhile. + """ + self.long_opts = [] + self.short_opts = [] + self.short2long.clear() + self.repeat = {} + + for option in self.option_table: + if len(option) == 3: + long, short, help = option + repeat = 0 + elif len(option) == 4: + long, short, help, repeat = option + else: + # the option table is part of the code, so simply + # assert that it is correct + raise ValueError(f"invalid option tuple: {option!r}") + + # Type- and value-check the option names + if not isinstance(long, str) or len(long) < 2: + raise DistutilsGetoptError( + f"invalid long option '{long}': must be a string of length >= 2" + ) + + if not ((short is None) or (isinstance(short, str) and len(short) == 1)): + raise DistutilsGetoptError( + f"invalid short option '{short}': must a single character or None" + ) + + self.repeat[long] = repeat + self.long_opts.append(long) + + if long[-1] == '=': # option takes an argument? + if short: + short = short + ':' + long = long[0:-1] + self.takes_arg[long] = True + else: + # Is option is a "negative alias" for some other option (eg. + # "quiet" == "!verbose")? + alias_to = self.negative_alias.get(long) + if alias_to is not None: + if self.takes_arg[alias_to]: + raise DistutilsGetoptError( + f"invalid negative alias '{long}': " + f"aliased option '{alias_to}' takes a value" + ) + + self.long_opts[-1] = long # XXX redundant?! + self.takes_arg[long] = False + + # If this is an alias option, make sure its "takes arg" flag is + # the same as the option it's aliased to. + alias_to = self.alias.get(long) + if alias_to is not None: + if self.takes_arg[long] != self.takes_arg[alias_to]: + raise DistutilsGetoptError( + f"invalid alias '{long}': inconsistent with " + f"aliased option '{alias_to}' (one of them takes a value, " + "the other doesn't" + ) + + # Now enforce some bondage on the long option name, so we can + # later translate it to an attribute name on some object. Have + # to do this a bit late to make sure we've removed any trailing + # '='. + if not longopt_re.match(long): + raise DistutilsGetoptError( + f"invalid long option name '{long}' " + "(must be letters, numbers, hyphens only" + ) + + self.attr_name[long] = self.get_attr_name(long) + if short: + self.short_opts.append(short) + self.short2long[short[0]] = long + + def getopt(self, args: Sequence[str] | None = None, object=None): # noqa: C901 + """Parse command-line options in args. Store as attributes on object. + + If 'args' is None or not supplied, uses 'sys.argv[1:]'. If + 'object' is None or not supplied, creates a new OptionDummy + object, stores option values there, and returns a tuple (args, + object). If 'object' is supplied, it is modified in place and + 'getopt()' just returns 'args'; in both cases, the returned + 'args' is a modified copy of the passed-in 'args' list, which + is left untouched. + """ + if args is None: + args = sys.argv[1:] + if object is None: + object = OptionDummy() + created_object = True + else: + created_object = False + + self._grok_option_table() + + short_opts = ' '.join(self.short_opts) + try: + opts, args = getopt.getopt(args, short_opts, self.long_opts) + except getopt.error as msg: + raise DistutilsArgError(msg) + + for opt, val in opts: + if len(opt) == 2 and opt[0] == '-': # it's a short option + opt = self.short2long[opt[1]] + else: + assert len(opt) > 2 and opt[:2] == '--' + opt = opt[2:] + + alias = self.alias.get(opt) + if alias: + opt = alias + + if not self.takes_arg[opt]: # boolean option? + assert val == '', "boolean option can't have value" + alias = self.negative_alias.get(opt) + if alias: + opt = alias + val = 0 + else: + val = 1 + + attr = self.attr_name[opt] + # The only repeating option at the moment is 'verbose'. + # It has a negative option -q quiet, which should set verbose = False. + if val and self.repeat.get(attr) is not None: + val = getattr(object, attr, 0) + 1 + setattr(object, attr, val) + self.option_order.append((opt, val)) + + # for opts + if created_object: + return args, object + else: + return args + + def get_option_order(self): + """Returns the list of (option, value) tuples processed by the + previous run of 'getopt()'. Raises RuntimeError if + 'getopt()' hasn't been called yet. + """ + if self.option_order is None: + raise RuntimeError("'getopt()' hasn't been called yet") + else: + return self.option_order + + def generate_help(self, header=None): # noqa: C901 + """Generate help text (a list of strings, one per suggested line of + output) from the option table for this FancyGetopt object. + """ + # Blithely assume the option table is good: probably wouldn't call + # 'generate_help()' unless you've already called 'getopt()'. + + # First pass: determine maximum length of long option names + max_opt = 0 + for option in self.option_table: + long = option[0] + short = option[1] + ell = len(long) + if long[-1] == '=': + ell = ell - 1 + if short is not None: + ell = ell + 5 # " (-x)" where short == 'x' + if ell > max_opt: + max_opt = ell + + opt_width = max_opt + 2 + 2 + 2 # room for indent + dashes + gutter + + # Typical help block looks like this: + # --foo controls foonabulation + # Help block for longest option looks like this: + # --flimflam set the flim-flam level + # and with wrapped text: + # --flimflam set the flim-flam level (must be between + # 0 and 100, except on Tuesdays) + # Options with short names will have the short name shown (but + # it doesn't contribute to max_opt): + # --foo (-f) controls foonabulation + # If adding the short option would make the left column too wide, + # we push the explanation off to the next line + # --flimflam (-l) + # set the flim-flam level + # Important parameters: + # - 2 spaces before option block start lines + # - 2 dashes for each long option name + # - min. 2 spaces between option and explanation (gutter) + # - 5 characters (incl. space) for short option name + + # Now generate lines of help text. (If 80 columns were good enough + # for Jesus, then 78 columns are good enough for me!) + line_width = 78 + text_width = line_width - opt_width + big_indent = ' ' * opt_width + if header: + lines = [header] + else: + lines = ['Option summary:'] + + for option in self.option_table: + long, short, help = option[:3] + text = wrap_text(help, text_width) + if long[-1] == '=': + long = long[0:-1] + + # Case 1: no short option at all (makes life easy) + if short is None: + if text: + lines.append(f" --{long:<{max_opt}} {text[0]}") + else: + lines.append(f" --{long:<{max_opt}}") + + # Case 2: we have a short option, so we have to include it + # just after the long option + else: + opt_names = f"{long} (-{short})" + if text: + lines.append(f" --{opt_names:<{max_opt}} {text[0]}") + else: + lines.append(f" --{opt_names:<{max_opt}}") + + for ell in text[1:]: + lines.append(big_indent + ell) + return lines + + def print_help(self, header=None, file=None): + if file is None: + file = sys.stdout + for line in self.generate_help(header): + file.write(line + "\n") + + +def fancy_getopt(options, negative_opt, object, args: Sequence[str] | None): + parser = FancyGetopt(options) + parser.set_negative_aliases(negative_opt) + return parser.getopt(args, object) + + +WS_TRANS = {ord(_wschar): ' ' for _wschar in string.whitespace} + + +def wrap_text(text, width): + """wrap_text(text : string, width : int) -> [string] + + Split 'text' into multiple lines of no more than 'width' characters + each, and return the list of strings that results. + """ + if text is None: + return [] + if len(text) <= width: + return [text] + + text = text.expandtabs() + text = text.translate(WS_TRANS) + chunks = re.split(r'( +|-+)', text) + chunks = [ch for ch in chunks if ch] # ' - ' results in empty strings + lines = [] + + while chunks: + cur_line = [] # list of chunks (to-be-joined) + cur_len = 0 # length of current line + + while chunks: + ell = len(chunks[0]) + if cur_len + ell <= width: # can squeeze (at least) this chunk in + cur_line.append(chunks[0]) + del chunks[0] + cur_len = cur_len + ell + else: # this line is full + # drop last chunk if all space + if cur_line and cur_line[-1][0] == ' ': + del cur_line[-1] + break + + if chunks: # any chunks left to process? + # if the current line is still empty, then we had a single + # chunk that's too big too fit on a line -- so we break + # down and break it up at the line width + if cur_len == 0: + cur_line.append(chunks[0][0:width]) + chunks[0] = chunks[0][width:] + + # all-whitespace chunks at the end of a line can be discarded + # (and we know from the re.split above that if a chunk has + # *any* whitespace, it is *all* whitespace) + if chunks[0][0] == ' ': + del chunks[0] + + # and store this line in the list-of-all-lines -- as a single + # string, of course! + lines.append(''.join(cur_line)) + + return lines + + +def translate_longopt(opt): + """Convert a long option name to a valid Python identifier by + changing "-" to "_". + """ + return opt.translate(longopt_xlate) + + +class OptionDummy: + """Dummy class just used as a place to hold command-line option + values as instance attributes.""" + + def __init__(self, options: Sequence[Any] = []): + """Create a new OptionDummy instance. The attributes listed in + 'options' will be initialized to None.""" + for opt in options: + setattr(self, opt, None) + + +if __name__ == "__main__": + text = """\ +Tra-la-la, supercalifragilisticexpialidocious. +How *do* you spell that odd word, anyways? +(Someone ask Mary -- she'll know [or she'll +say, "How should I know?"].)""" + + for w in (10, 20, 30, 40): + print(f"width: {w}") + print("\n".join(wrap_text(text, w))) + print() diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/file_util.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/file_util.py new file mode 100644 index 000000000..0acc8cb84 --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/file_util.py @@ -0,0 +1,236 @@ +"""distutils.file_util + +Utility functions for operating on single files. +""" + +import os + +from ._log import log +from .errors import DistutilsFileError + +# for generating verbose output in 'copy_file()' +_copy_action = {None: 'copying', 'hard': 'hard linking', 'sym': 'symbolically linking'} + + +def _copy_file_contents(src, dst, buffer_size=16 * 1024): # noqa: C901 + """Copy the file 'src' to 'dst'; both must be filenames. Any error + opening either file, reading from 'src', or writing to 'dst', raises + DistutilsFileError. Data is read/written in chunks of 'buffer_size' + bytes (default 16k). No attempt is made to handle anything apart from + regular files. + """ + # Stolen from shutil module in the standard library, but with + # custom error-handling added. + fsrc = None + fdst = None + try: + try: + fsrc = open(src, 'rb') + except OSError as e: + raise DistutilsFileError(f"could not open '{src}': {e.strerror}") + + if os.path.exists(dst): + try: + os.unlink(dst) + except OSError as e: + raise DistutilsFileError(f"could not delete '{dst}': {e.strerror}") + + try: + fdst = open(dst, 'wb') + except OSError as e: + raise DistutilsFileError(f"could not create '{dst}': {e.strerror}") + + while True: + try: + buf = fsrc.read(buffer_size) + except OSError as e: + raise DistutilsFileError(f"could not read from '{src}': {e.strerror}") + + if not buf: + break + + try: + fdst.write(buf) + except OSError as e: + raise DistutilsFileError(f"could not write to '{dst}': {e.strerror}") + finally: + if fdst: + fdst.close() + if fsrc: + fsrc.close() + + +def copy_file( # noqa: C901 + src, + dst, + preserve_mode=True, + preserve_times=True, + update=False, + link=None, + verbose=True, + dry_run=False, +): + """Copy a file 'src' to 'dst'. If 'dst' is a directory, then 'src' is + copied there with the same name; otherwise, it must be a filename. (If + the file exists, it will be ruthlessly clobbered.) If 'preserve_mode' + is true (the default), the file's mode (type and permission bits, or + whatever is analogous on the current platform) is copied. If + 'preserve_times' is true (the default), the last-modified and + last-access times are copied as well. If 'update' is true, 'src' will + only be copied if 'dst' does not exist, or if 'dst' does exist but is + older than 'src'. + + 'link' allows you to make hard links (os.link) or symbolic links + (os.symlink) instead of copying: set it to "hard" or "sym"; if it is + None (the default), files are copied. Don't set 'link' on systems that + don't support it: 'copy_file()' doesn't check if hard or symbolic + linking is available. If hardlink fails, falls back to + _copy_file_contents(). + + Under Mac OS, uses the native file copy function in macostools; on + other systems, uses '_copy_file_contents()' to copy file contents. + + Return a tuple (dest_name, copied): 'dest_name' is the actual name of + the output file, and 'copied' is true if the file was copied (or would + have been copied, if 'dry_run' true). + """ + # XXX if the destination file already exists, we clobber it if + # copying, but blow up if linking. Hmmm. And I don't know what + # macostools.copyfile() does. Should definitely be consistent, and + # should probably blow up if destination exists and we would be + # changing it (ie. it's not already a hard/soft link to src OR + # (not update) and (src newer than dst). + + from distutils._modified import newer + from stat import S_IMODE, ST_ATIME, ST_MODE, ST_MTIME + + if not os.path.isfile(src): + raise DistutilsFileError( + f"can't copy '{src}': doesn't exist or not a regular file" + ) + + if os.path.isdir(dst): + dir = dst + dst = os.path.join(dst, os.path.basename(src)) + else: + dir = os.path.dirname(dst) + + if update and not newer(src, dst): + if verbose >= 1: + log.debug("not copying %s (output up-to-date)", src) + return (dst, False) + + try: + action = _copy_action[link] + except KeyError: + raise ValueError(f"invalid value '{link}' for 'link' argument") + + if verbose >= 1: + if os.path.basename(dst) == os.path.basename(src): + log.info("%s %s -> %s", action, src, dir) + else: + log.info("%s %s -> %s", action, src, dst) + + if dry_run: + return (dst, True) + + # If linking (hard or symbolic), use the appropriate system call + # (Unix only, of course, but that's the caller's responsibility) + elif link == 'hard': + if not (os.path.exists(dst) and os.path.samefile(src, dst)): + try: + os.link(src, dst) + except OSError: + # If hard linking fails, fall back on copying file + # (some special filesystems don't support hard linking + # even under Unix, see issue #8876). + pass + else: + return (dst, True) + elif link == 'sym': + if not (os.path.exists(dst) and os.path.samefile(src, dst)): + os.symlink(src, dst) + return (dst, True) + + # Otherwise (non-Mac, not linking), copy the file contents and + # (optionally) copy the times and mode. + _copy_file_contents(src, dst) + if preserve_mode or preserve_times: + st = os.stat(src) + + # According to David Ascher , utime() should be done + # before chmod() (at least under NT). + if preserve_times: + os.utime(dst, (st[ST_ATIME], st[ST_MTIME])) + if preserve_mode: + os.chmod(dst, S_IMODE(st[ST_MODE])) + + return (dst, True) + + +# XXX I suspect this is Unix-specific -- need porting help! +def move_file(src, dst, verbose=True, dry_run=False): # noqa: C901 + """Move a file 'src' to 'dst'. If 'dst' is a directory, the file will + be moved into it with the same name; otherwise, 'src' is just renamed + to 'dst'. Return the new full name of the file. + + Handles cross-device moves on Unix using 'copy_file()'. What about + other systems??? + """ + import errno + from os.path import basename, dirname, exists, isdir, isfile + + if verbose >= 1: + log.info("moving %s -> %s", src, dst) + + if dry_run: + return dst + + if not isfile(src): + raise DistutilsFileError(f"can't move '{src}': not a regular file") + + if isdir(dst): + dst = os.path.join(dst, basename(src)) + elif exists(dst): + raise DistutilsFileError( + f"can't move '{src}': destination '{dst}' already exists" + ) + + if not isdir(dirname(dst)): + raise DistutilsFileError( + f"can't move '{src}': destination '{dst}' not a valid path" + ) + + copy_it = False + try: + os.rename(src, dst) + except OSError as e: + (num, msg) = e.args + if num == errno.EXDEV: + copy_it = True + else: + raise DistutilsFileError(f"couldn't move '{src}' to '{dst}': {msg}") + + if copy_it: + copy_file(src, dst, verbose=verbose) + try: + os.unlink(src) + except OSError as e: + (num, msg) = e.args + try: + os.unlink(dst) + except OSError: + pass + raise DistutilsFileError( + f"couldn't move '{src}' to '{dst}' by copy/delete: " + f"delete '{src}' failed: {msg}" + ) + return dst + + +def write_file(filename, contents): + """Create a file with the specified name and write 'contents' (a + sequence of strings without line terminators) to it. + """ + with open(filename, 'w', encoding='utf-8') as f: + f.writelines(line + '\n' for line in contents) diff --git a/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/filelist.py b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/filelist.py new file mode 100644 index 000000000..70dc0fdeb --- /dev/null +++ b/ESP-IDF_Robot/tutorial/.tutorial/lib/python3.12/site-packages/setuptools/_distutils/filelist.py @@ -0,0 +1,431 @@ +"""distutils.filelist + +Provides the FileList class, used for poking about the filesystem +and building lists of files. +""" + +from __future__ import annotations + +import fnmatch +import functools +import os +import re +from collections.abc import Iterable +from typing import Literal, overload + +from ._log import log +from .errors import DistutilsInternalError, DistutilsTemplateError +from .util import convert_path + + +class FileList: + """A list of files built by on exploring the filesystem and filtered by + applying various patterns to what we find there. + + Instance attributes: + dir + directory from which files will be taken -- only used if + 'allfiles' not supplied to constructor + files + list of filenames currently being built/filtered/manipulated + allfiles + complete list of files under consideration (ie. without any + filtering applied) + """ + + def __init__(self, warn: object = None, debug_print: object = None) -> None: + # ignore argument to FileList, but keep them for backwards + # compatibility + self.allfiles: Iterable[str] | None = None + self.files: list[str] = [] + + def set_allfiles(self, allfiles: Iterable[str]) -> None: + self.allfiles = allfiles + + def findall(self, dir: str | os.PathLike[str] = os.curdir) -> None: + self.allfiles = findall(dir) + + def debug_print(self, msg: object) -> None: + """Print 'msg' to stdout if the global DEBUG (taken from the + DISTUTILS_DEBUG environment variable) flag is true. + """ + from distutils.debug import DEBUG + + if DEBUG: + print(msg) + + # Collection methods + + def append(self, item: str) -> None: + self.files.append(item) + + def extend(self, items: Iterable[str]) -> None: + self.files.extend(items) + + def sort(self) -> None: + # Not a strict lexical sort! + sortable_files = sorted(map(os.path.split, self.files)) + self.files = [] + for sort_tuple in sortable_files: + self.files.append(os.path.join(*sort_tuple)) + + # Other miscellaneous utility methods + + def remove_duplicates(self) -> None: + # Assumes list has been sorted! + for i in range(len(self.files) - 1, 0, -1): + if self.files[i] == self.files[i - 1]: + del self.files[i] + + # "File template" methods + + def _parse_template_line(self, line): + words = line.split() + action = words[0] + + patterns = dir = dir_pattern = None + + if action in ('include', 'exclude', 'global-include', 'global-exclude'): + if len(words) < 2: + raise DistutilsTemplateError( + f"'{action}' expects ..." + ) + patterns = [convert_path(w) for w in words[1:]] + elif action in ('recursive-include', 'recursive-exclude'): + if len(words) < 3: + raise DistutilsTemplateError( + f"'{action}' expects