@levencode/deploom 0.0.0-stage → 0.2.21-next.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2664) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +40 -3
  3. package/THIRD_PARTY_NOTICES/CPython/CPython-third-party-license.rst +1183 -0
  4. package/THIRD_PARTY_NOTICES/CPython/LICENSE.txt +645 -0
  5. package/THIRD_PARTY_NOTICES/CPython/bzip2-1.0.8/LICENSE +42 -0
  6. package/THIRD_PARTY_NOTICES/CPython/expat-2.8.5/AUTHORS +10 -0
  7. package/THIRD_PARTY_NOTICES/CPython/expat-2.8.5/COPYING +21 -0
  8. package/THIRD_PARTY_NOTICES/CPython/hacl-star-bb3d0dc8d9d15a5cd51094d5b69e70aa09005ff0/LICENSE +201 -0
  9. package/THIRD_PARTY_NOTICES/CPython/libb2-0.98.1/COPYING +117 -0
  10. package/THIRD_PARTY_NOTICES/CPython/libffi-3.4.4/LICENSE +21 -0
  11. package/THIRD_PARTY_NOTICES/CPython/libffi-3.4.4/LICENSE-BUILDTOOLS +353 -0
  12. package/THIRD_PARTY_NOTICES/CPython/mpdecimal-4.0.0/COPYRIGHT.txt +23 -0
  13. package/THIRD_PARTY_NOTICES/CPython/official-embed.spdx.json +433 -0
  14. package/THIRD_PARTY_NOTICES/CPython/openssl-3.5.9/AUTHORS.md +53 -0
  15. package/THIRD_PARTY_NOTICES/CPython/openssl-3.5.9/LICENSE.txt +177 -0
  16. package/THIRD_PARTY_NOTICES/CPython/sqlite-3.50.4.0/public-domain.txt +32 -0
  17. package/THIRD_PARTY_NOTICES/CPython/xz-5.2.5/AUTHORS +27 -0
  18. package/THIRD_PARTY_NOTICES/CPython/xz-5.2.5/COPYING +65 -0
  19. package/THIRD_PARTY_NOTICES/CPython/xz-5.2.5/COPYING.GPLv2 +339 -0
  20. package/THIRD_PARTY_NOTICES/CPython/xz-5.2.5/COPYING.GPLv3 +674 -0
  21. package/THIRD_PARTY_NOTICES/CPython/xz-5.2.5/COPYING.LGPLv2.1 +502 -0
  22. package/THIRD_PARTY_NOTICES/CPython/zlib-1.3.1/LICENSE +22 -0
  23. package/THIRD_PARTY_NOTICES/CPython/zlib-1.3.1/README +117 -0
  24. package/THIRD_PARTY_NOTICES/PyJWT/pyjwt-2.15.1.dist-info/licenses/AUTHORS.rst +7 -0
  25. package/THIRD_PARTY_NOTICES/PyJWT/pyjwt-2.15.1.dist-info/licenses/LICENSE +21 -0
  26. package/THIRD_PARTY_NOTICES/PyYAML/pyyaml-6.0.3.dist-info/licenses/LICENSE +20 -0
  27. package/THIRD_PARTY_NOTICES/annotated-types/annotated_types-0.8.0.dist-info/licenses/LICENSE +21 -0
  28. package/THIRD_PARTY_NOTICES/anyio/anyio-4.15.1.dist-info/licenses/LICENSE +20 -0
  29. package/THIRD_PARTY_NOTICES/attrs/attrs-26.1.0.dist-info/licenses/LICENSE +21 -0
  30. package/THIRD_PARTY_NOTICES/certifi/certifi-2026.10.23.dist-info/licenses/LICENSE +20 -0
  31. package/THIRD_PARTY_NOTICES/cffi/cffi-2.1.1.dist-info/licenses/LICENSE +23 -0
  32. package/THIRD_PARTY_NOTICES/charset-normalizer/charset_normalizer-3.5.2.dist-info/licenses/LICENSE +21 -0
  33. package/THIRD_PARTY_NOTICES/click/click-8.5.0.dist-info/licenses/LICENSE.txt +28 -0
  34. package/THIRD_PARTY_NOTICES/cryptography/cryptography-50.0.2.dist-info/licenses/LICENSE +3 -0
  35. package/THIRD_PARTY_NOTICES/cryptography/cryptography-50.0.2.dist-info/licenses/LICENSE.APACHE +202 -0
  36. package/THIRD_PARTY_NOTICES/cryptography/cryptography-50.0.2.dist-info/licenses/LICENSE.BSD +27 -0
  37. package/THIRD_PARTY_NOTICES/deploom-mcp/deploom_mcp-0.2.21.dist-info/licenses/LICENSE +202 -0
  38. package/THIRD_PARTY_NOTICES/h11/h11-0.16.0.dist-info/licenses/LICENSE.txt +22 -0
  39. package/THIRD_PARTY_NOTICES/httpcore2/httpcore2-2.16.0.dist-info/licenses/LICENSE.md +28 -0
  40. package/THIRD_PARTY_NOTICES/httpx2/httpx2-2.16.0.dist-info/licenses/LICENSE.md +13 -0
  41. package/THIRD_PARTY_NOTICES/idna/idna-3.20.dist-info/licenses/LICENSE.md +31 -0
  42. package/THIRD_PARTY_NOTICES/jsonschema/jsonschema-4.26.0.dist-info/licenses/COPYING +19 -0
  43. package/THIRD_PARTY_NOTICES/jsonschema-specifications/jsonschema_specifications-2025.9.1.dist-info/licenses/COPYING +19 -0
  44. package/THIRD_PARTY_NOTICES/mcp/mcp-2.3.0.dist-info/licenses/LICENSE +21 -0
  45. package/THIRD_PARTY_NOTICES/mcp-types/mcp_types-2.3.0.dist-info/licenses/LICENSE +21 -0
  46. package/THIRD_PARTY_NOTICES/opentelemetry-api/opentelemetry_api-1.45.2.dist-info/licenses/LICENSE +201 -0
  47. package/THIRD_PARTY_NOTICES/pycparser/pycparser-3.12.dist-info/licenses/LICENSE +27 -0
  48. package/THIRD_PARTY_NOTICES/pydantic/pydantic-2.14.2.dist-info/licenses/LICENSE +21 -0
  49. package/THIRD_PARTY_NOTICES/pydantic_core/pydantic_core-2.50.2.dist-info/licenses/LICENSE +21 -0
  50. package/THIRD_PARTY_NOTICES/python-dateutil/python_dateutil-3.0.0.dist-info/licenses/LICENSE +54 -0
  51. package/THIRD_PARTY_NOTICES/python-multipart/python_multipart-0.0.32.dist-info/licenses/LICENSE.txt +202 -0
  52. package/THIRD_PARTY_NOTICES/pywin32/adodbapi/license.txt +505 -0
  53. package/THIRD_PARTY_NOTICES/pywin32/pythonwin/license.txt +30 -0
  54. package/THIRD_PARTY_NOTICES/pywin32/win32/license.txt +30 -0
  55. package/THIRD_PARTY_NOTICES/pywin32/win32com/License.txt +30 -0
  56. package/THIRD_PARTY_NOTICES/referencing/referencing-0.37.0.dist-info/licenses/COPYING +19 -0
  57. package/THIRD_PARTY_NOTICES/requests/requests-2.34.2.dist-info/licenses/LICENSE +175 -0
  58. package/THIRD_PARTY_NOTICES/requests/requests-2.34.2.dist-info/licenses/NOTICE +2 -0
  59. package/THIRD_PARTY_NOTICES/rpds-py/rpds_py-2026.9.1.dist-info/licenses/LICENSE +19 -0
  60. package/THIRD_PARTY_NOTICES/semantic-version/semantic_version-2.10.0.dist-info/LICENSE +22 -0
  61. package/THIRD_PARTY_NOTICES/six/six-1.17.0.dist-info/LICENSE +18 -0
  62. package/THIRD_PARTY_NOTICES/sse-starlette/sse_starlette-3.6.0.dist-info/licenses/AUTHORS +10 -0
  63. package/THIRD_PARTY_NOTICES/sse-starlette/sse_starlette-3.6.0.dist-info/licenses/LICENSE +27 -0
  64. package/THIRD_PARTY_NOTICES/starlette/starlette-1.10.0.dist-info/licenses/LICENSE.md +27 -0
  65. package/THIRD_PARTY_NOTICES/truststore/truststore-0.10.5.dist-info/licenses/LICENSE +21 -0
  66. package/THIRD_PARTY_NOTICES/typing-inspection/typing_inspection-0.4.4.dist-info/licenses/LICENSE +21 -0
  67. package/THIRD_PARTY_NOTICES/typing_extensions/typing_extensions-4.16.0.dist-info/licenses/LICENSE +279 -0
  68. package/THIRD_PARTY_NOTICES/tzdata/tzdata-2026.6.dist-info/licenses/LICENSE +16 -0
  69. package/THIRD_PARTY_NOTICES/tzdata/tzdata-2026.6.dist-info/licenses/licenses/LICENSE_APACHE +201 -0
  70. package/THIRD_PARTY_NOTICES/urllib3/urllib3-2.8.0.dist-info/licenses/LICENSE.txt +21 -0
  71. package/THIRD_PARTY_NOTICES/uvicorn/uvicorn-0.54.0.dist-info/licenses/LICENSE.md +27 -0
  72. package/THIRD_PARTY_NOTICES/z3-solver/BUILD-INFO.txt +3 -0
  73. package/THIRD_PARTY_NOTICES/z3-solver/GCC-COPYRIGHT.txt +1532 -0
  74. package/THIRD_PARTY_NOTICES/z3-solver/GCC-GPL-3.txt +674 -0
  75. package/THIRD_PARTY_NOTICES/z3-solver/GCC-RUNTIME-EXCEPTION.txt +73 -0
  76. package/THIRD_PARTY_NOTICES/z3-solver/MinGW-COPYRIGHT.txt +998 -0
  77. package/THIRD_PARTY_NOTICES/z3-solver/Z3-LICENSE.txt +10 -0
  78. package/THIRD_PARTY_NOTICES/z3-solver/compiler-copyright.txt +1714 -0
  79. package/bin/client-config.cjs +86 -0
  80. package/bin/deploom.cjs +223 -0
  81. package/bin/launch.cjs +71 -0
  82. package/bin/verify-runtime.cjs +42 -0
  83. package/package.json +41 -6
  84. package/runtime/LICENSE.txt +645 -0
  85. package/runtime/Lib/site-packages/00_deploom_runtime.pth +1 -0
  86. package/runtime/Lib/site-packages/PyWin32.chm +0 -0
  87. package/runtime/Lib/site-packages/_cffi_backend.cp313-win_amd64.pyd +0 -0
  88. package/runtime/Lib/site-packages/_yaml/__init__.py +33 -0
  89. package/runtime/Lib/site-packages/adodbapi/__init__.py +82 -0
  90. package/runtime/Lib/site-packages/adodbapi/ado_consts.py +283 -0
  91. package/runtime/Lib/site-packages/adodbapi/adodbapi.py +1153 -0
  92. package/runtime/Lib/site-packages/adodbapi/apibase.py +723 -0
  93. package/runtime/Lib/site-packages/adodbapi/examples/db_print.py +72 -0
  94. package/runtime/Lib/site-packages/adodbapi/examples/db_table_names.py +21 -0
  95. package/runtime/Lib/site-packages/adodbapi/examples/xls_read.py +41 -0
  96. package/runtime/Lib/site-packages/adodbapi/examples/xls_write.py +41 -0
  97. package/runtime/Lib/site-packages/adodbapi/is64bit.py +34 -0
  98. package/runtime/Lib/site-packages/adodbapi/license.txt +505 -0
  99. package/runtime/Lib/site-packages/adodbapi/process_connect_string.py +137 -0
  100. package/runtime/Lib/site-packages/adodbapi/readme.txt +88 -0
  101. package/runtime/Lib/site-packages/adodbapi/schema_table.py +16 -0
  102. package/runtime/Lib/site-packages/adodbapi/setup.py +68 -0
  103. package/runtime/Lib/site-packages/adodbapi/test/adodbapitest.py +1547 -0
  104. package/runtime/Lib/site-packages/adodbapi/test/adodbapitestconfig.py +184 -0
  105. package/runtime/Lib/site-packages/adodbapi/test/dbapi20.py +879 -0
  106. package/runtime/Lib/site-packages/adodbapi/test/is64bit.py +34 -0
  107. package/runtime/Lib/site-packages/adodbapi/test/setuptestframework.py +98 -0
  108. package/runtime/Lib/site-packages/adodbapi/test/test_adodbapi_dbapi20.py +195 -0
  109. package/runtime/Lib/site-packages/adodbapi/test/tryconnection.py +30 -0
  110. package/runtime/Lib/site-packages/annotated_types/__init__.py +416 -0
  111. package/runtime/Lib/site-packages/annotated_types/py.typed +0 -0
  112. package/runtime/Lib/site-packages/annotated_types/test_cases.py +146 -0
  113. package/runtime/Lib/site-packages/annotated_types-0.8.0.dist-info/METADATA +295 -0
  114. package/runtime/Lib/site-packages/annotated_types-0.8.0.dist-info/RECORD +7 -0
  115. package/runtime/Lib/site-packages/annotated_types-0.8.0.dist-info/WHEEL +4 -0
  116. package/runtime/Lib/site-packages/annotated_types-0.8.0.dist-info/licenses/LICENSE +21 -0
  117. package/runtime/Lib/site-packages/anyio/__init__.py +154 -0
  118. package/runtime/Lib/site-packages/anyio/_backends/__init__.py +0 -0
  119. package/runtime/Lib/site-packages/anyio/_backends/_asyncio.py +3201 -0
  120. package/runtime/Lib/site-packages/anyio/_backends/_trio.py +1473 -0
  121. package/runtime/Lib/site-packages/anyio/_core/__init__.py +0 -0
  122. package/runtime/Lib/site-packages/anyio/_core/_asyncio_selector_thread.py +167 -0
  123. package/runtime/Lib/site-packages/anyio/_core/_concurrency_utils.py +156 -0
  124. package/runtime/Lib/site-packages/anyio/_core/_contextmanagers.py +200 -0
  125. package/runtime/Lib/site-packages/anyio/_core/_eventloop.py +240 -0
  126. package/runtime/Lib/site-packages/anyio/_core/_exceptions.py +205 -0
  127. package/runtime/Lib/site-packages/anyio/_core/_fileio.py +1045 -0
  128. package/runtime/Lib/site-packages/anyio/_core/_futures.py +191 -0
  129. package/runtime/Lib/site-packages/anyio/_core/_resources.py +18 -0
  130. package/runtime/Lib/site-packages/anyio/_core/_signals.py +29 -0
  131. package/runtime/Lib/site-packages/anyio/_core/_sockets.py +1011 -0
  132. package/runtime/Lib/site-packages/anyio/_core/_streams.py +52 -0
  133. package/runtime/Lib/site-packages/anyio/_core/_subprocesses.py +196 -0
  134. package/runtime/Lib/site-packages/anyio/_core/_synchronization.py +778 -0
  135. package/runtime/Lib/site-packages/anyio/_core/_tasks.py +464 -0
  136. package/runtime/Lib/site-packages/anyio/_core/_tempfile.py +615 -0
  137. package/runtime/Lib/site-packages/anyio/_core/_testing.py +82 -0
  138. package/runtime/Lib/site-packages/anyio/_core/_typedattr.py +85 -0
  139. package/runtime/Lib/site-packages/anyio/_lazyimport.py +176 -0
  140. package/runtime/Lib/site-packages/anyio/abc/__init__.py +63 -0
  141. package/runtime/Lib/site-packages/anyio/abc/_eventloop.py +428 -0
  142. package/runtime/Lib/site-packages/anyio/abc/_resources.py +39 -0
  143. package/runtime/Lib/site-packages/anyio/abc/_sockets.py +401 -0
  144. package/runtime/Lib/site-packages/anyio/abc/_streams.py +237 -0
  145. package/runtime/Lib/site-packages/anyio/abc/_subprocesses.py +82 -0
  146. package/runtime/Lib/site-packages/anyio/abc/_tasks.py +223 -0
  147. package/runtime/Lib/site-packages/anyio/abc/_testing.py +79 -0
  148. package/runtime/Lib/site-packages/anyio/from_thread.py +588 -0
  149. package/runtime/Lib/site-packages/anyio/functools.py +400 -0
  150. package/runtime/Lib/site-packages/anyio/itertools.py +629 -0
  151. package/runtime/Lib/site-packages/anyio/lowlevel.py +228 -0
  152. package/runtime/Lib/site-packages/anyio/py.typed +0 -0
  153. package/runtime/Lib/site-packages/anyio/pytest_plugin.py +404 -0
  154. package/runtime/Lib/site-packages/anyio/streams/__init__.py +0 -0
  155. package/runtime/Lib/site-packages/anyio/streams/buffered.py +201 -0
  156. package/runtime/Lib/site-packages/anyio/streams/file.py +157 -0
  157. package/runtime/Lib/site-packages/anyio/streams/memory.py +326 -0
  158. package/runtime/Lib/site-packages/anyio/streams/stapled.py +160 -0
  159. package/runtime/Lib/site-packages/anyio/streams/text.py +176 -0
  160. package/runtime/Lib/site-packages/anyio/streams/tls.py +436 -0
  161. package/runtime/Lib/site-packages/anyio/to_interpreter.py +246 -0
  162. package/runtime/Lib/site-packages/anyio/to_process.py +269 -0
  163. package/runtime/Lib/site-packages/anyio/to_thread.py +80 -0
  164. package/runtime/Lib/site-packages/anyio-4.15.1.dist-info/METADATA +108 -0
  165. package/runtime/Lib/site-packages/anyio-4.15.1.dist-info/RECORD +53 -0
  166. package/runtime/Lib/site-packages/anyio-4.15.1.dist-info/WHEEL +5 -0
  167. package/runtime/Lib/site-packages/anyio-4.15.1.dist-info/entry_points.txt +2 -0
  168. package/runtime/Lib/site-packages/anyio-4.15.1.dist-info/licenses/LICENSE +20 -0
  169. package/runtime/Lib/site-packages/anyio-4.15.1.dist-info/top_level.txt +1 -0
  170. package/runtime/Lib/site-packages/attr/__init__.py +104 -0
  171. package/runtime/Lib/site-packages/attr/__init__.pyi +389 -0
  172. package/runtime/Lib/site-packages/attr/_cmp.py +160 -0
  173. package/runtime/Lib/site-packages/attr/_cmp.pyi +13 -0
  174. package/runtime/Lib/site-packages/attr/_compat.py +99 -0
  175. package/runtime/Lib/site-packages/attr/_config.py +31 -0
  176. package/runtime/Lib/site-packages/attr/_funcs.py +497 -0
  177. package/runtime/Lib/site-packages/attr/_make.py +3406 -0
  178. package/runtime/Lib/site-packages/attr/_next_gen.py +674 -0
  179. package/runtime/Lib/site-packages/attr/_typing_compat.pyi +15 -0
  180. package/runtime/Lib/site-packages/attr/_version_info.py +89 -0
  181. package/runtime/Lib/site-packages/attr/_version_info.pyi +9 -0
  182. package/runtime/Lib/site-packages/attr/converters.py +162 -0
  183. package/runtime/Lib/site-packages/attr/converters.pyi +19 -0
  184. package/runtime/Lib/site-packages/attr/exceptions.py +95 -0
  185. package/runtime/Lib/site-packages/attr/exceptions.pyi +17 -0
  186. package/runtime/Lib/site-packages/attr/filters.py +72 -0
  187. package/runtime/Lib/site-packages/attr/filters.pyi +6 -0
  188. package/runtime/Lib/site-packages/attr/py.typed +0 -0
  189. package/runtime/Lib/site-packages/attr/setters.py +79 -0
  190. package/runtime/Lib/site-packages/attr/setters.pyi +20 -0
  191. package/runtime/Lib/site-packages/attr/validators.py +750 -0
  192. package/runtime/Lib/site-packages/attr/validators.pyi +140 -0
  193. package/runtime/Lib/site-packages/attrs/__init__.py +72 -0
  194. package/runtime/Lib/site-packages/attrs/__init__.pyi +314 -0
  195. package/runtime/Lib/site-packages/attrs/converters.py +3 -0
  196. package/runtime/Lib/site-packages/attrs/exceptions.py +3 -0
  197. package/runtime/Lib/site-packages/attrs/filters.py +3 -0
  198. package/runtime/Lib/site-packages/attrs/py.typed +0 -0
  199. package/runtime/Lib/site-packages/attrs/setters.py +3 -0
  200. package/runtime/Lib/site-packages/attrs/validators.py +3 -0
  201. package/runtime/Lib/site-packages/attrs-26.1.0.dist-info/METADATA +199 -0
  202. package/runtime/Lib/site-packages/attrs-26.1.0.dist-info/RECORD +35 -0
  203. package/runtime/Lib/site-packages/attrs-26.1.0.dist-info/WHEEL +4 -0
  204. package/runtime/Lib/site-packages/attrs-26.1.0.dist-info/licenses/LICENSE +21 -0
  205. package/runtime/Lib/site-packages/certifi/__init__.py +4 -0
  206. package/runtime/Lib/site-packages/certifi/__main__.py +12 -0
  207. package/runtime/Lib/site-packages/certifi/cacert.pem +3885 -0
  208. package/runtime/Lib/site-packages/certifi/core.py +83 -0
  209. package/runtime/Lib/site-packages/certifi/py.typed +0 -0
  210. package/runtime/Lib/site-packages/certifi/tests/__init__.py +0 -0
  211. package/runtime/Lib/site-packages/certifi/tests/test_certify.py +18 -0
  212. package/runtime/Lib/site-packages/certifi-2026.10.23.dist-info/METADATA +79 -0
  213. package/runtime/Lib/site-packages/certifi-2026.10.23.dist-info/RECORD +12 -0
  214. package/runtime/Lib/site-packages/certifi-2026.10.23.dist-info/WHEEL +5 -0
  215. package/runtime/Lib/site-packages/certifi-2026.10.23.dist-info/licenses/LICENSE +20 -0
  216. package/runtime/Lib/site-packages/certifi-2026.10.23.dist-info/top_level.txt +1 -0
  217. package/runtime/Lib/site-packages/cffi/__init__.py +14 -0
  218. package/runtime/Lib/site-packages/cffi/_cffi_errors.h +135 -0
  219. package/runtime/Lib/site-packages/cffi/_cffi_gen_src.py +216 -0
  220. package/runtime/Lib/site-packages/cffi/_cffi_include.h +397 -0
  221. package/runtime/Lib/site-packages/cffi/_embedding.h +512 -0
  222. package/runtime/Lib/site-packages/cffi/_imp_emulation.py +83 -0
  223. package/runtime/Lib/site-packages/cffi/_shimmed_dist_utils.py +45 -0
  224. package/runtime/Lib/site-packages/cffi/api.py +960 -0
  225. package/runtime/Lib/site-packages/cffi/backend_ctypes.py +1120 -0
  226. package/runtime/Lib/site-packages/cffi/cffi_opcode.py +187 -0
  227. package/runtime/Lib/site-packages/cffi/commontypes.py +82 -0
  228. package/runtime/Lib/site-packages/cffi/cparser.py +1014 -0
  229. package/runtime/Lib/site-packages/cffi/error.py +31 -0
  230. package/runtime/Lib/site-packages/cffi/ffiplatform.py +113 -0
  231. package/runtime/Lib/site-packages/cffi/gen_src.py +5 -0
  232. package/runtime/Lib/site-packages/cffi/lock.py +30 -0
  233. package/runtime/Lib/site-packages/cffi/model.py +617 -0
  234. package/runtime/Lib/site-packages/cffi/parse_c_type.h +181 -0
  235. package/runtime/Lib/site-packages/cffi/pkgconfig.py +121 -0
  236. package/runtime/Lib/site-packages/cffi/recompiler.py +1586 -0
  237. package/runtime/Lib/site-packages/cffi/setuptools_ext.py +231 -0
  238. package/runtime/Lib/site-packages/cffi/vengine_cpy.py +1058 -0
  239. package/runtime/Lib/site-packages/cffi/vengine_gen.py +679 -0
  240. package/runtime/Lib/site-packages/cffi/verifier.py +306 -0
  241. package/runtime/Lib/site-packages/cffi-2.1.1.dist-info/METADATA +67 -0
  242. package/runtime/Lib/site-packages/cffi-2.1.1.dist-info/RECORD +31 -0
  243. package/runtime/Lib/site-packages/cffi-2.1.1.dist-info/WHEEL +5 -0
  244. package/runtime/Lib/site-packages/cffi-2.1.1.dist-info/entry_points.txt +5 -0
  245. package/runtime/Lib/site-packages/cffi-2.1.1.dist-info/licenses/LICENSE +23 -0
  246. package/runtime/Lib/site-packages/cffi-2.1.1.dist-info/top_level.txt +2 -0
  247. package/runtime/Lib/site-packages/charset_normalizer/__init__.py +48 -0
  248. package/runtime/Lib/site-packages/charset_normalizer/__main__.py +6 -0
  249. package/runtime/Lib/site-packages/charset_normalizer/api.py +934 -0
  250. package/runtime/Lib/site-packages/charset_normalizer/cd.cp313-win_amd64.pyd +0 -0
  251. package/runtime/Lib/site-packages/charset_normalizer/cd.py +467 -0
  252. package/runtime/Lib/site-packages/charset_normalizer/cli/__init__.py +8 -0
  253. package/runtime/Lib/site-packages/charset_normalizer/cli/__main__.py +363 -0
  254. package/runtime/Lib/site-packages/charset_normalizer/constant.py +2497 -0
  255. package/runtime/Lib/site-packages/charset_normalizer/legacy.py +79 -0
  256. package/runtime/Lib/site-packages/charset_normalizer/md.cp313-win_amd64.pyd +0 -0
  257. package/runtime/Lib/site-packages/charset_normalizer/md.py +1065 -0
  258. package/runtime/Lib/site-packages/charset_normalizer/models.py +387 -0
  259. package/runtime/Lib/site-packages/charset_normalizer/py.typed +0 -0
  260. package/runtime/Lib/site-packages/charset_normalizer/utils.py +452 -0
  261. package/runtime/Lib/site-packages/charset_normalizer/version.py +8 -0
  262. package/runtime/Lib/site-packages/charset_normalizer-3.5.2.dist-info/METADATA +892 -0
  263. package/runtime/Lib/site-packages/charset_normalizer-3.5.2.dist-info/RECORD +21 -0
  264. package/runtime/Lib/site-packages/charset_normalizer-3.5.2.dist-info/WHEEL +5 -0
  265. package/runtime/Lib/site-packages/charset_normalizer-3.5.2.dist-info/entry_points.txt +2 -0
  266. package/runtime/Lib/site-packages/charset_normalizer-3.5.2.dist-info/licenses/LICENSE +21 -0
  267. package/runtime/Lib/site-packages/charset_normalizer-3.5.2.dist-info/top_level.txt +1 -0
  268. package/runtime/Lib/site-packages/click/__init__.py +144 -0
  269. package/runtime/Lib/site-packages/click/_compat.py +590 -0
  270. package/runtime/Lib/site-packages/click/_termui_impl.py +972 -0
  271. package/runtime/Lib/site-packages/click/_textwrap.py +188 -0
  272. package/runtime/Lib/site-packages/click/_utils.py +36 -0
  273. package/runtime/Lib/site-packages/click/_winconsole.py +297 -0
  274. package/runtime/Lib/site-packages/click/core.py +3799 -0
  275. package/runtime/Lib/site-packages/click/decorators.py +627 -0
  276. package/runtime/Lib/site-packages/click/exceptions.py +378 -0
  277. package/runtime/Lib/site-packages/click/formatting.py +320 -0
  278. package/runtime/Lib/site-packages/click/globals.py +67 -0
  279. package/runtime/Lib/site-packages/click/parser.py +533 -0
  280. package/runtime/Lib/site-packages/click/py.typed +0 -0
  281. package/runtime/Lib/site-packages/click/shell_completion.py +801 -0
  282. package/runtime/Lib/site-packages/click/termui.py +1014 -0
  283. package/runtime/Lib/site-packages/click/testing.py +798 -0
  284. package/runtime/Lib/site-packages/click/types.py +1422 -0
  285. package/runtime/Lib/site-packages/click/utils.py +688 -0
  286. package/runtime/Lib/site-packages/click-8.5.0.dist-info/METADATA +83 -0
  287. package/runtime/Lib/site-packages/click-8.5.0.dist-info/RECORD +22 -0
  288. package/runtime/Lib/site-packages/click-8.5.0.dist-info/WHEEL +4 -0
  289. package/runtime/Lib/site-packages/click-8.5.0.dist-info/licenses/LICENSE.txt +28 -0
  290. package/runtime/Lib/site-packages/cryptography/__about__.py +17 -0
  291. package/runtime/Lib/site-packages/cryptography/__init__.py +13 -0
  292. package/runtime/Lib/site-packages/cryptography/cobblestone.py +21 -0
  293. package/runtime/Lib/site-packages/cryptography/exceptions.py +52 -0
  294. package/runtime/Lib/site-packages/cryptography/fernet.py +240 -0
  295. package/runtime/Lib/site-packages/cryptography/hazmat/__init__.py +13 -0
  296. package/runtime/Lib/site-packages/cryptography/hazmat/_oid.py +373 -0
  297. package/runtime/Lib/site-packages/cryptography/hazmat/asn1/__init__.py +47 -0
  298. package/runtime/Lib/site-packages/cryptography/hazmat/asn1/asn1.py +533 -0
  299. package/runtime/Lib/site-packages/cryptography/hazmat/backends/__init__.py +13 -0
  300. package/runtime/Lib/site-packages/cryptography/hazmat/backends/openssl/__init__.py +9 -0
  301. package/runtime/Lib/site-packages/cryptography/hazmat/backends/openssl/backend.py +309 -0
  302. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/__init__.py +5 -0
  303. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/__init__.pyi +67 -0
  304. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/_openssl.pyi +8 -0
  305. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/asn1.pyi +7 -0
  306. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/cobblestone.pyi +33 -0
  307. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/declarative_asn1.pyi +133 -0
  308. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/exceptions.pyi +17 -0
  309. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/ocsp.pyi +117 -0
  310. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/__init__.pyi +82 -0
  311. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/aead.pyi +189 -0
  312. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/ciphers.pyi +38 -0
  313. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/cmac.pyi +18 -0
  314. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/dh.pyi +51 -0
  315. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/dsa.pyi +41 -0
  316. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/ec.pyi +52 -0
  317. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/ed25519.pyi +13 -0
  318. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/ed448.pyi +13 -0
  319. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/hashes.pyi +30 -0
  320. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/hmac.pyi +22 -0
  321. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/hpke.pyi +109 -0
  322. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/kdf.pyi +205 -0
  323. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/keys.pyi +34 -0
  324. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/keywrap.pyi +28 -0
  325. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/mldsa.pyi +35 -0
  326. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/mlkem.pyi +18 -0
  327. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/poly1305.pyi +15 -0
  328. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/rsa.pyi +55 -0
  329. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/x25519.pyi +13 -0
  330. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/openssl/x448.pyi +13 -0
  331. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/pkcs12.pyi +52 -0
  332. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/pkcs7.pyi +50 -0
  333. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/test_support.pyi +23 -0
  334. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust/x509.pyi +313 -0
  335. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/_rust.pyd +0 -0
  336. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/openssl/__init__.py +5 -0
  337. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/openssl/_conditional.py +199 -0
  338. package/runtime/Lib/site-packages/cryptography/hazmat/bindings/openssl/binding.py +107 -0
  339. package/runtime/Lib/site-packages/cryptography/hazmat/decrepit/__init__.py +5 -0
  340. package/runtime/Lib/site-packages/cryptography/hazmat/decrepit/ciphers/__init__.py +5 -0
  341. package/runtime/Lib/site-packages/cryptography/hazmat/decrepit/ciphers/algorithms.py +145 -0
  342. package/runtime/Lib/site-packages/cryptography/hazmat/decrepit/ciphers/modes.py +53 -0
  343. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/__init__.py +5 -0
  344. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/_asymmetric.py +19 -0
  345. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/_cipheralgorithm.py +60 -0
  346. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/_modes.py +105 -0
  347. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/_serialization.py +136 -0
  348. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/asymmetric/__init__.py +5 -0
  349. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/asymmetric/dh.py +253 -0
  350. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/asymmetric/dsa.py +179 -0
  351. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/asymmetric/ec.py +369 -0
  352. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/asymmetric/ed25519.py +116 -0
  353. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/asymmetric/ed448.py +143 -0
  354. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/asymmetric/mldsa.py +505 -0
  355. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/asymmetric/mlkem.py +278 -0
  356. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/asymmetric/padding.py +141 -0
  357. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/asymmetric/rsa.py +295 -0
  358. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/asymmetric/types.py +94 -0
  359. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/asymmetric/utils.py +28 -0
  360. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/asymmetric/x25519.py +134 -0
  361. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/asymmetric/x448.py +137 -0
  362. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/ciphers/__init__.py +27 -0
  363. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/ciphers/aead.py +23 -0
  364. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/ciphers/algorithms.py +138 -0
  365. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/ciphers/base.py +146 -0
  366. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/ciphers/modes.py +192 -0
  367. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/cmac.py +10 -0
  368. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/constant_time.py +14 -0
  369. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/hashes.py +357 -0
  370. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/hmac.py +13 -0
  371. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/hpke.py +27 -0
  372. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/kdf/__init__.py +32 -0
  373. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/kdf/argon2.py +17 -0
  374. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/kdf/concatkdf.py +16 -0
  375. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/kdf/hkdf.py +16 -0
  376. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/kdf/kbkdf.py +26 -0
  377. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/kdf/pbkdf2.py +13 -0
  378. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/kdf/scrypt.py +19 -0
  379. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/kdf/x963kdf.py +13 -0
  380. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/keywrap.py +25 -0
  381. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/padding.py +69 -0
  382. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/poly1305.py +11 -0
  383. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/serialization/__init__.py +85 -0
  384. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/serialization/base.py +16 -0
  385. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/serialization/pkcs12.py +176 -0
  386. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/serialization/pkcs7.py +412 -0
  387. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/serialization/ssh.py +1615 -0
  388. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/twofactor/__init__.py +9 -0
  389. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/twofactor/hotp.py +101 -0
  390. package/runtime/Lib/site-packages/cryptography/hazmat/primitives/twofactor/totp.py +56 -0
  391. package/runtime/Lib/site-packages/cryptography/py.typed +0 -0
  392. package/runtime/Lib/site-packages/cryptography/utils.py +136 -0
  393. package/runtime/Lib/site-packages/cryptography/x509/__init__.py +270 -0
  394. package/runtime/Lib/site-packages/cryptography/x509/base.py +834 -0
  395. package/runtime/Lib/site-packages/cryptography/x509/certificate_transparency.py +35 -0
  396. package/runtime/Lib/site-packages/cryptography/x509/extensions.py +2533 -0
  397. package/runtime/Lib/site-packages/cryptography/x509/general_name.py +281 -0
  398. package/runtime/Lib/site-packages/cryptography/x509/name.py +489 -0
  399. package/runtime/Lib/site-packages/cryptography/x509/ocsp.py +379 -0
  400. package/runtime/Lib/site-packages/cryptography/x509/oid.py +37 -0
  401. package/runtime/Lib/site-packages/cryptography/x509/verification.py +34 -0
  402. package/runtime/Lib/site-packages/cryptography-50.0.2.dist-info/METADATA +111 -0
  403. package/runtime/Lib/site-packages/cryptography-50.0.2.dist-info/RECORD +120 -0
  404. package/runtime/Lib/site-packages/cryptography-50.0.2.dist-info/WHEEL +4 -0
  405. package/runtime/Lib/site-packages/cryptography-50.0.2.dist-info/licenses/LICENSE +3 -0
  406. package/runtime/Lib/site-packages/cryptography-50.0.2.dist-info/licenses/LICENSE.APACHE +202 -0
  407. package/runtime/Lib/site-packages/cryptography-50.0.2.dist-info/licenses/LICENSE.BSD +27 -0
  408. package/runtime/Lib/site-packages/cryptography-50.0.2.dist-info/sboms/cryptography-rust.cyclonedx.json +1365 -0
  409. package/runtime/Lib/site-packages/cryptography-50.0.2.dist-info/sboms/sbom.json +43 -0
  410. package/runtime/Lib/site-packages/dateutil/__init__.py +26 -0
  411. package/runtime/Lib/site-packages/dateutil/_common.py +43 -0
  412. package/runtime/Lib/site-packages/dateutil/_tzdata_impl.py +147 -0
  413. package/runtime/Lib/site-packages/dateutil/_version.py +4 -0
  414. package/runtime/Lib/site-packages/dateutil/easter.py +89 -0
  415. package/runtime/Lib/site-packages/dateutil/parser/__init__.py +61 -0
  416. package/runtime/Lib/site-packages/dateutil/parser/_parser.py +1613 -0
  417. package/runtime/Lib/site-packages/dateutil/parser/isoparser.py +416 -0
  418. package/runtime/Lib/site-packages/dateutil/relativedelta.py +596 -0
  419. package/runtime/Lib/site-packages/dateutil/rrule.py +1764 -0
  420. package/runtime/Lib/site-packages/dateutil/tz/__init__.py +60 -0
  421. package/runtime/Lib/site-packages/dateutil/tz/_common.py +419 -0
  422. package/runtime/Lib/site-packages/dateutil/tz/_factories.py +80 -0
  423. package/runtime/Lib/site-packages/dateutil/tz/_tzfile.py +1428 -0
  424. package/runtime/Lib/site-packages/dateutil/tz/_tzpath.py +104 -0
  425. package/runtime/Lib/site-packages/dateutil/tz/tz.py +1472 -0
  426. package/runtime/Lib/site-packages/dateutil/tz/win.py +370 -0
  427. package/runtime/Lib/site-packages/dateutil/tzwin.py +2 -0
  428. package/runtime/Lib/site-packages/dateutil/utils.py +71 -0
  429. package/runtime/Lib/site-packages/dateutil/zoneinfo/__init__.py +233 -0
  430. package/runtime/Lib/site-packages/dateutil/zoneinfo/rebuild.py +42 -0
  431. package/runtime/Lib/site-packages/deploom_mcp/__init__.py +7 -0
  432. package/runtime/Lib/site-packages/deploom_mcp/__main__.py +7 -0
  433. package/runtime/Lib/site-packages/deploom_mcp/_core/VERSION +1 -0
  434. package/runtime/Lib/site-packages/deploom_mcp/_core/analyze_verification_telemetry.py +426 -0
  435. package/runtime/Lib/site-packages/deploom_mcp/_core/artifact_integrity.py +468 -0
  436. package/runtime/Lib/site-packages/deploom_mcp/_core/baseline_cohort_inference.py +352 -0
  437. package/runtime/Lib/site-packages/deploom_mcp/_core/baseline_constraint_verifier.py +5903 -0
  438. package/runtime/Lib/site-packages/deploom_mcp/_core/baseline_performance_summary.py +270 -0
  439. package/runtime/Lib/site-packages/deploom_mcp/_core/baseline_repair_handoff.py +208 -0
  440. package/runtime/Lib/site-packages/deploom_mcp/_core/block_psi54_branch_search.py +225 -0
  441. package/runtime/Lib/site-packages/deploom_mcp/_core/block_psi55_resolver_overrides.py +244 -0
  442. package/runtime/Lib/site-packages/deploom_mcp/_core/block_psi56_causal_anytime_search.py +285 -0
  443. package/runtime/Lib/site-packages/deploom_mcp/_core/block_psi57_yarn1_resolver_seed.py +622 -0
  444. package/runtime/Lib/site-packages/deploom_mcp/_core/block_psi581_probe_budget_and_cohort.py +194 -0
  445. package/runtime/Lib/site-packages/deploom_mcp/_core/block_psi582_pre_run_closure.py +168 -0
  446. package/runtime/Lib/site-packages/deploom_mcp/_core/block_psi583_duplicate_fallback_control.py +43 -0
  447. package/runtime/Lib/site-packages/deploom_mcp/_core/block_psi58_bounded_causal_search.py +193 -0
  448. package/runtime/Lib/site-packages/deploom_mcp/_core/block_psi58_reuse_economics.py +44 -0
  449. package/runtime/Lib/site-packages/deploom_mcp/_core/block_psi591_unified_cohort_handoff.py +214 -0
  450. package/runtime/Lib/site-packages/deploom_mcp/_core/block_psi59_transitive_override_search.py +525 -0
  451. package/runtime/Lib/site-packages/deploom_mcp/_core/block_psi_anytime.py +313 -0
  452. package/runtime/Lib/site-packages/deploom_mcp/_core/block_psi_progressive_baseline.py +166 -0
  453. package/runtime/Lib/site-packages/deploom_mcp/_core/block_v_predicate_search.py +427 -0
  454. package/runtime/Lib/site-packages/deploom_mcp/_core/block_v_predicate_state.py +385 -0
  455. package/runtime/Lib/site-packages/deploom_mcp/_core/block_v_prepared_artifact.py +1094 -0
  456. package/runtime/Lib/site-packages/deploom_mcp/_core/block_v_recovery.py +916 -0
  457. package/runtime/Lib/site-packages/deploom_mcp/_core/block_vex_storage.py +352 -0
  458. package/runtime/Lib/site-packages/deploom_mcp/_core/block_vf_active_search.py +167 -0
  459. package/runtime/Lib/site-packages/deploom_mcp/_core/bounded_telemetry.py +68 -0
  460. package/runtime/Lib/site-packages/deploom_mcp/_core/checkpoint_build_upgrade.py +158 -0
  461. package/runtime/Lib/site-packages/deploom_mcp/_core/checkpoint_index_recovery.py +63 -0
  462. package/runtime/Lib/site-packages/deploom_mcp/_core/cli_io.py +30 -0
  463. package/runtime/Lib/site-packages/deploom_mcp/_core/cohort_action_cost.py +50 -0
  464. package/runtime/Lib/site-packages/deploom_mcp/_core/cohort_attempt_telemetry.py +131 -0
  465. package/runtime/Lib/site-packages/deploom_mcp/_core/cohort_conflict_regions.py +114 -0
  466. package/runtime/Lib/site-packages/deploom_mcp/_core/cohort_size_policy.py +22 -0
  467. package/runtime/Lib/site-packages/deploom_mcp/_core/cohort_telemetry_report.py +105 -0
  468. package/runtime/Lib/site-packages/deploom_mcp/_core/constraint_cache.py +757 -0
  469. package/runtime/Lib/site-packages/deploom_mcp/_core/constraint_verify.py +669 -0
  470. package/runtime/Lib/site-packages/deploom_mcp/_core/cross_process_io.py +135 -0
  471. package/runtime/Lib/site-packages/deploom_mcp/_core/delivery_audit_recovery.py +53 -0
  472. package/runtime/Lib/site-packages/deploom_mcp/_core/delivery_git_status.py +62 -0
  473. package/runtime/Lib/site-packages/deploom_mcp/_core/delivery_source_identity.py +196 -0
  474. package/runtime/Lib/site-packages/deploom_mcp/_core/delivery_worktree.py +53 -0
  475. package/runtime/Lib/site-packages/deploom_mcp/_core/dependency-knowledge.schema.json +61 -0
  476. package/runtime/Lib/site-packages/deploom_mcp/_core/dependency_audit_branch.py +651 -0
  477. package/runtime/Lib/site-packages/deploom_mcp/_core/dependency_compatibility_evidence.py +364 -0
  478. package/runtime/Lib/site-packages/deploom_mcp/_core/dependency_interaction.py +60 -0
  479. package/runtime/Lib/site-packages/deploom_mcp/_core/dependency_live_roadmap_generator.py +28192 -0
  480. package/runtime/Lib/site-packages/deploom_mcp/_core/dependency_live_roadmap_worker.py +162 -0
  481. package/runtime/Lib/site-packages/deploom_mcp/_core/dependency_release_branch.py +407 -0
  482. package/runtime/Lib/site-packages/deploom_mcp/_core/deploom_failure.py +619 -0
  483. package/runtime/Lib/site-packages/deploom_mcp/_core/document_locales/en.json +83 -0
  484. package/runtime/Lib/site-packages/deploom_mcp/_core/document_locales/ru.json +83 -0
  485. package/runtime/Lib/site-packages/deploom_mcp/_core/draft_decision_contract.py +159 -0
  486. package/runtime/Lib/site-packages/deploom_mcp/_core/draft_input_identity.py +218 -0
  487. package/runtime/Lib/site-packages/deploom_mcp/_core/draft_npm_preflight.py +171 -0
  488. package/runtime/Lib/site-packages/deploom_mcp/_core/draft_publication_guard.py +68 -0
  489. package/runtime/Lib/site-packages/deploom_mcp/_core/frontend_source_policy.py +54 -0
  490. package/runtime/Lib/site-packages/deploom_mcp/_core/git_hook_policy.py +102 -0
  491. package/runtime/Lib/site-packages/deploom_mcp/_core/git_identity.py +65 -0
  492. package/runtime/Lib/site-packages/deploom_mcp/_core/io_governor.py +124 -0
  493. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_adaptive_budget.py +109 -0
  494. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_audit_policy.py +79 -0
  495. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_checkpoint_publication.py +90 -0
  496. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_cohort_planner.py +378 -0
  497. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_cohort_review.py +98 -0
  498. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_delivery.py +701 -0
  499. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_delivery_checkout.py +59 -0
  500. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_delivery_notes.py +228 -0
  501. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_delivery_preflight.py +112 -0
  502. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_delivery_submodules.py +31 -0
  503. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_discovery_checkpoint.py +94 -0
  504. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_migration.py +6249 -0
  505. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_progress.py +52 -0
  506. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_registry_metadata.py +98 -0
  507. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_registry_yarn.py +127 -0
  508. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_restart.py +70 -0
  509. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_resume.py +73 -0
  510. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_scope_expansion.py +101 -0
  511. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_stage_checkpoint.py +211 -0
  512. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_state_transaction.py +124 -0
  513. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_target_deferrals.py +61 -0
  514. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_task.py +1411 -0
  515. package/runtime/Lib/site-packages/deploom_mcp/_core/iterative_trial_workspace.py +54 -0
  516. package/runtime/Lib/site-packages/deploom_mcp/_core/lockfile_consistency.py +1242 -0
  517. package/runtime/Lib/site-packages/deploom_mcp/_core/lockfile_preflight.py +102 -0
  518. package/runtime/Lib/site-packages/deploom_mcp/_core/manual_dependency_audit.py +2081 -0
  519. package/runtime/Lib/site-packages/deploom_mcp/_core/materialization_retention.py +148 -0
  520. package/runtime/Lib/site-packages/deploom_mcp/_core/materialized_workspace_verifier.py +320 -0
  521. package/runtime/Lib/site-packages/deploom_mcp/_core/migration_documents.py +506 -0
  522. package/runtime/Lib/site-packages/deploom_mcp/_core/migration_research.py +158 -0
  523. package/runtime/Lib/site-packages/deploom_mcp/_core/migration_validation.py +231 -0
  524. package/runtime/Lib/site-packages/deploom_mcp/_core/npm_bundle_obligations.py +240 -0
  525. package/runtime/Lib/site-packages/deploom_mcp/_core/npm_platform_obligations.py +256 -0
  526. package/runtime/Lib/site-packages/deploom_mcp/_core/npm_semver_batch.py +111 -0
  527. package/runtime/Lib/site-packages/deploom_mcp/_core/npm_shared_transition.py +88 -0
  528. package/runtime/Lib/site-packages/deploom_mcp/_core/osv_offline.py +105 -0
  529. package/runtime/Lib/site-packages/deploom_mcp/_core/package_manager_profile.py +331 -0
  530. package/runtime/Lib/site-packages/deploom_mcp/_core/package_manager_telemetry.py +73 -0
  531. package/runtime/Lib/site-packages/deploom_mcp/_core/peer_solver_goal.py +109 -0
  532. package/runtime/Lib/site-packages/deploom_mcp/_core/peer_solver_model.py +304 -0
  533. package/runtime/Lib/site-packages/deploom_mcp/_core/peer_solver_transition.py +308 -0
  534. package/runtime/Lib/site-packages/deploom_mcp/_core/peer_solver_z3.py +300 -0
  535. package/runtime/Lib/site-packages/deploom_mcp/_core/planning_cache.py +180 -0
  536. package/runtime/Lib/site-packages/deploom_mcp/_core/prepared_workspace_fastpath.py +1528 -0
  537. package/runtime/Lib/site-packages/deploom_mcp/_core/project_execution_environment.py +105 -0
  538. package/runtime/Lib/site-packages/deploom_mcp/_core/project_runtime.py +433 -0
  539. package/runtime/Lib/site-packages/deploom_mcp/_core/project_topology.py +813 -0
  540. package/runtime/Lib/site-packages/deploom_mcp/_core/proven_dependency_state.py +234 -0
  541. package/runtime/Lib/site-packages/deploom_mcp/_core/registry_advisory_evidence.py +202 -0
  542. package/runtime/Lib/site-packages/deploom_mcp/_core/registry_candidate_diagnostics.py +334 -0
  543. package/runtime/Lib/site-packages/deploom_mcp/_core/registry_metadata_cache.py +233 -0
  544. package/runtime/Lib/site-packages/deploom_mcp/_core/registry_request_context.py +36 -0
  545. package/runtime/Lib/site-packages/deploom_mcp/_core/reparse_materialization.py +335 -0
  546. package/runtime/Lib/site-packages/deploom_mcp/_core/resolution_inventory.py +481 -0
  547. package/runtime/Lib/site-packages/deploom_mcp/_core/resolved_dependency_state.py +820 -0
  548. package/runtime/Lib/site-packages/deploom_mcp/_core/run_tool_tests.py +69 -0
  549. package/runtime/Lib/site-packages/deploom_mcp/_core/run_writer_lock.py +78 -0
  550. package/runtime/Lib/site-packages/deploom_mcp/_core/runtime_metrics.py +185 -0
  551. package/runtime/Lib/site-packages/deploom_mcp/_core/scoped_source_policy.py +111 -0
  552. package/runtime/Lib/site-packages/deploom_mcp/_core/security_workspace_scope.py +136 -0
  553. package/runtime/Lib/site-packages/deploom_mcp/_core/settings.schema.json +1229 -0
  554. package/runtime/Lib/site-packages/deploom_mcp/_core/snapshot_compaction.py +288 -0
  555. package/runtime/Lib/site-packages/deploom_mcp/_core/source_snapshot.py +2635 -0
  556. package/runtime/Lib/site-packages/deploom_mcp/_core/source_snapshot_storage.py +96 -0
  557. package/runtime/Lib/site-packages/deploom_mcp/_core/standalone_build_outputs.py +167 -0
  558. package/runtime/Lib/site-packages/deploom_mcp/_core/storage_capacity.py +19 -0
  559. package/runtime/Lib/site-packages/deploom_mcp/_core/storage_cleanup_inventory.py +379 -0
  560. package/runtime/Lib/site-packages/deploom_mcp/_core/storage_maintenance_control.py +84 -0
  561. package/runtime/Lib/site-packages/deploom_mcp/_core/storybook_release_policy.py +37 -0
  562. package/runtime/Lib/site-packages/deploom_mcp/_core/substrate_identity.py +129 -0
  563. package/runtime/Lib/site-packages/deploom_mcp/_core/validate_dependency_regression.py +402 -0
  564. package/runtime/Lib/site-packages/deploom_mcp/_core/validate_dependency_update.py +920 -0
  565. package/runtime/Lib/site-packages/deploom_mcp/_core/verification_experiment_registry.py +299 -0
  566. package/runtime/Lib/site-packages/deploom_mcp/_core/verification_identity_diagnostics.py +38 -0
  567. package/runtime/Lib/site-packages/deploom_mcp/_core/verification_invocation.py +145 -0
  568. package/runtime/Lib/site-packages/deploom_mcp/_core/verification_linux_pid_namespace.py +134 -0
  569. package/runtime/Lib/site-packages/deploom_mcp/_core/verification_observability.py +857 -0
  570. package/runtime/Lib/site-packages/deploom_mcp/_core/verification_process_supervisor.py +790 -0
  571. package/runtime/Lib/site-packages/deploom_mcp/_core/verification_proof.py +1526 -0
  572. package/runtime/Lib/site-packages/deploom_mcp/_core/verification_source_closure.py +337 -0
  573. package/runtime/Lib/site-packages/deploom_mcp/_core/verification_stage_checkpoint.py +367 -0
  574. package/runtime/Lib/site-packages/deploom_mcp/_core/verification_storage_maintenance.py +298 -0
  575. package/runtime/Lib/site-packages/deploom_mcp/_core/verification_workspace_backend.py +398 -0
  576. package/runtime/Lib/site-packages/deploom_mcp/_core/windows_unc.py +48 -0
  577. package/runtime/Lib/site-packages/deploom_mcp/_core/worker_runtime_state.py +26 -0
  578. package/runtime/Lib/site-packages/deploom_mcp/_core/workspace_glob.py +208 -0
  579. package/runtime/Lib/site-packages/deploom_mcp/_core/workspace_health_evidence.py +145 -0
  580. package/runtime/Lib/site-packages/deploom_mcp/_core/workspace_health_policy.py +142 -0
  581. package/runtime/Lib/site-packages/deploom_mcp/_core/workspace_noise.py +83 -0
  582. package/runtime/Lib/site-packages/deploom_mcp/_core/workspace_npm_lock_delta.py +351 -0
  583. package/runtime/Lib/site-packages/deploom_mcp/_core/workspace_npm_obligations.py +190 -0
  584. package/runtime/Lib/site-packages/deploom_mcp/_core/workspace_npm_preflight.py +535 -0
  585. package/runtime/Lib/site-packages/deploom_mcp/_core/workspace_npm_transitive_override.py +239 -0
  586. package/runtime/Lib/site-packages/deploom_mcp/_core/workspace_peer_model.py +936 -0
  587. package/runtime/Lib/site-packages/deploom_mcp/_core/workspace_registry_metadata.py +73 -0
  588. package/runtime/Lib/site-packages/deploom_mcp/_core/yarn_berry.py +151 -0
  589. package/runtime/Lib/site-packages/deploom_mcp/audit_evidence.py +186 -0
  590. package/runtime/Lib/site-packages/deploom_mcp/audit_server.py +57 -0
  591. package/runtime/Lib/site-packages/deploom_mcp/audit_worker.py +738 -0
  592. package/runtime/Lib/site-packages/deploom_mcp/blueprint.py +1344 -0
  593. package/runtime/Lib/site-packages/deploom_mcp/decision_followups.py +384 -0
  594. package/runtime/Lib/site-packages/deploom_mcp/decisions.py +485 -0
  595. package/runtime/Lib/site-packages/deploom_mcp/dependency_audit.py +237 -0
  596. package/runtime/Lib/site-packages/deploom_mcp/distribution.py +51 -0
  597. package/runtime/Lib/site-packages/deploom_mcp/goal_artifact_scope.py +65 -0
  598. package/runtime/Lib/site-packages/deploom_mcp/goal_candidate.py +174 -0
  599. package/runtime/Lib/site-packages/deploom_mcp/goal_candidate_worker.py +30 -0
  600. package/runtime/Lib/site-packages/deploom_mcp/goal_check_bindings.py +236 -0
  601. package/runtime/Lib/site-packages/deploom_mcp/goal_choice_contract.py +79 -0
  602. package/runtime/Lib/site-packages/deploom_mcp/goal_choice_issuance.py +58 -0
  603. package/runtime/Lib/site-packages/deploom_mcp/goal_choice_lineage.py +115 -0
  604. package/runtime/Lib/site-packages/deploom_mcp/goal_choice_profile.py +38 -0
  605. package/runtime/Lib/site-packages/deploom_mcp/goal_choice_worker.py +66 -0
  606. package/runtime/Lib/site-packages/deploom_mcp/goal_contract.py +173 -0
  607. package/runtime/Lib/site-packages/deploom_mcp/goal_core_integrity.py +28 -0
  608. package/runtime/Lib/site-packages/deploom_mcp/goal_current_proof_boundary.py +41 -0
  609. package/runtime/Lib/site-packages/deploom_mcp/goal_current_proof_budget.py +135 -0
  610. package/runtime/Lib/site-packages/deploom_mcp/goal_current_proof_process.py +137 -0
  611. package/runtime/Lib/site-packages/deploom_mcp/goal_current_read_trace.py +66 -0
  612. package/runtime/Lib/site-packages/deploom_mcp/goal_delta_trial.py +413 -0
  613. package/runtime/Lib/site-packages/deploom_mcp/goal_execution_environment.py +71 -0
  614. package/runtime/Lib/site-packages/deploom_mcp/goal_execution_registry.py +207 -0
  615. package/runtime/Lib/site-packages/deploom_mcp/goal_final_authorization.py +133 -0
  616. package/runtime/Lib/site-packages/deploom_mcp/goal_final_auxiliary.py +114 -0
  617. package/runtime/Lib/site-packages/deploom_mcp/goal_final_candidate.py +102 -0
  618. package/runtime/Lib/site-packages/deploom_mcp/goal_final_checkpoint.py +342 -0
  619. package/runtime/Lib/site-packages/deploom_mcp/goal_final_materialization.py +150 -0
  620. package/runtime/Lib/site-packages/deploom_mcp/goal_final_resource_policy.py +49 -0
  621. package/runtime/Lib/site-packages/deploom_mcp/goal_final_transaction.py +243 -0
  622. package/runtime/Lib/site-packages/deploom_mcp/goal_final_worker.py +19 -0
  623. package/runtime/Lib/site-packages/deploom_mcp/goal_frozen_candidate.py +187 -0
  624. package/runtime/Lib/site-packages/deploom_mcp/goal_generated_outputs.py +94 -0
  625. package/runtime/Lib/site-packages/deploom_mcp/goal_historical_checkpoint.py +220 -0
  626. package/runtime/Lib/site-packages/deploom_mcp/goal_historical_lineage.py +97 -0
  627. package/runtime/Lib/site-packages/deploom_mcp/goal_invocation_adapter.py +179 -0
  628. package/runtime/Lib/site-packages/deploom_mcp/goal_lock_scope.py +476 -0
  629. package/runtime/Lib/site-packages/deploom_mcp/goal_published_edges.py +263 -0
  630. package/runtime/Lib/site-packages/deploom_mcp/goal_report.py +134 -0
  631. package/runtime/Lib/site-packages/deploom_mcp/goal_shared_scope.py +36 -0
  632. package/runtime/Lib/site-packages/deploom_mcp/goal_tap_nyc_execution.py +153 -0
  633. package/runtime/Lib/site-packages/deploom_mcp/goal_tap_nyc_input.py +174 -0
  634. package/runtime/Lib/site-packages/deploom_mcp/goal_tap_nyc_outputs.py +64 -0
  635. package/runtime/Lib/site-packages/deploom_mcp/goal_tap_nyc_spawn.py +66 -0
  636. package/runtime/Lib/site-packages/deploom_mcp/goal_tool_cache.py +146 -0
  637. package/runtime/Lib/site-packages/deploom_mcp/goal_tools.py +90 -0
  638. package/runtime/Lib/site-packages/deploom_mcp/goal_verifier_bridge.py +293 -0
  639. package/runtime/Lib/site-packages/deploom_mcp/goal_windows_file_swap.py +233 -0
  640. package/runtime/Lib/site-packages/deploom_mcp/goal_windows_tree_swap.py +105 -0
  641. package/runtime/Lib/site-packages/deploom_mcp/goal_worker.py +103 -0
  642. package/runtime/Lib/site-packages/deploom_mcp/goal_workspace_observation.py +49 -0
  643. package/runtime/Lib/site-packages/deploom_mcp/migration_evidence.py +191 -0
  644. package/runtime/Lib/site-packages/deploom_mcp/migration_sources.py +217 -0
  645. package/runtime/Lib/site-packages/deploom_mcp/migration_usage.cjs +91 -0
  646. package/runtime/Lib/site-packages/deploom_mcp/migration_usage.py +76 -0
  647. package/runtime/Lib/site-packages/deploom_mcp/migration_worker.py +56 -0
  648. package/runtime/Lib/site-packages/deploom_mcp/planning_registry.py +130 -0
  649. package/runtime/Lib/site-packages/deploom_mcp/process_runner.py +313 -0
  650. package/runtime/Lib/site-packages/deploom_mcp/project_capabilities.py +103 -0
  651. package/runtime/Lib/site-packages/deploom_mcp/proxy_settings.py +60 -0
  652. package/runtime/Lib/site-packages/deploom_mcp/public_cache.py +152 -0
  653. package/runtime/Lib/site-packages/deploom_mcp/py.typed +0 -0
  654. package/runtime/Lib/site-packages/deploom_mcp/registry_projection.py +313 -0
  655. package/runtime/Lib/site-packages/deploom_mcp/resources/release-manifest.json +176 -0
  656. package/runtime/Lib/site-packages/deploom_mcp/resources/scripts/check_skill.py +36 -0
  657. package/runtime/Lib/site-packages/deploom_mcp/resources/scripts/install_skill.py +280 -0
  658. package/runtime/Lib/site-packages/deploom_mcp/resources/scripts/skill_integrity.py +95 -0
  659. package/runtime/Lib/site-packages/deploom_mcp/resources/skills/deploom-upgrade/SKILL.md +281 -0
  660. package/runtime/Lib/site-packages/deploom_mcp/resources/skills/deploom-upgrade/contract.json +20 -0
  661. package/runtime/Lib/site-packages/deploom_mcp/resources/skills/deploom-upgrade/examples/blocked-upgrade.md +37 -0
  662. package/runtime/Lib/site-packages/deploom_mcp/resources/skills/deploom-upgrade/examples/plan-only.md +20 -0
  663. package/runtime/Lib/site-packages/deploom_mcp/resources/skills/deploom-upgrade/examples/yellow-exclude-react.md +29 -0
  664. package/runtime/Lib/site-packages/deploom_mcp/resources/skills/deploom-upgrade/references/blueprint-contract.md +160 -0
  665. package/runtime/Lib/site-packages/deploom_mcp/resources/skills/deploom-upgrade/references/evidence-report.md +150 -0
  666. package/runtime/Lib/site-packages/deploom_mcp/resources/skills/deploom-upgrade/references/execution-policy.md +143 -0
  667. package/runtime/Lib/site-packages/deploom_mcp/resources/skills/deploom-upgrade/references/goal-and-migration-evidence.md +124 -0
  668. package/runtime/Lib/site-packages/deploom_mcp/resources/skills/deploom-upgrade/references/npm-workspaces.md +241 -0
  669. package/runtime/Lib/site-packages/deploom_mcp/resources/skills/deploom-upgrade/references/preflight.md +75 -0
  670. package/runtime/Lib/site-packages/deploom_mcp/resources/skills/deploom-upgrade/references/verification-policy.md +77 -0
  671. package/runtime/Lib/site-packages/deploom_mcp/resources/skills/deploom-upgrade/scripts/validate_evidence.py +264 -0
  672. package/runtime/Lib/site-packages/deploom_mcp/resources/upgrade-blueprint.schema.json +1080 -0
  673. package/runtime/Lib/site-packages/deploom_mcp/resources/workspace-upgrade-blueprint.schema.json +1770 -0
  674. package/runtime/Lib/site-packages/deploom_mcp/server.py +1345 -0
  675. package/runtime/Lib/site-packages/deploom_mcp/shared_records.py +75 -0
  676. package/runtime/Lib/site-packages/deploom_mcp/standalone_audit_guard.cjs +71 -0
  677. package/runtime/Lib/site-packages/deploom_mcp/target_assessment.py +185 -0
  678. package/runtime/Lib/site-packages/deploom_mcp/workspace_acceptance.py +311 -0
  679. package/runtime/Lib/site-packages/deploom_mcp/workspace_candidate_policy.py +123 -0
  680. package/runtime/Lib/site-packages/deploom_mcp/workspace_delivery_apply.py +149 -0
  681. package/runtime/Lib/site-packages/deploom_mcp/workspace_edits.py +413 -0
  682. package/runtime/Lib/site-packages/deploom_mcp/workspace_finalize.py +85 -0
  683. package/runtime/Lib/site-packages/deploom_mcp/workspace_goal_request.py +95 -0
  684. package/runtime/Lib/site-packages/deploom_mcp/workspace_input_io.py +123 -0
  685. package/runtime/Lib/site-packages/deploom_mcp/workspace_inventory.py +428 -0
  686. package/runtime/Lib/site-packages/deploom_mcp/workspace_migration_card.py +343 -0
  687. package/runtime/Lib/site-packages/deploom_mcp/workspace_native_intent.py +155 -0
  688. package/runtime/Lib/site-packages/deploom_mcp/workspace_plan_details.py +172 -0
  689. package/runtime/Lib/site-packages/deploom_mcp/workspace_plan_snapshot.py +429 -0
  690. package/runtime/Lib/site-packages/deploom_mcp/workspace_policy_delivery.py +88 -0
  691. package/runtime/Lib/site-packages/deploom_mcp/workspace_policy_request.py +139 -0
  692. package/runtime/Lib/site-packages/deploom_mcp/workspace_source_delivery.py +138 -0
  693. package/runtime/Lib/site-packages/deploom_mcp/workspace_tools.py +313 -0
  694. package/runtime/Lib/site-packages/deploom_mcp/workspace_upgrade.py +237 -0
  695. package/runtime/Lib/site-packages/deploom_mcp/workspace_verification_attempt.py +127 -0
  696. package/runtime/Lib/site-packages/deploom_mcp/yarn_candidate_audit.py +72 -0
  697. package/runtime/Lib/site-packages/deploom_mcp-0.2.21.dist-info/METADATA +85 -0
  698. package/runtime/Lib/site-packages/deploom_mcp-0.2.21.dist-info/RECORD +272 -0
  699. package/runtime/Lib/site-packages/deploom_mcp-0.2.21.dist-info/WHEEL +5 -0
  700. package/runtime/Lib/site-packages/deploom_mcp-0.2.21.dist-info/entry_points.txt +4 -0
  701. package/runtime/Lib/site-packages/deploom_mcp-0.2.21.dist-info/licenses/LICENSE +202 -0
  702. package/runtime/Lib/site-packages/deploom_mcp-0.2.21.dist-info/top_level.txt +1 -0
  703. package/runtime/Lib/site-packages/h11/__init__.py +62 -0
  704. package/runtime/Lib/site-packages/h11/_abnf.py +132 -0
  705. package/runtime/Lib/site-packages/h11/_connection.py +659 -0
  706. package/runtime/Lib/site-packages/h11/_events.py +369 -0
  707. package/runtime/Lib/site-packages/h11/_headers.py +282 -0
  708. package/runtime/Lib/site-packages/h11/_readers.py +250 -0
  709. package/runtime/Lib/site-packages/h11/_receivebuffer.py +153 -0
  710. package/runtime/Lib/site-packages/h11/_state.py +365 -0
  711. package/runtime/Lib/site-packages/h11/_util.py +135 -0
  712. package/runtime/Lib/site-packages/h11/_version.py +16 -0
  713. package/runtime/Lib/site-packages/h11/_writers.py +145 -0
  714. package/runtime/Lib/site-packages/h11/py.typed +1 -0
  715. package/runtime/Lib/site-packages/h11-0.16.0.dist-info/METADATA +202 -0
  716. package/runtime/Lib/site-packages/h11-0.16.0.dist-info/RECORD +17 -0
  717. package/runtime/Lib/site-packages/h11-0.16.0.dist-info/WHEEL +5 -0
  718. package/runtime/Lib/site-packages/h11-0.16.0.dist-info/licenses/LICENSE.txt +22 -0
  719. package/runtime/Lib/site-packages/h11-0.16.0.dist-info/top_level.txt +1 -0
  720. package/runtime/Lib/site-packages/httpcore2/__init__.py +141 -0
  721. package/runtime/Lib/site-packages/httpcore2/_api.py +95 -0
  722. package/runtime/Lib/site-packages/httpcore2/_async/__init__.py +39 -0
  723. package/runtime/Lib/site-packages/httpcore2/_async/connection.py +208 -0
  724. package/runtime/Lib/site-packages/httpcore2/_async/connection_pool.py +440 -0
  725. package/runtime/Lib/site-packages/httpcore2/_async/http11.py +357 -0
  726. package/runtime/Lib/site-packages/httpcore2/_async/http2.py +582 -0
  727. package/runtime/Lib/site-packages/httpcore2/_async/http_proxy.py +357 -0
  728. package/runtime/Lib/site-packages/httpcore2/_async/interfaces.py +160 -0
  729. package/runtime/Lib/site-packages/httpcore2/_async/socks_proxy.py +327 -0
  730. package/runtime/Lib/site-packages/httpcore2/_backends/__init__.py +0 -0
  731. package/runtime/Lib/site-packages/httpcore2/_backends/anyio.py +149 -0
  732. package/runtime/Lib/site-packages/httpcore2/_backends/auto.py +50 -0
  733. package/runtime/Lib/site-packages/httpcore2/_backends/base.py +97 -0
  734. package/runtime/Lib/site-packages/httpcore2/_backends/mock.py +143 -0
  735. package/runtime/Lib/site-packages/httpcore2/_backends/sync.py +235 -0
  736. package/runtime/Lib/site-packages/httpcore2/_backends/trio.py +157 -0
  737. package/runtime/Lib/site-packages/httpcore2/_exceptions.py +84 -0
  738. package/runtime/Lib/site-packages/httpcore2/_models.py +490 -0
  739. package/runtime/Lib/site-packages/httpcore2/_ssl.py +40 -0
  740. package/runtime/Lib/site-packages/httpcore2/_sync/__init__.py +39 -0
  741. package/runtime/Lib/site-packages/httpcore2/_sync/connection.py +208 -0
  742. package/runtime/Lib/site-packages/httpcore2/_sync/connection_pool.py +440 -0
  743. package/runtime/Lib/site-packages/httpcore2/_sync/http11.py +357 -0
  744. package/runtime/Lib/site-packages/httpcore2/_sync/http2.py +582 -0
  745. package/runtime/Lib/site-packages/httpcore2/_sync/http_proxy.py +357 -0
  746. package/runtime/Lib/site-packages/httpcore2/_sync/interfaces.py +160 -0
  747. package/runtime/Lib/site-packages/httpcore2/_sync/socks_proxy.py +327 -0
  748. package/runtime/Lib/site-packages/httpcore2/_synchronization.py +338 -0
  749. package/runtime/Lib/site-packages/httpcore2/_trace.py +105 -0
  750. package/runtime/Lib/site-packages/httpcore2/_utils.py +65 -0
  751. package/runtime/Lib/site-packages/httpcore2/py.typed +0 -0
  752. package/runtime/Lib/site-packages/httpcore2-2.16.0.dist-info/METADATA +785 -0
  753. package/runtime/Lib/site-packages/httpcore2-2.16.0.dist-info/RECORD +36 -0
  754. package/runtime/Lib/site-packages/httpcore2-2.16.0.dist-info/WHEEL +4 -0
  755. package/runtime/Lib/site-packages/httpcore2-2.16.0.dist-info/licenses/LICENSE.md +28 -0
  756. package/runtime/Lib/site-packages/httpx2/__init__.py +130 -0
  757. package/runtime/Lib/site-packages/httpx2/__version__.py +5 -0
  758. package/runtime/Lib/site-packages/httpx2/_alias.py +71 -0
  759. package/runtime/Lib/site-packages/httpx2/_api.py +532 -0
  760. package/runtime/Lib/site-packages/httpx2/_auth.py +335 -0
  761. package/runtime/Lib/site-packages/httpx2/_client.py +2236 -0
  762. package/runtime/Lib/site-packages/httpx2/_config.py +221 -0
  763. package/runtime/Lib/site-packages/httpx2/_content.py +237 -0
  764. package/runtime/Lib/site-packages/httpx2/_cookies.py +74 -0
  765. package/runtime/Lib/site-packages/httpx2/_decoders.py +458 -0
  766. package/runtime/Lib/site-packages/httpx2/_exceptions.py +380 -0
  767. package/runtime/Lib/site-packages/httpx2/_main.py +483 -0
  768. package/runtime/Lib/site-packages/httpx2/_models.py +1274 -0
  769. package/runtime/Lib/site-packages/httpx2/_multipart.py +284 -0
  770. package/runtime/Lib/site-packages/httpx2/_sse.py +226 -0
  771. package/runtime/Lib/site-packages/httpx2/_status_codes.py +189 -0
  772. package/runtime/Lib/site-packages/httpx2/_transports/__init__.py +27 -0
  773. package/runtime/Lib/site-packages/httpx2/_transports/asgi.py +178 -0
  774. package/runtime/Lib/site-packages/httpx2/_transports/base.py +83 -0
  775. package/runtime/Lib/site-packages/httpx2/_transports/default.py +400 -0
  776. package/runtime/Lib/site-packages/httpx2/_transports/mock.py +40 -0
  777. package/runtime/Lib/site-packages/httpx2/_transports/wsgi.py +145 -0
  778. package/runtime/Lib/site-packages/httpx2/_types.py +86 -0
  779. package/runtime/Lib/site-packages/httpx2/_urlparse.py +502 -0
  780. package/runtime/Lib/site-packages/httpx2/_urls.py +689 -0
  781. package/runtime/Lib/site-packages/httpx2/_utils.py +282 -0
  782. package/runtime/Lib/site-packages/httpx2/py.typed +0 -0
  783. package/runtime/Lib/site-packages/httpx2/websockets/__init__.py +57 -0
  784. package/runtime/Lib/site-packages/httpx2/websockets/_api.py +1676 -0
  785. package/runtime/Lib/site-packages/httpx2/websockets/_exceptions.py +55 -0
  786. package/runtime/Lib/site-packages/httpx2/websockets/_ping.py +43 -0
  787. package/runtime/Lib/site-packages/httpx2/websockets/_transport.py +289 -0
  788. package/runtime/Lib/site-packages/httpx2-2.16.0.dist-info/METADATA +230 -0
  789. package/runtime/Lib/site-packages/httpx2-2.16.0.dist-info/RECORD +37 -0
  790. package/runtime/Lib/site-packages/httpx2-2.16.0.dist-info/WHEEL +4 -0
  791. package/runtime/Lib/site-packages/httpx2-2.16.0.dist-info/entry_points.txt +2 -0
  792. package/runtime/Lib/site-packages/httpx2-2.16.0.dist-info/licenses/LICENSE.md +13 -0
  793. package/runtime/Lib/site-packages/idna/__init__.py +47 -0
  794. package/runtime/Lib/site-packages/idna/__main__.py +6 -0
  795. package/runtime/Lib/site-packages/idna/cli.py +132 -0
  796. package/runtime/Lib/site-packages/idna/codec.py +225 -0
  797. package/runtime/Lib/site-packages/idna/compat.py +43 -0
  798. package/runtime/Lib/site-packages/idna/core.py +863 -0
  799. package/runtime/Lib/site-packages/idna/idnadata.py +1933 -0
  800. package/runtime/Lib/site-packages/idna/intranges.py +55 -0
  801. package/runtime/Lib/site-packages/idna/package_data.py +1 -0
  802. package/runtime/Lib/site-packages/idna/py.typed +0 -0
  803. package/runtime/Lib/site-packages/idna/uts46data.py +17117 -0
  804. package/runtime/Lib/site-packages/idna-3.20.dist-info/METADATA +176 -0
  805. package/runtime/Lib/site-packages/idna-3.20.dist-info/RECORD +16 -0
  806. package/runtime/Lib/site-packages/idna-3.20.dist-info/WHEEL +4 -0
  807. package/runtime/Lib/site-packages/idna-3.20.dist-info/entry_points.txt +3 -0
  808. package/runtime/Lib/site-packages/idna-3.20.dist-info/licenses/LICENSE.md +31 -0
  809. package/runtime/Lib/site-packages/isapi/PyISAPI_loader.dll +0 -0
  810. package/runtime/Lib/site-packages/isapi/README.txt +7 -0
  811. package/runtime/Lib/site-packages/isapi/__init__.py +39 -0
  812. package/runtime/Lib/site-packages/isapi/doc/isapi.html +92 -0
  813. package/runtime/Lib/site-packages/isapi/install.py +809 -0
  814. package/runtime/Lib/site-packages/isapi/isapicon.py +121 -0
  815. package/runtime/Lib/site-packages/isapi/samples/README.txt +20 -0
  816. package/runtime/Lib/site-packages/isapi/samples/advanced.py +218 -0
  817. package/runtime/Lib/site-packages/isapi/samples/redirector.py +116 -0
  818. package/runtime/Lib/site-packages/isapi/samples/redirector_asynch.py +85 -0
  819. package/runtime/Lib/site-packages/isapi/samples/redirector_with_filter.py +162 -0
  820. package/runtime/Lib/site-packages/isapi/samples/test.py +195 -0
  821. package/runtime/Lib/site-packages/isapi/simple.py +73 -0
  822. package/runtime/Lib/site-packages/isapi/test/README.txt +3 -0
  823. package/runtime/Lib/site-packages/isapi/test/extension_simple.py +114 -0
  824. package/runtime/Lib/site-packages/isapi/threaded_extension.py +193 -0
  825. package/runtime/Lib/site-packages/jsonschema/__init__.py +120 -0
  826. package/runtime/Lib/site-packages/jsonschema/__main__.py +6 -0
  827. package/runtime/Lib/site-packages/jsonschema/_format.py +546 -0
  828. package/runtime/Lib/site-packages/jsonschema/_keywords.py +449 -0
  829. package/runtime/Lib/site-packages/jsonschema/_legacy_keywords.py +449 -0
  830. package/runtime/Lib/site-packages/jsonschema/_types.py +204 -0
  831. package/runtime/Lib/site-packages/jsonschema/_typing.py +29 -0
  832. package/runtime/Lib/site-packages/jsonschema/_utils.py +355 -0
  833. package/runtime/Lib/site-packages/jsonschema/benchmarks/__init__.py +5 -0
  834. package/runtime/Lib/site-packages/jsonschema/benchmarks/const_vs_enum.py +30 -0
  835. package/runtime/Lib/site-packages/jsonschema/benchmarks/contains.py +28 -0
  836. package/runtime/Lib/site-packages/jsonschema/benchmarks/import_benchmark.py +31 -0
  837. package/runtime/Lib/site-packages/jsonschema/benchmarks/issue232/issue.json +2653 -0
  838. package/runtime/Lib/site-packages/jsonschema/benchmarks/issue232.py +25 -0
  839. package/runtime/Lib/site-packages/jsonschema/benchmarks/json_schema_test_suite.py +12 -0
  840. package/runtime/Lib/site-packages/jsonschema/benchmarks/nested_schemas.py +56 -0
  841. package/runtime/Lib/site-packages/jsonschema/benchmarks/subcomponents.py +42 -0
  842. package/runtime/Lib/site-packages/jsonschema/benchmarks/unused_registry.py +35 -0
  843. package/runtime/Lib/site-packages/jsonschema/benchmarks/useless_applicator_schemas.py +106 -0
  844. package/runtime/Lib/site-packages/jsonschema/benchmarks/useless_keywords.py +32 -0
  845. package/runtime/Lib/site-packages/jsonschema/benchmarks/validator_creation.py +14 -0
  846. package/runtime/Lib/site-packages/jsonschema/cli.py +292 -0
  847. package/runtime/Lib/site-packages/jsonschema/exceptions.py +490 -0
  848. package/runtime/Lib/site-packages/jsonschema/protocols.py +230 -0
  849. package/runtime/Lib/site-packages/jsonschema/tests/__init__.py +0 -0
  850. package/runtime/Lib/site-packages/jsonschema/tests/_suite.py +285 -0
  851. package/runtime/Lib/site-packages/jsonschema/tests/fuzz_validate.py +50 -0
  852. package/runtime/Lib/site-packages/jsonschema/tests/test_cli.py +904 -0
  853. package/runtime/Lib/site-packages/jsonschema/tests/test_deprecations.py +432 -0
  854. package/runtime/Lib/site-packages/jsonschema/tests/test_exceptions.py +759 -0
  855. package/runtime/Lib/site-packages/jsonschema/tests/test_format.py +91 -0
  856. package/runtime/Lib/site-packages/jsonschema/tests/test_jsonschema_test_suite.py +262 -0
  857. package/runtime/Lib/site-packages/jsonschema/tests/test_types.py +221 -0
  858. package/runtime/Lib/site-packages/jsonschema/tests/test_utils.py +138 -0
  859. package/runtime/Lib/site-packages/jsonschema/tests/test_validators.py +2573 -0
  860. package/runtime/Lib/site-packages/jsonschema/tests/typing/__init__.py +0 -0
  861. package/runtime/Lib/site-packages/jsonschema/tests/typing/test_all_concrete_validators_match_protocol.py +38 -0
  862. package/runtime/Lib/site-packages/jsonschema/validators.py +1410 -0
  863. package/runtime/Lib/site-packages/jsonschema-4.26.0.dist-info/METADATA +170 -0
  864. package/runtime/Lib/site-packages/jsonschema-4.26.0.dist-info/RECORD +43 -0
  865. package/runtime/Lib/site-packages/jsonschema-4.26.0.dist-info/WHEEL +4 -0
  866. package/runtime/Lib/site-packages/jsonschema-4.26.0.dist-info/entry_points.txt +2 -0
  867. package/runtime/Lib/site-packages/jsonschema-4.26.0.dist-info/licenses/COPYING +19 -0
  868. package/runtime/Lib/site-packages/jsonschema_specifications/__init__.py +12 -0
  869. package/runtime/Lib/site-packages/jsonschema_specifications/_core.py +38 -0
  870. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft201909/metaschema.json +42 -0
  871. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/applicator +56 -0
  872. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/content +17 -0
  873. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/core +57 -0
  874. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/format +14 -0
  875. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/meta-data +37 -0
  876. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft201909/vocabularies/validation +98 -0
  877. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft202012/metaschema.json +58 -0
  878. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/applicator +48 -0
  879. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/content +17 -0
  880. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/core +51 -0
  881. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/format-annotation +14 -0
  882. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/format-assertion +14 -0
  883. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/meta-data +37 -0
  884. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/unevaluated +15 -0
  885. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft202012/vocabularies/validation +98 -0
  886. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft3/metaschema.json +172 -0
  887. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft4/metaschema.json +149 -0
  888. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft6/metaschema.json +153 -0
  889. package/runtime/Lib/site-packages/jsonschema_specifications/schemas/draft7/metaschema.json +166 -0
  890. package/runtime/Lib/site-packages/jsonschema_specifications/tests/__init__.py +0 -0
  891. package/runtime/Lib/site-packages/jsonschema_specifications/tests/test_jsonschema_specifications.py +41 -0
  892. package/runtime/Lib/site-packages/jsonschema_specifications-2025.9.1.dist-info/METADATA +54 -0
  893. package/runtime/Lib/site-packages/jsonschema_specifications-2025.9.1.dist-info/RECORD +28 -0
  894. package/runtime/Lib/site-packages/jsonschema_specifications-2025.9.1.dist-info/WHEEL +4 -0
  895. package/runtime/Lib/site-packages/jsonschema_specifications-2025.9.1.dist-info/licenses/COPYING +19 -0
  896. package/runtime/Lib/site-packages/jwt/__init__.py +78 -0
  897. package/runtime/Lib/site-packages/jwt/algorithms.py +1121 -0
  898. package/runtime/Lib/site-packages/jwt/api_jwk.py +196 -0
  899. package/runtime/Lib/site-packages/jwt/api_jws.py +485 -0
  900. package/runtime/Lib/site-packages/jwt/api_jwt.py +595 -0
  901. package/runtime/Lib/site-packages/jwt/exceptions.py +113 -0
  902. package/runtime/Lib/site-packages/jwt/help.py +66 -0
  903. package/runtime/Lib/site-packages/jwt/jwk_set_cache.py +47 -0
  904. package/runtime/Lib/site-packages/jwt/jwks_client.py +333 -0
  905. package/runtime/Lib/site-packages/jwt/py.typed +0 -0
  906. package/runtime/Lib/site-packages/jwt/types.py +69 -0
  907. package/runtime/Lib/site-packages/jwt/utils.py +146 -0
  908. package/runtime/Lib/site-packages/jwt/warnings.py +11 -0
  909. package/runtime/Lib/site-packages/mcp/__init__.py +145 -0
  910. package/runtime/Lib/site-packages/mcp/cli/__init__.py +6 -0
  911. package/runtime/Lib/site-packages/mcp/cli/claude.py +170 -0
  912. package/runtime/Lib/site-packages/mcp/cli/cli.py +486 -0
  913. package/runtime/Lib/site-packages/mcp/client/__init__.py +44 -0
  914. package/runtime/Lib/site-packages/mcp/client/__main__.py +81 -0
  915. package/runtime/Lib/site-packages/mcp/client/_input_required.py +127 -0
  916. package/runtime/Lib/site-packages/mcp/client/_memory.py +109 -0
  917. package/runtime/Lib/site-packages/mcp/client/_probe.py +114 -0
  918. package/runtime/Lib/site-packages/mcp/client/_transport.py +21 -0
  919. package/runtime/Lib/site-packages/mcp/client/auth/__init__.py +22 -0
  920. package/runtime/Lib/site-packages/mcp/client/auth/exceptions.py +10 -0
  921. package/runtime/Lib/site-packages/mcp/client/auth/extensions/__init__.py +0 -0
  922. package/runtime/Lib/site-packages/mcp/client/auth/extensions/client_credentials.py +416 -0
  923. package/runtime/Lib/site-packages/mcp/client/auth/extensions/identity_assertion.py +216 -0
  924. package/runtime/Lib/site-packages/mcp/client/auth/oauth2.py +793 -0
  925. package/runtime/Lib/site-packages/mcp/client/auth/utils.py +442 -0
  926. package/runtime/Lib/site-packages/mcp/client/caching.py +387 -0
  927. package/runtime/Lib/site-packages/mcp/client/client.py +985 -0
  928. package/runtime/Lib/site-packages/mcp/client/context.py +5 -0
  929. package/runtime/Lib/site-packages/mcp/client/extension.py +196 -0
  930. package/runtime/Lib/site-packages/mcp/client/session.py +1506 -0
  931. package/runtime/Lib/site-packages/mcp/client/session_group.py +453 -0
  932. package/runtime/Lib/site-packages/mcp/client/sse.py +171 -0
  933. package/runtime/Lib/site-packages/mcp/client/stdio.py +355 -0
  934. package/runtime/Lib/site-packages/mcp/client/streamable_http.py +793 -0
  935. package/runtime/Lib/site-packages/mcp/client/subscriptions.py +282 -0
  936. package/runtime/Lib/site-packages/mcp/os/__init__.py +1 -0
  937. package/runtime/Lib/site-packages/mcp/os/posix/__init__.py +1 -0
  938. package/runtime/Lib/site-packages/mcp/os/posix/utilities.py +63 -0
  939. package/runtime/Lib/site-packages/mcp/os/win32/__init__.py +1 -0
  940. package/runtime/Lib/site-packages/mcp/os/win32/utilities.py +292 -0
  941. package/runtime/Lib/site-packages/mcp/py.typed +0 -0
  942. package/runtime/Lib/site-packages/mcp/server/__init__.py +7 -0
  943. package/runtime/Lib/site-packages/mcp/server/__main__.py +24 -0
  944. package/runtime/Lib/site-packages/mcp/server/_otel.py +72 -0
  945. package/runtime/Lib/site-packages/mcp/server/_streamable_http_modern.py +526 -0
  946. package/runtime/Lib/site-packages/mcp/server/apps.py +241 -0
  947. package/runtime/Lib/site-packages/mcp/server/auth/__init__.py +1 -0
  948. package/runtime/Lib/site-packages/mcp/server/auth/errors.py +5 -0
  949. package/runtime/Lib/site-packages/mcp/server/auth/handlers/__init__.py +1 -0
  950. package/runtime/Lib/site-packages/mcp/server/auth/handlers/authorize.py +221 -0
  951. package/runtime/Lib/site-packages/mcp/server/auth/handlers/metadata.py +29 -0
  952. package/runtime/Lib/site-packages/mcp/server/auth/handlers/register.py +154 -0
  953. package/runtime/Lib/site-packages/mcp/server/auth/handlers/revoke.py +87 -0
  954. package/runtime/Lib/site-packages/mcp/server/auth/handlers/token.py +275 -0
  955. package/runtime/Lib/site-packages/mcp/server/auth/json_response.py +10 -0
  956. package/runtime/Lib/site-packages/mcp/server/auth/middleware/__init__.py +1 -0
  957. package/runtime/Lib/site-packages/mcp/server/auth/middleware/auth_context.py +46 -0
  958. package/runtime/Lib/site-packages/mcp/server/auth/middleware/bearer_auth.py +165 -0
  959. package/runtime/Lib/site-packages/mcp/server/auth/middleware/client_auth.py +119 -0
  960. package/runtime/Lib/site-packages/mcp/server/auth/provider.py +380 -0
  961. package/runtime/Lib/site-packages/mcp/server/auth/routes.py +261 -0
  962. package/runtime/Lib/site-packages/mcp/server/auth/settings.py +70 -0
  963. package/runtime/Lib/site-packages/mcp/server/caching.py +85 -0
  964. package/runtime/Lib/site-packages/mcp/server/connection.py +493 -0
  965. package/runtime/Lib/site-packages/mcp/server/context.py +194 -0
  966. package/runtime/Lib/site-packages/mcp/server/elicitation.py +191 -0
  967. package/runtime/Lib/site-packages/mcp/server/extension.py +185 -0
  968. package/runtime/Lib/site-packages/mcp/server/fastmcp.py +16 -0
  969. package/runtime/Lib/site-packages/mcp/server/lowlevel/__init__.py +3 -0
  970. package/runtime/Lib/site-packages/mcp/server/lowlevel/helper_types.py +11 -0
  971. package/runtime/Lib/site-packages/mcp/server/lowlevel/server.py +852 -0
  972. package/runtime/Lib/site-packages/mcp/server/mcpserver/__init__.py +61 -0
  973. package/runtime/Lib/site-packages/mcp/server/mcpserver/context.py +391 -0
  974. package/runtime/Lib/site-packages/mcp/server/mcpserver/exceptions.py +76 -0
  975. package/runtime/Lib/site-packages/mcp/server/mcpserver/prompts/__init__.py +4 -0
  976. package/runtime/Lib/site-packages/mcp/server/mcpserver/prompts/base.py +213 -0
  977. package/runtime/Lib/site-packages/mcp/server/mcpserver/prompts/manager.py +67 -0
  978. package/runtime/Lib/site-packages/mcp/server/mcpserver/resolve.py +846 -0
  979. package/runtime/Lib/site-packages/mcp/server/mcpserver/resources/__init__.py +26 -0
  980. package/runtime/Lib/site-packages/mcp/server/mcpserver/resources/base.py +43 -0
  981. package/runtime/Lib/site-packages/mcp/server/mcpserver/resources/resource_manager.py +137 -0
  982. package/runtime/Lib/site-packages/mcp/server/mcpserver/resources/templates.py +248 -0
  983. package/runtime/Lib/site-packages/mcp/server/mcpserver/resources/types.py +230 -0
  984. package/runtime/Lib/site-packages/mcp/server/mcpserver/server.py +1418 -0
  985. package/runtime/Lib/site-packages/mcp/server/mcpserver/tools/__init__.py +4 -0
  986. package/runtime/Lib/site-packages/mcp/server/mcpserver/tools/base.py +213 -0
  987. package/runtime/Lib/site-packages/mcp/server/mcpserver/tools/tool_manager.py +87 -0
  988. package/runtime/Lib/site-packages/mcp/server/mcpserver/utilities/__init__.py +1 -0
  989. package/runtime/Lib/site-packages/mcp/server/mcpserver/utilities/context_injection.py +68 -0
  990. package/runtime/Lib/site-packages/mcp/server/mcpserver/utilities/func_metadata.py +655 -0
  991. package/runtime/Lib/site-packages/mcp/server/mcpserver/utilities/logging.py +39 -0
  992. package/runtime/Lib/site-packages/mcp/server/mcpserver/utilities/types.py +101 -0
  993. package/runtime/Lib/site-packages/mcp/server/models.py +17 -0
  994. package/runtime/Lib/site-packages/mcp/server/request_state.py +454 -0
  995. package/runtime/Lib/site-packages/mcp/server/runner.py +872 -0
  996. package/runtime/Lib/site-packages/mcp/server/session.py +489 -0
  997. package/runtime/Lib/site-packages/mcp/server/sse.py +287 -0
  998. package/runtime/Lib/site-packages/mcp/server/stdio.py +217 -0
  999. package/runtime/Lib/site-packages/mcp/server/streamable_http.py +1135 -0
  1000. package/runtime/Lib/site-packages/mcp/server/streamable_http_manager.py +427 -0
  1001. package/runtime/Lib/site-packages/mcp/server/subscriptions.py +254 -0
  1002. package/runtime/Lib/site-packages/mcp/server/transport_security.py +183 -0
  1003. package/runtime/Lib/site-packages/mcp/server/validation.py +93 -0
  1004. package/runtime/Lib/site-packages/mcp/shared/__init__.py +0 -0
  1005. package/runtime/Lib/site-packages/mcp/shared/_callable_inspection.py +33 -0
  1006. package/runtime/Lib/site-packages/mcp/shared/_compat.py +19 -0
  1007. package/runtime/Lib/site-packages/mcp/shared/_context_streams.py +119 -0
  1008. package/runtime/Lib/site-packages/mcp/shared/_httpx_utils.py +222 -0
  1009. package/runtime/Lib/site-packages/mcp/shared/_otel.py +60 -0
  1010. package/runtime/Lib/site-packages/mcp/shared/_request_clock.py +81 -0
  1011. package/runtime/Lib/site-packages/mcp/shared/_stream_protocols.py +49 -0
  1012. package/runtime/Lib/site-packages/mcp/shared/auth.py +258 -0
  1013. package/runtime/Lib/site-packages/mcp/shared/auth_utils.py +80 -0
  1014. package/runtime/Lib/site-packages/mcp/shared/context.py +85 -0
  1015. package/runtime/Lib/site-packages/mcp/shared/direct_dispatcher.py +337 -0
  1016. package/runtime/Lib/site-packages/mcp/shared/dispatcher.py +283 -0
  1017. package/runtime/Lib/site-packages/mcp/shared/exceptions.py +119 -0
  1018. package/runtime/Lib/site-packages/mcp/shared/extension.py +28 -0
  1019. package/runtime/Lib/site-packages/mcp/shared/inbound.py +595 -0
  1020. package/runtime/Lib/site-packages/mcp/shared/jsonrpc_dispatcher.py +856 -0
  1021. package/runtime/Lib/site-packages/mcp/shared/memory.py +33 -0
  1022. package/runtime/Lib/site-packages/mcp/shared/message.py +63 -0
  1023. package/runtime/Lib/site-packages/mcp/shared/metadata_utils.py +46 -0
  1024. package/runtime/Lib/site-packages/mcp/shared/path_security.py +176 -0
  1025. package/runtime/Lib/site-packages/mcp/shared/peer.py +240 -0
  1026. package/runtime/Lib/site-packages/mcp/shared/subscriptions.py +111 -0
  1027. package/runtime/Lib/site-packages/mcp/shared/tool_name_validation.py +129 -0
  1028. package/runtime/Lib/site-packages/mcp/shared/transport_context.py +45 -0
  1029. package/runtime/Lib/site-packages/mcp/shared/uri_template.py +1116 -0
  1030. package/runtime/Lib/site-packages/mcp/types/__init__.py +31 -0
  1031. package/runtime/Lib/site-packages/mcp/types/jsonrpc.py +13 -0
  1032. package/runtime/Lib/site-packages/mcp/types/methods.py +13 -0
  1033. package/runtime/Lib/site-packages/mcp/types/version.py +13 -0
  1034. package/runtime/Lib/site-packages/mcp-2.3.0.dist-info/METADATA +172 -0
  1035. package/runtime/Lib/site-packages/mcp-2.3.0.dist-info/RECORD +130 -0
  1036. package/runtime/Lib/site-packages/mcp-2.3.0.dist-info/WHEEL +4 -0
  1037. package/runtime/Lib/site-packages/mcp-2.3.0.dist-info/entry_points.txt +2 -0
  1038. package/runtime/Lib/site-packages/mcp-2.3.0.dist-info/licenses/LICENSE +21 -0
  1039. package/runtime/Lib/site-packages/mcp_types/__init__.py +453 -0
  1040. package/runtime/Lib/site-packages/mcp_types/_types.py +2198 -0
  1041. package/runtime/Lib/site-packages/mcp_types/_v2025_11_25/__init__.py +3391 -0
  1042. package/runtime/Lib/site-packages/mcp_types/_v2026_07_28/__init__.py +3617 -0
  1043. package/runtime/Lib/site-packages/mcp_types/_wire_base.py +9 -0
  1044. package/runtime/Lib/site-packages/mcp_types/jsonrpc.py +148 -0
  1045. package/runtime/Lib/site-packages/mcp_types/methods.py +746 -0
  1046. package/runtime/Lib/site-packages/mcp_types/py.typed +0 -0
  1047. package/runtime/Lib/site-packages/mcp_types/version.py +74 -0
  1048. package/runtime/Lib/site-packages/mcp_types-2.3.0.dist-info/METADATA +43 -0
  1049. package/runtime/Lib/site-packages/mcp_types-2.3.0.dist-info/RECORD +13 -0
  1050. package/runtime/Lib/site-packages/mcp_types-2.3.0.dist-info/WHEEL +4 -0
  1051. package/runtime/Lib/site-packages/mcp_types-2.3.0.dist-info/licenses/LICENSE +21 -0
  1052. package/runtime/Lib/site-packages/multipart/__init__.py +38 -0
  1053. package/runtime/Lib/site-packages/multipart/decoders.py +1 -0
  1054. package/runtime/Lib/site-packages/multipart/exceptions.py +1 -0
  1055. package/runtime/Lib/site-packages/multipart/multipart.py +1 -0
  1056. package/runtime/Lib/site-packages/opentelemetry/_logs/__init__.py +47 -0
  1057. package/runtime/Lib/site-packages/opentelemetry/_logs/_internal/__init__.py +484 -0
  1058. package/runtime/Lib/site-packages/opentelemetry/_logs/py.typed +0 -0
  1059. package/runtime/Lib/site-packages/opentelemetry/_logs/severity/__init__.py +44 -0
  1060. package/runtime/Lib/site-packages/opentelemetry/attributes/__init__.py +243 -0
  1061. package/runtime/Lib/site-packages/opentelemetry/attributes/py.typed +0 -0
  1062. package/runtime/Lib/site-packages/opentelemetry/baggage/__init__.py +122 -0
  1063. package/runtime/Lib/site-packages/opentelemetry/baggage/propagation/__init__.py +179 -0
  1064. package/runtime/Lib/site-packages/opentelemetry/baggage/py.typed +0 -0
  1065. package/runtime/Lib/site-packages/opentelemetry/context/__init__.py +147 -0
  1066. package/runtime/Lib/site-packages/opentelemetry/context/context.py +65 -0
  1067. package/runtime/Lib/site-packages/opentelemetry/context/contextvars_context.py +43 -0
  1068. package/runtime/Lib/site-packages/opentelemetry/context/py.typed +0 -0
  1069. package/runtime/Lib/site-packages/opentelemetry/environment_variables/__init__.py +72 -0
  1070. package/runtime/Lib/site-packages/opentelemetry/environment_variables/py.typed +0 -0
  1071. package/runtime/Lib/site-packages/opentelemetry/metrics/__init__.py +121 -0
  1072. package/runtime/Lib/site-packages/opentelemetry/metrics/_internal/__init__.py +892 -0
  1073. package/runtime/Lib/site-packages/opentelemetry/metrics/_internal/instrument.py +540 -0
  1074. package/runtime/Lib/site-packages/opentelemetry/metrics/_internal/observation.py +51 -0
  1075. package/runtime/Lib/site-packages/opentelemetry/metrics/py.typed +0 -0
  1076. package/runtime/Lib/site-packages/opentelemetry/propagate/__init__.py +171 -0
  1077. package/runtime/Lib/site-packages/opentelemetry/propagate/py.typed +0 -0
  1078. package/runtime/Lib/site-packages/opentelemetry/propagators/_envcarrier.py +94 -0
  1079. package/runtime/Lib/site-packages/opentelemetry/propagators/composite.py +78 -0
  1080. package/runtime/Lib/site-packages/opentelemetry/propagators/py.typed +0 -0
  1081. package/runtime/Lib/site-packages/opentelemetry/propagators/textmap.py +181 -0
  1082. package/runtime/Lib/site-packages/opentelemetry/py.typed +0 -0
  1083. package/runtime/Lib/site-packages/opentelemetry/trace/__init__.py +661 -0
  1084. package/runtime/Lib/site-packages/opentelemetry/trace/propagation/__init__.py +37 -0
  1085. package/runtime/Lib/site-packages/opentelemetry/trace/propagation/tracecontext.py +126 -0
  1086. package/runtime/Lib/site-packages/opentelemetry/trace/py.typed +0 -0
  1087. package/runtime/Lib/site-packages/opentelemetry/trace/span.py +616 -0
  1088. package/runtime/Lib/site-packages/opentelemetry/trace/status.py +68 -0
  1089. package/runtime/Lib/site-packages/opentelemetry/util/_decorator.py +75 -0
  1090. package/runtime/Lib/site-packages/opentelemetry/util/_importlib_metadata.py +61 -0
  1091. package/runtime/Lib/site-packages/opentelemetry/util/_once.py +36 -0
  1092. package/runtime/Lib/site-packages/opentelemetry/util/_providers.py +42 -0
  1093. package/runtime/Lib/site-packages/opentelemetry/util/py.typed +0 -0
  1094. package/runtime/Lib/site-packages/opentelemetry/util/re.py +93 -0
  1095. package/runtime/Lib/site-packages/opentelemetry/util/types.py +28 -0
  1096. package/runtime/Lib/site-packages/opentelemetry/version/__init__.py +4 -0
  1097. package/runtime/Lib/site-packages/opentelemetry/version/py.typed +0 -0
  1098. package/runtime/Lib/site-packages/opentelemetry_api-1.45.2.dist-info/METADATA +43 -0
  1099. package/runtime/Lib/site-packages/opentelemetry_api-1.45.2.dist-info/RECORD +47 -0
  1100. package/runtime/Lib/site-packages/opentelemetry_api-1.45.2.dist-info/WHEEL +4 -0
  1101. package/runtime/Lib/site-packages/opentelemetry_api-1.45.2.dist-info/entry_points.txt +15 -0
  1102. package/runtime/Lib/site-packages/opentelemetry_api-1.45.2.dist-info/licenses/LICENSE +201 -0
  1103. package/runtime/Lib/site-packages/pycparser/__init__.py +98 -0
  1104. package/runtime/Lib/site-packages/pycparser/_ast_gen.py +385 -0
  1105. package/runtime/Lib/site-packages/pycparser/_c_ast.cfg +268 -0
  1106. package/runtime/Lib/site-packages/pycparser/ast_transforms.py +201 -0
  1107. package/runtime/Lib/site-packages/pycparser/c_ast.py +1670 -0
  1108. package/runtime/Lib/site-packages/pycparser/c_generator.py +866 -0
  1109. package/runtime/Lib/site-packages/pycparser/c_lexer.py +861 -0
  1110. package/runtime/Lib/site-packages/pycparser/c_parser.py +2759 -0
  1111. package/runtime/Lib/site-packages/pycparser-3.12.dist-info/METADATA +286 -0
  1112. package/runtime/Lib/site-packages/pycparser-3.12.dist-info/RECORD +13 -0
  1113. package/runtime/Lib/site-packages/pycparser-3.12.dist-info/WHEEL +5 -0
  1114. package/runtime/Lib/site-packages/pycparser-3.12.dist-info/licenses/LICENSE +27 -0
  1115. package/runtime/Lib/site-packages/pycparser-3.12.dist-info/top_level.txt +1 -0
  1116. package/runtime/Lib/site-packages/pydantic/__init__.py +461 -0
  1117. package/runtime/Lib/site-packages/pydantic/_internal/__init__.py +0 -0
  1118. package/runtime/Lib/site-packages/pydantic/_internal/_config.py +408 -0
  1119. package/runtime/Lib/site-packages/pydantic/_internal/_core_metadata.py +97 -0
  1120. package/runtime/Lib/site-packages/pydantic/_internal/_core_utils.py +156 -0
  1121. package/runtime/Lib/site-packages/pydantic/_internal/_dataclasses.py +327 -0
  1122. package/runtime/Lib/site-packages/pydantic/_internal/_decorators.py +906 -0
  1123. package/runtime/Lib/site-packages/pydantic/_internal/_decorators_v1.py +174 -0
  1124. package/runtime/Lib/site-packages/pydantic/_internal/_discriminated_union.py +510 -0
  1125. package/runtime/Lib/site-packages/pydantic/_internal/_docs_extraction.py +128 -0
  1126. package/runtime/Lib/site-packages/pydantic/_internal/_fields.py +910 -0
  1127. package/runtime/Lib/site-packages/pydantic/_internal/_forward_ref.py +23 -0
  1128. package/runtime/Lib/site-packages/pydantic/_internal/_generate_schema.py +2984 -0
  1129. package/runtime/Lib/site-packages/pydantic/_internal/_generics.py +556 -0
  1130. package/runtime/Lib/site-packages/pydantic/_internal/_git.py +27 -0
  1131. package/runtime/Lib/site-packages/pydantic/_internal/_import_utils.py +20 -0
  1132. package/runtime/Lib/site-packages/pydantic/_internal/_known_annotated_metadata.py +405 -0
  1133. package/runtime/Lib/site-packages/pydantic/_internal/_mock_val_ser.py +237 -0
  1134. package/runtime/Lib/site-packages/pydantic/_internal/_model_construction.py +833 -0
  1135. package/runtime/Lib/site-packages/pydantic/_internal/_namespace_utils.py +299 -0
  1136. package/runtime/Lib/site-packages/pydantic/_internal/_repr.py +122 -0
  1137. package/runtime/Lib/site-packages/pydantic/_internal/_schema_gather.py +49 -0
  1138. package/runtime/Lib/site-packages/pydantic/_internal/_schema_generation_shared.py +126 -0
  1139. package/runtime/Lib/site-packages/pydantic/_internal/_serializers.py +59 -0
  1140. package/runtime/Lib/site-packages/pydantic/_internal/_signature.py +193 -0
  1141. package/runtime/Lib/site-packages/pydantic/_internal/_type_refs.py +128 -0
  1142. package/runtime/Lib/site-packages/pydantic/_internal/_typing_extra.py +502 -0
  1143. package/runtime/Lib/site-packages/pydantic/_internal/_utils.py +433 -0
  1144. package/runtime/Lib/site-packages/pydantic/_internal/_validate_call.py +141 -0
  1145. package/runtime/Lib/site-packages/pydantic/_internal/_validators.py +541 -0
  1146. package/runtime/Lib/site-packages/pydantic/_migration.py +317 -0
  1147. package/runtime/Lib/site-packages/pydantic/alias_generators.py +62 -0
  1148. package/runtime/Lib/site-packages/pydantic/aliases.py +136 -0
  1149. package/runtime/Lib/site-packages/pydantic/annotated_handlers.py +123 -0
  1150. package/runtime/Lib/site-packages/pydantic/class_validators.py +5 -0
  1151. package/runtime/Lib/site-packages/pydantic/color.py +605 -0
  1152. package/runtime/Lib/site-packages/pydantic/config.py +1295 -0
  1153. package/runtime/Lib/site-packages/pydantic/dataclasses.py +385 -0
  1154. package/runtime/Lib/site-packages/pydantic/datetime_parse.py +5 -0
  1155. package/runtime/Lib/site-packages/pydantic/decorator.py +5 -0
  1156. package/runtime/Lib/site-packages/pydantic/deprecated/__init__.py +0 -0
  1157. package/runtime/Lib/site-packages/pydantic/deprecated/class_validators.py +257 -0
  1158. package/runtime/Lib/site-packages/pydantic/deprecated/config.py +72 -0
  1159. package/runtime/Lib/site-packages/pydantic/deprecated/copy_internals.py +224 -0
  1160. package/runtime/Lib/site-packages/pydantic/deprecated/decorator.py +286 -0
  1161. package/runtime/Lib/site-packages/pydantic/deprecated/json.py +142 -0
  1162. package/runtime/Lib/site-packages/pydantic/deprecated/parse.py +81 -0
  1163. package/runtime/Lib/site-packages/pydantic/deprecated/tools.py +104 -0
  1164. package/runtime/Lib/site-packages/pydantic/env_settings.py +5 -0
  1165. package/runtime/Lib/site-packages/pydantic/error_wrappers.py +5 -0
  1166. package/runtime/Lib/site-packages/pydantic/errors.py +185 -0
  1167. package/runtime/Lib/site-packages/pydantic/experimental/__init__.py +1 -0
  1168. package/runtime/Lib/site-packages/pydantic/experimental/arguments_schema.py +44 -0
  1169. package/runtime/Lib/site-packages/pydantic/experimental/missing_sentinel.py +29 -0
  1170. package/runtime/Lib/site-packages/pydantic/experimental/pipeline.py +684 -0
  1171. package/runtime/Lib/site-packages/pydantic/fields.py +2065 -0
  1172. package/runtime/Lib/site-packages/pydantic/functional_serializers.py +461 -0
  1173. package/runtime/Lib/site-packages/pydantic/functional_validators.py +920 -0
  1174. package/runtime/Lib/site-packages/pydantic/generics.py +5 -0
  1175. package/runtime/Lib/site-packages/pydantic/json.py +5 -0
  1176. package/runtime/Lib/site-packages/pydantic/json_schema.py +3261 -0
  1177. package/runtime/Lib/site-packages/pydantic/main.py +1947 -0
  1178. package/runtime/Lib/site-packages/pydantic/mypy.py +1469 -0
  1179. package/runtime/Lib/site-packages/pydantic/networks.py +1417 -0
  1180. package/runtime/Lib/site-packages/pydantic/parse.py +5 -0
  1181. package/runtime/Lib/site-packages/pydantic/plugin/__init__.py +190 -0
  1182. package/runtime/Lib/site-packages/pydantic/plugin/_loader.py +58 -0
  1183. package/runtime/Lib/site-packages/pydantic/plugin/_schema_validator.py +152 -0
  1184. package/runtime/Lib/site-packages/pydantic/py.typed +0 -0
  1185. package/runtime/Lib/site-packages/pydantic/root_model.py +189 -0
  1186. package/runtime/Lib/site-packages/pydantic/schema.py +5 -0
  1187. package/runtime/Lib/site-packages/pydantic/tools.py +5 -0
  1188. package/runtime/Lib/site-packages/pydantic/type_adapter.py +780 -0
  1189. package/runtime/Lib/site-packages/pydantic/types.py +3405 -0
  1190. package/runtime/Lib/site-packages/pydantic/typing.py +5 -0
  1191. package/runtime/Lib/site-packages/pydantic/utils.py +5 -0
  1192. package/runtime/Lib/site-packages/pydantic/v1/__init__.py +131 -0
  1193. package/runtime/Lib/site-packages/pydantic/v1/_hypothesis_plugin.py +391 -0
  1194. package/runtime/Lib/site-packages/pydantic/v1/annotated_types.py +72 -0
  1195. package/runtime/Lib/site-packages/pydantic/v1/class_validators.py +361 -0
  1196. package/runtime/Lib/site-packages/pydantic/v1/color.py +494 -0
  1197. package/runtime/Lib/site-packages/pydantic/v1/config.py +191 -0
  1198. package/runtime/Lib/site-packages/pydantic/v1/dataclasses.py +503 -0
  1199. package/runtime/Lib/site-packages/pydantic/v1/datetime_parse.py +248 -0
  1200. package/runtime/Lib/site-packages/pydantic/v1/decorator.py +264 -0
  1201. package/runtime/Lib/site-packages/pydantic/v1/env_settings.py +350 -0
  1202. package/runtime/Lib/site-packages/pydantic/v1/error_wrappers.py +161 -0
  1203. package/runtime/Lib/site-packages/pydantic/v1/errors.py +646 -0
  1204. package/runtime/Lib/site-packages/pydantic/v1/fields.py +1253 -0
  1205. package/runtime/Lib/site-packages/pydantic/v1/generics.py +400 -0
  1206. package/runtime/Lib/site-packages/pydantic/v1/json.py +112 -0
  1207. package/runtime/Lib/site-packages/pydantic/v1/main.py +1130 -0
  1208. package/runtime/Lib/site-packages/pydantic/v1/mypy.py +950 -0
  1209. package/runtime/Lib/site-packages/pydantic/v1/networks.py +747 -0
  1210. package/runtime/Lib/site-packages/pydantic/v1/parse.py +66 -0
  1211. package/runtime/Lib/site-packages/pydantic/v1/py.typed +0 -0
  1212. package/runtime/Lib/site-packages/pydantic/v1/schema.py +1163 -0
  1213. package/runtime/Lib/site-packages/pydantic/v1/tools.py +92 -0
  1214. package/runtime/Lib/site-packages/pydantic/v1/types.py +1213 -0
  1215. package/runtime/Lib/site-packages/pydantic/v1/typing.py +627 -0
  1216. package/runtime/Lib/site-packages/pydantic/v1/utils.py +807 -0
  1217. package/runtime/Lib/site-packages/pydantic/v1/validators.py +768 -0
  1218. package/runtime/Lib/site-packages/pydantic/v1/version.py +38 -0
  1219. package/runtime/Lib/site-packages/pydantic/validate_call_decorator.py +121 -0
  1220. package/runtime/Lib/site-packages/pydantic/validators.py +5 -0
  1221. package/runtime/Lib/site-packages/pydantic/version.py +113 -0
  1222. package/runtime/Lib/site-packages/pydantic/warnings.py +130 -0
  1223. package/runtime/Lib/site-packages/pydantic-2.14.2.dist-info/METADATA +1602 -0
  1224. package/runtime/Lib/site-packages/pydantic-2.14.2.dist-info/RECORD +111 -0
  1225. package/runtime/Lib/site-packages/pydantic-2.14.2.dist-info/WHEEL +4 -0
  1226. package/runtime/Lib/site-packages/pydantic-2.14.2.dist-info/licenses/LICENSE +21 -0
  1227. package/runtime/Lib/site-packages/pydantic_core/__init__.py +193 -0
  1228. package/runtime/Lib/site-packages/pydantic_core/_pydantic_core/__init__.pyi +1118 -0
  1229. package/runtime/Lib/site-packages/pydantic_core/_pydantic_core/_schema_gather.pyi +34 -0
  1230. package/runtime/Lib/site-packages/pydantic_core/_pydantic_core.cp313-win_amd64.pyd +0 -0
  1231. package/runtime/Lib/site-packages/pydantic_core/core_schema.py +5092 -0
  1232. package/runtime/Lib/site-packages/pydantic_core/py.typed +0 -0
  1233. package/runtime/Lib/site-packages/pydantic_core-2.50.2.dist-info/METADATA +171 -0
  1234. package/runtime/Lib/site-packages/pydantic_core-2.50.2.dist-info/RECORD +11 -0
  1235. package/runtime/Lib/site-packages/pydantic_core-2.50.2.dist-info/WHEEL +4 -0
  1236. package/runtime/Lib/site-packages/pydantic_core-2.50.2.dist-info/licenses/LICENSE +21 -0
  1237. package/runtime/Lib/site-packages/pydantic_core-2.50.2.dist-info/sboms/pydantic-core.cyclonedx.json +3889 -0
  1238. package/runtime/Lib/site-packages/pyjwt-2.15.1.dist-info/METADATA +94 -0
  1239. package/runtime/Lib/site-packages/pyjwt-2.15.1.dist-info/RECORD +19 -0
  1240. package/runtime/Lib/site-packages/pyjwt-2.15.1.dist-info/WHEEL +5 -0
  1241. package/runtime/Lib/site-packages/pyjwt-2.15.1.dist-info/licenses/AUTHORS.rst +7 -0
  1242. package/runtime/Lib/site-packages/pyjwt-2.15.1.dist-info/licenses/LICENSE +21 -0
  1243. package/runtime/Lib/site-packages/pyjwt-2.15.1.dist-info/top_level.txt +1 -0
  1244. package/runtime/Lib/site-packages/python_dateutil-3.0.0.dist-info/METADATA +204 -0
  1245. package/runtime/Lib/site-packages/python_dateutil-3.0.0.dist-info/RECORD +27 -0
  1246. package/runtime/Lib/site-packages/python_dateutil-3.0.0.dist-info/WHEEL +6 -0
  1247. package/runtime/Lib/site-packages/python_dateutil-3.0.0.dist-info/licenses/LICENSE +54 -0
  1248. package/runtime/Lib/site-packages/python_dateutil-3.0.0.dist-info/top_level.txt +1 -0
  1249. package/runtime/Lib/site-packages/python_dateutil-3.0.0.dist-info/zip-safe +1 -0
  1250. package/runtime/Lib/site-packages/python_multipart/__init__.py +35 -0
  1251. package/runtime/Lib/site-packages/python_multipart/decoders.py +185 -0
  1252. package/runtime/Lib/site-packages/python_multipart/exceptions.py +34 -0
  1253. package/runtime/Lib/site-packages/python_multipart/multipart.py +1925 -0
  1254. package/runtime/Lib/site-packages/python_multipart/py.typed +0 -0
  1255. package/runtime/Lib/site-packages/python_multipart-0.0.32.dist-info/METADATA +43 -0
  1256. package/runtime/Lib/site-packages/python_multipart-0.0.32.dist-info/RECORD +13 -0
  1257. package/runtime/Lib/site-packages/python_multipart-0.0.32.dist-info/WHEEL +4 -0
  1258. package/runtime/Lib/site-packages/python_multipart-0.0.32.dist-info/licenses/LICENSE.txt +202 -0
  1259. package/runtime/Lib/site-packages/pythoncom.py +4 -0
  1260. package/runtime/Lib/site-packages/pywin32-311.dist-info/METADATA +233 -0
  1261. package/runtime/Lib/site-packages/pywin32-311.dist-info/RECORD +477 -0
  1262. package/runtime/Lib/site-packages/pywin32-311.dist-info/WHEEL +5 -0
  1263. package/runtime/Lib/site-packages/pywin32-311.dist-info/entry_points.txt +3 -0
  1264. package/runtime/Lib/site-packages/pywin32-311.dist-info/top_level.txt +93 -0
  1265. package/runtime/Lib/site-packages/pywin32.pth +7 -0
  1266. package/runtime/Lib/site-packages/pywin32.version.txt +1 -0
  1267. package/runtime/Lib/site-packages/pywin32_system32/pythoncom313.dll +0 -0
  1268. package/runtime/Lib/site-packages/pywin32_system32/pywintypes313.dll +0 -0
  1269. package/runtime/Lib/site-packages/pyyaml-6.0.3.dist-info/METADATA +59 -0
  1270. package/runtime/Lib/site-packages/pyyaml-6.0.3.dist-info/RECORD +24 -0
  1271. package/runtime/Lib/site-packages/pyyaml-6.0.3.dist-info/WHEEL +5 -0
  1272. package/runtime/Lib/site-packages/pyyaml-6.0.3.dist-info/licenses/LICENSE +20 -0
  1273. package/runtime/Lib/site-packages/pyyaml-6.0.3.dist-info/top_level.txt +2 -0
  1274. package/runtime/Lib/site-packages/referencing/__init__.py +7 -0
  1275. package/runtime/Lib/site-packages/referencing/_attrs.py +31 -0
  1276. package/runtime/Lib/site-packages/referencing/_attrs.pyi +21 -0
  1277. package/runtime/Lib/site-packages/referencing/_core.py +739 -0
  1278. package/runtime/Lib/site-packages/referencing/exceptions.py +165 -0
  1279. package/runtime/Lib/site-packages/referencing/jsonschema.py +642 -0
  1280. package/runtime/Lib/site-packages/referencing/py.typed +0 -0
  1281. package/runtime/Lib/site-packages/referencing/retrieval.py +94 -0
  1282. package/runtime/Lib/site-packages/referencing/tests/__init__.py +0 -0
  1283. package/runtime/Lib/site-packages/referencing/tests/test_core.py +1057 -0
  1284. package/runtime/Lib/site-packages/referencing/tests/test_exceptions.py +34 -0
  1285. package/runtime/Lib/site-packages/referencing/tests/test_jsonschema.py +382 -0
  1286. package/runtime/Lib/site-packages/referencing/tests/test_referencing_suite.py +66 -0
  1287. package/runtime/Lib/site-packages/referencing/tests/test_retrieval.py +106 -0
  1288. package/runtime/Lib/site-packages/referencing/typing.py +61 -0
  1289. package/runtime/Lib/site-packages/referencing-0.37.0.dist-info/METADATA +64 -0
  1290. package/runtime/Lib/site-packages/referencing-0.37.0.dist-info/RECORD +19 -0
  1291. package/runtime/Lib/site-packages/referencing-0.37.0.dist-info/WHEEL +4 -0
  1292. package/runtime/Lib/site-packages/referencing-0.37.0.dist-info/licenses/COPYING +19 -0
  1293. package/runtime/Lib/site-packages/requests/__init__.py +219 -0
  1294. package/runtime/Lib/site-packages/requests/__version__.py +14 -0
  1295. package/runtime/Lib/site-packages/requests/_internal_utils.py +51 -0
  1296. package/runtime/Lib/site-packages/requests/_types.py +183 -0
  1297. package/runtime/Lib/site-packages/requests/adapters.py +748 -0
  1298. package/runtime/Lib/site-packages/requests/api.py +180 -0
  1299. package/runtime/Lib/site-packages/requests/auth.py +354 -0
  1300. package/runtime/Lib/site-packages/requests/certs.py +18 -0
  1301. package/runtime/Lib/site-packages/requests/compat.py +113 -0
  1302. package/runtime/Lib/site-packages/requests/cookies.py +625 -0
  1303. package/runtime/Lib/site-packages/requests/exceptions.py +162 -0
  1304. package/runtime/Lib/site-packages/requests/help.py +134 -0
  1305. package/runtime/Lib/site-packages/requests/hooks.py +48 -0
  1306. package/runtime/Lib/site-packages/requests/models.py +1180 -0
  1307. package/runtime/Lib/site-packages/requests/packages.py +23 -0
  1308. package/runtime/Lib/site-packages/requests/py.typed +0 -0
  1309. package/runtime/Lib/site-packages/requests/sessions.py +920 -0
  1310. package/runtime/Lib/site-packages/requests/status_codes.py +128 -0
  1311. package/runtime/Lib/site-packages/requests/structures.py +130 -0
  1312. package/runtime/Lib/site-packages/requests/utils.py +1155 -0
  1313. package/runtime/Lib/site-packages/requests-2.34.2.dist-info/METADATA +120 -0
  1314. package/runtime/Lib/site-packages/requests-2.34.2.dist-info/RECORD +26 -0
  1315. package/runtime/Lib/site-packages/requests-2.34.2.dist-info/WHEEL +5 -0
  1316. package/runtime/Lib/site-packages/requests-2.34.2.dist-info/licenses/LICENSE +175 -0
  1317. package/runtime/Lib/site-packages/requests-2.34.2.dist-info/licenses/NOTICE +2 -0
  1318. package/runtime/Lib/site-packages/requests-2.34.2.dist-info/top_level.txt +1 -0
  1319. package/runtime/Lib/site-packages/rpds/__init__.py +5 -0
  1320. package/runtime/Lib/site-packages/rpds/__init__.pyi +79 -0
  1321. package/runtime/Lib/site-packages/rpds/py.typed +0 -0
  1322. package/runtime/Lib/site-packages/rpds/rpds.cp313-win_amd64.pyd +0 -0
  1323. package/runtime/Lib/site-packages/rpds_py-2026.9.1.dist-info/METADATA +99 -0
  1324. package/runtime/Lib/site-packages/rpds_py-2026.9.1.dist-info/RECORD +9 -0
  1325. package/runtime/Lib/site-packages/rpds_py-2026.9.1.dist-info/WHEEL +4 -0
  1326. package/runtime/Lib/site-packages/rpds_py-2026.9.1.dist-info/licenses/LICENSE +19 -0
  1327. package/runtime/Lib/site-packages/rpds_py-2026.9.1.dist-info/sboms/rpds-py.cyclonedx.json +680 -0
  1328. package/runtime/Lib/site-packages/semantic_version/__init__.py +18 -0
  1329. package/runtime/Lib/site-packages/semantic_version/base.py +1449 -0
  1330. package/runtime/Lib/site-packages/semantic_version/django_fields.py +107 -0
  1331. package/runtime/Lib/site-packages/semantic_version-2.10.0.dist-info/LICENSE +22 -0
  1332. package/runtime/Lib/site-packages/semantic_version-2.10.0.dist-info/METADATA +324 -0
  1333. package/runtime/Lib/site-packages/semantic_version-2.10.0.dist-info/RECORD +8 -0
  1334. package/runtime/Lib/site-packages/semantic_version-2.10.0.dist-info/WHEEL +6 -0
  1335. package/runtime/Lib/site-packages/semantic_version-2.10.0.dist-info/top_level.txt +1 -0
  1336. package/runtime/Lib/site-packages/six-1.17.0.dist-info/LICENSE +18 -0
  1337. package/runtime/Lib/site-packages/six-1.17.0.dist-info/METADATA +43 -0
  1338. package/runtime/Lib/site-packages/six-1.17.0.dist-info/RECORD +6 -0
  1339. package/runtime/Lib/site-packages/six-1.17.0.dist-info/WHEEL +6 -0
  1340. package/runtime/Lib/site-packages/six-1.17.0.dist-info/top_level.txt +1 -0
  1341. package/runtime/Lib/site-packages/six.py +1003 -0
  1342. package/runtime/Lib/site-packages/sse_starlette/__init__.py +5 -0
  1343. package/runtime/Lib/site-packages/sse_starlette/_utils.py +36 -0
  1344. package/runtime/Lib/site-packages/sse_starlette/event.py +96 -0
  1345. package/runtime/Lib/site-packages/sse_starlette/py.typed +0 -0
  1346. package/runtime/Lib/site-packages/sse_starlette/sse.py +579 -0
  1347. package/runtime/Lib/site-packages/sse_starlette-3.6.0.dist-info/METADATA +494 -0
  1348. package/runtime/Lib/site-packages/sse_starlette-3.6.0.dist-info/RECORD +11 -0
  1349. package/runtime/Lib/site-packages/sse_starlette-3.6.0.dist-info/WHEEL +5 -0
  1350. package/runtime/Lib/site-packages/sse_starlette-3.6.0.dist-info/licenses/AUTHORS +10 -0
  1351. package/runtime/Lib/site-packages/sse_starlette-3.6.0.dist-info/licenses/LICENSE +27 -0
  1352. package/runtime/Lib/site-packages/sse_starlette-3.6.0.dist-info/top_level.txt +1 -0
  1353. package/runtime/Lib/site-packages/starlette/__init__.py +1 -0
  1354. package/runtime/Lib/site-packages/starlette/_exception_handler.py +67 -0
  1355. package/runtime/Lib/site-packages/starlette/_utils.py +152 -0
  1356. package/runtime/Lib/site-packages/starlette/applications.py +124 -0
  1357. package/runtime/Lib/site-packages/starlette/authentication.py +157 -0
  1358. package/runtime/Lib/site-packages/starlette/background.py +36 -0
  1359. package/runtime/Lib/site-packages/starlette/concurrency.py +59 -0
  1360. package/runtime/Lib/site-packages/starlette/config.py +142 -0
  1361. package/runtime/Lib/site-packages/starlette/convertors.py +89 -0
  1362. package/runtime/Lib/site-packages/starlette/datastructures.py +717 -0
  1363. package/runtime/Lib/site-packages/starlette/endpoints.py +128 -0
  1364. package/runtime/Lib/site-packages/starlette/exceptions.py +43 -0
  1365. package/runtime/Lib/site-packages/starlette/formparsers.py +289 -0
  1366. package/runtime/Lib/site-packages/starlette/middleware/__init__.py +37 -0
  1367. package/runtime/Lib/site-packages/starlette/middleware/authentication.py +52 -0
  1368. package/runtime/Lib/site-packages/starlette/middleware/base.py +254 -0
  1369. package/runtime/Lib/site-packages/starlette/middleware/body_limit.py +132 -0
  1370. package/runtime/Lib/site-packages/starlette/middleware/cors.py +177 -0
  1371. package/runtime/Lib/site-packages/starlette/middleware/errors.py +259 -0
  1372. package/runtime/Lib/site-packages/starlette/middleware/exceptions.py +73 -0
  1373. package/runtime/Lib/site-packages/starlette/middleware/gzip.py +230 -0
  1374. package/runtime/Lib/site-packages/starlette/middleware/httpsredirect.py +22 -0
  1375. package/runtime/Lib/site-packages/starlette/middleware/opentelemetry.py +126 -0
  1376. package/runtime/Lib/site-packages/starlette/middleware/sessions.py +139 -0
  1377. package/runtime/Lib/site-packages/starlette/middleware/trustedhost.py +66 -0
  1378. package/runtime/Lib/site-packages/starlette/middleware/wsgi.py +157 -0
  1379. package/runtime/Lib/site-packages/starlette/py.typed +0 -0
  1380. package/runtime/Lib/site-packages/starlette/requests.py +357 -0
  1381. package/runtime/Lib/site-packages/starlette/responses.py +616 -0
  1382. package/runtime/Lib/site-packages/starlette/routing.py +772 -0
  1383. package/runtime/Lib/site-packages/starlette/schemas.py +152 -0
  1384. package/runtime/Lib/site-packages/starlette/staticfiles.py +231 -0
  1385. package/runtime/Lib/site-packages/starlette/status.py +211 -0
  1386. package/runtime/Lib/site-packages/starlette/templating.py +156 -0
  1387. package/runtime/Lib/site-packages/starlette/testclient.py +624 -0
  1388. package/runtime/Lib/site-packages/starlette/types.py +26 -0
  1389. package/runtime/Lib/site-packages/starlette/websockets.py +202 -0
  1390. package/runtime/Lib/site-packages/starlette-1.10.0.dist-info/METADATA +181 -0
  1391. package/runtime/Lib/site-packages/starlette-1.10.0.dist-info/RECORD +41 -0
  1392. package/runtime/Lib/site-packages/starlette-1.10.0.dist-info/WHEEL +4 -0
  1393. package/runtime/Lib/site-packages/starlette-1.10.0.dist-info/licenses/LICENSE.md +27 -0
  1394. package/runtime/Lib/site-packages/truststore/__init__.py +36 -0
  1395. package/runtime/Lib/site-packages/truststore/_api.py +377 -0
  1396. package/runtime/Lib/site-packages/truststore/_macos.py +571 -0
  1397. package/runtime/Lib/site-packages/truststore/_openssl.py +65 -0
  1398. package/runtime/Lib/site-packages/truststore/_ssl_constants.py +30 -0
  1399. package/runtime/Lib/site-packages/truststore/_windows.py +567 -0
  1400. package/runtime/Lib/site-packages/truststore/py.typed +0 -0
  1401. package/runtime/Lib/site-packages/truststore-0.10.5.dist-info/METADATA +110 -0
  1402. package/runtime/Lib/site-packages/truststore-0.10.5.dist-info/RECORD +11 -0
  1403. package/runtime/Lib/site-packages/truststore-0.10.5.dist-info/WHEEL +4 -0
  1404. package/runtime/Lib/site-packages/truststore-0.10.5.dist-info/licenses/LICENSE +21 -0
  1405. package/runtime/Lib/site-packages/typing_extensions-4.16.0.dist-info/METADATA +73 -0
  1406. package/runtime/Lib/site-packages/typing_extensions-4.16.0.dist-info/RECORD +5 -0
  1407. package/runtime/Lib/site-packages/typing_extensions-4.16.0.dist-info/WHEEL +4 -0
  1408. package/runtime/Lib/site-packages/typing_extensions-4.16.0.dist-info/licenses/LICENSE +279 -0
  1409. package/runtime/Lib/site-packages/typing_extensions.py +4422 -0
  1410. package/runtime/Lib/site-packages/typing_inspection/__init__.py +0 -0
  1411. package/runtime/Lib/site-packages/typing_inspection/introspection.py +587 -0
  1412. package/runtime/Lib/site-packages/typing_inspection/py.typed +0 -0
  1413. package/runtime/Lib/site-packages/typing_inspection/typing_objects.py +620 -0
  1414. package/runtime/Lib/site-packages/typing_inspection/typing_objects.pyi +421 -0
  1415. package/runtime/Lib/site-packages/typing_inspection-0.4.4.dist-info/METADATA +49 -0
  1416. package/runtime/Lib/site-packages/typing_inspection-0.4.4.dist-info/RECORD +9 -0
  1417. package/runtime/Lib/site-packages/typing_inspection-0.4.4.dist-info/WHEEL +4 -0
  1418. package/runtime/Lib/site-packages/typing_inspection-0.4.4.dist-info/licenses/LICENSE +21 -0
  1419. package/runtime/Lib/site-packages/tzdata/__init__.py +6 -0
  1420. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Abidjan +0 -0
  1421. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Accra +0 -0
  1422. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Addis_Ababa +0 -0
  1423. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Algiers +0 -0
  1424. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Asmara +0 -0
  1425. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Asmera +0 -0
  1426. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Bamako +0 -0
  1427. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Bangui +0 -0
  1428. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Banjul +0 -0
  1429. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Bissau +0 -0
  1430. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Blantyre +0 -0
  1431. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Brazzaville +0 -0
  1432. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Bujumbura +0 -0
  1433. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Cairo +0 -0
  1434. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Casablanca +0 -0
  1435. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Ceuta +0 -0
  1436. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Conakry +0 -0
  1437. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Dakar +0 -0
  1438. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Dar_es_Salaam +0 -0
  1439. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Djibouti +0 -0
  1440. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Douala +0 -0
  1441. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/El_Aaiun +0 -0
  1442. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Freetown +0 -0
  1443. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Gaborone +0 -0
  1444. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Harare +0 -0
  1445. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Johannesburg +0 -0
  1446. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Juba +0 -0
  1447. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Kampala +0 -0
  1448. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Khartoum +0 -0
  1449. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Kigali +0 -0
  1450. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Kinshasa +0 -0
  1451. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Lagos +0 -0
  1452. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Libreville +0 -0
  1453. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Lome +0 -0
  1454. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Luanda +0 -0
  1455. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Lubumbashi +0 -0
  1456. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Lusaka +0 -0
  1457. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Malabo +0 -0
  1458. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Maputo +0 -0
  1459. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Maseru +0 -0
  1460. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Mbabane +0 -0
  1461. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Mogadishu +0 -0
  1462. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Monrovia +0 -0
  1463. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Nairobi +0 -0
  1464. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Ndjamena +0 -0
  1465. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Niamey +0 -0
  1466. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Nouakchott +0 -0
  1467. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Ouagadougou +0 -0
  1468. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Porto-Novo +0 -0
  1469. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Sao_Tome +0 -0
  1470. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Timbuktu +0 -0
  1471. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Tripoli +0 -0
  1472. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Tunis +0 -0
  1473. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/Windhoek +0 -0
  1474. package/runtime/Lib/site-packages/tzdata/zoneinfo/Africa/__init__.py +0 -0
  1475. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Adak +0 -0
  1476. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Anchorage +0 -0
  1477. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Anguilla +0 -0
  1478. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Antigua +0 -0
  1479. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Araguaina +0 -0
  1480. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Argentina/Buenos_Aires +0 -0
  1481. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Argentina/Catamarca +0 -0
  1482. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Argentina/ComodRivadavia +0 -0
  1483. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Argentina/Cordoba +0 -0
  1484. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Argentina/Jujuy +0 -0
  1485. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Argentina/La_Rioja +0 -0
  1486. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Argentina/Mendoza +0 -0
  1487. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Argentina/Rio_Gallegos +0 -0
  1488. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Argentina/Salta +0 -0
  1489. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Argentina/San_Juan +0 -0
  1490. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Argentina/San_Luis +0 -0
  1491. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Argentina/Tucuman +0 -0
  1492. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Argentina/Ushuaia +0 -0
  1493. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Argentina/__init__.py +0 -0
  1494. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Aruba +0 -0
  1495. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Asuncion +0 -0
  1496. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Atikokan +0 -0
  1497. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Atka +0 -0
  1498. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Bahia +0 -0
  1499. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Bahia_Banderas +0 -0
  1500. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Barbados +0 -0
  1501. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Belem +0 -0
  1502. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Belize +0 -0
  1503. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Blanc-Sablon +0 -0
  1504. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Boa_Vista +0 -0
  1505. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Bogota +0 -0
  1506. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Boise +0 -0
  1507. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Buenos_Aires +0 -0
  1508. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Cambridge_Bay +0 -0
  1509. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Campo_Grande +0 -0
  1510. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Cancun +0 -0
  1511. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Caracas +0 -0
  1512. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Catamarca +0 -0
  1513. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Cayenne +0 -0
  1514. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Cayman +0 -0
  1515. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Chicago +0 -0
  1516. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Chihuahua +0 -0
  1517. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Ciudad_Juarez +0 -0
  1518. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Coral_Harbour +0 -0
  1519. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Cordoba +0 -0
  1520. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Costa_Rica +0 -0
  1521. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Coyhaique +0 -0
  1522. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Creston +0 -0
  1523. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Cuiaba +0 -0
  1524. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Curacao +0 -0
  1525. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Danmarkshavn +0 -0
  1526. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Dawson +0 -0
  1527. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Dawson_Creek +0 -0
  1528. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Denver +0 -0
  1529. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Detroit +0 -0
  1530. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Dominica +0 -0
  1531. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Edmonton +0 -0
  1532. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Eirunepe +0 -0
  1533. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/El_Salvador +0 -0
  1534. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Ensenada +0 -0
  1535. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Fort_Nelson +0 -0
  1536. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Fort_Wayne +0 -0
  1537. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Fortaleza +0 -0
  1538. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Glace_Bay +0 -0
  1539. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Godthab +0 -0
  1540. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Goose_Bay +0 -0
  1541. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Grand_Turk +0 -0
  1542. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Grenada +0 -0
  1543. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Guadeloupe +0 -0
  1544. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Guatemala +0 -0
  1545. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Guayaquil +0 -0
  1546. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Guyana +0 -0
  1547. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Halifax +0 -0
  1548. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Havana +0 -0
  1549. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Hermosillo +0 -0
  1550. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Indiana/Indianapolis +0 -0
  1551. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Indiana/Knox +0 -0
  1552. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Indiana/Marengo +0 -0
  1553. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Indiana/Petersburg +0 -0
  1554. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Indiana/Tell_City +0 -0
  1555. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Indiana/Vevay +0 -0
  1556. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Indiana/Vincennes +0 -0
  1557. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Indiana/Winamac +0 -0
  1558. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Indiana/__init__.py +0 -0
  1559. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Indianapolis +0 -0
  1560. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Inuvik +0 -0
  1561. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Iqaluit +0 -0
  1562. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Jamaica +0 -0
  1563. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Jujuy +0 -0
  1564. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Juneau +0 -0
  1565. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Kentucky/Louisville +0 -0
  1566. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Kentucky/Monticello +0 -0
  1567. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Kentucky/__init__.py +0 -0
  1568. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Knox_IN +0 -0
  1569. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Kralendijk +0 -0
  1570. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/La_Paz +0 -0
  1571. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Lima +0 -0
  1572. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Los_Angeles +0 -0
  1573. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Louisville +0 -0
  1574. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Lower_Princes +0 -0
  1575. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Maceio +0 -0
  1576. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Managua +0 -0
  1577. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Manaus +0 -0
  1578. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Marigot +0 -0
  1579. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Martinique +0 -0
  1580. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Matamoros +0 -0
  1581. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Mazatlan +0 -0
  1582. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Mendoza +0 -0
  1583. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Menominee +0 -0
  1584. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Merida +0 -0
  1585. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Metlakatla +0 -0
  1586. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Mexico_City +0 -0
  1587. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Miquelon +0 -0
  1588. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Moncton +0 -0
  1589. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Monterrey +0 -0
  1590. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Montevideo +0 -0
  1591. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Montreal +0 -0
  1592. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Montserrat +0 -0
  1593. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Nassau +0 -0
  1594. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/New_York +0 -0
  1595. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Nipigon +0 -0
  1596. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Nome +0 -0
  1597. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Noronha +0 -0
  1598. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/North_Dakota/Beulah +0 -0
  1599. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/North_Dakota/Center +0 -0
  1600. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/North_Dakota/New_Salem +0 -0
  1601. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/North_Dakota/__init__.py +0 -0
  1602. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Nuuk +0 -0
  1603. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Ojinaga +0 -0
  1604. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Panama +0 -0
  1605. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Pangnirtung +0 -0
  1606. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Paramaribo +0 -0
  1607. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Phoenix +0 -0
  1608. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Port-au-Prince +0 -0
  1609. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Port_of_Spain +0 -0
  1610. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Porto_Acre +0 -0
  1611. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Porto_Velho +0 -0
  1612. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Puerto_Rico +0 -0
  1613. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Punta_Arenas +0 -0
  1614. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Rainy_River +0 -0
  1615. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Rankin_Inlet +0 -0
  1616. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Recife +0 -0
  1617. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Regina +0 -0
  1618. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Resolute +0 -0
  1619. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Rio_Branco +0 -0
  1620. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Rosario +0 -0
  1621. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Santa_Isabel +0 -0
  1622. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Santarem +0 -0
  1623. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Santiago +0 -0
  1624. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Santo_Domingo +0 -0
  1625. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Sao_Paulo +0 -0
  1626. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Scoresbysund +0 -0
  1627. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Shiprock +0 -0
  1628. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Sitka +0 -0
  1629. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/St_Barthelemy +0 -0
  1630. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/St_Johns +0 -0
  1631. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/St_Kitts +0 -0
  1632. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/St_Lucia +0 -0
  1633. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/St_Thomas +0 -0
  1634. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/St_Vincent +0 -0
  1635. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Swift_Current +0 -0
  1636. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Tegucigalpa +0 -0
  1637. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Thule +0 -0
  1638. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Thunder_Bay +0 -0
  1639. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Tijuana +0 -0
  1640. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Toronto +0 -0
  1641. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Tortola +0 -0
  1642. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Vancouver +0 -0
  1643. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Virgin +0 -0
  1644. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Whitehorse +0 -0
  1645. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Winnipeg +0 -0
  1646. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Yakutat +0 -0
  1647. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/Yellowknife +0 -0
  1648. package/runtime/Lib/site-packages/tzdata/zoneinfo/America/__init__.py +0 -0
  1649. package/runtime/Lib/site-packages/tzdata/zoneinfo/Antarctica/Casey +0 -0
  1650. package/runtime/Lib/site-packages/tzdata/zoneinfo/Antarctica/Davis +0 -0
  1651. package/runtime/Lib/site-packages/tzdata/zoneinfo/Antarctica/DumontDUrville +0 -0
  1652. package/runtime/Lib/site-packages/tzdata/zoneinfo/Antarctica/Macquarie +0 -0
  1653. package/runtime/Lib/site-packages/tzdata/zoneinfo/Antarctica/Mawson +0 -0
  1654. package/runtime/Lib/site-packages/tzdata/zoneinfo/Antarctica/McMurdo +0 -0
  1655. package/runtime/Lib/site-packages/tzdata/zoneinfo/Antarctica/Palmer +0 -0
  1656. package/runtime/Lib/site-packages/tzdata/zoneinfo/Antarctica/Rothera +0 -0
  1657. package/runtime/Lib/site-packages/tzdata/zoneinfo/Antarctica/South_Pole +0 -0
  1658. package/runtime/Lib/site-packages/tzdata/zoneinfo/Antarctica/Syowa +0 -0
  1659. package/runtime/Lib/site-packages/tzdata/zoneinfo/Antarctica/Troll +0 -0
  1660. package/runtime/Lib/site-packages/tzdata/zoneinfo/Antarctica/Vostok +0 -0
  1661. package/runtime/Lib/site-packages/tzdata/zoneinfo/Antarctica/__init__.py +0 -0
  1662. package/runtime/Lib/site-packages/tzdata/zoneinfo/Arctic/Longyearbyen +0 -0
  1663. package/runtime/Lib/site-packages/tzdata/zoneinfo/Arctic/__init__.py +0 -0
  1664. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Aden +0 -0
  1665. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Almaty +0 -0
  1666. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Amman +0 -0
  1667. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Anadyr +0 -0
  1668. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Aqtau +0 -0
  1669. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Aqtobe +0 -0
  1670. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Ashgabat +0 -0
  1671. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Ashkhabad +0 -0
  1672. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Atyrau +0 -0
  1673. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Baghdad +0 -0
  1674. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Bahrain +0 -0
  1675. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Baku +0 -0
  1676. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Bangkok +0 -0
  1677. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Barnaul +0 -0
  1678. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Beirut +0 -0
  1679. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Bishkek +0 -0
  1680. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Brunei +0 -0
  1681. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Calcutta +0 -0
  1682. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Chita +0 -0
  1683. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Choibalsan +0 -0
  1684. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Chongqing +0 -0
  1685. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Chungking +0 -0
  1686. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Colombo +0 -0
  1687. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Dacca +0 -0
  1688. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Damascus +0 -0
  1689. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Dhaka +0 -0
  1690. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Dili +0 -0
  1691. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Dubai +0 -0
  1692. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Dushanbe +0 -0
  1693. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Famagusta +0 -0
  1694. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Gaza +0 -0
  1695. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Harbin +0 -0
  1696. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Hebron +0 -0
  1697. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Ho_Chi_Minh +0 -0
  1698. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Hong_Kong +0 -0
  1699. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Hovd +0 -0
  1700. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Irkutsk +0 -0
  1701. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Istanbul +0 -0
  1702. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Jakarta +0 -0
  1703. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Jayapura +0 -0
  1704. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Jerusalem +0 -0
  1705. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Kabul +0 -0
  1706. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Kamchatka +0 -0
  1707. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Karachi +0 -0
  1708. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Kashgar +0 -0
  1709. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Kathmandu +0 -0
  1710. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Katmandu +0 -0
  1711. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Khandyga +0 -0
  1712. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Kolkata +0 -0
  1713. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Krasnoyarsk +0 -0
  1714. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Kuala_Lumpur +0 -0
  1715. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Kuching +0 -0
  1716. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Kuwait +0 -0
  1717. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Macao +0 -0
  1718. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Macau +0 -0
  1719. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Magadan +0 -0
  1720. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Makassar +0 -0
  1721. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Manila +0 -0
  1722. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Muscat +0 -0
  1723. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Nicosia +0 -0
  1724. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Novokuznetsk +0 -0
  1725. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Novosibirsk +0 -0
  1726. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Omsk +0 -0
  1727. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Oral +0 -0
  1728. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Phnom_Penh +0 -0
  1729. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Pontianak +0 -0
  1730. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Pyongyang +0 -0
  1731. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Qatar +0 -0
  1732. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Qostanay +0 -0
  1733. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Qyzylorda +0 -0
  1734. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Rangoon +0 -0
  1735. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Riyadh +0 -0
  1736. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Saigon +0 -0
  1737. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Sakhalin +0 -0
  1738. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Samarkand +0 -0
  1739. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Seoul +0 -0
  1740. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Shanghai +0 -0
  1741. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Singapore +0 -0
  1742. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Srednekolymsk +0 -0
  1743. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Taipei +0 -0
  1744. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Tashkent +0 -0
  1745. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Tbilisi +0 -0
  1746. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Tehran +0 -0
  1747. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Tel_Aviv +0 -0
  1748. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Thimbu +0 -0
  1749. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Thimphu +0 -0
  1750. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Tokyo +0 -0
  1751. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Tomsk +0 -0
  1752. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Ujung_Pandang +0 -0
  1753. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Ulaanbaatar +0 -0
  1754. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Ulan_Bator +0 -0
  1755. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Urumqi +0 -0
  1756. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Ust-Nera +0 -0
  1757. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Vientiane +0 -0
  1758. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Vladivostok +0 -0
  1759. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Yakutsk +0 -0
  1760. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Yangon +0 -0
  1761. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Yekaterinburg +0 -0
  1762. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/Yerevan +0 -0
  1763. package/runtime/Lib/site-packages/tzdata/zoneinfo/Asia/__init__.py +0 -0
  1764. package/runtime/Lib/site-packages/tzdata/zoneinfo/Atlantic/Azores +0 -0
  1765. package/runtime/Lib/site-packages/tzdata/zoneinfo/Atlantic/Bermuda +0 -0
  1766. package/runtime/Lib/site-packages/tzdata/zoneinfo/Atlantic/Canary +0 -0
  1767. package/runtime/Lib/site-packages/tzdata/zoneinfo/Atlantic/Cape_Verde +0 -0
  1768. package/runtime/Lib/site-packages/tzdata/zoneinfo/Atlantic/Faeroe +0 -0
  1769. package/runtime/Lib/site-packages/tzdata/zoneinfo/Atlantic/Faroe +0 -0
  1770. package/runtime/Lib/site-packages/tzdata/zoneinfo/Atlantic/Jan_Mayen +0 -0
  1771. package/runtime/Lib/site-packages/tzdata/zoneinfo/Atlantic/Madeira +0 -0
  1772. package/runtime/Lib/site-packages/tzdata/zoneinfo/Atlantic/Reykjavik +0 -0
  1773. package/runtime/Lib/site-packages/tzdata/zoneinfo/Atlantic/South_Georgia +0 -0
  1774. package/runtime/Lib/site-packages/tzdata/zoneinfo/Atlantic/St_Helena +0 -0
  1775. package/runtime/Lib/site-packages/tzdata/zoneinfo/Atlantic/Stanley +0 -0
  1776. package/runtime/Lib/site-packages/tzdata/zoneinfo/Atlantic/__init__.py +0 -0
  1777. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/ACT +0 -0
  1778. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Adelaide +0 -0
  1779. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Brisbane +0 -0
  1780. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Broken_Hill +0 -0
  1781. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Canberra +0 -0
  1782. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Currie +0 -0
  1783. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Darwin +0 -0
  1784. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Eucla +0 -0
  1785. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Hobart +0 -0
  1786. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/LHI +0 -0
  1787. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Lindeman +0 -0
  1788. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Lord_Howe +0 -0
  1789. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Melbourne +0 -0
  1790. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/NSW +0 -0
  1791. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/North +0 -0
  1792. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Perth +0 -0
  1793. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Queensland +0 -0
  1794. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/South +0 -0
  1795. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Sydney +0 -0
  1796. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Tasmania +0 -0
  1797. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Victoria +0 -0
  1798. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/West +0 -0
  1799. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/Yancowinna +0 -0
  1800. package/runtime/Lib/site-packages/tzdata/zoneinfo/Australia/__init__.py +0 -0
  1801. package/runtime/Lib/site-packages/tzdata/zoneinfo/Brazil/Acre +0 -0
  1802. package/runtime/Lib/site-packages/tzdata/zoneinfo/Brazil/DeNoronha +0 -0
  1803. package/runtime/Lib/site-packages/tzdata/zoneinfo/Brazil/East +0 -0
  1804. package/runtime/Lib/site-packages/tzdata/zoneinfo/Brazil/West +0 -0
  1805. package/runtime/Lib/site-packages/tzdata/zoneinfo/Brazil/__init__.py +0 -0
  1806. package/runtime/Lib/site-packages/tzdata/zoneinfo/CET +0 -0
  1807. package/runtime/Lib/site-packages/tzdata/zoneinfo/CST6CDT +0 -0
  1808. package/runtime/Lib/site-packages/tzdata/zoneinfo/Canada/Atlantic +0 -0
  1809. package/runtime/Lib/site-packages/tzdata/zoneinfo/Canada/Central +0 -0
  1810. package/runtime/Lib/site-packages/tzdata/zoneinfo/Canada/Eastern +0 -0
  1811. package/runtime/Lib/site-packages/tzdata/zoneinfo/Canada/Mountain +0 -0
  1812. package/runtime/Lib/site-packages/tzdata/zoneinfo/Canada/Newfoundland +0 -0
  1813. package/runtime/Lib/site-packages/tzdata/zoneinfo/Canada/Pacific +0 -0
  1814. package/runtime/Lib/site-packages/tzdata/zoneinfo/Canada/Saskatchewan +0 -0
  1815. package/runtime/Lib/site-packages/tzdata/zoneinfo/Canada/Yukon +0 -0
  1816. package/runtime/Lib/site-packages/tzdata/zoneinfo/Canada/__init__.py +0 -0
  1817. package/runtime/Lib/site-packages/tzdata/zoneinfo/Chile/Continental +0 -0
  1818. package/runtime/Lib/site-packages/tzdata/zoneinfo/Chile/EasterIsland +0 -0
  1819. package/runtime/Lib/site-packages/tzdata/zoneinfo/Chile/__init__.py +0 -0
  1820. package/runtime/Lib/site-packages/tzdata/zoneinfo/Cuba +0 -0
  1821. package/runtime/Lib/site-packages/tzdata/zoneinfo/EET +0 -0
  1822. package/runtime/Lib/site-packages/tzdata/zoneinfo/EST +0 -0
  1823. package/runtime/Lib/site-packages/tzdata/zoneinfo/EST5EDT +0 -0
  1824. package/runtime/Lib/site-packages/tzdata/zoneinfo/Egypt +0 -0
  1825. package/runtime/Lib/site-packages/tzdata/zoneinfo/Eire +0 -0
  1826. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT +0 -0
  1827. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT+0 +0 -0
  1828. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT+1 +0 -0
  1829. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT+10 +0 -0
  1830. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT+11 +0 -0
  1831. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT+12 +0 -0
  1832. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT+2 +0 -0
  1833. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT+3 +0 -0
  1834. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT+4 +0 -0
  1835. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT+5 +0 -0
  1836. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT+6 +0 -0
  1837. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT+7 +0 -0
  1838. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT+8 +0 -0
  1839. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT+9 +0 -0
  1840. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-0 +0 -0
  1841. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-1 +0 -0
  1842. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-10 +0 -0
  1843. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-11 +0 -0
  1844. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-12 +0 -0
  1845. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-13 +0 -0
  1846. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-14 +0 -0
  1847. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-2 +0 -0
  1848. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-3 +0 -0
  1849. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-4 +0 -0
  1850. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-5 +0 -0
  1851. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-6 +0 -0
  1852. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-7 +0 -0
  1853. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-8 +0 -0
  1854. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT-9 +0 -0
  1855. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/GMT0 +0 -0
  1856. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/Greenwich +0 -0
  1857. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/UCT +0 -0
  1858. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/UTC +0 -0
  1859. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/Universal +0 -0
  1860. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/Zulu +0 -0
  1861. package/runtime/Lib/site-packages/tzdata/zoneinfo/Etc/__init__.py +0 -0
  1862. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Amsterdam +0 -0
  1863. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Andorra +0 -0
  1864. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Astrakhan +0 -0
  1865. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Athens +0 -0
  1866. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Belfast +0 -0
  1867. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Belgrade +0 -0
  1868. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Berlin +0 -0
  1869. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Bratislava +0 -0
  1870. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Brussels +0 -0
  1871. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Bucharest +0 -0
  1872. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Budapest +0 -0
  1873. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Busingen +0 -0
  1874. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Chisinau +0 -0
  1875. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Copenhagen +0 -0
  1876. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Dublin +0 -0
  1877. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Gibraltar +0 -0
  1878. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Guernsey +0 -0
  1879. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Helsinki +0 -0
  1880. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Isle_of_Man +0 -0
  1881. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Istanbul +0 -0
  1882. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Jersey +0 -0
  1883. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Kaliningrad +0 -0
  1884. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Kiev +0 -0
  1885. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Kirov +0 -0
  1886. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Kyiv +0 -0
  1887. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Lisbon +0 -0
  1888. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Ljubljana +0 -0
  1889. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/London +0 -0
  1890. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Luxembourg +0 -0
  1891. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Madrid +0 -0
  1892. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Malta +0 -0
  1893. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Mariehamn +0 -0
  1894. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Minsk +0 -0
  1895. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Monaco +0 -0
  1896. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Moscow +0 -0
  1897. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Nicosia +0 -0
  1898. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Oslo +0 -0
  1899. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Paris +0 -0
  1900. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Podgorica +0 -0
  1901. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Prague +0 -0
  1902. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Riga +0 -0
  1903. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Rome +0 -0
  1904. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Samara +0 -0
  1905. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/San_Marino +0 -0
  1906. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Sarajevo +0 -0
  1907. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Saratov +0 -0
  1908. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Simferopol +0 -0
  1909. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Skopje +0 -0
  1910. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Sofia +0 -0
  1911. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Stockholm +0 -0
  1912. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Tallinn +0 -0
  1913. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Tirane +0 -0
  1914. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Tiraspol +0 -0
  1915. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Ulyanovsk +0 -0
  1916. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Uzhgorod +0 -0
  1917. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Vaduz +0 -0
  1918. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Vatican +0 -0
  1919. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Vienna +0 -0
  1920. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Vilnius +0 -0
  1921. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Volgograd +0 -0
  1922. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Warsaw +0 -0
  1923. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Zagreb +0 -0
  1924. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Zaporozhye +0 -0
  1925. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/Zurich +0 -0
  1926. package/runtime/Lib/site-packages/tzdata/zoneinfo/Europe/__init__.py +0 -0
  1927. package/runtime/Lib/site-packages/tzdata/zoneinfo/Factory +0 -0
  1928. package/runtime/Lib/site-packages/tzdata/zoneinfo/GB +0 -0
  1929. package/runtime/Lib/site-packages/tzdata/zoneinfo/GB-Eire +0 -0
  1930. package/runtime/Lib/site-packages/tzdata/zoneinfo/GMT +0 -0
  1931. package/runtime/Lib/site-packages/tzdata/zoneinfo/GMT+0 +0 -0
  1932. package/runtime/Lib/site-packages/tzdata/zoneinfo/GMT-0 +0 -0
  1933. package/runtime/Lib/site-packages/tzdata/zoneinfo/GMT0 +0 -0
  1934. package/runtime/Lib/site-packages/tzdata/zoneinfo/Greenwich +0 -0
  1935. package/runtime/Lib/site-packages/tzdata/zoneinfo/HST +0 -0
  1936. package/runtime/Lib/site-packages/tzdata/zoneinfo/Hongkong +0 -0
  1937. package/runtime/Lib/site-packages/tzdata/zoneinfo/Iceland +0 -0
  1938. package/runtime/Lib/site-packages/tzdata/zoneinfo/Indian/Antananarivo +0 -0
  1939. package/runtime/Lib/site-packages/tzdata/zoneinfo/Indian/Chagos +0 -0
  1940. package/runtime/Lib/site-packages/tzdata/zoneinfo/Indian/Christmas +0 -0
  1941. package/runtime/Lib/site-packages/tzdata/zoneinfo/Indian/Cocos +0 -0
  1942. package/runtime/Lib/site-packages/tzdata/zoneinfo/Indian/Comoro +0 -0
  1943. package/runtime/Lib/site-packages/tzdata/zoneinfo/Indian/Kerguelen +0 -0
  1944. package/runtime/Lib/site-packages/tzdata/zoneinfo/Indian/Mahe +0 -0
  1945. package/runtime/Lib/site-packages/tzdata/zoneinfo/Indian/Maldives +0 -0
  1946. package/runtime/Lib/site-packages/tzdata/zoneinfo/Indian/Mauritius +0 -0
  1947. package/runtime/Lib/site-packages/tzdata/zoneinfo/Indian/Mayotte +0 -0
  1948. package/runtime/Lib/site-packages/tzdata/zoneinfo/Indian/Reunion +0 -0
  1949. package/runtime/Lib/site-packages/tzdata/zoneinfo/Indian/__init__.py +0 -0
  1950. package/runtime/Lib/site-packages/tzdata/zoneinfo/Iran +0 -0
  1951. package/runtime/Lib/site-packages/tzdata/zoneinfo/Israel +0 -0
  1952. package/runtime/Lib/site-packages/tzdata/zoneinfo/Jamaica +0 -0
  1953. package/runtime/Lib/site-packages/tzdata/zoneinfo/Japan +0 -0
  1954. package/runtime/Lib/site-packages/tzdata/zoneinfo/Kwajalein +0 -0
  1955. package/runtime/Lib/site-packages/tzdata/zoneinfo/Libya +0 -0
  1956. package/runtime/Lib/site-packages/tzdata/zoneinfo/MET +0 -0
  1957. package/runtime/Lib/site-packages/tzdata/zoneinfo/MST +0 -0
  1958. package/runtime/Lib/site-packages/tzdata/zoneinfo/MST7MDT +0 -0
  1959. package/runtime/Lib/site-packages/tzdata/zoneinfo/Mexico/BajaNorte +0 -0
  1960. package/runtime/Lib/site-packages/tzdata/zoneinfo/Mexico/BajaSur +0 -0
  1961. package/runtime/Lib/site-packages/tzdata/zoneinfo/Mexico/General +0 -0
  1962. package/runtime/Lib/site-packages/tzdata/zoneinfo/Mexico/__init__.py +0 -0
  1963. package/runtime/Lib/site-packages/tzdata/zoneinfo/NZ +0 -0
  1964. package/runtime/Lib/site-packages/tzdata/zoneinfo/NZ-CHAT +0 -0
  1965. package/runtime/Lib/site-packages/tzdata/zoneinfo/Navajo +0 -0
  1966. package/runtime/Lib/site-packages/tzdata/zoneinfo/PRC +0 -0
  1967. package/runtime/Lib/site-packages/tzdata/zoneinfo/PST8PDT +0 -0
  1968. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Apia +0 -0
  1969. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Auckland +0 -0
  1970. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Bougainville +0 -0
  1971. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Chatham +0 -0
  1972. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Chuuk +0 -0
  1973. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Easter +0 -0
  1974. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Efate +0 -0
  1975. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Enderbury +0 -0
  1976. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Fakaofo +0 -0
  1977. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Fiji +0 -0
  1978. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Funafuti +0 -0
  1979. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Galapagos +0 -0
  1980. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Gambier +0 -0
  1981. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Guadalcanal +0 -0
  1982. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Guam +0 -0
  1983. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Honolulu +0 -0
  1984. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Johnston +0 -0
  1985. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Kanton +0 -0
  1986. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Kiritimati +0 -0
  1987. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Kosrae +0 -0
  1988. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Kwajalein +0 -0
  1989. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Majuro +0 -0
  1990. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Marquesas +0 -0
  1991. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Midway +0 -0
  1992. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Nauru +0 -0
  1993. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Niue +0 -0
  1994. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Norfolk +0 -0
  1995. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Noumea +0 -0
  1996. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Pago_Pago +0 -0
  1997. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Palau +0 -0
  1998. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Pitcairn +0 -0
  1999. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Pohnpei +0 -0
  2000. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Ponape +0 -0
  2001. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Port_Moresby +0 -0
  2002. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Rarotonga +0 -0
  2003. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Saipan +0 -0
  2004. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Samoa +0 -0
  2005. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Tahiti +0 -0
  2006. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Tarawa +0 -0
  2007. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Tongatapu +0 -0
  2008. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Truk +0 -0
  2009. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Wake +0 -0
  2010. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Wallis +0 -0
  2011. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/Yap +0 -0
  2012. package/runtime/Lib/site-packages/tzdata/zoneinfo/Pacific/__init__.py +0 -0
  2013. package/runtime/Lib/site-packages/tzdata/zoneinfo/Poland +0 -0
  2014. package/runtime/Lib/site-packages/tzdata/zoneinfo/Portugal +0 -0
  2015. package/runtime/Lib/site-packages/tzdata/zoneinfo/ROC +0 -0
  2016. package/runtime/Lib/site-packages/tzdata/zoneinfo/ROK +0 -0
  2017. package/runtime/Lib/site-packages/tzdata/zoneinfo/Singapore +0 -0
  2018. package/runtime/Lib/site-packages/tzdata/zoneinfo/Turkey +0 -0
  2019. package/runtime/Lib/site-packages/tzdata/zoneinfo/UCT +0 -0
  2020. package/runtime/Lib/site-packages/tzdata/zoneinfo/US/Alaska +0 -0
  2021. package/runtime/Lib/site-packages/tzdata/zoneinfo/US/Aleutian +0 -0
  2022. package/runtime/Lib/site-packages/tzdata/zoneinfo/US/Arizona +0 -0
  2023. package/runtime/Lib/site-packages/tzdata/zoneinfo/US/Central +0 -0
  2024. package/runtime/Lib/site-packages/tzdata/zoneinfo/US/East-Indiana +0 -0
  2025. package/runtime/Lib/site-packages/tzdata/zoneinfo/US/Eastern +0 -0
  2026. package/runtime/Lib/site-packages/tzdata/zoneinfo/US/Hawaii +0 -0
  2027. package/runtime/Lib/site-packages/tzdata/zoneinfo/US/Indiana-Starke +0 -0
  2028. package/runtime/Lib/site-packages/tzdata/zoneinfo/US/Michigan +0 -0
  2029. package/runtime/Lib/site-packages/tzdata/zoneinfo/US/Mountain +0 -0
  2030. package/runtime/Lib/site-packages/tzdata/zoneinfo/US/Pacific +0 -0
  2031. package/runtime/Lib/site-packages/tzdata/zoneinfo/US/Samoa +0 -0
  2032. package/runtime/Lib/site-packages/tzdata/zoneinfo/US/__init__.py +0 -0
  2033. package/runtime/Lib/site-packages/tzdata/zoneinfo/UTC +0 -0
  2034. package/runtime/Lib/site-packages/tzdata/zoneinfo/Universal +0 -0
  2035. package/runtime/Lib/site-packages/tzdata/zoneinfo/W-SU +0 -0
  2036. package/runtime/Lib/site-packages/tzdata/zoneinfo/WET +0 -0
  2037. package/runtime/Lib/site-packages/tzdata/zoneinfo/Zulu +0 -0
  2038. package/runtime/Lib/site-packages/tzdata/zoneinfo/__init__.py +0 -0
  2039. package/runtime/Lib/site-packages/tzdata/zoneinfo/iso3166.tab +279 -0
  2040. package/runtime/Lib/site-packages/tzdata/zoneinfo/leapseconds +84 -0
  2041. package/runtime/Lib/site-packages/tzdata/zoneinfo/tzdata.zi +4202 -0
  2042. package/runtime/Lib/site-packages/tzdata/zoneinfo/zone.tab +448 -0
  2043. package/runtime/Lib/site-packages/tzdata/zoneinfo/zone1970.tab +375 -0
  2044. package/runtime/Lib/site-packages/tzdata/zoneinfo/zonenow.tab +302 -0
  2045. package/runtime/Lib/site-packages/tzdata/zones +598 -0
  2046. package/runtime/Lib/site-packages/tzdata-2026.6.dist-info/METADATA +33 -0
  2047. package/runtime/Lib/site-packages/tzdata-2026.6.dist-info/RECORD +633 -0
  2048. package/runtime/Lib/site-packages/tzdata-2026.6.dist-info/WHEEL +6 -0
  2049. package/runtime/Lib/site-packages/tzdata-2026.6.dist-info/licenses/LICENSE +16 -0
  2050. package/runtime/Lib/site-packages/tzdata-2026.6.dist-info/licenses/licenses/LICENSE_APACHE +201 -0
  2051. package/runtime/Lib/site-packages/tzdata-2026.6.dist-info/top_level.txt +1 -0
  2052. package/runtime/Lib/site-packages/urllib3/__init__.py +211 -0
  2053. package/runtime/Lib/site-packages/urllib3/_base_connection.py +167 -0
  2054. package/runtime/Lib/site-packages/urllib3/_collections.py +490 -0
  2055. package/runtime/Lib/site-packages/urllib3/_request_methods.py +278 -0
  2056. package/runtime/Lib/site-packages/urllib3/_version.py +24 -0
  2057. package/runtime/Lib/site-packages/urllib3/connection.py +1204 -0
  2058. package/runtime/Lib/site-packages/urllib3/connectionpool.py +1211 -0
  2059. package/runtime/Lib/site-packages/urllib3/contrib/__init__.py +0 -0
  2060. package/runtime/Lib/site-packages/urllib3/contrib/emscripten/__init__.py +17 -0
  2061. package/runtime/Lib/site-packages/urllib3/contrib/emscripten/connection.py +260 -0
  2062. package/runtime/Lib/site-packages/urllib3/contrib/emscripten/emscripten_fetch_worker.js +110 -0
  2063. package/runtime/Lib/site-packages/urllib3/contrib/emscripten/fetch.py +726 -0
  2064. package/runtime/Lib/site-packages/urllib3/contrib/emscripten/request.py +22 -0
  2065. package/runtime/Lib/site-packages/urllib3/contrib/emscripten/response.py +281 -0
  2066. package/runtime/Lib/site-packages/urllib3/contrib/pyopenssl.py +603 -0
  2067. package/runtime/Lib/site-packages/urllib3/contrib/socks.py +226 -0
  2068. package/runtime/Lib/site-packages/urllib3/exceptions.py +335 -0
  2069. package/runtime/Lib/site-packages/urllib3/fields.py +341 -0
  2070. package/runtime/Lib/site-packages/urllib3/filepost.py +89 -0
  2071. package/runtime/Lib/site-packages/urllib3/http2/__init__.py +53 -0
  2072. package/runtime/Lib/site-packages/urllib3/http2/connection.py +357 -0
  2073. package/runtime/Lib/site-packages/urllib3/http2/probe.py +87 -0
  2074. package/runtime/Lib/site-packages/urllib3/poolmanager.py +677 -0
  2075. package/runtime/Lib/site-packages/urllib3/py.typed +2 -0
  2076. package/runtime/Lib/site-packages/urllib3/response.py +1526 -0
  2077. package/runtime/Lib/site-packages/urllib3/util/__init__.py +42 -0
  2078. package/runtime/Lib/site-packages/urllib3/util/connection.py +137 -0
  2079. package/runtime/Lib/site-packages/urllib3/util/proxy.py +43 -0
  2080. package/runtime/Lib/site-packages/urllib3/util/request.py +299 -0
  2081. package/runtime/Lib/site-packages/urllib3/util/response.py +101 -0
  2082. package/runtime/Lib/site-packages/urllib3/util/retry.py +569 -0
  2083. package/runtime/Lib/site-packages/urllib3/util/ssl_.py +481 -0
  2084. package/runtime/Lib/site-packages/urllib3/util/ssl_match_hostname.py +153 -0
  2085. package/runtime/Lib/site-packages/urllib3/util/ssltransport.py +271 -0
  2086. package/runtime/Lib/site-packages/urllib3/util/timeout.py +275 -0
  2087. package/runtime/Lib/site-packages/urllib3/util/url.py +577 -0
  2088. package/runtime/Lib/site-packages/urllib3/util/util.py +42 -0
  2089. package/runtime/Lib/site-packages/urllib3/util/wait.py +124 -0
  2090. package/runtime/Lib/site-packages/urllib3-2.8.0.dist-info/METADATA +175 -0
  2091. package/runtime/Lib/site-packages/urllib3-2.8.0.dist-info/RECORD +42 -0
  2092. package/runtime/Lib/site-packages/urllib3-2.8.0.dist-info/WHEEL +4 -0
  2093. package/runtime/Lib/site-packages/urllib3-2.8.0.dist-info/licenses/LICENSE.txt +21 -0
  2094. package/runtime/Lib/site-packages/uvicorn/__init__.py +5 -0
  2095. package/runtime/Lib/site-packages/uvicorn/__main__.py +4 -0
  2096. package/runtime/Lib/site-packages/uvicorn/_ansi.py +29 -0
  2097. package/runtime/Lib/site-packages/uvicorn/_compat.py +91 -0
  2098. package/runtime/Lib/site-packages/uvicorn/_subprocess.py +84 -0
  2099. package/runtime/Lib/site-packages/uvicorn/_types.py +280 -0
  2100. package/runtime/Lib/site-packages/uvicorn/config.py +618 -0
  2101. package/runtime/Lib/site-packages/uvicorn/importer.py +34 -0
  2102. package/runtime/Lib/site-packages/uvicorn/lifespan/__init__.py +0 -0
  2103. package/runtime/Lib/site-packages/uvicorn/lifespan/off.py +17 -0
  2104. package/runtime/Lib/site-packages/uvicorn/lifespan/on.py +137 -0
  2105. package/runtime/Lib/site-packages/uvicorn/logging.py +117 -0
  2106. package/runtime/Lib/site-packages/uvicorn/loops/__init__.py +0 -0
  2107. package/runtime/Lib/site-packages/uvicorn/loops/asyncio.py +11 -0
  2108. package/runtime/Lib/site-packages/uvicorn/loops/auto.py +17 -0
  2109. package/runtime/Lib/site-packages/uvicorn/loops/uvloop.py +10 -0
  2110. package/runtime/Lib/site-packages/uvicorn/loops/zuvloop.py +10 -0
  2111. package/runtime/Lib/site-packages/uvicorn/main.py +656 -0
  2112. package/runtime/Lib/site-packages/uvicorn/middleware/__init__.py +0 -0
  2113. package/runtime/Lib/site-packages/uvicorn/middleware/asgi2.py +15 -0
  2114. package/runtime/Lib/site-packages/uvicorn/middleware/message_logger.py +87 -0
  2115. package/runtime/Lib/site-packages/uvicorn/middleware/proxy_headers.py +187 -0
  2116. package/runtime/Lib/site-packages/uvicorn/middleware/wsgi.py +199 -0
  2117. package/runtime/Lib/site-packages/uvicorn/protocols/__init__.py +0 -0
  2118. package/runtime/Lib/site-packages/uvicorn/protocols/http/__init__.py +0 -0
  2119. package/runtime/Lib/site-packages/uvicorn/protocols/http/auto.py +15 -0
  2120. package/runtime/Lib/site-packages/uvicorn/protocols/http/auto_zttp_impl.py +89 -0
  2121. package/runtime/Lib/site-packages/uvicorn/protocols/http/flow_control.py +54 -0
  2122. package/runtime/Lib/site-packages/uvicorn/protocols/http/h11_impl.py +540 -0
  2123. package/runtime/Lib/site-packages/uvicorn/protocols/http/httptools_impl.py +581 -0
  2124. package/runtime/Lib/site-packages/uvicorn/protocols/http/zttp_h2_impl.py +559 -0
  2125. package/runtime/Lib/site-packages/uvicorn/protocols/http/zttp_impl.py +537 -0
  2126. package/runtime/Lib/site-packages/uvicorn/protocols/utils.py +62 -0
  2127. package/runtime/Lib/site-packages/uvicorn/protocols/websockets/__init__.py +0 -0
  2128. package/runtime/Lib/site-packages/uvicorn/protocols/websockets/auto.py +21 -0
  2129. package/runtime/Lib/site-packages/uvicorn/protocols/websockets/websockets_impl.py +390 -0
  2130. package/runtime/Lib/site-packages/uvicorn/protocols/websockets/websockets_sansio_impl.py +556 -0
  2131. package/runtime/Lib/site-packages/uvicorn/protocols/websockets/wsproto_impl.py +500 -0
  2132. package/runtime/Lib/site-packages/uvicorn/py.typed +1 -0
  2133. package/runtime/Lib/site-packages/uvicorn/server.py +356 -0
  2134. package/runtime/Lib/site-packages/uvicorn/supervisors/__init__.py +16 -0
  2135. package/runtime/Lib/site-packages/uvicorn/supervisors/basereload.py +124 -0
  2136. package/runtime/Lib/site-packages/uvicorn/supervisors/multiprocess.py +282 -0
  2137. package/runtime/Lib/site-packages/uvicorn/supervisors/statreload.py +52 -0
  2138. package/runtime/Lib/site-packages/uvicorn/supervisors/watchfilesreload.py +86 -0
  2139. package/runtime/Lib/site-packages/uvicorn/workers.py +111 -0
  2140. package/runtime/Lib/site-packages/uvicorn-0.54.0.dist-info/METADATA +189 -0
  2141. package/runtime/Lib/site-packages/uvicorn-0.54.0.dist-info/RECORD +51 -0
  2142. package/runtime/Lib/site-packages/uvicorn-0.54.0.dist-info/WHEEL +4 -0
  2143. package/runtime/Lib/site-packages/uvicorn-0.54.0.dist-info/entry_points.txt +2 -0
  2144. package/runtime/Lib/site-packages/uvicorn-0.54.0.dist-info/licenses/LICENSE.md +27 -0
  2145. package/runtime/Lib/site-packages/win32/Demos/BackupRead_BackupWrite.py +119 -0
  2146. package/runtime/Lib/site-packages/win32/Demos/BackupSeek_streamheaders.py +137 -0
  2147. package/runtime/Lib/site-packages/win32/Demos/CopyFileEx.py +57 -0
  2148. package/runtime/Lib/site-packages/win32/Demos/CreateFileTransacted_MiniVersion.py +122 -0
  2149. package/runtime/Lib/site-packages/win32/Demos/EvtFormatMessage.py +83 -0
  2150. package/runtime/Lib/site-packages/win32/Demos/EvtSubscribe_pull.py +28 -0
  2151. package/runtime/Lib/site-packages/win32/Demos/EvtSubscribe_push.py +32 -0
  2152. package/runtime/Lib/site-packages/win32/Demos/FileSecurityTest.py +137 -0
  2153. package/runtime/Lib/site-packages/win32/Demos/GetSaveFileName.py +43 -0
  2154. package/runtime/Lib/site-packages/win32/Demos/NetValidatePasswordPolicy.py +127 -0
  2155. package/runtime/Lib/site-packages/win32/Demos/OpenEncryptedFileRaw.py +66 -0
  2156. package/runtime/Lib/site-packages/win32/Demos/RegCreateKeyTransacted.py +60 -0
  2157. package/runtime/Lib/site-packages/win32/Demos/RegRestoreKey.py +71 -0
  2158. package/runtime/Lib/site-packages/win32/Demos/SystemParametersInfo.py +210 -0
  2159. package/runtime/Lib/site-packages/win32/Demos/c_extension/setup.py +26 -0
  2160. package/runtime/Lib/site-packages/win32/Demos/dde/ddeclient.py +18 -0
  2161. package/runtime/Lib/site-packages/win32/Demos/dde/ddeserver.py +42 -0
  2162. package/runtime/Lib/site-packages/win32/Demos/desktopmanager.py +246 -0
  2163. package/runtime/Lib/site-packages/win32/Demos/eventLogDemo.py +138 -0
  2164. package/runtime/Lib/site-packages/win32/Demos/getfilever.py +33 -0
  2165. package/runtime/Lib/site-packages/win32/Demos/images/frowny.bmp +0 -0
  2166. package/runtime/Lib/site-packages/win32/Demos/images/smiley.bmp +0 -0
  2167. package/runtime/Lib/site-packages/win32/Demos/mmapfile_demo.py +101 -0
  2168. package/runtime/Lib/site-packages/win32/Demos/pipes/cat.py +17 -0
  2169. package/runtime/Lib/site-packages/win32/Demos/pipes/runproc.py +114 -0
  2170. package/runtime/Lib/site-packages/win32/Demos/print_desktop.py +113 -0
  2171. package/runtime/Lib/site-packages/win32/Demos/rastest.py +166 -0
  2172. package/runtime/Lib/site-packages/win32/Demos/security/GetTokenInformation.py +110 -0
  2173. package/runtime/Lib/site-packages/win32/Demos/security/account_rights.py +49 -0
  2174. package/runtime/Lib/site-packages/win32/Demos/security/explicit_entries.py +170 -0
  2175. package/runtime/Lib/site-packages/win32/Demos/security/get_policy_info.py +39 -0
  2176. package/runtime/Lib/site-packages/win32/Demos/security/list_rights.py +35 -0
  2177. package/runtime/Lib/site-packages/win32/Demos/security/localized_names.py +70 -0
  2178. package/runtime/Lib/site-packages/win32/Demos/security/lsaregevent.py +14 -0
  2179. package/runtime/Lib/site-packages/win32/Demos/security/lsastore.py +12 -0
  2180. package/runtime/Lib/site-packages/win32/Demos/security/query_information.py +25 -0
  2181. package/runtime/Lib/site-packages/win32/Demos/security/regsave_sa.py +61 -0
  2182. package/runtime/Lib/site-packages/win32/Demos/security/regsecurity.py +36 -0
  2183. package/runtime/Lib/site-packages/win32/Demos/security/sa_inherit.py +8 -0
  2184. package/runtime/Lib/site-packages/win32/Demos/security/security_enums.py +336 -0
  2185. package/runtime/Lib/site-packages/win32/Demos/security/set_file_audit.py +106 -0
  2186. package/runtime/Lib/site-packages/win32/Demos/security/set_file_owner.py +73 -0
  2187. package/runtime/Lib/site-packages/win32/Demos/security/set_policy_info.py +25 -0
  2188. package/runtime/Lib/site-packages/win32/Demos/security/setkernelobjectsecurity.py +134 -0
  2189. package/runtime/Lib/site-packages/win32/Demos/security/setnamedsecurityinfo.py +131 -0
  2190. package/runtime/Lib/site-packages/win32/Demos/security/setsecurityinfo.py +131 -0
  2191. package/runtime/Lib/site-packages/win32/Demos/security/setuserobjectsecurity.py +102 -0
  2192. package/runtime/Lib/site-packages/win32/Demos/security/sspi/fetch_url.py +158 -0
  2193. package/runtime/Lib/site-packages/win32/Demos/security/sspi/simple_auth.py +72 -0
  2194. package/runtime/Lib/site-packages/win32/Demos/security/sspi/socket_server.py +199 -0
  2195. package/runtime/Lib/site-packages/win32/Demos/security/sspi/validate_password.py +41 -0
  2196. package/runtime/Lib/site-packages/win32/Demos/service/nativePipeTestService.py +63 -0
  2197. package/runtime/Lib/site-packages/win32/Demos/service/pipeTestService.py +185 -0
  2198. package/runtime/Lib/site-packages/win32/Demos/service/pipeTestServiceClient.py +158 -0
  2199. package/runtime/Lib/site-packages/win32/Demos/service/serviceEvents.py +98 -0
  2200. package/runtime/Lib/site-packages/win32/Demos/timer_demo.py +72 -0
  2201. package/runtime/Lib/site-packages/win32/Demos/win32clipboardDemo.py +155 -0
  2202. package/runtime/Lib/site-packages/win32/Demos/win32clipboard_bitmapdemo.py +117 -0
  2203. package/runtime/Lib/site-packages/win32/Demos/win32comport_demo.py +174 -0
  2204. package/runtime/Lib/site-packages/win32/Demos/win32console_demo.py +132 -0
  2205. package/runtime/Lib/site-packages/win32/Demos/win32cred_demo.py +82 -0
  2206. package/runtime/Lib/site-packages/win32/Demos/win32fileDemo.py +41 -0
  2207. package/runtime/Lib/site-packages/win32/Demos/win32gui_demo.py +177 -0
  2208. package/runtime/Lib/site-packages/win32/Demos/win32gui_devicenotify.py +106 -0
  2209. package/runtime/Lib/site-packages/win32/Demos/win32gui_dialog.py +445 -0
  2210. package/runtime/Lib/site-packages/win32/Demos/win32gui_menu.py +464 -0
  2211. package/runtime/Lib/site-packages/win32/Demos/win32gui_taskbar.py +136 -0
  2212. package/runtime/Lib/site-packages/win32/Demos/win32netdemo.py +272 -0
  2213. package/runtime/Lib/site-packages/win32/Demos/win32rcparser_demo.py +86 -0
  2214. package/runtime/Lib/site-packages/win32/Demos/win32servicedemo.py +23 -0
  2215. package/runtime/Lib/site-packages/win32/Demos/win32ts_logoff_disconnected.py +25 -0
  2216. package/runtime/Lib/site-packages/win32/Demos/win32wnet/testwnet.py +123 -0
  2217. package/runtime/Lib/site-packages/win32/Demos/win32wnet/winnetwk.py +100 -0
  2218. package/runtime/Lib/site-packages/win32/Demos/winprocess.py +230 -0
  2219. package/runtime/Lib/site-packages/win32/_win32sysloader.pyd +0 -0
  2220. package/runtime/Lib/site-packages/win32/_winxptheme.pyd +0 -0
  2221. package/runtime/Lib/site-packages/win32/include/PyWinTypes.h +739 -0
  2222. package/runtime/Lib/site-packages/win32/lib/_win32verstamp_pywin32ctypes.py +164 -0
  2223. package/runtime/Lib/site-packages/win32/lib/afxres.py +9 -0
  2224. package/runtime/Lib/site-packages/win32/lib/commctrl.py +1551 -0
  2225. package/runtime/Lib/site-packages/win32/lib/mmsystem.py +956 -0
  2226. package/runtime/Lib/site-packages/win32/lib/netbios.py +293 -0
  2227. package/runtime/Lib/site-packages/win32/lib/ntsecuritycon.py +731 -0
  2228. package/runtime/Lib/site-packages/win32/lib/pywin32_bootstrap.py +21 -0
  2229. package/runtime/Lib/site-packages/win32/lib/pywin32_testutil.py +291 -0
  2230. package/runtime/Lib/site-packages/win32/lib/pywintypes.py +124 -0
  2231. package/runtime/Lib/site-packages/win32/lib/rasutil.py +40 -0
  2232. package/runtime/Lib/site-packages/win32/lib/regcheck.py +162 -0
  2233. package/runtime/Lib/site-packages/win32/lib/regutil.py +395 -0
  2234. package/runtime/Lib/site-packages/win32/lib/sspi.py +413 -0
  2235. package/runtime/Lib/site-packages/win32/lib/sspicon.py +477 -0
  2236. package/runtime/Lib/site-packages/win32/lib/win2kras.py +14 -0
  2237. package/runtime/Lib/site-packages/win32/lib/win32con.py +5066 -0
  2238. package/runtime/Lib/site-packages/win32/lib/win32cryptcon.py +1922 -0
  2239. package/runtime/Lib/site-packages/win32/lib/win32evtlogutil.py +225 -0
  2240. package/runtime/Lib/site-packages/win32/lib/win32gui_struct.py +961 -0
  2241. package/runtime/Lib/site-packages/win32/lib/win32inetcon.py +1086 -0
  2242. package/runtime/Lib/site-packages/win32/lib/win32netcon.py +627 -0
  2243. package/runtime/Lib/site-packages/win32/lib/win32pdhquery.py +570 -0
  2244. package/runtime/Lib/site-packages/win32/lib/win32pdhutil.py +212 -0
  2245. package/runtime/Lib/site-packages/win32/lib/win32rcparser.py +674 -0
  2246. package/runtime/Lib/site-packages/win32/lib/win32serviceutil.py +1077 -0
  2247. package/runtime/Lib/site-packages/win32/lib/win32timezone.py +1201 -0
  2248. package/runtime/Lib/site-packages/win32/lib/win32traceutil.py +59 -0
  2249. package/runtime/Lib/site-packages/win32/lib/win32verstamp.py +235 -0
  2250. package/runtime/Lib/site-packages/win32/lib/winerror.py +7361 -0
  2251. package/runtime/Lib/site-packages/win32/lib/winioctlcon.py +1079 -0
  2252. package/runtime/Lib/site-packages/win32/lib/winnt.py +1347 -0
  2253. package/runtime/Lib/site-packages/win32/lib/winperf.py +236 -0
  2254. package/runtime/Lib/site-packages/win32/lib/winxptheme.py +8 -0
  2255. package/runtime/Lib/site-packages/win32/libs/pywintypes.lib +0 -0
  2256. package/runtime/Lib/site-packages/win32/license.txt +30 -0
  2257. package/runtime/Lib/site-packages/win32/mmapfile.pyd +0 -0
  2258. package/runtime/Lib/site-packages/win32/odbc.pyd +0 -0
  2259. package/runtime/Lib/site-packages/win32/perfmon.pyd +0 -0
  2260. package/runtime/Lib/site-packages/win32/perfmondata.dll +0 -0
  2261. package/runtime/Lib/site-packages/win32/pythonservice.exe +0 -0
  2262. package/runtime/Lib/site-packages/win32/scripts/ControlService.py +594 -0
  2263. package/runtime/Lib/site-packages/win32/scripts/VersionStamp/BrandProject.py +97 -0
  2264. package/runtime/Lib/site-packages/win32/scripts/VersionStamp/bulkstamp.py +156 -0
  2265. package/runtime/Lib/site-packages/win32/scripts/VersionStamp/vssutil.py +201 -0
  2266. package/runtime/Lib/site-packages/win32/scripts/backupEventLog.py +46 -0
  2267. package/runtime/Lib/site-packages/win32/scripts/h2py.py +194 -0
  2268. package/runtime/Lib/site-packages/win32/scripts/killProcName.py +62 -0
  2269. package/runtime/Lib/site-packages/win32/scripts/pywin32_postinstall.py +733 -0
  2270. package/runtime/Lib/site-packages/win32/scripts/pywin32_testall.py +120 -0
  2271. package/runtime/Lib/site-packages/win32/scripts/rasutil.py +98 -0
  2272. package/runtime/Lib/site-packages/win32/scripts/regsetup.py +607 -0
  2273. package/runtime/Lib/site-packages/win32/scripts/setup_d.py +111 -0
  2274. package/runtime/Lib/site-packages/win32/servicemanager.pyd +0 -0
  2275. package/runtime/Lib/site-packages/win32/test/handles.py +175 -0
  2276. package/runtime/Lib/site-packages/win32/test/test_clipboard.py +137 -0
  2277. package/runtime/Lib/site-packages/win32/test/test_exceptions.py +213 -0
  2278. package/runtime/Lib/site-packages/win32/test/test_odbc.py +264 -0
  2279. package/runtime/Lib/site-packages/win32/test/test_pywintypes.py +111 -0
  2280. package/runtime/Lib/site-packages/win32/test/test_security.py +166 -0
  2281. package/runtime/Lib/site-packages/win32/test/test_sspi.py +229 -0
  2282. package/runtime/Lib/site-packages/win32/test/test_win32api.py +273 -0
  2283. package/runtime/Lib/site-packages/win32/test/test_win32clipboard.py +59 -0
  2284. package/runtime/Lib/site-packages/win32/test/test_win32cred.py +91 -0
  2285. package/runtime/Lib/site-packages/win32/test/test_win32crypt.py +144 -0
  2286. package/runtime/Lib/site-packages/win32/test/test_win32event.py +119 -0
  2287. package/runtime/Lib/site-packages/win32/test/test_win32file.py +1097 -0
  2288. package/runtime/Lib/site-packages/win32/test/test_win32gui.py +188 -0
  2289. package/runtime/Lib/site-packages/win32/test/test_win32guistruct.py +333 -0
  2290. package/runtime/Lib/site-packages/win32/test/test_win32inet.py +108 -0
  2291. package/runtime/Lib/site-packages/win32/test/test_win32net.py +23 -0
  2292. package/runtime/Lib/site-packages/win32/test/test_win32pipe.py +148 -0
  2293. package/runtime/Lib/site-packages/win32/test/test_win32print.py +24 -0
  2294. package/runtime/Lib/site-packages/win32/test/test_win32profile.py +19 -0
  2295. package/runtime/Lib/site-packages/win32/test/test_win32rcparser.py +70 -0
  2296. package/runtime/Lib/site-packages/win32/test/test_win32timezone.py +16 -0
  2297. package/runtime/Lib/site-packages/win32/test/test_win32trace.py +366 -0
  2298. package/runtime/Lib/site-packages/win32/test/test_win32ts.py +19 -0
  2299. package/runtime/Lib/site-packages/win32/test/test_win32wnet.py +174 -0
  2300. package/runtime/Lib/site-packages/win32/test/testall.py +223 -0
  2301. package/runtime/Lib/site-packages/win32/test/win32rcparser/python.bmp +0 -0
  2302. package/runtime/Lib/site-packages/win32/test/win32rcparser/python.ico +0 -0
  2303. package/runtime/Lib/site-packages/win32/test/win32rcparser/test.h +46 -0
  2304. package/runtime/Lib/site-packages/win32/test/win32rcparser/test.rc +215 -0
  2305. package/runtime/Lib/site-packages/win32/timer.pyd +0 -0
  2306. package/runtime/Lib/site-packages/win32/win32api.pyd +0 -0
  2307. package/runtime/Lib/site-packages/win32/win32clipboard.pyd +0 -0
  2308. package/runtime/Lib/site-packages/win32/win32console.pyd +0 -0
  2309. package/runtime/Lib/site-packages/win32/win32cred.pyd +0 -0
  2310. package/runtime/Lib/site-packages/win32/win32crypt.pyd +0 -0
  2311. package/runtime/Lib/site-packages/win32/win32event.pyd +0 -0
  2312. package/runtime/Lib/site-packages/win32/win32evtlog.pyd +0 -0
  2313. package/runtime/Lib/site-packages/win32/win32file.pyd +0 -0
  2314. package/runtime/Lib/site-packages/win32/win32gui.pyd +0 -0
  2315. package/runtime/Lib/site-packages/win32/win32help.pyd +0 -0
  2316. package/runtime/Lib/site-packages/win32/win32inet.pyd +0 -0
  2317. package/runtime/Lib/site-packages/win32/win32job.pyd +0 -0
  2318. package/runtime/Lib/site-packages/win32/win32lz.pyd +0 -0
  2319. package/runtime/Lib/site-packages/win32/win32net.pyd +0 -0
  2320. package/runtime/Lib/site-packages/win32/win32pdh.pyd +0 -0
  2321. package/runtime/Lib/site-packages/win32/win32pipe.pyd +0 -0
  2322. package/runtime/Lib/site-packages/win32/win32print.pyd +0 -0
  2323. package/runtime/Lib/site-packages/win32/win32process.pyd +0 -0
  2324. package/runtime/Lib/site-packages/win32/win32profile.pyd +0 -0
  2325. package/runtime/Lib/site-packages/win32/win32ras.pyd +0 -0
  2326. package/runtime/Lib/site-packages/win32/win32security.pyd +0 -0
  2327. package/runtime/Lib/site-packages/win32/win32service.pyd +0 -0
  2328. package/runtime/Lib/site-packages/win32/win32trace.pyd +0 -0
  2329. package/runtime/Lib/site-packages/win32/win32transaction.pyd +0 -0
  2330. package/runtime/Lib/site-packages/win32/win32ts.pyd +0 -0
  2331. package/runtime/Lib/site-packages/win32/win32wnet.pyd +0 -0
  2332. package/runtime/Lib/site-packages/win32/winxpgui.py +13 -0
  2333. package/runtime/Lib/site-packages/win32com/HTML/COM_Records.html +382 -0
  2334. package/runtime/Lib/site-packages/win32com/HTML/GeneratedSupport.html +104 -0
  2335. package/runtime/Lib/site-packages/win32com/HTML/PythonCOM.html +90 -0
  2336. package/runtime/Lib/site-packages/win32com/HTML/QuickStartClientCom.html +82 -0
  2337. package/runtime/Lib/site-packages/win32com/HTML/QuickStartServerCom.html +195 -0
  2338. package/runtime/Lib/site-packages/win32com/HTML/docindex.html +23 -0
  2339. package/runtime/Lib/site-packages/win32com/HTML/image/BTN_HomePage.gif +0 -0
  2340. package/runtime/Lib/site-packages/win32com/HTML/image/BTN_ManualTop.gif +0 -0
  2341. package/runtime/Lib/site-packages/win32com/HTML/image/BTN_NextPage.gif +0 -0
  2342. package/runtime/Lib/site-packages/win32com/HTML/image/BTN_PrevPage.gif +0 -0
  2343. package/runtime/Lib/site-packages/win32com/HTML/image/blank.gif +0 -0
  2344. package/runtime/Lib/site-packages/win32com/HTML/image/pycom_blowing.gif +0 -0
  2345. package/runtime/Lib/site-packages/win32com/HTML/image/pythoncom.gif +0 -0
  2346. package/runtime/Lib/site-packages/win32com/HTML/image/www_icon.gif +0 -0
  2347. package/runtime/Lib/site-packages/win32com/HTML/index.html +31 -0
  2348. package/runtime/Lib/site-packages/win32com/HTML/misc.html +18 -0
  2349. package/runtime/Lib/site-packages/win32com/HTML/package.html +37 -0
  2350. package/runtime/Lib/site-packages/win32com/HTML/variant.html +162 -0
  2351. package/runtime/Lib/site-packages/win32com/License.txt +30 -0
  2352. package/runtime/Lib/site-packages/win32com/__init__.py +134 -0
  2353. package/runtime/Lib/site-packages/win32com/client/CLSIDToClass.py +60 -0
  2354. package/runtime/Lib/site-packages/win32com/client/__init__.py +703 -0
  2355. package/runtime/Lib/site-packages/win32com/client/build.py +774 -0
  2356. package/runtime/Lib/site-packages/win32com/client/combrowse.py +605 -0
  2357. package/runtime/Lib/site-packages/win32com/client/connect.py +48 -0
  2358. package/runtime/Lib/site-packages/win32com/client/dynamic.py +699 -0
  2359. package/runtime/Lib/site-packages/win32com/client/gencache.py +825 -0
  2360. package/runtime/Lib/site-packages/win32com/client/genpy.py +1352 -0
  2361. package/runtime/Lib/site-packages/win32com/client/makepy.py +453 -0
  2362. package/runtime/Lib/site-packages/win32com/client/selecttlb.py +182 -0
  2363. package/runtime/Lib/site-packages/win32com/client/tlbrowse.py +277 -0
  2364. package/runtime/Lib/site-packages/win32com/client/util.py +103 -0
  2365. package/runtime/Lib/site-packages/win32com/demos/__init__.py +0 -0
  2366. package/runtime/Lib/site-packages/win32com/demos/connect.py +97 -0
  2367. package/runtime/Lib/site-packages/win32com/demos/dump_clipboard.py +74 -0
  2368. package/runtime/Lib/site-packages/win32com/demos/eventsApartmentThreaded.py +98 -0
  2369. package/runtime/Lib/site-packages/win32com/demos/eventsFreeThreaded.py +92 -0
  2370. package/runtime/Lib/site-packages/win32com/demos/excelAddin.py +169 -0
  2371. package/runtime/Lib/site-packages/win32com/demos/excelRTDServer.py +434 -0
  2372. package/runtime/Lib/site-packages/win32com/demos/iebutton.py +214 -0
  2373. package/runtime/Lib/site-packages/win32com/demos/ietoolbar.py +368 -0
  2374. package/runtime/Lib/site-packages/win32com/demos/outlookAddin.py +135 -0
  2375. package/runtime/Lib/site-packages/win32com/demos/trybag.py +78 -0
  2376. package/runtime/Lib/site-packages/win32com/include/PythonCOM.h +746 -0
  2377. package/runtime/Lib/site-packages/win32com/include/PythonCOMRegister.h +56 -0
  2378. package/runtime/Lib/site-packages/win32com/include/PythonCOMServer.h +167 -0
  2379. package/runtime/Lib/site-packages/win32com/libs/axscript.lib +0 -0
  2380. package/runtime/Lib/site-packages/win32com/libs/pythoncom.lib +0 -0
  2381. package/runtime/Lib/site-packages/win32com/makegw/__init__.py +1 -0
  2382. package/runtime/Lib/site-packages/win32com/makegw/makegw.py +618 -0
  2383. package/runtime/Lib/site-packages/win32com/makegw/makegwenum.py +331 -0
  2384. package/runtime/Lib/site-packages/win32com/makegw/makegwparse.py +1017 -0
  2385. package/runtime/Lib/site-packages/win32com/olectl.py +70 -0
  2386. package/runtime/Lib/site-packages/win32com/readme.html +87 -0
  2387. package/runtime/Lib/site-packages/win32com/server/__init__.py +1 -0
  2388. package/runtime/Lib/site-packages/win32com/server/connect.py +85 -0
  2389. package/runtime/Lib/site-packages/win32com/server/dispatcher.py +239 -0
  2390. package/runtime/Lib/site-packages/win32com/server/exception.py +99 -0
  2391. package/runtime/Lib/site-packages/win32com/server/factory.py +26 -0
  2392. package/runtime/Lib/site-packages/win32com/server/localserver.py +53 -0
  2393. package/runtime/Lib/site-packages/win32com/server/policy.py +803 -0
  2394. package/runtime/Lib/site-packages/win32com/server/register.py +677 -0
  2395. package/runtime/Lib/site-packages/win32com/server/util.py +229 -0
  2396. package/runtime/Lib/site-packages/win32com/servers/PythonTools.py +47 -0
  2397. package/runtime/Lib/site-packages/win32com/servers/__init__.py +0 -0
  2398. package/runtime/Lib/site-packages/win32com/servers/dictionary.py +133 -0
  2399. package/runtime/Lib/site-packages/win32com/servers/interp.py +59 -0
  2400. package/runtime/Lib/site-packages/win32com/servers/perfmon.py +36 -0
  2401. package/runtime/Lib/site-packages/win32com/servers/test_pycomtest.py +181 -0
  2402. package/runtime/Lib/site-packages/win32com/storagecon.py +142 -0
  2403. package/runtime/Lib/site-packages/win32com/test/GenTestScripts.py +95 -0
  2404. package/runtime/Lib/site-packages/win32com/test/Testpys.sct +63 -0
  2405. package/runtime/Lib/site-packages/win32com/test/__init__.py +1 -0
  2406. package/runtime/Lib/site-packages/win32com/test/daodump.py +88 -0
  2407. package/runtime/Lib/site-packages/win32com/test/errorSemantics.py +243 -0
  2408. package/runtime/Lib/site-packages/win32com/test/pippo.idl +66 -0
  2409. package/runtime/Lib/site-packages/win32com/test/pippo_server.py +96 -0
  2410. package/runtime/Lib/site-packages/win32com/test/policySemantics.py +115 -0
  2411. package/runtime/Lib/site-packages/win32com/test/readme.txt +19 -0
  2412. package/runtime/Lib/site-packages/win32com/test/testADOEvents.py +100 -0
  2413. package/runtime/Lib/site-packages/win32com/test/testAXScript.py +44 -0
  2414. package/runtime/Lib/site-packages/win32com/test/testAccess.py +185 -0
  2415. package/runtime/Lib/site-packages/win32com/test/testArrays.py +99 -0
  2416. package/runtime/Lib/site-packages/win32com/test/testClipboard.py +169 -0
  2417. package/runtime/Lib/site-packages/win32com/test/testCollections.py +159 -0
  2418. package/runtime/Lib/site-packages/win32com/test/testConversionErrors.py +35 -0
  2419. package/runtime/Lib/site-packages/win32com/test/testDCOM.py +50 -0
  2420. package/runtime/Lib/site-packages/win32com/test/testDates.py +74 -0
  2421. package/runtime/Lib/site-packages/win32com/test/testDictionary.py +101 -0
  2422. package/runtime/Lib/site-packages/win32com/test/testDictionary.vbs +24 -0
  2423. package/runtime/Lib/site-packages/win32com/test/testDynamic.py +84 -0
  2424. package/runtime/Lib/site-packages/win32com/test/testExchange.py +121 -0
  2425. package/runtime/Lib/site-packages/win32com/test/testExplorer.py +139 -0
  2426. package/runtime/Lib/site-packages/win32com/test/testGIT.py +142 -0
  2427. package/runtime/Lib/site-packages/win32com/test/testGatewayAddresses.py +149 -0
  2428. package/runtime/Lib/site-packages/win32com/test/testInterp.vbs +11 -0
  2429. package/runtime/Lib/site-packages/win32com/test/testIterators.py +140 -0
  2430. package/runtime/Lib/site-packages/win32com/test/testMSOffice.py +184 -0
  2431. package/runtime/Lib/site-packages/win32com/test/testMSOfficeEvents.py +138 -0
  2432. package/runtime/Lib/site-packages/win32com/test/testMarshal.py +164 -0
  2433. package/runtime/Lib/site-packages/win32com/test/testPersist.py +227 -0
  2434. package/runtime/Lib/site-packages/win32com/test/testPippo.py +80 -0
  2435. package/runtime/Lib/site-packages/win32com/test/testPyComTest.py +963 -0
  2436. package/runtime/Lib/site-packages/win32com/test/testPyScriptlet.js +33 -0
  2437. package/runtime/Lib/site-packages/win32com/test/testROT.py +29 -0
  2438. package/runtime/Lib/site-packages/win32com/test/testServers.py +51 -0
  2439. package/runtime/Lib/site-packages/win32com/test/testShell.py +272 -0
  2440. package/runtime/Lib/site-packages/win32com/test/testStorage.py +88 -0
  2441. package/runtime/Lib/site-packages/win32com/test/testStreams.py +147 -0
  2442. package/runtime/Lib/site-packages/win32com/test/testWMI.py +18 -0
  2443. package/runtime/Lib/site-packages/win32com/test/testall.py +321 -0
  2444. package/runtime/Lib/site-packages/win32com/test/testmakepy.py +54 -0
  2445. package/runtime/Lib/site-packages/win32com/test/testvb.py +578 -0
  2446. package/runtime/Lib/site-packages/win32com/test/testvbscript_regexp.py +40 -0
  2447. package/runtime/Lib/site-packages/win32com/test/testxslt.js +12 -0
  2448. package/runtime/Lib/site-packages/win32com/test/testxslt.py +34 -0
  2449. package/runtime/Lib/site-packages/win32com/test/testxslt.xsl +54 -0
  2450. package/runtime/Lib/site-packages/win32com/test/util.py +262 -0
  2451. package/runtime/Lib/site-packages/win32com/universal.py +224 -0
  2452. package/runtime/Lib/site-packages/win32com/util.py +35 -0
  2453. package/runtime/Lib/site-packages/win32comext/adsi/__init__.py +113 -0
  2454. package/runtime/Lib/site-packages/win32comext/adsi/adsi.pyd +0 -0
  2455. package/runtime/Lib/site-packages/win32comext/adsi/adsicon.py +340 -0
  2456. package/runtime/Lib/site-packages/win32comext/adsi/demos/objectPicker.py +68 -0
  2457. package/runtime/Lib/site-packages/win32comext/adsi/demos/scp.py +565 -0
  2458. package/runtime/Lib/site-packages/win32comext/adsi/demos/search.py +151 -0
  2459. package/runtime/Lib/site-packages/win32comext/adsi/demos/test.py +274 -0
  2460. package/runtime/Lib/site-packages/win32comext/authorization/__init__.py +6 -0
  2461. package/runtime/Lib/site-packages/win32comext/authorization/authorization.pyd +0 -0
  2462. package/runtime/Lib/site-packages/win32comext/authorization/demos/EditSecurity.py +229 -0
  2463. package/runtime/Lib/site-packages/win32comext/authorization/demos/EditServiceSecurity.py +219 -0
  2464. package/runtime/Lib/site-packages/win32comext/axcontrol/__init__.py +4 -0
  2465. package/runtime/Lib/site-packages/win32comext/axcontrol/axcontrol.pyd +0 -0
  2466. package/runtime/Lib/site-packages/win32comext/axdebug/__init__.py +4 -0
  2467. package/runtime/Lib/site-packages/win32comext/axdebug/adb.py +467 -0
  2468. package/runtime/Lib/site-packages/win32comext/axdebug/codecontainer.py +279 -0
  2469. package/runtime/Lib/site-packages/win32comext/axdebug/contexts.py +58 -0
  2470. package/runtime/Lib/site-packages/win32comext/axdebug/debugger.py +238 -0
  2471. package/runtime/Lib/site-packages/win32comext/axdebug/documents.py +135 -0
  2472. package/runtime/Lib/site-packages/win32comext/axdebug/dump.py +57 -0
  2473. package/runtime/Lib/site-packages/win32comext/axdebug/expressions.py +212 -0
  2474. package/runtime/Lib/site-packages/win32comext/axdebug/gateways.py +583 -0
  2475. package/runtime/Lib/site-packages/win32comext/axdebug/stackframe.py +178 -0
  2476. package/runtime/Lib/site-packages/win32comext/axdebug/util.py +98 -0
  2477. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/asp/CreateObject.asp +18 -0
  2478. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/asp/caps.asp +52 -0
  2479. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/asp/interrupt/test.asp +4 -0
  2480. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/asp/interrupt/test.html +10 -0
  2481. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/asp/interrupt/test1.asp +6 -0
  2482. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/asp/interrupt/test1.html +10 -0
  2483. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/asp/tut1.asp +10 -0
  2484. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/CHARTPY.HTM +179 -0
  2485. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/FOO.HTM +46 -0
  2486. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/MarqueeText1.htm +24 -0
  2487. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/calc.htm +115 -0
  2488. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/dbgtest.htm +16 -0
  2489. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/demo.htm +25 -0
  2490. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/demo_check.htm +39 -0
  2491. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/demo_intro.htm +37 -0
  2492. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/demo_menu.htm +14 -0
  2493. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/docwrite.htm +25 -0
  2494. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/foo2.htm +105 -0
  2495. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/form.htm +25 -0
  2496. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/marqueeDemo.htm +59 -0
  2497. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/mousetrack.htm +82 -0
  2498. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/ie/pycom_blowing.gif +0 -0
  2499. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/wsh/blank.pys +0 -0
  2500. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/wsh/excel.pys +31 -0
  2501. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/wsh/registry.pys +44 -0
  2502. package/runtime/Lib/site-packages/win32comext/axscript/Demos/client/wsh/test.pys +14 -0
  2503. package/runtime/Lib/site-packages/win32comext/axscript/__init__.py +4 -0
  2504. package/runtime/Lib/site-packages/win32comext/axscript/asputil.py +13 -0
  2505. package/runtime/Lib/site-packages/win32comext/axscript/axscript.pyd +0 -0
  2506. package/runtime/Lib/site-packages/win32comext/axscript/client/__init__.py +1 -0
  2507. package/runtime/Lib/site-packages/win32comext/axscript/client/debug.py +223 -0
  2508. package/runtime/Lib/site-packages/win32comext/axscript/client/error.py +260 -0
  2509. package/runtime/Lib/site-packages/win32comext/axscript/client/framework.py +1291 -0
  2510. package/runtime/Lib/site-packages/win32comext/axscript/client/pydumper.py +78 -0
  2511. package/runtime/Lib/site-packages/win32comext/axscript/client/pyscript.py +438 -0
  2512. package/runtime/Lib/site-packages/win32comext/axscript/client/pyscript_rexec.py +54 -0
  2513. package/runtime/Lib/site-packages/win32comext/axscript/client/scriptdispatch.py +103 -0
  2514. package/runtime/Lib/site-packages/win32comext/axscript/server/__init__.py +0 -0
  2515. package/runtime/Lib/site-packages/win32comext/axscript/server/axsite.py +145 -0
  2516. package/runtime/Lib/site-packages/win32comext/axscript/test/debugTest.pys +16 -0
  2517. package/runtime/Lib/site-packages/win32comext/axscript/test/debugTest.vbs +7 -0
  2518. package/runtime/Lib/site-packages/win32comext/axscript/test/leakTest.py +186 -0
  2519. package/runtime/Lib/site-packages/win32comext/axscript/test/testHost.py +241 -0
  2520. package/runtime/Lib/site-packages/win32comext/axscript/test/testHost4Dbg.py +83 -0
  2521. package/runtime/Lib/site-packages/win32comext/bits/__init__.py +6 -0
  2522. package/runtime/Lib/site-packages/win32comext/bits/bits.pyd +0 -0
  2523. package/runtime/Lib/site-packages/win32comext/bits/test/show_all_jobs.py +48 -0
  2524. package/runtime/Lib/site-packages/win32comext/bits/test/test_bits.py +119 -0
  2525. package/runtime/Lib/site-packages/win32comext/directsound/__init__.py +4 -0
  2526. package/runtime/Lib/site-packages/win32comext/directsound/directsound.pyd +0 -0
  2527. package/runtime/Lib/site-packages/win32comext/directsound/test/__init__.py +1 -0
  2528. package/runtime/Lib/site-packages/win32comext/directsound/test/ds_record.py +60 -0
  2529. package/runtime/Lib/site-packages/win32comext/directsound/test/ds_test.py +402 -0
  2530. package/runtime/Lib/site-packages/win32comext/ifilter/__init__.py +1 -0
  2531. package/runtime/Lib/site-packages/win32comext/ifilter/demo/filterDemo.py +300 -0
  2532. package/runtime/Lib/site-packages/win32comext/ifilter/ifilter.pyd +0 -0
  2533. package/runtime/Lib/site-packages/win32comext/ifilter/ifiltercon.py +110 -0
  2534. package/runtime/Lib/site-packages/win32comext/internet/__init__.py +4 -0
  2535. package/runtime/Lib/site-packages/win32comext/internet/inetcon.py +261 -0
  2536. package/runtime/Lib/site-packages/win32comext/internet/internet.pyd +0 -0
  2537. package/runtime/Lib/site-packages/win32comext/propsys/__init__.py +1 -0
  2538. package/runtime/Lib/site-packages/win32comext/propsys/propsys.pyd +0 -0
  2539. package/runtime/Lib/site-packages/win32comext/propsys/pscon.py +839 -0
  2540. package/runtime/Lib/site-packages/win32comext/propsys/test/testpropsys.py +5 -0
  2541. package/runtime/Lib/site-packages/win32comext/shell/__init__.py +4 -0
  2542. package/runtime/Lib/site-packages/win32comext/shell/demos/IActiveDesktop.py +83 -0
  2543. package/runtime/Lib/site-packages/win32comext/shell/demos/IFileOperationProgressSink.py +179 -0
  2544. package/runtime/Lib/site-packages/win32comext/shell/demos/IShellLinkDataList.py +67 -0
  2545. package/runtime/Lib/site-packages/win32comext/shell/demos/ITransferAdviseSink.py +93 -0
  2546. package/runtime/Lib/site-packages/win32comext/shell/demos/IUniformResourceLocator.py +56 -0
  2547. package/runtime/Lib/site-packages/win32comext/shell/demos/browse_for_folder.py +45 -0
  2548. package/runtime/Lib/site-packages/win32comext/shell/demos/create_link.py +73 -0
  2549. package/runtime/Lib/site-packages/win32comext/shell/demos/dump_link.py +58 -0
  2550. package/runtime/Lib/site-packages/win32comext/shell/demos/explorer_browser.py +143 -0
  2551. package/runtime/Lib/site-packages/win32comext/shell/demos/servers/column_provider.py +125 -0
  2552. package/runtime/Lib/site-packages/win32comext/shell/demos/servers/context_menu.py +122 -0
  2553. package/runtime/Lib/site-packages/win32comext/shell/demos/servers/copy_hook.py +84 -0
  2554. package/runtime/Lib/site-packages/win32comext/shell/demos/servers/empty_volume_cache.py +188 -0
  2555. package/runtime/Lib/site-packages/win32comext/shell/demos/servers/folder_view.py +866 -0
  2556. package/runtime/Lib/site-packages/win32comext/shell/demos/servers/icon_handler.py +81 -0
  2557. package/runtime/Lib/site-packages/win32comext/shell/demos/servers/shell_view.py +971 -0
  2558. package/runtime/Lib/site-packages/win32comext/shell/demos/shellexecuteex.py +19 -0
  2559. package/runtime/Lib/site-packages/win32comext/shell/demos/viewstate.py +68 -0
  2560. package/runtime/Lib/site-packages/win32comext/shell/demos/walk_shell_folders.py +24 -0
  2561. package/runtime/Lib/site-packages/win32comext/shell/shell.pyd +0 -0
  2562. package/runtime/Lib/site-packages/win32comext/shell/shellcon.py +1615 -0
  2563. package/runtime/Lib/site-packages/win32comext/shell/test/testSHFileOperation.py +75 -0
  2564. package/runtime/Lib/site-packages/win32comext/shell/test/testShellFolder.py +21 -0
  2565. package/runtime/Lib/site-packages/win32comext/shell/test/testShellItem.py +69 -0
  2566. package/runtime/Lib/site-packages/win32comext/taskscheduler/__init__.py +6 -0
  2567. package/runtime/Lib/site-packages/win32comext/taskscheduler/taskscheduler.pyd +0 -0
  2568. package/runtime/Lib/site-packages/win32comext/taskscheduler/test/test_addtask.py +66 -0
  2569. package/runtime/Lib/site-packages/win32comext/taskscheduler/test/test_addtask_1.py +68 -0
  2570. package/runtime/Lib/site-packages/win32comext/taskscheduler/test/test_addtask_2.py +49 -0
  2571. package/runtime/Lib/site-packages/win32comext/taskscheduler/test/test_localsystem.py +3 -0
  2572. package/runtime/Lib/site-packages/yaml/__init__.py +390 -0
  2573. package/runtime/Lib/site-packages/yaml/_yaml.cp313-win_amd64.pyd +0 -0
  2574. package/runtime/Lib/site-packages/yaml/composer.py +139 -0
  2575. package/runtime/Lib/site-packages/yaml/constructor.py +748 -0
  2576. package/runtime/Lib/site-packages/yaml/cyaml.py +101 -0
  2577. package/runtime/Lib/site-packages/yaml/dumper.py +62 -0
  2578. package/runtime/Lib/site-packages/yaml/emitter.py +1137 -0
  2579. package/runtime/Lib/site-packages/yaml/error.py +75 -0
  2580. package/runtime/Lib/site-packages/yaml/events.py +86 -0
  2581. package/runtime/Lib/site-packages/yaml/loader.py +63 -0
  2582. package/runtime/Lib/site-packages/yaml/nodes.py +49 -0
  2583. package/runtime/Lib/site-packages/yaml/parser.py +589 -0
  2584. package/runtime/Lib/site-packages/yaml/reader.py +185 -0
  2585. package/runtime/Lib/site-packages/yaml/representer.py +389 -0
  2586. package/runtime/Lib/site-packages/yaml/resolver.py +227 -0
  2587. package/runtime/Lib/site-packages/yaml/scanner.py +1435 -0
  2588. package/runtime/Lib/site-packages/yaml/serializer.py +111 -0
  2589. package/runtime/Lib/site-packages/yaml/tokens.py +104 -0
  2590. package/runtime/Lib/site-packages/z3/__init__.py +12 -0
  2591. package/runtime/Lib/site-packages/z3/include/z3++.h +4528 -0
  2592. package/runtime/Lib/site-packages/z3/include/z3.h +35 -0
  2593. package/runtime/Lib/site-packages/z3/include/z3_algebraic.h +249 -0
  2594. package/runtime/Lib/site-packages/z3/include/z3_api.h +7463 -0
  2595. package/runtime/Lib/site-packages/z3/include/z3_ast_containers.h +198 -0
  2596. package/runtime/Lib/site-packages/z3/include/z3_fixedpoint.h +382 -0
  2597. package/runtime/Lib/site-packages/z3/include/z3_fpa.h +1346 -0
  2598. package/runtime/Lib/site-packages/z3/include/z3_macros.h +22 -0
  2599. package/runtime/Lib/site-packages/z3/include/z3_optimization.h +377 -0
  2600. package/runtime/Lib/site-packages/z3/include/z3_polynomial.h +52 -0
  2601. package/runtime/Lib/site-packages/z3/include/z3_rcf.h +321 -0
  2602. package/runtime/Lib/site-packages/z3/include/z3_spacer.h +141 -0
  2603. package/runtime/Lib/site-packages/z3/include/z3_v1.h +62 -0
  2604. package/runtime/Lib/site-packages/z3/include/z3_version.h +7 -0
  2605. package/runtime/Lib/site-packages/z3/lib/libz3.dll +0 -0
  2606. package/runtime/Lib/site-packages/z3/z3.py +11780 -0
  2607. package/runtime/Lib/site-packages/z3/z3consts.py +359 -0
  2608. package/runtime/Lib/site-packages/z3/z3core.py +5499 -0
  2609. package/runtime/Lib/site-packages/z3/z3num.py +579 -0
  2610. package/runtime/Lib/site-packages/z3/z3poly.py +37 -0
  2611. package/runtime/Lib/site-packages/z3/z3printer.py +1532 -0
  2612. package/runtime/Lib/site-packages/z3/z3rcf.py +168 -0
  2613. package/runtime/Lib/site-packages/z3/z3types.py +254 -0
  2614. package/runtime/Lib/site-packages/z3/z3util.py +502 -0
  2615. package/runtime/Lib/site-packages/z3_solver-4.13.0.0.dist-info/METADATA +17 -0
  2616. package/runtime/Lib/site-packages/z3_solver-4.13.0.0.dist-info/RECORD +30 -0
  2617. package/runtime/Lib/site-packages/z3_solver-4.13.0.0.dist-info/WHEEL +6 -0
  2618. package/runtime/Lib/site-packages/z3_solver-4.13.0.0.dist-info/top_level.txt +1 -0
  2619. package/runtime/Scripts/pywin32_postinstall.py +733 -0
  2620. package/runtime/Scripts/pywin32_testall.py +120 -0
  2621. package/runtime/_asyncio.pyd +0 -0
  2622. package/runtime/_bz2.pyd +0 -0
  2623. package/runtime/_ctypes.pyd +0 -0
  2624. package/runtime/_decimal.pyd +0 -0
  2625. package/runtime/_elementtree.pyd +0 -0
  2626. package/runtime/_hashlib.pyd +0 -0
  2627. package/runtime/_lzma.pyd +0 -0
  2628. package/runtime/_multiprocessing.pyd +0 -0
  2629. package/runtime/_overlapped.pyd +0 -0
  2630. package/runtime/_queue.pyd +0 -0
  2631. package/runtime/_socket.pyd +0 -0
  2632. package/runtime/_sqlite3.pyd +0 -0
  2633. package/runtime/_ssl.pyd +0 -0
  2634. package/runtime/_uuid.pyd +0 -0
  2635. package/runtime/_wmi.pyd +0 -0
  2636. package/runtime/_zoneinfo.pyd +0 -0
  2637. package/runtime/bin/z3.exe +0 -0
  2638. package/runtime/libcrypto-3.dll +0 -0
  2639. package/runtime/libffi-8.dll +0 -0
  2640. package/runtime/libssl-3.dll +0 -0
  2641. package/runtime/pyexpat.pyd +0 -0
  2642. package/runtime/python.cat +0 -0
  2643. package/runtime/python.exe +0 -0
  2644. package/runtime/python3.dll +0 -0
  2645. package/runtime/python313._pth +7 -0
  2646. package/runtime/python313.dll +0 -0
  2647. package/runtime/python313.zip +0 -0
  2648. package/runtime/pythonw.exe +0 -0
  2649. package/runtime/select.pyd +0 -0
  2650. package/runtime/sqlite3.dll +0 -0
  2651. package/runtime/unicodedata.pyd +0 -0
  2652. package/runtime/vcruntime140.dll +0 -0
  2653. package/runtime/vcruntime140_1.dll +0 -0
  2654. package/runtime/winsound.pyd +0 -0
  2655. package/runtime-manifest.json +10547 -0
  2656. package/vendor/jsonc-parser/LICENSE.md +21 -0
  2657. package/vendor/jsonc-parser/lib/umd/impl/edit.js +201 -0
  2658. package/vendor/jsonc-parser/lib/umd/impl/format.js +275 -0
  2659. package/vendor/jsonc-parser/lib/umd/impl/parser.js +682 -0
  2660. package/vendor/jsonc-parser/lib/umd/impl/scanner.js +456 -0
  2661. package/vendor/jsonc-parser/lib/umd/impl/string-intern.js +42 -0
  2662. package/vendor/jsonc-parser/lib/umd/main.d.ts +351 -0
  2663. package/vendor/jsonc-parser/lib/umd/main.js +194 -0
  2664. package/vendor/jsonc-parser/package.json +37 -0
@@ -0,0 +1,3799 @@
1
+ from __future__ import annotations
2
+
3
+ import collections.abc as cabc
4
+ import enum
5
+ import errno
6
+ import inspect
7
+ import os
8
+ import sys
9
+ import typing as t
10
+ from abc import ABC
11
+ from abc import abstractmethod
12
+ from collections import abc
13
+ from collections import Counter
14
+ from contextlib import AbstractContextManager
15
+ from contextlib import contextmanager
16
+ from contextlib import ExitStack
17
+ from functools import update_wrapper
18
+ from gettext import gettext as _
19
+ from gettext import ngettext
20
+ from itertools import repeat
21
+ from types import TracebackType
22
+
23
+ from . import types
24
+ from ._utils import FLAG_NEEDS_VALUE
25
+ from ._utils import UNSET
26
+ from .exceptions import Abort
27
+ from .exceptions import BadParameter
28
+ from .exceptions import ClickException
29
+ from .exceptions import Exit
30
+ from .exceptions import MissingParameter
31
+ from .exceptions import NoArgsIsHelpError
32
+ from .exceptions import NoSuchCommand
33
+ from .exceptions import UsageError
34
+ from .formatting import HelpFormatter
35
+ from .formatting import join_options
36
+ from .globals import pop_context
37
+ from .globals import push_context
38
+ from .parser import _OptionParser
39
+ from .parser import _split_opt
40
+ from .termui import confirm
41
+ from .termui import prompt
42
+ from .termui import style
43
+ from .utils import _detect_program_name
44
+ from .utils import _expand_args
45
+ from .utils import _make_default_short_help
46
+ from .utils import _PacifyFlushWrapper
47
+ from .utils import echo
48
+ from .utils import make_str
49
+
50
+ if t.TYPE_CHECKING:
51
+ from typing_extensions import Self
52
+
53
+ from .shell_completion import CompletionItem
54
+
55
+ F = t.TypeVar("F", bound="t.Callable[..., t.Any]")
56
+ V = t.TypeVar("V")
57
+
58
+ # Reserved storage name of the automatic help option. No user parameter is
59
+ # expected to claim it.
60
+ _HELP_OPTION_STORAGE_NAME = "_click_default_help"
61
+
62
+
63
+ def _complete_visible_commands(
64
+ ctx: Context, incomplete: str
65
+ ) -> cabc.Iterator[tuple[str, Command]]:
66
+ """List all the subcommands of a group that start with the
67
+ incomplete value and aren't hidden.
68
+
69
+ :param ctx: Invocation context for the group.
70
+ :param incomplete: Value being completed. May be empty.
71
+ """
72
+ multi = t.cast(Group, ctx.command)
73
+
74
+ for name in multi.list_commands(ctx):
75
+ if name.startswith(incomplete):
76
+ command = multi.get_command(ctx, name)
77
+
78
+ if command is not None and not command.hidden:
79
+ yield name, command
80
+
81
+
82
+ def _check_nested_chain(
83
+ base_command: Group, cmd_name: str, cmd: Command, register: bool = False
84
+ ) -> None:
85
+ if not base_command.chain or not isinstance(cmd, Group):
86
+ return
87
+
88
+ if register:
89
+ message = (
90
+ f"It is not possible to add the group {cmd_name!r} to another"
91
+ f" group {base_command.name!r} that is in chain mode."
92
+ )
93
+ else:
94
+ message = (
95
+ f"Found the group {cmd_name!r} as subcommand to another group "
96
+ f" {base_command.name!r} that is in chain mode. This is not supported."
97
+ )
98
+
99
+ raise RuntimeError(message)
100
+
101
+
102
+ def _format_deprecated_label(deprecated: bool | str) -> str:
103
+ """Return the parenthesized deprecation label shown in help text."""
104
+ label = _("deprecated").upper()
105
+ if isinstance(deprecated, str):
106
+ return f"({label}: {deprecated})"
107
+ return f"({label})"
108
+
109
+
110
+ def _format_deprecated_suffix(deprecated: bool | str) -> str:
111
+ """Return the trailing reason for a ``DeprecationWarning`` message,
112
+ prefixed with a space, or an empty string when no reason was given.
113
+ """
114
+ if isinstance(deprecated, str):
115
+ return f" {deprecated}"
116
+ return ""
117
+
118
+
119
+ def batch(iterable: cabc.Iterable[V], batch_size: int) -> list[tuple[V, ...]]:
120
+ return list(zip(*repeat(iter(iterable), batch_size), strict=False))
121
+
122
+
123
+ @contextmanager
124
+ def augment_usage_errors(
125
+ ctx: Context, param: Parameter | None = None
126
+ ) -> cabc.Generator[None]:
127
+ """Context manager that attaches extra information to exceptions."""
128
+ try:
129
+ yield
130
+ except BadParameter as e:
131
+ if e.ctx is None:
132
+ e.ctx = ctx
133
+ if param is not None and e.param is None:
134
+ e.param = param
135
+ raise
136
+ except UsageError as e:
137
+ if e.ctx is None:
138
+ e.ctx = ctx
139
+ raise
140
+
141
+
142
+ def iter_params_for_processing(
143
+ invocation_order: cabc.Sequence[Parameter],
144
+ declaration_order: cabc.Sequence[Parameter],
145
+ ) -> list[Parameter]:
146
+ """Returns all declared parameters in the order they should be processed.
147
+
148
+ The declared parameters are re-shuffled depending on the order in which
149
+ they were invoked, as well as the eagerness of each parameters.
150
+
151
+ The invocation order takes precedence over the declaration order. I.e. the
152
+ order in which the user provided them to the CLI is respected.
153
+
154
+ This behavior and its effect on callback evaluation is detailed at:
155
+ https://click.palletsprojects.com/en/stable/advanced/#callback-evaluation-order
156
+ """
157
+
158
+ def sort_key(item: Parameter) -> tuple[bool, float]:
159
+ try:
160
+ idx: float = invocation_order.index(item)
161
+ except ValueError:
162
+ idx = float("inf")
163
+
164
+ return not item.is_eager, idx
165
+
166
+ return sorted(declaration_order, key=sort_key)
167
+
168
+
169
+ class ParameterSource(enum.IntEnum):
170
+ """This is an :class:`~enum.IntEnum` that indicates the source of a
171
+ parameter's value.
172
+
173
+ Use :meth:`click.Context.get_parameter_source` to get the
174
+ source for a parameter by name.
175
+
176
+ Members are ordered from most explicit to least explicit source.
177
+ This allows comparison to check if a value was explicitly provided:
178
+
179
+ .. code-block:: python
180
+
181
+ source = ctx.get_parameter_source("port")
182
+ if source < click.ParameterSource.DEFAULT_MAP:
183
+ ... # value was explicitly set
184
+
185
+ .. versionchanged:: 8.3.3
186
+ Use :class:`~enum.IntEnum` and reorder members from most to
187
+ least explicit. Supports comparison operators.
188
+
189
+ .. versionchanged:: 8.0
190
+ Use :class:`~enum.Enum` and drop the ``validate`` method.
191
+
192
+ .. versionchanged:: 8.0
193
+ Added the ``PROMPT`` value.
194
+ """
195
+
196
+ PROMPT = enum.auto()
197
+ """Used a prompt to confirm a default or provide a value."""
198
+ COMMANDLINE = enum.auto()
199
+ """The value was provided by the command line args."""
200
+ ENVIRONMENT = enum.auto()
201
+ """The value was provided with an environment variable."""
202
+ DEFAULT_MAP = enum.auto()
203
+ """Used a default provided by :attr:`Context.default_map`."""
204
+ DEFAULT = enum.auto()
205
+ """Used the default specified by the parameter."""
206
+
207
+
208
+ class Context:
209
+ """The context is a special internal object that holds state relevant
210
+ for the script execution at every single level. It's normally invisible
211
+ to commands unless they opt-in to getting access to it.
212
+
213
+ The context is useful as it can pass internal objects around and can
214
+ control special execution features such as reading data from
215
+ environment variables.
216
+
217
+ A context can be used as context manager in which case it will call
218
+ :meth:`close` on teardown.
219
+
220
+ :param command: the command class for this context.
221
+ :param parent: the parent context.
222
+ :param info_name: the info name for this invocation. Generally this
223
+ is the most descriptive name for the script or
224
+ command. For the toplevel script it is usually
225
+ the name of the script, for commands below that it's
226
+ the name of the script.
227
+ :param obj: an arbitrary object of user data.
228
+ :param auto_envvar_prefix: the prefix to use for automatic environment
229
+ variables. If this is `None` then reading
230
+ from environment variables is disabled. This
231
+ does not affect manually set environment
232
+ variables which are always read.
233
+ :param default_map: a dictionary (like object) with default values
234
+ for parameters.
235
+ :param terminal_width: the width of the terminal. The default is
236
+ inherit from parent context. If no context
237
+ defines the terminal width then auto
238
+ detection will be applied.
239
+ :param max_content_width: the maximum width for content rendered by
240
+ Click (this currently only affects help
241
+ pages). This defaults to 80 characters if
242
+ not overridden. In other words: even if the
243
+ terminal is larger than that, Click will not
244
+ format things wider than 80 characters by
245
+ default. In addition to that, formatters might
246
+ add some safety mapping on the right.
247
+ :param resilient_parsing: if this flag is enabled then Click will
248
+ parse without any interactivity or callback
249
+ invocation. Default values will also be
250
+ ignored. This is useful for implementing
251
+ things such as completion support.
252
+ :param allow_extra_args: if this is set to `True` then extra arguments
253
+ at the end will not raise an error and will be
254
+ kept on the context. The default is to inherit
255
+ from the command.
256
+ :param allow_interspersed_args: if this is set to `False` then options
257
+ and arguments cannot be mixed. The
258
+ default is to inherit from the command.
259
+ :param ignore_unknown_options: instructs click to ignore options it does
260
+ not know and keeps them for later
261
+ processing.
262
+ :param help_option_names: optionally a list of strings that define how
263
+ the default help parameter is named. The
264
+ default is ``['--help']``.
265
+ :param token_normalize_func: an optional function that is used to
266
+ normalize tokens (options, choices,
267
+ etc.). This for instance can be used to
268
+ implement case insensitive behavior.
269
+ :param color: controls if the terminal supports ANSI colors or not. The
270
+ default is autodetection. This is only needed if ANSI
271
+ codes are used in texts that Click prints which is by
272
+ default not the case. This for instance would affect
273
+ help output.
274
+ :param show_default: Show the default value for commands. If this
275
+ value is not set, it defaults to the value from the parent
276
+ context. ``Command.show_default`` overrides this default for the
277
+ specific command.
278
+
279
+ .. versionchanged:: 8.2
280
+ The ``protected_args`` attribute is deprecated and will be removed in
281
+ Click 9.0. ``args`` will contain remaining unparsed tokens.
282
+
283
+ .. versionchanged:: 8.1
284
+ The ``show_default`` parameter is overridden by
285
+ ``Command.show_default``, instead of the other way around.
286
+
287
+ .. versionchanged:: 8.0
288
+ The ``show_default`` parameter defaults to the value from the
289
+ parent context.
290
+
291
+ .. versionchanged:: 7.1
292
+ Added the ``show_default`` parameter.
293
+
294
+ .. versionchanged:: 4.0
295
+ Added the ``color``, ``ignore_unknown_options``, and
296
+ ``max_content_width`` parameters.
297
+
298
+ .. versionchanged:: 3.0
299
+ Added the ``allow_extra_args`` and ``allow_interspersed_args``
300
+ parameters.
301
+
302
+ .. versionchanged:: 2.0
303
+ Added the ``resilient_parsing``, ``help_option_names``, and
304
+ ``token_normalize_func`` parameters.
305
+ """
306
+
307
+ #: The formatter class to create with :meth:`make_formatter`.
308
+ #:
309
+ #: .. versionadded:: 8.0
310
+ formatter_class: type[HelpFormatter] = HelpFormatter
311
+
312
+ parent: Context | None
313
+ command: Command
314
+ info_name: str | None
315
+ params: dict[str, t.Any]
316
+ args: list[str]
317
+ _protected_args: list[str]
318
+ _opt_prefixes: set[str]
319
+ obj: t.Any
320
+ _meta: dict[str, t.Any]
321
+ default_map: cabc.MutableMapping[str, t.Any] | None
322
+ invoked_subcommand: str | None
323
+ terminal_width: int | None
324
+ max_content_width: int | None
325
+ allow_extra_args: bool
326
+ allow_interspersed_args: bool
327
+ ignore_unknown_options: bool
328
+ help_option_names: list[str]
329
+ token_normalize_func: t.Callable[[str], str] | None
330
+ resilient_parsing: bool
331
+ auto_envvar_prefix: str | None
332
+ color: bool | None
333
+ show_default: bool | None
334
+ _close_callbacks: list[t.Callable[[], t.Any]]
335
+ _depth: int
336
+ _parameter_source: dict[str, ParameterSource]
337
+ _param_default_explicit: dict[str, bool]
338
+ _exit_stack: ExitStack
339
+
340
+ def __init__(
341
+ self,
342
+ command: Command,
343
+ parent: Context | None = None,
344
+ info_name: str | None = None,
345
+ obj: t.Any | None = None,
346
+ auto_envvar_prefix: str | None = None,
347
+ default_map: cabc.MutableMapping[str, t.Any] | None = None,
348
+ terminal_width: int | None = None,
349
+ max_content_width: int | None = None,
350
+ resilient_parsing: bool = False,
351
+ allow_extra_args: bool | None = None,
352
+ allow_interspersed_args: bool | None = None,
353
+ ignore_unknown_options: bool | None = None,
354
+ help_option_names: list[str] | None = None,
355
+ token_normalize_func: t.Callable[[str], str] | None = None,
356
+ color: bool | None = None,
357
+ show_default: bool | None = None,
358
+ ) -> None:
359
+ #: the parent context or `None` if none exists.
360
+ self.parent = parent
361
+ #: the :class:`Command` for this context.
362
+ self.command = command
363
+ #: the descriptive information name
364
+ self.info_name = info_name
365
+ #: Map of parameter names to their parsed values. Parameters
366
+ #: with ``expose_value=False`` are not stored.
367
+ self.params = {}
368
+ #: the leftover arguments.
369
+ self.args = []
370
+ #: protected arguments. These are arguments that are prepended
371
+ #: to `args` when certain parsing scenarios are encountered but
372
+ #: must be never propagated to another arguments. This is used
373
+ #: to implement nested parsing.
374
+ self._protected_args = []
375
+ #: the collected prefixes of the command's options.
376
+ self._opt_prefixes = set(parent._opt_prefixes) if parent else set()
377
+
378
+ if obj is None and parent is not None:
379
+ obj = parent.obj
380
+
381
+ #: the user object stored.
382
+ self.obj = obj
383
+ self._meta = getattr(parent, "meta", {})
384
+
385
+ #: A dictionary (-like object) with defaults for parameters.
386
+ if (
387
+ default_map is None
388
+ and info_name is not None
389
+ and parent is not None
390
+ and parent.default_map is not None
391
+ ):
392
+ default_map = parent.default_map.get(info_name)
393
+
394
+ self.default_map = default_map
395
+
396
+ #: This flag indicates if a subcommand is going to be executed. A
397
+ #: group callback can use this information to figure out if it's
398
+ #: being executed directly or because the execution flow passes
399
+ #: onwards to a subcommand. By default it's None, but it can be
400
+ #: the name of the subcommand to execute.
401
+ #:
402
+ #: If chaining is enabled this will be set to ``'*'`` in case
403
+ #: any commands are executed. It is however not possible to
404
+ #: figure out which ones. If you require this knowledge you
405
+ #: should use a :func:`result_callback`.
406
+ self.invoked_subcommand = None
407
+
408
+ if terminal_width is None and parent is not None:
409
+ terminal_width = parent.terminal_width
410
+
411
+ #: The width of the terminal (None is autodetection).
412
+ self.terminal_width = terminal_width
413
+
414
+ if max_content_width is None and parent is not None:
415
+ max_content_width = parent.max_content_width
416
+
417
+ #: The maximum width of formatted content (None implies a sensible
418
+ #: default which is 80 for most things).
419
+ self.max_content_width = max_content_width
420
+
421
+ if allow_extra_args is None:
422
+ allow_extra_args = command.allow_extra_args
423
+
424
+ #: Indicates if the context allows extra args or if it should
425
+ #: fail on parsing.
426
+ #:
427
+ #: .. versionadded:: 3.0
428
+ self.allow_extra_args = allow_extra_args
429
+
430
+ if allow_interspersed_args is None:
431
+ allow_interspersed_args = command.allow_interspersed_args
432
+
433
+ #: Indicates if the context allows mixing of arguments and
434
+ #: options or not.
435
+ #:
436
+ #: .. versionadded:: 3.0
437
+ self.allow_interspersed_args = allow_interspersed_args
438
+
439
+ if ignore_unknown_options is None:
440
+ ignore_unknown_options = command.ignore_unknown_options
441
+
442
+ #: Instructs click to ignore options that a command does not
443
+ #: understand and will store it on the context for later
444
+ #: processing. This is primarily useful for situations where you
445
+ #: want to call into external programs. Generally this pattern is
446
+ #: strongly discouraged because it's not possibly to losslessly
447
+ #: forward all arguments.
448
+ #:
449
+ #: .. versionadded:: 4.0
450
+ self.ignore_unknown_options = ignore_unknown_options
451
+
452
+ if help_option_names is None:
453
+ if parent is not None:
454
+ help_option_names = parent.help_option_names
455
+ else:
456
+ help_option_names = ["--help"]
457
+
458
+ #: The names for the help options.
459
+ self.help_option_names = help_option_names
460
+
461
+ if token_normalize_func is None and parent is not None:
462
+ token_normalize_func = parent.token_normalize_func
463
+
464
+ #: An optional normalization function for tokens. This is
465
+ #: options, choices, commands etc.
466
+ self.token_normalize_func = token_normalize_func
467
+
468
+ #: Indicates if resilient parsing is enabled. In that case Click
469
+ #: will do its best to not cause any failures and default values
470
+ #: will be ignored. Useful for completion.
471
+ self.resilient_parsing = resilient_parsing
472
+
473
+ # If there is no envvar prefix yet, but the parent has one and
474
+ # the command on this level has a name, we can expand the envvar
475
+ # prefix automatically.
476
+ if auto_envvar_prefix is None:
477
+ if (
478
+ parent is not None
479
+ and parent.auto_envvar_prefix is not None
480
+ and self.info_name is not None
481
+ ):
482
+ auto_envvar_prefix = (
483
+ f"{parent.auto_envvar_prefix}_{self.info_name.upper()}"
484
+ )
485
+ else:
486
+ auto_envvar_prefix = auto_envvar_prefix.upper()
487
+
488
+ if auto_envvar_prefix is not None:
489
+ auto_envvar_prefix = auto_envvar_prefix.replace("-", "_")
490
+
491
+ self.auto_envvar_prefix = auto_envvar_prefix
492
+
493
+ if color is None and parent is not None:
494
+ color = parent.color
495
+
496
+ #: Controls if styling output is wanted or not.
497
+ self.color = color
498
+
499
+ if show_default is None and parent is not None:
500
+ show_default = parent.show_default
501
+
502
+ #: Show option default values when formatting help text.
503
+ self.show_default = show_default
504
+
505
+ self._close_callbacks = []
506
+ self._depth = 0
507
+ self._parameter_source = {}
508
+ # Tracks whether the option that currently owns each parameter slot in
509
+ # :attr:`params` had its ``default`` set explicitly by the user. Used
510
+ # to tie-break feature-switch groups where multiple options share a
511
+ # parameter name and both fall back to their default value.
512
+ # Refs: https://github.com/pallets/click/issues/3403
513
+ self._param_default_explicit = {}
514
+ self._exit_stack = ExitStack()
515
+
516
+ @property
517
+ def protected_args(self) -> list[str]:
518
+ import warnings
519
+
520
+ warnings.warn(
521
+ "'protected_args' is deprecated and will be removed in Click 9.0."
522
+ " 'args' will contain remaining unparsed tokens.",
523
+ DeprecationWarning,
524
+ stacklevel=2,
525
+ )
526
+ return self._protected_args
527
+
528
+ def to_info_dict(self) -> dict[str, t.Any]:
529
+ """Gather information that could be useful for a tool generating
530
+ user-facing documentation. This traverses the entire CLI
531
+ structure.
532
+
533
+ .. code-block:: python
534
+
535
+ with Context(cli) as ctx:
536
+ info = ctx.to_info_dict()
537
+
538
+ .. versionadded:: 8.0
539
+ """
540
+ return {
541
+ "command": self.command.to_info_dict(self),
542
+ "info_name": self.info_name,
543
+ "allow_extra_args": self.allow_extra_args,
544
+ "allow_interspersed_args": self.allow_interspersed_args,
545
+ "ignore_unknown_options": self.ignore_unknown_options,
546
+ "auto_envvar_prefix": self.auto_envvar_prefix,
547
+ }
548
+
549
+ def __enter__(self) -> Self:
550
+ self._depth += 1
551
+ push_context(self)
552
+ return self
553
+
554
+ def __exit__(
555
+ self,
556
+ exc_type: type[BaseException] | None,
557
+ exc_value: BaseException | None,
558
+ tb: TracebackType | None,
559
+ ) -> bool | None:
560
+ self._depth -= 1
561
+ exit_result: bool | None = None
562
+ if self._depth == 0:
563
+ exit_result = self._close_with_exception_info(exc_type, exc_value, tb)
564
+ pop_context()
565
+
566
+ return exit_result
567
+
568
+ @contextmanager
569
+ def scope(self, cleanup: bool = True) -> cabc.Generator[Context]:
570
+ """This helper method can be used with the context object to promote
571
+ it to the current thread local (see :func:`get_current_context`).
572
+ The default behavior of this is to invoke the cleanup functions which
573
+ can be disabled by setting `cleanup` to `False`. The cleanup
574
+ functions are typically used for things such as closing file handles.
575
+
576
+ If the cleanup is intended the context object can also be directly
577
+ used as a context manager.
578
+
579
+ Example usage::
580
+
581
+ with ctx.scope():
582
+ assert get_current_context() is ctx
583
+
584
+ This is equivalent::
585
+
586
+ with ctx:
587
+ assert get_current_context() is ctx
588
+
589
+ .. versionadded:: 5.0
590
+
591
+ :param cleanup: controls if the cleanup functions should be run or
592
+ not. The default is to run these functions. In
593
+ some situations the context only wants to be
594
+ temporarily pushed in which case this can be disabled.
595
+ Nested pushes automatically defer the cleanup.
596
+ """
597
+ if not cleanup:
598
+ self._depth += 1
599
+ try:
600
+ with self as rv:
601
+ yield rv
602
+ finally:
603
+ if not cleanup:
604
+ self._depth -= 1
605
+
606
+ @property
607
+ def meta(self) -> dict[str, t.Any]:
608
+ """This is a dictionary which is shared with all the contexts
609
+ that are nested. It exists so that click utilities can store some
610
+ state here if they need to. It is however the responsibility of
611
+ that code to manage this dictionary well.
612
+
613
+ The keys are supposed to be unique dotted strings. For instance
614
+ module paths are a good choice for it. What is stored in there is
615
+ irrelevant for the operation of click. However what is important is
616
+ that code that places data here adheres to the general semantics of
617
+ the system.
618
+
619
+ Example usage::
620
+
621
+ LANG_KEY = f'{__name__}.lang'
622
+
623
+ def set_language(value):
624
+ ctx = get_current_context()
625
+ ctx.meta[LANG_KEY] = value
626
+
627
+ def get_language():
628
+ return get_current_context().meta.get(LANG_KEY, 'en_US')
629
+
630
+ .. versionadded:: 5.0
631
+ """
632
+ return self._meta
633
+
634
+ def make_formatter(self) -> HelpFormatter:
635
+ """Creates the :class:`~click.HelpFormatter` for the help and
636
+ usage output.
637
+
638
+ To quickly customize the formatter class used without overriding
639
+ this method, set the :attr:`formatter_class` attribute.
640
+
641
+ .. versionchanged:: 8.0
642
+ Added the :attr:`formatter_class` attribute.
643
+ """
644
+ return self.formatter_class(
645
+ width=self.terminal_width, max_width=self.max_content_width
646
+ )
647
+
648
+ def with_resource(self, context_manager: AbstractContextManager[V]) -> V:
649
+ """Register a resource as if it were used in a ``with``
650
+ statement. The resource will be cleaned up when the context is
651
+ popped.
652
+
653
+ Uses :meth:`contextlib.ExitStack.enter_context`. It calls the
654
+ resource's ``__enter__()`` method and returns the result. When
655
+ the context is popped, it closes the stack, which calls the
656
+ resource's ``__exit__()`` method.
657
+
658
+ To register a cleanup function for something that isn't a
659
+ context manager, use :meth:`call_on_close`. Or use something
660
+ from :mod:`contextlib` to turn it into a context manager first.
661
+
662
+ .. code-block:: python
663
+
664
+ @click.group()
665
+ @click.option("--name")
666
+ @click.pass_context
667
+ def cli(ctx):
668
+ ctx.obj = ctx.with_resource(connect_db(name))
669
+
670
+ :param context_manager: The context manager to enter.
671
+ :return: Whatever ``context_manager.__enter__()`` returns.
672
+
673
+ .. versionadded:: 8.0
674
+ """
675
+ return self._exit_stack.enter_context(context_manager)
676
+
677
+ def call_on_close(self, f: t.Callable[..., t.Any]) -> t.Callable[..., t.Any]:
678
+ """Register a function to be called when the context tears down.
679
+
680
+ This can be used to close resources opened during the script
681
+ execution. Resources that support Python's context manager
682
+ protocol which would be used in a ``with`` statement should be
683
+ registered with :meth:`with_resource` instead.
684
+
685
+ :param f: The function to execute on teardown.
686
+ """
687
+ return self._exit_stack.callback(f)
688
+
689
+ def close(self) -> None:
690
+ """Invoke all close callbacks registered with
691
+ :meth:`call_on_close`, and exit all context managers entered
692
+ with :meth:`with_resource`.
693
+ """
694
+ self._close_with_exception_info(None, None, None)
695
+
696
+ def _close_with_exception_info(
697
+ self,
698
+ exc_type: type[BaseException] | None,
699
+ exc_value: BaseException | None,
700
+ tb: TracebackType | None,
701
+ ) -> bool | None:
702
+ """Unwind the exit stack by calling its :meth:`__exit__` providing the exception
703
+ information to allow for exception handling by the various resources registered
704
+ using :meth;`with_resource`
705
+
706
+ :return: Whatever ``exit_stack.__exit__()`` returns.
707
+ """
708
+ exit_result = self._exit_stack.__exit__(exc_type, exc_value, tb)
709
+ # In case the context is reused, create a new exit stack.
710
+ self._exit_stack = ExitStack()
711
+
712
+ return exit_result
713
+
714
+ @property
715
+ def command_path(self) -> str:
716
+ """The computed command path. This is used for the ``usage``
717
+ information on the help page. It's automatically created by
718
+ combining the info names of the chain of contexts to the root.
719
+ """
720
+ rv = ""
721
+ if self.info_name is not None:
722
+ rv = self.info_name
723
+ if self.parent is not None:
724
+ parent_command_path = [self.parent.command_path]
725
+
726
+ if isinstance(self.parent.command, Command):
727
+ for param in self.parent.command.get_params(self):
728
+ parent_command_path.extend(param.get_usage_pieces(self))
729
+
730
+ rv = f"{' '.join(parent_command_path)} {rv}"
731
+ return rv.lstrip()
732
+
733
+ def find_root(self) -> Context:
734
+ """Finds the outermost context."""
735
+ node = self
736
+ while node.parent is not None:
737
+ node = node.parent
738
+ return node
739
+
740
+ def find_object(self, object_type: type[V]) -> V | None:
741
+ """Finds the closest object of a given type."""
742
+ node: Context | None = self
743
+
744
+ while node is not None:
745
+ if isinstance(node.obj, object_type):
746
+ return node.obj
747
+
748
+ node = node.parent
749
+
750
+ return None
751
+
752
+ def ensure_object(self, object_type: type[V]) -> V:
753
+ """Like :meth:`find_object` but sets the innermost object to a
754
+ new instance of `object_type` if it does not exist.
755
+ """
756
+ rv = self.find_object(object_type)
757
+ if rv is None:
758
+ self.obj = rv = object_type()
759
+ return rv
760
+
761
+ def _default_map_has(self, name: str | None) -> bool:
762
+ """Check if :attr:`default_map` contains a real value for ``name``.
763
+
764
+ Returns ``False`` when the key is absent, the map is ``None``,
765
+ ``name`` is ``None``, or the stored value is the internal
766
+ :data:`UNSET` sentinel.
767
+ """
768
+ return (
769
+ name is not None
770
+ and self.default_map is not None
771
+ and name in self.default_map
772
+ and self.default_map[name] is not UNSET
773
+ )
774
+
775
+ @t.overload
776
+ def lookup_default(
777
+ self, name: str, call: t.Literal[True] = True
778
+ ) -> t.Any | None: ...
779
+
780
+ @t.overload
781
+ def lookup_default(
782
+ self, name: str, call: t.Literal[False] = ...
783
+ ) -> t.Any | t.Callable[[], t.Any] | None: ...
784
+
785
+ def lookup_default(self, name: str, call: bool = True) -> t.Any | None:
786
+ """Get the default for a parameter from :attr:`default_map`.
787
+
788
+ :param name: Name of the parameter.
789
+ :param call: If the default is a callable, call it. Disable to
790
+ return the callable instead.
791
+
792
+ .. versionchanged:: 8.0
793
+ Added the ``call`` parameter.
794
+ """
795
+ if not self._default_map_has(name):
796
+ return None
797
+
798
+ # Assert to make the type checker happy.
799
+ assert self.default_map is not None
800
+ value = self.default_map[name]
801
+
802
+ if call and callable(value):
803
+ return value()
804
+
805
+ return value
806
+
807
+ def fail(self, message: str) -> t.NoReturn:
808
+ """Aborts the execution of the program with a specific error
809
+ message.
810
+
811
+ :param message: the error message to fail with.
812
+ """
813
+ raise UsageError(message, self)
814
+
815
+ def abort(self) -> t.NoReturn:
816
+ """Aborts the script."""
817
+ raise Abort()
818
+
819
+ def exit(self, code: int = 0) -> t.NoReturn:
820
+ """Exits the application with a given exit code.
821
+
822
+ .. versionchanged:: 8.2
823
+ Callbacks and context managers registered with :meth:`call_on_close`
824
+ and :meth:`with_resource` are closed before exiting.
825
+ """
826
+ self.close()
827
+ raise Exit(code)
828
+
829
+ def get_usage(self) -> str:
830
+ """Helper method to get formatted usage string for the current
831
+ context and command.
832
+ """
833
+ return self.command.get_usage(self)
834
+
835
+ def get_help(self) -> str:
836
+ """Helper method to get formatted help page for the current
837
+ context and command.
838
+ """
839
+ return self.command.get_help(self)
840
+
841
+ def _make_sub_context(self, command: Command) -> Context:
842
+ """Create a new context of the same type as this context, but
843
+ for a new command.
844
+
845
+ :meta private:
846
+ """
847
+ return type(self)(command, info_name=command.name, parent=self)
848
+
849
+ @t.overload
850
+ def invoke(
851
+ self, callback: t.Callable[..., V], /, *args: t.Any, **kwargs: t.Any
852
+ ) -> V: ...
853
+
854
+ @t.overload
855
+ def invoke(self, callback: Command, /, *args: t.Any, **kwargs: t.Any) -> t.Any: ...
856
+
857
+ def invoke(
858
+ self, callback: Command | t.Callable[..., V], /, *args: t.Any, **kwargs: t.Any
859
+ ) -> t.Any | V:
860
+ """Invokes a command callback in exactly the way it expects. There
861
+ are two ways to invoke this method:
862
+
863
+ 1. the first argument can be a callback and all other arguments and
864
+ keyword arguments are forwarded directly to the function.
865
+ 2. the first argument is a click command object. In that case all
866
+ arguments are forwarded as well but proper click parameters
867
+ (options and click arguments) must be keyword arguments and Click
868
+ will fill in defaults.
869
+
870
+ .. versionchanged:: 8.0
871
+ All ``kwargs`` are tracked in :attr:`params` so they will be
872
+ passed if :meth:`forward` is called at multiple levels.
873
+
874
+ .. versionchanged:: 3.2
875
+ A new context is created, and missing arguments use default values.
876
+ """
877
+ if isinstance(callback, Command):
878
+ other_cmd = callback
879
+
880
+ if other_cmd.callback is None:
881
+ raise TypeError(
882
+ "The given command does not have a callback that can be invoked."
883
+ )
884
+ else:
885
+ callback = t.cast("t.Callable[..., V]", other_cmd.callback)
886
+
887
+ ctx = self._make_sub_context(other_cmd)
888
+
889
+ for param in other_cmd.params:
890
+ if param.name not in kwargs and param.expose_value:
891
+ default_value = param.get_default(ctx)
892
+ # We explicitly hide the :attr:`UNSET` value to the user, as we
893
+ # choose to make it an implementation detail. And because ``invoke``
894
+ # has been designed as part of Click public API, we return ``None``
895
+ # instead. Refs:
896
+ # https://github.com/pallets/click/issues/3066
897
+ # https://github.com/pallets/click/issues/3065
898
+ # https://github.com/pallets/click/pull/3068
899
+ if default_value is UNSET:
900
+ default_value = None
901
+ kwargs[param.name] = param.type_cast_value(ctx, default_value)
902
+
903
+ # Track all kwargs as params, so that forward() will pass
904
+ # them on in subsequent calls.
905
+ ctx.params.update(kwargs)
906
+ else:
907
+ ctx = self
908
+
909
+ with augment_usage_errors(self), ctx:
910
+ return callback(*args, **kwargs)
911
+
912
+ def forward(self, cmd: Command, /, *args: t.Any, **kwargs: t.Any) -> t.Any:
913
+ """Similar to :meth:`invoke` but fills in default keyword
914
+ arguments from the current context if the other command expects
915
+ it. This cannot invoke callbacks directly, only other commands.
916
+
917
+ .. versionchanged:: 8.0
918
+ All ``kwargs`` are tracked in :attr:`params` so they will be
919
+ passed if ``forward`` is called at multiple levels.
920
+ """
921
+ # Can only forward to other commands, not direct callbacks.
922
+ if not isinstance(cmd, Command):
923
+ raise TypeError("Callback is not a command.")
924
+
925
+ for param in self.params:
926
+ if param not in kwargs:
927
+ kwargs[param] = self.params[param]
928
+
929
+ return self.invoke(cmd, *args, **kwargs)
930
+
931
+ def set_parameter_source(self, name: str, source: ParameterSource) -> None:
932
+ """Set the source of a parameter. This indicates the location
933
+ from which the value of the parameter was obtained.
934
+
935
+ :param name: The name of the parameter.
936
+ :param source: A member of :class:`~click.core.ParameterSource`.
937
+ """
938
+ self._parameter_source[name] = source
939
+
940
+ def get_parameter_source(self, name: str) -> ParameterSource | None:
941
+ """Get the source of a parameter. This indicates the location
942
+ from which the value of the parameter was obtained.
943
+
944
+ This can be useful for determining when a user specified a value
945
+ on the command line that is the same as the default value. It
946
+ will be :attr:`~click.core.ParameterSource.DEFAULT` only if the
947
+ value was actually taken from the default.
948
+
949
+ :param name: The name of the parameter.
950
+ :rtype: ParameterSource
951
+
952
+ .. versionchanged:: 8.0
953
+ Returns ``None`` if the parameter was not provided from any
954
+ source.
955
+ """
956
+ return self._parameter_source.get(name)
957
+
958
+
959
+ class Command:
960
+ """Commands are the basic building block of command line interfaces in
961
+ Click. A basic command handles command line parsing and might dispatch
962
+ more parsing to commands nested below it.
963
+
964
+ :param name: the name of the command to use unless a group overrides it.
965
+ :param context_settings: an optional dictionary with defaults that are
966
+ passed to the context object.
967
+ :param callback: the callback to invoke. This is optional.
968
+ :param params: the parameters to register with this command. This can
969
+ be either :class:`Option` or :class:`Argument` objects.
970
+ :param help: the help string to use for this command.
971
+ :param epilog: like the help string but it's printed at the end of the
972
+ help page after everything else.
973
+ :param short_help: the short help to use for this command. This is
974
+ shown on the command listing of the parent command.
975
+ :param add_help_option: by default each command registers a ``--help``
976
+ option. This can be disabled by this parameter.
977
+ :param no_args_is_help: this controls what happens if no arguments are
978
+ provided. This option is disabled by default.
979
+ If enabled this will add ``--help`` as argument
980
+ if no arguments are passed
981
+ :param hidden: hide this command from help outputs.
982
+ :param deprecated: If ``True`` or non-empty string, issues a message
983
+ indicating that the command is deprecated and highlights
984
+ its deprecation in --help. The message can be customized
985
+ by using a string as the value.
986
+
987
+ .. versionchanged:: 8.2
988
+ This is the base class for all commands, not ``BaseCommand``.
989
+ ``deprecated`` can be set to a string as well to customize the
990
+ deprecation message.
991
+
992
+ .. versionchanged:: 8.1
993
+ ``help``, ``epilog``, and ``short_help`` are stored unprocessed,
994
+ all formatting is done when outputting help text, not at init,
995
+ and is done even if not using the ``@command`` decorator.
996
+
997
+ .. versionchanged:: 8.0
998
+ Added a ``repr`` showing the command name.
999
+
1000
+ .. versionchanged:: 7.1
1001
+ Added the ``no_args_is_help`` parameter.
1002
+
1003
+ .. versionchanged:: 2.0
1004
+ Added the ``context_settings`` parameter.
1005
+ """
1006
+
1007
+ #: The context class to create with :meth:`make_context`.
1008
+ #:
1009
+ #: .. versionadded:: 8.0
1010
+ context_class: type[Context] = Context
1011
+
1012
+ #: the default for the :attr:`Context.allow_extra_args` flag.
1013
+ allow_extra_args = False
1014
+
1015
+ #: the default for the :attr:`Context.allow_interspersed_args` flag.
1016
+ allow_interspersed_args = True
1017
+
1018
+ #: the default for the :attr:`Context.ignore_unknown_options` flag.
1019
+ ignore_unknown_options = False
1020
+
1021
+ name: str | None
1022
+ context_settings: cabc.MutableMapping[str, t.Any]
1023
+ callback: t.Callable[..., t.Any] | None
1024
+ params: list[Parameter]
1025
+ help: str | None
1026
+ epilog: str | None
1027
+ options_metavar: str | None
1028
+ short_help: str | None
1029
+ add_help_option: bool
1030
+ _help_option: Option | None
1031
+ no_args_is_help: bool
1032
+ hidden: bool
1033
+ deprecated: bool | str
1034
+
1035
+ def __init__(
1036
+ self,
1037
+ name: str | None,
1038
+ context_settings: cabc.MutableMapping[str, t.Any] | None = None,
1039
+ callback: t.Callable[..., t.Any] | None = None,
1040
+ params: list[Parameter] | None = None,
1041
+ help: str | None = None,
1042
+ epilog: str | None = None,
1043
+ short_help: str | None = None,
1044
+ options_metavar: str | None = "[OPTIONS]",
1045
+ add_help_option: bool = True,
1046
+ no_args_is_help: bool = False,
1047
+ hidden: bool = False,
1048
+ deprecated: bool | str = False,
1049
+ ) -> None:
1050
+ #: the name the command thinks it has. Upon registering a command
1051
+ #: on a :class:`Group` the group will default the command name
1052
+ #: with this information. You should instead use the
1053
+ #: :class:`Context`\'s :attr:`~Context.info_name` attribute.
1054
+ self.name = name
1055
+
1056
+ if context_settings is None:
1057
+ context_settings = {}
1058
+
1059
+ #: an optional dictionary with defaults passed to the context.
1060
+ self.context_settings = context_settings
1061
+
1062
+ #: the callback to execute when the command fires. This might be
1063
+ #: `None` in which case nothing happens.
1064
+ self.callback = callback
1065
+ #: the list of parameters for this command in the order they
1066
+ #: should show up in the help page and execute. Eager parameters
1067
+ #: will automatically be handled before non eager ones.
1068
+ self.params = params or []
1069
+ self.help = help
1070
+ self.epilog = epilog
1071
+ self.options_metavar = options_metavar
1072
+ self.short_help = short_help
1073
+ self.add_help_option = add_help_option
1074
+ self._help_option = None
1075
+ self.no_args_is_help = no_args_is_help
1076
+ self.hidden = hidden
1077
+ self.deprecated = deprecated
1078
+
1079
+ def to_info_dict(self, ctx: Context) -> dict[str, t.Any]:
1080
+ return {
1081
+ "name": self.name,
1082
+ "params": [param.to_info_dict() for param in self.get_params(ctx)],
1083
+ "help": self.help,
1084
+ "epilog": self.epilog,
1085
+ "short_help": self.short_help,
1086
+ "hidden": self.hidden,
1087
+ "deprecated": self.deprecated,
1088
+ }
1089
+
1090
+ def __repr__(self) -> str:
1091
+ return f"<{self.__class__.__name__} {self.name}>"
1092
+
1093
+ def get_usage(self, ctx: Context) -> str:
1094
+ """Formats the usage line into a string and returns it.
1095
+
1096
+ Calls :meth:`format_usage` internally.
1097
+ """
1098
+ formatter = ctx.make_formatter()
1099
+ self.format_usage(ctx, formatter)
1100
+ return formatter.getvalue().rstrip("\n")
1101
+
1102
+ def get_params(self, ctx: Context) -> list[Parameter]:
1103
+ params = self.params
1104
+ help_option = self.get_help_option(ctx)
1105
+
1106
+ if help_option is not None:
1107
+ params = [*params, help_option]
1108
+
1109
+ if __debug__:
1110
+ import warnings
1111
+
1112
+ opts = [opt for param in params for opt in param.opts]
1113
+ opts_counter = Counter(opts)
1114
+ duplicate_opts = (opt for opt, count in opts_counter.items() if count > 1)
1115
+
1116
+ for duplicate_opt in duplicate_opts:
1117
+ warnings.warn(
1118
+ (
1119
+ f"The parameter {duplicate_opt} is used more than once. "
1120
+ "Remove its duplicate as parameters should be unique."
1121
+ ),
1122
+ stacklevel=3,
1123
+ )
1124
+
1125
+ # Options may deliberately share a storage name to compete for
1126
+ # the same value (feature switches), but an argument sharing a
1127
+ # name silently overwrites the other parameter's value.
1128
+ names_counter = Counter(param.name for param in params)
1129
+ duplicate_names = (
1130
+ name for name, count in names_counter.items() if count > 1
1131
+ )
1132
+
1133
+ for duplicate_name in duplicate_names:
1134
+ sharers = [param for param in params if param.name == duplicate_name]
1135
+
1136
+ if help_option in sharers:
1137
+ warnings.warn(
1138
+ (
1139
+ f"The name {duplicate_name!r} is reserved for the "
1140
+ "automatic help option. Give the parameter a "
1141
+ "different name."
1142
+ ),
1143
+ stacklevel=3,
1144
+ )
1145
+ elif any(isinstance(param, Argument) for param in sharers):
1146
+ warnings.warn(
1147
+ (
1148
+ f"The name {duplicate_name!r} is used by an argument "
1149
+ "and another parameter. They will overwrite each "
1150
+ "other's value during parsing. Give each parameter "
1151
+ "a unique name."
1152
+ ),
1153
+ stacklevel=3,
1154
+ )
1155
+
1156
+ return params
1157
+
1158
+ def format_usage(self, ctx: Context, formatter: HelpFormatter) -> None:
1159
+ """Writes the usage line into the formatter.
1160
+
1161
+ This is a low-level method called by :meth:`get_usage`.
1162
+ """
1163
+ pieces = self.collect_usage_pieces(ctx)
1164
+ formatter.write_usage(ctx.command_path, " ".join(pieces))
1165
+
1166
+ def collect_usage_pieces(self, ctx: Context) -> list[str]:
1167
+ """Returns all the pieces that go into the usage line and returns
1168
+ it as a list of strings.
1169
+ """
1170
+ rv = [self.options_metavar] if self.options_metavar else []
1171
+
1172
+ for param in self.get_params(ctx):
1173
+ rv.extend(param.get_usage_pieces(ctx))
1174
+
1175
+ return rv
1176
+
1177
+ def get_help_option_names(self, ctx: Context) -> list[str]:
1178
+ """Returns the names for the help option.
1179
+
1180
+ Drops duplicates and names already reserved by another parameter. Order of
1181
+ :attr:`Context.help_option_names` is preserved, so the result is stable.
1182
+
1183
+ .. versionchanged:: 8.5.0
1184
+ Names keep their declaration order.
1185
+ """
1186
+ all_names = dict.fromkeys(ctx.help_option_names)
1187
+ for param in self.params:
1188
+ for name in (*param.opts, *param.secondary_opts):
1189
+ all_names.pop(name, None)
1190
+ return list(all_names)
1191
+
1192
+ def get_help_option(self, ctx: Context) -> Option | None:
1193
+ """Returns the help option object.
1194
+
1195
+ Skipped if :attr:`add_help_option` is ``False``.
1196
+
1197
+ .. versionchanged:: 8.5.0
1198
+ The help option stores its value under the reserved name
1199
+ ``_click_default_help``, so a parameter named ``help`` no
1200
+ longer breaks parsing.
1201
+
1202
+ .. versionchanged:: 8.1.8
1203
+ The help option is now cached to avoid creating it multiple times.
1204
+ """
1205
+ help_option_names = self.get_help_option_names(ctx)
1206
+
1207
+ if not help_option_names or not self.add_help_option:
1208
+ return None
1209
+
1210
+ # Cache the help option object in private _help_option attribute to
1211
+ # avoid creating it multiple times. Not doing this will break the
1212
+ # callback ordering by iter_params_for_processing(), which relies on
1213
+ # object comparison.
1214
+ if self._help_option is None:
1215
+ # Avoid circular import.
1216
+ from .decorators import help_option
1217
+
1218
+ # The help option never exposes its value, so it uses a reserved
1219
+ # storage name, keeping it clear of user parameters (like an
1220
+ # argument named "help") that would otherwise clobber its value.
1221
+ help_option(*help_option_names, _HELP_OPTION_STORAGE_NAME)(self)
1222
+ self._help_option = self.params.pop() # type: ignore[assignment]
1223
+
1224
+ return self._help_option
1225
+
1226
+ def make_parser(self, ctx: Context) -> _OptionParser:
1227
+ """Creates the underlying option parser for this command."""
1228
+ parser = _OptionParser(ctx)
1229
+ for param in self.get_params(ctx):
1230
+ param.add_to_parser(parser, ctx)
1231
+ return parser
1232
+
1233
+ def get_help(self, ctx: Context) -> str:
1234
+ """Formats the help into a string and returns it.
1235
+
1236
+ Calls :meth:`format_help` internally.
1237
+ """
1238
+ formatter = ctx.make_formatter()
1239
+ self.format_help(ctx, formatter)
1240
+ return formatter.getvalue().rstrip("\n")
1241
+
1242
+ def get_short_help_str(self, limit: int = 45) -> str:
1243
+ """Gets short help for the command or makes it by shortening the
1244
+ long help string.
1245
+ """
1246
+ if self.short_help:
1247
+ text = inspect.cleandoc(self.short_help)
1248
+ elif self.help:
1249
+ text = _make_default_short_help(self.help, limit)
1250
+ else:
1251
+ text = ""
1252
+
1253
+ if self.deprecated:
1254
+ text = f"{_(text)} {_format_deprecated_label(self.deprecated)}"
1255
+
1256
+ return text.strip()
1257
+
1258
+ def format_help(self, ctx: Context, formatter: HelpFormatter) -> None:
1259
+ """Writes the help into the formatter if it exists.
1260
+
1261
+ This is a low-level method called by :meth:`get_help`.
1262
+
1263
+ This calls the following methods:
1264
+
1265
+ - :meth:`format_usage`
1266
+ - :meth:`format_help_text`
1267
+ - :meth:`format_arguments`
1268
+ - :meth:`format_options`
1269
+ - :meth:`format_epilog`
1270
+ """
1271
+ self.format_usage(ctx, formatter)
1272
+ self.format_help_text(ctx, formatter)
1273
+ self.format_arguments(ctx, formatter)
1274
+ self.format_options(ctx, formatter)
1275
+ self.format_epilog(ctx, formatter)
1276
+
1277
+ def format_help_text(self, ctx: Context, formatter: HelpFormatter) -> None:
1278
+ """Writes the help text to the formatter if it exists."""
1279
+ if self.help is not None:
1280
+ # truncate the help text to the first form feed
1281
+ text = inspect.cleandoc(self.help).partition("\f")[0]
1282
+ else:
1283
+ text = ""
1284
+
1285
+ if self.deprecated:
1286
+ label = _format_deprecated_label(self.deprecated)
1287
+ text = f"{_(text)} {label}" if text else label
1288
+
1289
+ if text:
1290
+ formatter.write_paragraph()
1291
+
1292
+ with formatter.indentation():
1293
+ formatter.write_text(text)
1294
+
1295
+ def format_options(self, ctx: Context, formatter: HelpFormatter) -> None:
1296
+ """Writes all the options into the formatter if they exist."""
1297
+ opts = []
1298
+ for param in self.get_params(ctx):
1299
+ rv = param.get_help_record(ctx)
1300
+ if rv is not None and not isinstance(param, Argument):
1301
+ opts.append(rv)
1302
+
1303
+ if opts:
1304
+ with formatter.section(_("Options")):
1305
+ formatter.write_dl(opts)
1306
+
1307
+ def format_arguments(self, ctx: Context, formatter: HelpFormatter) -> None:
1308
+ """Writes the arguments that have a help record into the formatter."""
1309
+ args = []
1310
+ for param in self.get_params(ctx):
1311
+ rv = param.get_help_record(ctx)
1312
+ if rv is not None and isinstance(param, Argument):
1313
+ args.append(rv)
1314
+
1315
+ if args:
1316
+ with formatter.section(_("Positional arguments")):
1317
+ formatter.write_dl(args)
1318
+
1319
+ def format_epilog(self, ctx: Context, formatter: HelpFormatter) -> None:
1320
+ """Writes the epilog into the formatter if it exists."""
1321
+ if self.epilog:
1322
+ epilog = inspect.cleandoc(self.epilog)
1323
+ formatter.write_paragraph()
1324
+
1325
+ with formatter.indentation():
1326
+ formatter.write_text(epilog)
1327
+
1328
+ def make_context(
1329
+ self,
1330
+ info_name: str | None,
1331
+ args: list[str],
1332
+ parent: Context | None = None,
1333
+ **extra: t.Any,
1334
+ ) -> Context:
1335
+ """This function when given an info name and arguments will kick
1336
+ off the parsing and create a new :class:`Context`. It does not
1337
+ invoke the actual command callback though.
1338
+
1339
+ To quickly customize the context class used without overriding
1340
+ this method, set the :attr:`context_class` attribute.
1341
+
1342
+ :param info_name: the info name for this invocation. Generally this
1343
+ is the most descriptive name for the script or
1344
+ command. For the toplevel script it's usually
1345
+ the name of the script, for commands below it's
1346
+ the name of the command.
1347
+ :param args: the arguments to parse as list of strings.
1348
+ :param parent: the parent context if available.
1349
+ :param extra: extra keyword arguments forwarded to the context
1350
+ constructor.
1351
+
1352
+ .. versionchanged:: 8.0
1353
+ Added the :attr:`context_class` attribute.
1354
+ """
1355
+ for key, value in self.context_settings.items():
1356
+ if key not in extra:
1357
+ extra[key] = value
1358
+
1359
+ ctx = self.context_class(self, info_name=info_name, parent=parent, **extra)
1360
+
1361
+ with ctx.scope(cleanup=False):
1362
+ self.parse_args(ctx, args)
1363
+ return ctx
1364
+
1365
+ def parse_args(self, ctx: Context, args: list[str]) -> list[str]:
1366
+ if not args and self.no_args_is_help and not ctx.resilient_parsing:
1367
+ raise NoArgsIsHelpError(ctx)
1368
+
1369
+ parser = self.make_parser(ctx)
1370
+ opts, args, param_order = parser.parse_args(args=args)
1371
+
1372
+ for param in iter_params_for_processing(param_order, self.get_params(ctx)):
1373
+ _, args = param.handle_parse_result(ctx, opts, args)
1374
+
1375
+ # We now have all parameters' values into `ctx.params`, but the data may contain
1376
+ # the `UNSET` sentinel.
1377
+ # Convert `UNSET` to `None` to ensure that the user doesn't see `UNSET`.
1378
+ #
1379
+ # Waiting until after the initial parse to convert allows us to treat `UNSET`
1380
+ # more like a missing value when multiple params use the same name.
1381
+ # Refs:
1382
+ # https://github.com/pallets/click/issues/3071
1383
+ # https://github.com/pallets/click/pull/3079
1384
+ for name, value in ctx.params.items():
1385
+ if value is UNSET:
1386
+ ctx.params[name] = None
1387
+
1388
+ if args and not ctx.allow_extra_args and not ctx.resilient_parsing:
1389
+ ctx.fail(
1390
+ ngettext(
1391
+ "Got unexpected extra argument ({args})",
1392
+ "Got unexpected extra arguments ({args})",
1393
+ len(args),
1394
+ ).format(args=" ".join(map(str, args)))
1395
+ )
1396
+
1397
+ ctx.args = args
1398
+ ctx._opt_prefixes.update(parser._opt_prefixes)
1399
+ return args
1400
+
1401
+ def invoke(self, ctx: Context) -> t.Any:
1402
+ """Given a context, this invokes the attached callback (if it exists)
1403
+ in the right way.
1404
+ """
1405
+ if self.deprecated:
1406
+ message = _(
1407
+ "DeprecationWarning: The command {name!r} is deprecated.{extra_message}"
1408
+ ).format(
1409
+ name=self.name,
1410
+ extra_message=_format_deprecated_suffix(self.deprecated),
1411
+ )
1412
+ echo(style(message, fg="red"), err=True)
1413
+
1414
+ if self.callback is not None:
1415
+ return ctx.invoke(self.callback, **ctx.params)
1416
+
1417
+ def shell_complete(self, ctx: Context, incomplete: str) -> list[CompletionItem]:
1418
+ """Return a list of completions for the incomplete value. Looks
1419
+ at the names of options and chained multi-commands.
1420
+
1421
+ Any command could be part of a chained multi-command, so sibling
1422
+ commands are valid at any point during command completion.
1423
+
1424
+ :param ctx: Invocation context for this command.
1425
+ :param incomplete: Value being completed. May be empty.
1426
+
1427
+ .. versionadded:: 8.0
1428
+ """
1429
+ from click.shell_completion import CompletionItem
1430
+
1431
+ results: list[CompletionItem] = []
1432
+
1433
+ if incomplete and not incomplete[0].isalnum():
1434
+ for param in self.get_params(ctx):
1435
+ if (
1436
+ not isinstance(param, Option)
1437
+ or param.hidden
1438
+ or (
1439
+ not param.multiple
1440
+ and ctx.get_parameter_source(param.name)
1441
+ is ParameterSource.COMMANDLINE
1442
+ )
1443
+ ):
1444
+ continue
1445
+
1446
+ results.extend(
1447
+ CompletionItem(name, help=param.help)
1448
+ for name in [*param.opts, *param.secondary_opts]
1449
+ if name.startswith(incomplete)
1450
+ )
1451
+
1452
+ while ctx.parent is not None:
1453
+ ctx = ctx.parent
1454
+
1455
+ if isinstance(ctx.command, Group) and ctx.command.chain:
1456
+ results.extend(
1457
+ CompletionItem(name, help=command.get_short_help_str())
1458
+ for name, command in _complete_visible_commands(ctx, incomplete)
1459
+ if name not in ctx._protected_args
1460
+ )
1461
+
1462
+ return results
1463
+
1464
+ @t.overload
1465
+ def main(
1466
+ self,
1467
+ args: cabc.Sequence[str] | None = None,
1468
+ prog_name: str | None = None,
1469
+ complete_var: str | None = None,
1470
+ standalone_mode: t.Literal[True] = True,
1471
+ **extra: t.Any,
1472
+ ) -> t.NoReturn: ...
1473
+
1474
+ @t.overload
1475
+ def main(
1476
+ self,
1477
+ args: cabc.Sequence[str] | None = None,
1478
+ prog_name: str | None = None,
1479
+ complete_var: str | None = None,
1480
+ standalone_mode: bool = ...,
1481
+ **extra: t.Any,
1482
+ ) -> t.Any: ...
1483
+
1484
+ def main(
1485
+ self,
1486
+ args: cabc.Sequence[str] | None = None,
1487
+ prog_name: str | None = None,
1488
+ complete_var: str | None = None,
1489
+ standalone_mode: bool = True,
1490
+ windows_expand_args: bool = True,
1491
+ **extra: t.Any,
1492
+ ) -> t.Any:
1493
+ """This is the way to invoke a script with all the bells and
1494
+ whistles as a command line application. This will always terminate
1495
+ the application after a call. If this is not wanted, ``SystemExit``
1496
+ needs to be caught.
1497
+
1498
+ This method is also available by directly calling the instance of
1499
+ a :class:`Command`.
1500
+
1501
+ :param args: the arguments that should be used for parsing. If not
1502
+ provided, ``sys.argv[1:]`` is used.
1503
+ :param prog_name: the program name that should be used. By default
1504
+ the program name is constructed by taking the file
1505
+ name from ``sys.argv[0]``.
1506
+ :param complete_var: the environment variable that controls the
1507
+ bash completion support. The default is
1508
+ ``"_<prog_name>_COMPLETE"`` with prog_name in
1509
+ uppercase.
1510
+ :param standalone_mode: the default behavior is to invoke the script
1511
+ in standalone mode. Click will then
1512
+ handle exceptions and convert them into
1513
+ error messages and the function will never
1514
+ return but shut down the interpreter. If
1515
+ this is set to `False` they will be
1516
+ propagated to the caller and the return
1517
+ value of this function is the return value
1518
+ of :meth:`invoke`.
1519
+ :param windows_expand_args: Expand glob patterns, user dir, and
1520
+ env vars in command line args on Windows.
1521
+ :param extra: extra keyword arguments are forwarded to the context
1522
+ constructor. See :class:`Context` for more information.
1523
+
1524
+ .. versionchanged:: 8.0.1
1525
+ Added the ``windows_expand_args`` parameter to allow
1526
+ disabling command line arg expansion on Windows.
1527
+
1528
+ .. versionchanged:: 8.0
1529
+ When taking arguments from ``sys.argv`` on Windows, glob
1530
+ patterns, user dir, and env vars are expanded.
1531
+
1532
+ .. versionchanged:: 3.0
1533
+ Added the ``standalone_mode`` parameter.
1534
+ """
1535
+ if args is None:
1536
+ args = sys.argv[1:]
1537
+
1538
+ if os.name == "nt" and windows_expand_args:
1539
+ args = _expand_args(args)
1540
+ else:
1541
+ args = list(args)
1542
+
1543
+ if prog_name is None:
1544
+ prog_name = _detect_program_name()
1545
+
1546
+ # Process shell completion requests and exit early.
1547
+ self._main_shell_completion(extra, prog_name, complete_var)
1548
+
1549
+ try:
1550
+ try:
1551
+ with self.make_context(prog_name, args, **extra) as ctx:
1552
+ rv = self.invoke(ctx)
1553
+ if not standalone_mode:
1554
+ return rv
1555
+ # it's not safe to `ctx.exit(rv)` here!
1556
+ # note that `rv` may actually contain data like "1" which
1557
+ # has obvious effects
1558
+ # more subtle case: `rv=[None, None]` can come out of
1559
+ # chained commands which all returned `None` -- so it's not
1560
+ # even always obvious that `rv` indicates success/failure
1561
+ # by its truthiness/falsiness
1562
+ ctx.exit()
1563
+ except (EOFError, KeyboardInterrupt) as e:
1564
+ echo(file=sys.stderr)
1565
+ raise Abort() from e
1566
+ except ClickException as e:
1567
+ if not standalone_mode:
1568
+ raise
1569
+ e.show()
1570
+ sys.exit(e.exit_code)
1571
+ except OSError as e:
1572
+ if e.errno == errno.EPIPE:
1573
+ sys.stdout = t.cast(t.TextIO, _PacifyFlushWrapper(sys.stdout))
1574
+ sys.stderr = t.cast(t.TextIO, _PacifyFlushWrapper(sys.stderr))
1575
+ sys.exit(1)
1576
+ else:
1577
+ raise
1578
+ except Exit as e:
1579
+ if standalone_mode:
1580
+ sys.exit(e.exit_code)
1581
+ else:
1582
+ # in non-standalone mode, return the exit code
1583
+ # note that this is only reached if `self.invoke` above raises
1584
+ # an Exit explicitly -- thus bypassing the check there which
1585
+ # would return its result
1586
+ # the results of non-standalone execution may therefore be
1587
+ # somewhat ambiguous: if there are codepaths which lead to
1588
+ # `ctx.exit(1)` and to `return 1`, the caller won't be able to
1589
+ # tell the difference between the two
1590
+ return e.exit_code
1591
+ except Abort:
1592
+ if not standalone_mode:
1593
+ raise
1594
+ echo(_("Aborted!"), file=sys.stderr)
1595
+ sys.exit(1)
1596
+
1597
+ def _main_shell_completion(
1598
+ self,
1599
+ ctx_args: cabc.MutableMapping[str, t.Any],
1600
+ prog_name: str,
1601
+ complete_var: str | None = None,
1602
+ ) -> None:
1603
+ """Check if the shell is asking for tab completion, process
1604
+ that, then exit early. Called from :meth:`main` before the
1605
+ program is invoked.
1606
+
1607
+ :param prog_name: Name of the executable in the shell.
1608
+ :param complete_var: Name of the environment variable that holds
1609
+ the completion instruction. Defaults to
1610
+ ``_{PROG_NAME}_COMPLETE``.
1611
+
1612
+ .. versionchanged:: 8.2.0
1613
+ Dots (``.``) in ``prog_name`` are replaced with underscores (``_``).
1614
+ """
1615
+ if complete_var is None:
1616
+ complete_name = prog_name.replace("-", "_").replace(".", "_")
1617
+ complete_var = f"_{complete_name}_COMPLETE".upper()
1618
+
1619
+ instruction = os.environ.get(complete_var)
1620
+
1621
+ if not instruction:
1622
+ return
1623
+
1624
+ from .shell_completion import shell_complete
1625
+
1626
+ rv = shell_complete(self, ctx_args, prog_name, complete_var, instruction)
1627
+ sys.exit(rv)
1628
+
1629
+ def __call__(self, *args: t.Any, **kwargs: t.Any) -> t.Any:
1630
+ """Alias for :meth:`main`."""
1631
+ return self.main(*args, **kwargs)
1632
+
1633
+
1634
+ class _FakeSubclassCheck(type):
1635
+ def __subclasscheck__(cls, subclass: type) -> bool:
1636
+ return issubclass(subclass, cls.__bases__[0])
1637
+
1638
+ def __instancecheck__(cls, instance: t.Any) -> bool:
1639
+ return isinstance(instance, cls.__bases__[0])
1640
+
1641
+
1642
+ class _BaseCommand(Command, metaclass=_FakeSubclassCheck):
1643
+ """
1644
+ .. deprecated:: 8.2
1645
+ Will be removed in Click 9.0. Use ``Command`` instead.
1646
+ """
1647
+
1648
+
1649
+ class Group(Command):
1650
+ """A group is a command that nests other commands (or more groups).
1651
+
1652
+ :param name: The name of the group command.
1653
+ :param commands: Map names to :class:`Command` objects. Can be a list, which
1654
+ will use :attr:`Command.name` as the keys.
1655
+ :param invoke_without_command: Invoke the group's callback even if a
1656
+ subcommand is not given.
1657
+ :param no_args_is_help: If no arguments are given, show the group's help and
1658
+ exit. Defaults to the opposite of ``invoke_without_command``.
1659
+ :param subcommand_metavar: How to represent the subcommand argument in help.
1660
+ The default will represent whether ``chain`` is set or not.
1661
+ :param chain: Allow passing more than one subcommand argument. After parsing
1662
+ a command's arguments, if any arguments remain another command will be
1663
+ matched, and so on.
1664
+ :param result_callback: A function to call after the group's and
1665
+ subcommand's callbacks. The value returned by the subcommand is passed.
1666
+ If ``chain`` is enabled, the value will be a list of values returned by
1667
+ all the commands. If ``invoke_without_command`` is enabled, the value
1668
+ will be the value returned by the group's callback, or an empty list if
1669
+ ``chain`` is enabled.
1670
+ :param kwargs: Other arguments passed to :class:`Command`.
1671
+
1672
+ .. versionchanged:: 8.0
1673
+ The ``commands`` argument can be a list of command objects.
1674
+
1675
+ .. versionchanged:: 8.2
1676
+ Merged with and replaces the ``MultiCommand`` base class.
1677
+ """
1678
+
1679
+ allow_extra_args = True
1680
+ allow_interspersed_args = False
1681
+
1682
+ #: If set, this is used by the group's :meth:`command` decorator
1683
+ #: as the default :class:`Command` class. This is useful to make all
1684
+ #: subcommands use a custom command class.
1685
+ #:
1686
+ #: .. versionadded:: 8.0
1687
+ command_class: type[Command] | None = None
1688
+
1689
+ #: If set, this is used by the group's :meth:`group` decorator
1690
+ #: as the default :class:`Group` class. This is useful to make all
1691
+ #: subgroups use a custom group class.
1692
+ #:
1693
+ #: If set to the special value :class:`type` (literally
1694
+ #: ``group_class = type``), this group's class will be used as the
1695
+ #: default class. This makes a custom group class continue to make
1696
+ #: custom groups.
1697
+ #:
1698
+ #: .. versionadded:: 8.0
1699
+ group_class: type[Group | type] | None = None
1700
+ # Literal[type] isn't valid, so use Type[type]
1701
+
1702
+ commands: cabc.MutableMapping[str, Command]
1703
+ invoke_without_command: bool
1704
+ subcommand_metavar: str
1705
+ chain: bool
1706
+ _result_callback: t.Callable[..., t.Any] | None
1707
+
1708
+ def __init__(
1709
+ self,
1710
+ name: str | None = None,
1711
+ commands: cabc.MutableMapping[str, Command]
1712
+ | cabc.Sequence[Command]
1713
+ | None = None,
1714
+ invoke_without_command: bool = False,
1715
+ no_args_is_help: bool | None = None,
1716
+ subcommand_metavar: str | None = None,
1717
+ chain: bool = False,
1718
+ result_callback: t.Callable[..., t.Any] | None = None,
1719
+ **kwargs: t.Any,
1720
+ ) -> None:
1721
+ super().__init__(name, **kwargs)
1722
+
1723
+ if commands is None:
1724
+ commands = {}
1725
+ elif isinstance(commands, abc.Sequence):
1726
+ commands = {c.name: c for c in commands if c.name is not None}
1727
+
1728
+ #: The registered subcommands by their exported names.
1729
+ self.commands = commands
1730
+
1731
+ if no_args_is_help is None:
1732
+ no_args_is_help = not invoke_without_command
1733
+
1734
+ self.no_args_is_help = no_args_is_help
1735
+ self.invoke_without_command = invoke_without_command
1736
+
1737
+ if subcommand_metavar is None:
1738
+ # When the group can run without a subcommand, the leading command
1739
+ # token is optional, so wrap it in brackets to reflect that.
1740
+ if chain:
1741
+ if invoke_without_command:
1742
+ subcommand_metavar = "[COMMAND1] [ARGS]... [COMMAND2 [ARGS]...]..."
1743
+ else:
1744
+ subcommand_metavar = "COMMAND1 [ARGS]... [COMMAND2 [ARGS]...]..."
1745
+ elif invoke_without_command:
1746
+ subcommand_metavar = "[COMMAND] [ARGS]..."
1747
+ else:
1748
+ subcommand_metavar = "COMMAND [ARGS]..."
1749
+
1750
+ self.subcommand_metavar = subcommand_metavar
1751
+ self.chain = chain
1752
+ # The result callback that is stored. This can be set or
1753
+ # overridden with the :func:`result_callback` decorator.
1754
+ self._result_callback = result_callback
1755
+
1756
+ if self.chain:
1757
+ for param in self.params:
1758
+ if isinstance(param, Argument) and not param.required:
1759
+ raise RuntimeError(
1760
+ "A group in chain mode cannot have optional arguments."
1761
+ )
1762
+
1763
+ def to_info_dict(self, ctx: Context) -> dict[str, t.Any]:
1764
+ info_dict = super().to_info_dict(ctx)
1765
+ commands = {}
1766
+
1767
+ for name in self.list_commands(ctx):
1768
+ command = self.get_command(ctx, name)
1769
+
1770
+ if command is None:
1771
+ continue
1772
+
1773
+ sub_ctx = ctx._make_sub_context(command)
1774
+
1775
+ with sub_ctx.scope(cleanup=False):
1776
+ commands[name] = command.to_info_dict(sub_ctx)
1777
+
1778
+ info_dict.update(commands=commands, chain=self.chain)
1779
+ return info_dict
1780
+
1781
+ def add_command(self, cmd: Command, name: str | None = None) -> None:
1782
+ """Registers another :class:`Command` with this group. If the name
1783
+ is not provided, the name of the command is used.
1784
+ """
1785
+ name = name or cmd.name
1786
+ if name is None:
1787
+ raise TypeError("Command has no name.")
1788
+ _check_nested_chain(self, name, cmd, register=True)
1789
+ self.commands[name] = cmd
1790
+
1791
+ @t.overload
1792
+ def command(self, __func: t.Callable[..., t.Any]) -> Command: ...
1793
+
1794
+ @t.overload
1795
+ def command(
1796
+ self, *args: t.Any, **kwargs: t.Any
1797
+ ) -> t.Callable[[t.Callable[..., t.Any]], Command]: ...
1798
+
1799
+ def command(
1800
+ self, *args: t.Any, **kwargs: t.Any
1801
+ ) -> t.Callable[[t.Callable[..., t.Any]], Command] | Command:
1802
+ """A shortcut decorator for declaring and attaching a command to
1803
+ the group. This takes the same arguments as :func:`command` and
1804
+ immediately registers the created command with this group by
1805
+ calling :meth:`add_command`.
1806
+
1807
+ To customize the command class used, set the
1808
+ :attr:`command_class` attribute.
1809
+
1810
+ .. versionchanged:: 8.1
1811
+ This decorator can be applied without parentheses.
1812
+
1813
+ .. versionchanged:: 8.0
1814
+ Added the :attr:`command_class` attribute.
1815
+ """
1816
+ from .decorators import command
1817
+
1818
+ func: t.Callable[..., t.Any] | None = None
1819
+
1820
+ if args and callable(args[0]):
1821
+ assert len(args) == 1 and not kwargs, (
1822
+ "Use 'command(**kwargs)(callable)' to provide arguments."
1823
+ )
1824
+ (func,) = args
1825
+ args = ()
1826
+
1827
+ if self.command_class and kwargs.get("cls") is None:
1828
+ kwargs["cls"] = self.command_class
1829
+
1830
+ def decorator(f: t.Callable[..., t.Any]) -> Command:
1831
+ cmd: Command = command(*args, **kwargs)(f)
1832
+ self.add_command(cmd)
1833
+ return cmd
1834
+
1835
+ if func is not None:
1836
+ return decorator(func)
1837
+
1838
+ return decorator
1839
+
1840
+ @t.overload
1841
+ def group(self, __func: t.Callable[..., t.Any]) -> Group: ...
1842
+
1843
+ @t.overload
1844
+ def group(
1845
+ self, *args: t.Any, **kwargs: t.Any
1846
+ ) -> t.Callable[[t.Callable[..., t.Any]], Group]: ...
1847
+
1848
+ def group(
1849
+ self, *args: t.Any, **kwargs: t.Any
1850
+ ) -> t.Callable[[t.Callable[..., t.Any]], Group] | Group:
1851
+ """A shortcut decorator for declaring and attaching a group to
1852
+ the group. This takes the same arguments as :func:`group` and
1853
+ immediately registers the created group with this group by
1854
+ calling :meth:`add_command`.
1855
+
1856
+ To customize the group class used, set the :attr:`group_class`
1857
+ attribute.
1858
+
1859
+ .. versionchanged:: 8.1
1860
+ This decorator can be applied without parentheses.
1861
+
1862
+ .. versionchanged:: 8.0
1863
+ Added the :attr:`group_class` attribute.
1864
+ """
1865
+ from .decorators import group
1866
+
1867
+ func: t.Callable[..., t.Any] | None = None
1868
+
1869
+ if args and callable(args[0]):
1870
+ assert len(args) == 1 and not kwargs, (
1871
+ "Use 'group(**kwargs)(callable)' to provide arguments."
1872
+ )
1873
+ (func,) = args
1874
+ args = ()
1875
+
1876
+ if self.group_class is not None and kwargs.get("cls") is None:
1877
+ if self.group_class is type:
1878
+ kwargs["cls"] = type(self)
1879
+ else:
1880
+ kwargs["cls"] = self.group_class
1881
+
1882
+ def decorator(f: t.Callable[..., t.Any]) -> Group:
1883
+ cmd: Group = group(*args, **kwargs)(f)
1884
+ self.add_command(cmd)
1885
+ return cmd
1886
+
1887
+ if func is not None:
1888
+ return decorator(func)
1889
+
1890
+ return decorator
1891
+
1892
+ def result_callback(self, replace: bool = False) -> t.Callable[[F], F]:
1893
+ """Adds a result callback to the command. By default if a
1894
+ result callback is already registered this will chain them but
1895
+ this can be disabled with the `replace` parameter. The result
1896
+ callback is invoked with the return value of the subcommand
1897
+ (or the list of return values from all subcommands if chaining
1898
+ is enabled) as well as the parameters as they would be passed
1899
+ to the main callback.
1900
+
1901
+ Example::
1902
+
1903
+ @click.group()
1904
+ @click.option('-i', '--input', default=23)
1905
+ def cli(input):
1906
+ return 42
1907
+
1908
+ @cli.result_callback()
1909
+ def process_result(result, input):
1910
+ return result + input
1911
+
1912
+ :param replace: if set to `True` an already existing result
1913
+ callback will be removed.
1914
+
1915
+ .. versionchanged:: 8.0
1916
+ Renamed from ``resultcallback``.
1917
+
1918
+ .. versionadded:: 3.0
1919
+ """
1920
+
1921
+ def decorator(f: F) -> F:
1922
+ old_callback = self._result_callback
1923
+
1924
+ if old_callback is None or replace:
1925
+ self._result_callback = f
1926
+ return f
1927
+
1928
+ def function(value: t.Any, /, *args: t.Any, **kwargs: t.Any) -> t.Any:
1929
+ inner = old_callback(value, *args, **kwargs)
1930
+ return f(inner, *args, **kwargs)
1931
+
1932
+ self._result_callback = rv = update_wrapper(t.cast(F, function), f)
1933
+ return rv # type: ignore[return-value]
1934
+
1935
+ return decorator
1936
+
1937
+ def get_command(self, ctx: Context, cmd_name: str) -> Command | None:
1938
+ """Given a context and a command name, this returns a :class:`Command`
1939
+ object if it exists or returns ``None``.
1940
+ """
1941
+ return self.commands.get(cmd_name)
1942
+
1943
+ def list_commands(self, ctx: Context) -> list[str]:
1944
+ """Returns a list of subcommand names in the order they should appear."""
1945
+ return sorted(self.commands)
1946
+
1947
+ def collect_usage_pieces(self, ctx: Context) -> list[str]:
1948
+ rv = super().collect_usage_pieces(ctx)
1949
+ rv.append(self.subcommand_metavar)
1950
+ return rv
1951
+
1952
+ def format_options(self, ctx: Context, formatter: HelpFormatter) -> None:
1953
+ super().format_options(ctx, formatter)
1954
+ self.format_commands(ctx, formatter)
1955
+
1956
+ def format_commands(self, ctx: Context, formatter: HelpFormatter) -> None:
1957
+ """Extra format methods for multi methods that adds all the commands
1958
+ after the options.
1959
+ """
1960
+ commands = []
1961
+ for subcommand in self.list_commands(ctx):
1962
+ cmd = self.get_command(ctx, subcommand)
1963
+ # What is this, the tool lied about a command. Ignore it
1964
+ if cmd is None:
1965
+ continue
1966
+ if cmd.hidden:
1967
+ continue
1968
+
1969
+ commands.append((subcommand, cmd))
1970
+
1971
+ # allow for 3 times the default spacing
1972
+ if len(commands):
1973
+ limit = formatter.width - 6 - max(len(cmd[0]) for cmd in commands)
1974
+
1975
+ rows = []
1976
+ for subcommand, cmd in commands:
1977
+ help = cmd.get_short_help_str(limit)
1978
+ rows.append((subcommand, help))
1979
+
1980
+ if rows:
1981
+ with formatter.section(_("Commands")):
1982
+ formatter.write_dl(rows)
1983
+
1984
+ def parse_args(self, ctx: Context, args: list[str]) -> list[str]:
1985
+ if not args and self.no_args_is_help and not ctx.resilient_parsing:
1986
+ raise NoArgsIsHelpError(ctx)
1987
+
1988
+ rest = super().parse_args(ctx, args)
1989
+
1990
+ if self.chain:
1991
+ ctx._protected_args = rest
1992
+ ctx.args = []
1993
+ elif rest:
1994
+ ctx._protected_args, ctx.args = rest[:1], rest[1:]
1995
+
1996
+ return ctx.args
1997
+
1998
+ def invoke(self, ctx: Context) -> t.Any:
1999
+ def _process_result(value: t.Any) -> t.Any:
2000
+ if self._result_callback is not None:
2001
+ value = ctx.invoke(self._result_callback, value, **ctx.params)
2002
+ return value
2003
+
2004
+ if not ctx._protected_args:
2005
+ if self.invoke_without_command:
2006
+ # No subcommand was invoked, so the result callback is
2007
+ # invoked with the group return value for regular
2008
+ # groups, or an empty list for chained groups.
2009
+ with ctx:
2010
+ rv = super().invoke(ctx)
2011
+ return _process_result([] if self.chain else rv)
2012
+ ctx.fail(_("Missing command."))
2013
+
2014
+ # Fetch args back out
2015
+ args = [*ctx._protected_args, *ctx.args]
2016
+ ctx.args = []
2017
+ ctx._protected_args = []
2018
+
2019
+ # If we're not in chain mode, we only allow the invocation of a
2020
+ # single command but we also inform the current context about the
2021
+ # name of the command to invoke.
2022
+ if not self.chain:
2023
+ # Make sure the context is entered so we do not clean up
2024
+ # resources until the result processor has worked.
2025
+ with ctx:
2026
+ cmd_name, cmd, args = self.resolve_command(ctx, args)
2027
+ assert cmd is not None
2028
+ ctx.invoked_subcommand = cmd_name
2029
+ super().invoke(ctx)
2030
+ sub_ctx = cmd.make_context(cmd_name, args, parent=ctx)
2031
+ with sub_ctx:
2032
+ return _process_result(sub_ctx.command.invoke(sub_ctx))
2033
+
2034
+ # In chain mode we create the contexts step by step, but after the
2035
+ # base command has been invoked. Because at that point we do not
2036
+ # know the subcommands yet, the invoked subcommand attribute is
2037
+ # set to ``*`` to inform the command that subcommands are executed
2038
+ # but nothing else.
2039
+ with ctx:
2040
+ ctx.invoked_subcommand = "*" if args else None
2041
+ super().invoke(ctx)
2042
+
2043
+ # Otherwise we make every single context and invoke them in a
2044
+ # chain. In that case the return value to the result processor
2045
+ # is the list of all invoked subcommand's results.
2046
+ contexts = []
2047
+ while args:
2048
+ cmd_name, cmd, args = self.resolve_command(ctx, args)
2049
+ assert cmd is not None
2050
+ sub_ctx = cmd.make_context(
2051
+ cmd_name,
2052
+ args,
2053
+ parent=ctx,
2054
+ allow_extra_args=True,
2055
+ allow_interspersed_args=False,
2056
+ )
2057
+ contexts.append(sub_ctx)
2058
+ args, sub_ctx.args = sub_ctx.args, []
2059
+
2060
+ rv = []
2061
+ for sub_ctx in contexts:
2062
+ with sub_ctx:
2063
+ rv.append(sub_ctx.command.invoke(sub_ctx))
2064
+ return _process_result(rv)
2065
+
2066
+ def resolve_command(
2067
+ self, ctx: Context, args: list[str]
2068
+ ) -> tuple[str | None, Command | None, list[str]]:
2069
+ cmd_name = make_str(args[0])
2070
+
2071
+ # Get the command
2072
+ cmd = self.get_command(ctx, cmd_name)
2073
+
2074
+ # If we can't find the command but there is a normalization
2075
+ # function available, we try with that one.
2076
+ if cmd is None and ctx.token_normalize_func is not None:
2077
+ cmd_name = ctx.token_normalize_func(cmd_name)
2078
+ cmd = self.get_command(ctx, cmd_name)
2079
+
2080
+ # If we don't find the command we want to show an error message
2081
+ # to the user that it was not provided. However, there is
2082
+ # something else we should do: if the first argument looks like
2083
+ # an option we want to kick off parsing again for arguments to
2084
+ # resolve things like --help which now should go to the main
2085
+ # place.
2086
+ if cmd is None and not ctx.resilient_parsing:
2087
+ if _split_opt(cmd_name)[0]:
2088
+ self.parse_args(ctx, args)
2089
+ raise NoSuchCommand(cmd_name, possibilities=self.commands, ctx=ctx)
2090
+ return cmd_name if cmd else None, cmd, args[1:]
2091
+
2092
+ def shell_complete(self, ctx: Context, incomplete: str) -> list[CompletionItem]:
2093
+ """Return a list of completions for the incomplete value. Looks
2094
+ at the names of options, subcommands, and chained
2095
+ multi-commands.
2096
+
2097
+ :param ctx: Invocation context for this command.
2098
+ :param incomplete: Value being completed. May be empty.
2099
+
2100
+ .. versionadded:: 8.0
2101
+ """
2102
+ from click.shell_completion import CompletionItem
2103
+
2104
+ results = [
2105
+ CompletionItem(name, help=command.get_short_help_str())
2106
+ for name, command in _complete_visible_commands(ctx, incomplete)
2107
+ ]
2108
+ results.extend(super().shell_complete(ctx, incomplete))
2109
+ return results
2110
+
2111
+
2112
+ class _MultiCommand(Group, metaclass=_FakeSubclassCheck):
2113
+ """
2114
+ .. deprecated:: 8.2
2115
+ Will be removed in Click 9.0. Use ``Group`` instead.
2116
+ """
2117
+
2118
+
2119
+ class CommandCollection(Group):
2120
+ """A :class:`Group` that looks up subcommands on other groups. If a command
2121
+ is not found on this group, each registered source is checked in order.
2122
+ Parameters on a source are not added to this group, and a source's callback
2123
+ is not invoked when invoking its commands. In other words, this "flattens"
2124
+ commands in many groups into this one group.
2125
+
2126
+ :param name: The name of the group command.
2127
+ :param sources: A list of :class:`Group` objects to look up commands from.
2128
+ :param kwargs: Other arguments passed to :class:`Group`.
2129
+
2130
+ .. versionchanged:: 8.2
2131
+ This is a subclass of ``Group``. Commands are looked up first on this
2132
+ group, then each of its sources.
2133
+ """
2134
+
2135
+ sources: list[Group]
2136
+
2137
+ def __init__(
2138
+ self,
2139
+ name: str | None = None,
2140
+ sources: list[Group] | None = None,
2141
+ **kwargs: t.Any,
2142
+ ) -> None:
2143
+ super().__init__(name, **kwargs)
2144
+ #: The list of registered groups.
2145
+ self.sources = sources or []
2146
+
2147
+ def add_source(self, group: Group) -> None:
2148
+ """Add a group as a source of commands."""
2149
+ self.sources.append(group)
2150
+
2151
+ def get_command(self, ctx: Context, cmd_name: str) -> Command | None:
2152
+ rv = super().get_command(ctx, cmd_name)
2153
+
2154
+ if rv is not None:
2155
+ return rv
2156
+
2157
+ for source in self.sources:
2158
+ rv = source.get_command(ctx, cmd_name)
2159
+
2160
+ if rv is not None:
2161
+ if self.chain:
2162
+ _check_nested_chain(self, cmd_name, rv)
2163
+
2164
+ return rv
2165
+
2166
+ return None
2167
+
2168
+ def list_commands(self, ctx: Context) -> list[str]:
2169
+ rv: set[str] = set(super().list_commands(ctx))
2170
+
2171
+ for source in self.sources:
2172
+ rv.update(source.list_commands(ctx))
2173
+
2174
+ return sorted(rv)
2175
+
2176
+
2177
+ def _check_iter(value: cabc.Iterable[V]) -> cabc.Iterator[V]:
2178
+ """Check if the value is iterable but not a string. Raises a type
2179
+ error, or return an iterator over the value.
2180
+ """
2181
+ if isinstance(value, str):
2182
+ raise TypeError
2183
+
2184
+ return iter(value)
2185
+
2186
+
2187
+ class Parameter(ABC):
2188
+ r"""A parameter to a command comes in two versions: they are either
2189
+ :class:`Option`\s or :class:`Argument`\s. Other subclasses are currently
2190
+ not supported by design as some of the internals for parsing are
2191
+ intentionally not finalized.
2192
+
2193
+ Some settings are supported by both options and arguments.
2194
+
2195
+ :param param_decls: the parameter declarations for this option or
2196
+ argument. This is a list of flags or argument
2197
+ names.
2198
+ :param type: the type that should be used. Either a :class:`ParamType`
2199
+ or a Python type. The latter is converted into the former
2200
+ automatically if supported.
2201
+ :param required: controls if this is optional or not.
2202
+ :param default: the default value if omitted. This can also be a callable,
2203
+ in which case it's invoked when the default is needed
2204
+ without any arguments.
2205
+ :param callback: A function to further process or validate the value
2206
+ after type conversion. It is called as ``f(ctx, param, value)``
2207
+ and must return the value. It is called for all sources,
2208
+ including prompts.
2209
+ :param nargs: the number of arguments to match. If not ``1`` the return
2210
+ value is a tuple instead of single value. The default for
2211
+ nargs is ``1`` (except if the type is a tuple, then it's
2212
+ the arity of the tuple). If ``nargs=-1``, all remaining
2213
+ parameters are collected.
2214
+ :param metavar: how the value is represented in the help page.
2215
+ :param expose_value: if this is `True` then the value is passed onwards
2216
+ to the command callback and stored on the context,
2217
+ otherwise it's skipped.
2218
+ :param is_eager: eager values are processed before non eager ones. This
2219
+ should not be set for arguments or it will inverse the
2220
+ order of processing.
2221
+ :param envvar: environment variable(s) that are used to provide a default value for
2222
+ this parameter. This can be a string or a sequence of strings. If a sequence is
2223
+ given, only the first non-empty environment variable is used for the parameter.
2224
+ :param shell_complete: A function that returns custom shell
2225
+ completions. Used instead of the param's type completion if
2226
+ given. Takes ``ctx, param, incomplete`` and must return a list
2227
+ of :class:`~click.shell_completion.CompletionItem` or a list of
2228
+ strings.
2229
+ :param deprecated: If ``True`` or non-empty string, issues a message
2230
+ indicating that the argument is deprecated and highlights
2231
+ its deprecation in --help. The message can be customized
2232
+ by using a string as the value. A deprecated parameter
2233
+ cannot be required, a ValueError will be raised otherwise.
2234
+
2235
+ .. versionchanged:: 8.2.0
2236
+ Introduction of ``deprecated``.
2237
+
2238
+ .. versionchanged:: 8.2
2239
+ Adding duplicate parameter names to a :class:`~click.core.Command` will
2240
+ result in a ``UserWarning`` being shown.
2241
+
2242
+ .. versionchanged:: 8.2
2243
+ Adding duplicate parameter names to a :class:`~click.core.Command` will
2244
+ result in a ``UserWarning`` being shown.
2245
+
2246
+ .. versionchanged:: 8.0
2247
+ ``process_value`` validates required parameters and bounded
2248
+ ``nargs``, and invokes the parameter callback before returning
2249
+ the value. This allows the callback to validate prompts.
2250
+ ``full_process_value`` is removed.
2251
+
2252
+ .. versionchanged:: 8.0
2253
+ ``autocompletion`` is renamed to ``shell_complete`` and has new
2254
+ semantics described above. The old name is deprecated and will
2255
+ be removed in 8.1, until then it will be wrapped to match the
2256
+ new requirements.
2257
+
2258
+ .. versionchanged:: 8.0
2259
+ For ``multiple=True, nargs>1``, the default must be a list of
2260
+ tuples.
2261
+
2262
+ .. versionchanged:: 8.0
2263
+ Setting a default is no longer required for ``nargs>1``, it will
2264
+ default to ``None``. ``multiple=True`` or ``nargs=-1`` will
2265
+ default to ``()``.
2266
+
2267
+ .. versionchanged:: 7.1
2268
+ Empty environment variables are ignored rather than taking the
2269
+ empty string value. This makes it possible for scripts to clear
2270
+ variables if they can't unset them.
2271
+
2272
+ .. versionchanged:: 2.0
2273
+ Changed signature for parameter callback to also be passed the
2274
+ parameter. The old callback format will still work, but it will
2275
+ raise a warning to give you a chance to migrate the code easier.
2276
+ """
2277
+
2278
+ param_type_name = "parameter"
2279
+
2280
+ name: str
2281
+ opts: list[str]
2282
+ secondary_opts: list[str]
2283
+ # `Parameter.type` is annotated in `__init__` to avoid confusing mypy
2284
+ required: bool
2285
+ callback: t.Callable[[Context, Parameter, t.Any], t.Any] | None
2286
+ nargs: int
2287
+ multiple: bool
2288
+ expose_value: bool
2289
+ default: t.Any | t.Callable[[], t.Any] | None
2290
+ _default_explicit: bool
2291
+ is_eager: bool
2292
+ metavar: str | None
2293
+ envvar: str | cabc.Sequence[str] | None
2294
+ _custom_shell_complete: (
2295
+ t.Callable[[Context, Parameter, str], list[CompletionItem] | list[str]] | None
2296
+ )
2297
+ deprecated: bool | str
2298
+
2299
+ def __init__(
2300
+ self,
2301
+ param_decls: cabc.Sequence[str] | None = None,
2302
+ type: types.ParamType[t.Any] | t.Any | None = None,
2303
+ required: bool = False,
2304
+ # XXX The default historically embed two concepts:
2305
+ # - the declaration of a Parameter object carrying the default (handy to
2306
+ # arbitrage the default value of coupled Parameters sharing the same
2307
+ # self.name, like flag options),
2308
+ # - and the actual value of the default.
2309
+ # It is confusing and is the source of many issues discussed in:
2310
+ # https://github.com/pallets/click/pull/3030
2311
+ # In the future, we might think of splitting it in two, not unlike
2312
+ # Option.is_flag and Option.flag_value: we could have something like
2313
+ # Parameter.is_default and Parameter.default_value.
2314
+ default: t.Any | t.Callable[[], t.Any] | None = UNSET,
2315
+ callback: t.Callable[[Context, Parameter, t.Any], t.Any] | None = None,
2316
+ nargs: int | None = None,
2317
+ multiple: bool = False,
2318
+ metavar: str | None = None,
2319
+ expose_value: bool = True,
2320
+ is_eager: bool = False,
2321
+ envvar: str | cabc.Sequence[str] | None = None,
2322
+ shell_complete: t.Callable[
2323
+ [Context, Parameter, str], list[CompletionItem] | list[str]
2324
+ ]
2325
+ | None = None,
2326
+ deprecated: bool | str = False,
2327
+ ) -> None:
2328
+ self.name, self.opts, self.secondary_opts = self._parse_decls(
2329
+ param_decls or (), expose_value
2330
+ )
2331
+ self.type: types.ParamType[t.Any] = types.convert_type(type, default)
2332
+
2333
+ # Default nargs to what the type tells us if we have that
2334
+ # information available.
2335
+ if nargs is None:
2336
+ if self.type.is_composite:
2337
+ nargs = self.type.arity
2338
+ else:
2339
+ nargs = 1
2340
+
2341
+ self.required = required
2342
+ self.callback = callback
2343
+ self.nargs = nargs
2344
+ self.multiple = multiple
2345
+ self.expose_value = expose_value
2346
+ self.default = default
2347
+ # Whether the user passed ``default`` explicitly to the constructor.
2348
+ # Captured before any auto-derived default (like ``False`` for boolean
2349
+ # flags in :class:`Option`) replaces the :data:`UNSET` sentinel, so it
2350
+ # remains ``False`` when the default was inferred rather than chosen.
2351
+ # Refs: https://github.com/pallets/click/issues/3403
2352
+ self._default_explicit = default is not UNSET
2353
+ self.is_eager = is_eager
2354
+ self.metavar = metavar
2355
+ self.envvar = envvar
2356
+ self._custom_shell_complete = shell_complete
2357
+ self.deprecated = deprecated
2358
+
2359
+ if __debug__:
2360
+ if self.type.is_composite and nargs != self.type.arity:
2361
+ raise ValueError(
2362
+ f"'nargs' must be {self.type.arity} (or None) for"
2363
+ f" type {self.type!r}, but it was {nargs}."
2364
+ )
2365
+
2366
+ if required and deprecated:
2367
+ raise ValueError(
2368
+ f"The {self.param_type_name} '{self.human_readable_name}' "
2369
+ "is deprecated and still required. A deprecated "
2370
+ f"{self.param_type_name} cannot be required."
2371
+ )
2372
+
2373
+ @staticmethod
2374
+ def _hide_unset(value: t.Any) -> t.Any:
2375
+ """Present the internal :data:`UNSET` sentinel as ``None`` at a boundary that
2376
+ exposes a parameter's value (introspection, prompts), keeping the sentinel an
2377
+ implementation detail.
2378
+ """
2379
+ return None if value is UNSET else value
2380
+
2381
+ def to_info_dict(self) -> dict[str, t.Any]:
2382
+ """Gather information that could be useful for a tool generating
2383
+ user-facing documentation.
2384
+
2385
+ Use :meth:`click.Context.to_info_dict` to traverse the entire
2386
+ CLI structure.
2387
+
2388
+ .. versionchanged:: 8.3.0
2389
+ Returns ``None`` for the :attr:`default` if it was not set.
2390
+
2391
+ .. versionadded:: 8.0
2392
+ """
2393
+ return {
2394
+ "name": self.name,
2395
+ "param_type_name": self.param_type_name,
2396
+ "opts": self.opts,
2397
+ "secondary_opts": self.secondary_opts,
2398
+ "type": self.type.to_info_dict(),
2399
+ "required": self.required,
2400
+ "nargs": self.nargs,
2401
+ "multiple": self.multiple,
2402
+ "default": self._hide_unset(self.default),
2403
+ "envvar": self.envvar,
2404
+ }
2405
+
2406
+ def __repr__(self) -> str:
2407
+ return f"<{self.__class__.__name__} {self.name}>"
2408
+
2409
+ @abstractmethod
2410
+ def _parse_decls(
2411
+ self, decls: cabc.Sequence[str], expose_value: bool
2412
+ ) -> tuple[str, list[str], list[str]]: ...
2413
+
2414
+ @property
2415
+ def human_readable_name(self) -> str:
2416
+ """Returns the human readable name of this parameter. This is the
2417
+ same as the name for options, but the metavar for arguments.
2418
+ """
2419
+ return self.name
2420
+
2421
+ def make_metavar(self, ctx: Context) -> str:
2422
+ if self.metavar is not None:
2423
+ return self.metavar
2424
+
2425
+ metavar = self.type.get_metavar(param=self, ctx=ctx)
2426
+
2427
+ if metavar is None:
2428
+ metavar = self.type.name.upper()
2429
+
2430
+ if self.nargs != 1:
2431
+ metavar += "..."
2432
+
2433
+ return metavar
2434
+
2435
+ @t.overload
2436
+ def get_default(
2437
+ self, ctx: Context, call: t.Literal[True] = True
2438
+ ) -> t.Any | None: ...
2439
+
2440
+ @t.overload
2441
+ def get_default(
2442
+ self, ctx: Context, call: bool = ...
2443
+ ) -> t.Any | t.Callable[[], t.Any] | None: ...
2444
+
2445
+ def get_default(
2446
+ self, ctx: Context, call: bool = True
2447
+ ) -> t.Any | t.Callable[[], t.Any] | None:
2448
+ """Get the default for the parameter. Tries
2449
+ :meth:`Context.lookup_default` first, then the local default.
2450
+
2451
+ :param ctx: Current context.
2452
+ :param call: If the default is a callable, call it. Disable to
2453
+ return the callable instead.
2454
+
2455
+ .. versionchanged:: 8.0.2
2456
+ Type casting is no longer performed when getting a default.
2457
+
2458
+ .. versionchanged:: 8.0.1
2459
+ Type casting can fail in resilient parsing mode. Invalid
2460
+ defaults will not prevent showing help text.
2461
+
2462
+ .. versionchanged:: 8.0
2463
+ Looks at ``ctx.default_map`` first.
2464
+
2465
+ .. versionchanged:: 8.0
2466
+ Added the ``call`` parameter.
2467
+ """
2468
+ value = ctx.lookup_default(self.name, call=False)
2469
+
2470
+ if value is None and not ctx._default_map_has(self.name):
2471
+ value = self.default
2472
+
2473
+ if call and callable(value):
2474
+ value = value()
2475
+
2476
+ return value
2477
+
2478
+ @abstractmethod
2479
+ def add_to_parser(self, parser: _OptionParser, ctx: Context) -> None: ...
2480
+
2481
+ def consume_value(
2482
+ self, ctx: Context, opts: cabc.Mapping[str, t.Any]
2483
+ ) -> tuple[t.Any, ParameterSource]:
2484
+ """Returns the parameter value produced by the parser.
2485
+
2486
+ If the parser did not produce a value from user input, the value is either
2487
+ sourced from the environment variable, the default map, or the parameter's
2488
+ default value. In that order of precedence.
2489
+
2490
+ If no value is found, an internal sentinel value is returned.
2491
+
2492
+ :meta private:
2493
+ """
2494
+ # Collect from the parse the value passed by the user to the CLI.
2495
+ value = opts.get(self.name, UNSET)
2496
+ # If the value is set, it means it was sourced from the command line by the
2497
+ # parser, otherwise it left unset by default.
2498
+ source = (
2499
+ ParameterSource.COMMANDLINE
2500
+ if value is not UNSET
2501
+ else ParameterSource.DEFAULT
2502
+ )
2503
+
2504
+ if value is UNSET:
2505
+ envvar_value = self.value_from_envvar(ctx)
2506
+ if envvar_value is not None:
2507
+ value = envvar_value
2508
+ source = ParameterSource.ENVIRONMENT
2509
+
2510
+ if value is UNSET:
2511
+ default_map_value = ctx.lookup_default(self.name)
2512
+ if default_map_value is not None or ctx._default_map_has(self.name):
2513
+ value = default_map_value
2514
+ source = ParameterSource.DEFAULT_MAP
2515
+
2516
+ # A string from default_map must be split for multi-value
2517
+ # parameters, matching value_from_envvar behavior.
2518
+ if isinstance(value, str) and self.nargs != 1:
2519
+ value = self.type.split_envvar_value(value)
2520
+
2521
+ if value is UNSET:
2522
+ default_value = self.get_default(ctx)
2523
+ if default_value is not UNSET:
2524
+ value = default_value
2525
+ source = ParameterSource.DEFAULT
2526
+
2527
+ return value, source
2528
+
2529
+ def type_cast_value(self, ctx: Context, value: t.Any) -> t.Any:
2530
+ """Convert and validate a value against the parameter's
2531
+ :attr:`type`, :attr:`multiple`, and :attr:`nargs`.
2532
+ """
2533
+ if value is None:
2534
+ if self.multiple or self.nargs == -1:
2535
+ return ()
2536
+ else:
2537
+ return value
2538
+
2539
+ def check_iter(value: t.Any) -> cabc.Iterator[t.Any]:
2540
+ try:
2541
+ return _check_iter(value)
2542
+ except TypeError:
2543
+ # This should only happen when passing in args manually,
2544
+ # the parser should construct an iterable when parsing
2545
+ # the command line.
2546
+ raise BadParameter(
2547
+ _("Value must be an iterable."), ctx=ctx, param=self
2548
+ ) from None
2549
+
2550
+ # Define the conversion function based on nargs and type.
2551
+
2552
+ if self.nargs == 1 or self.type.is_composite:
2553
+
2554
+ def convert(value: t.Any) -> t.Any:
2555
+ return self.type(value, param=self, ctx=ctx)
2556
+
2557
+ elif self.nargs == -1:
2558
+
2559
+ def convert(value: t.Any) -> t.Any: # tuple[t.Any, ...]
2560
+ return tuple(self.type(x, self, ctx) for x in check_iter(value))
2561
+
2562
+ else: # nargs > 1
2563
+
2564
+ def convert(value: t.Any) -> t.Any: # tuple[t.Any, ...]
2565
+ value = tuple(check_iter(value))
2566
+
2567
+ if len(value) != self.nargs:
2568
+ raise BadParameter(
2569
+ ngettext(
2570
+ "Takes {nargs} values but 1 was given.",
2571
+ "Takes {nargs} values but {len} were given.",
2572
+ len(value),
2573
+ ).format(nargs=self.nargs, len=len(value)),
2574
+ ctx=ctx,
2575
+ param=self,
2576
+ )
2577
+
2578
+ return tuple(self.type(x, self, ctx) for x in value)
2579
+
2580
+ if self.multiple:
2581
+ return tuple(convert(x) for x in check_iter(value))
2582
+
2583
+ return convert(value)
2584
+
2585
+ def value_is_missing(self, value: t.Any) -> bool:
2586
+ """A value is considered missing if:
2587
+
2588
+ - it is :attr:`UNSET`,
2589
+ - or if it is an empty sequence while the parameter is suppose to have
2590
+ non-single value (i.e. :attr:`nargs` is not ``1`` or :attr:`multiple` is
2591
+ set).
2592
+
2593
+ :meta private:
2594
+ """
2595
+ if value is UNSET:
2596
+ return True
2597
+
2598
+ if (self.nargs != 1 or self.multiple) and value == ():
2599
+ return True
2600
+
2601
+ return False
2602
+
2603
+ def process_value(self, ctx: Context, value: t.Any) -> t.Any:
2604
+ """Process the value of this parameter:
2605
+
2606
+ 1. Type cast the value using :meth:`type_cast_value`.
2607
+ 2. Check if the value is missing (see: :meth:`value_is_missing`), and raise
2608
+ :exc:`MissingParameter` if it is required.
2609
+ 3. If a :attr:`callback` is set, call it to have the value replaced by the
2610
+ result of the callback. If the value was not set, the callback receive
2611
+ ``None``. This keep the legacy behavior as it was before the introduction of
2612
+ the :attr:`UNSET` sentinel.
2613
+
2614
+ :meta private:
2615
+ """
2616
+ # shelter `type_cast_value` from ever seeing an `UNSET` value by handling the
2617
+ # cases in which `UNSET` gets special treatment explicitly at this layer
2618
+ #
2619
+ # Refs:
2620
+ # https://github.com/pallets/click/issues/3069
2621
+ if value is UNSET:
2622
+ if self.multiple or self.nargs == -1:
2623
+ value = ()
2624
+ else:
2625
+ value = self.type_cast_value(ctx, value)
2626
+
2627
+ if self.required and self.value_is_missing(value):
2628
+ raise MissingParameter(ctx=ctx, param=self)
2629
+
2630
+ if self.callback is not None:
2631
+ # Legacy case: UNSET is not exposed directly to the callback, but converted
2632
+ # to None.
2633
+ if value is UNSET:
2634
+ value = None
2635
+
2636
+ # Search for parameters with UNSET values in the context.
2637
+ unset_keys = {k: None for k, v in ctx.params.items() if v is UNSET}
2638
+ # No UNSET values, call the callback as usual.
2639
+ if not unset_keys:
2640
+ value = self.callback(ctx, self, value)
2641
+
2642
+ # Legacy case: provide a temporarily manipulated context to the callback
2643
+ # to hide UNSET values as None.
2644
+ #
2645
+ # Refs:
2646
+ # https://github.com/pallets/click/issues/3136
2647
+ # https://github.com/pallets/click/pull/3137
2648
+ else:
2649
+ # Add another layer to the context stack to clearly hint that the
2650
+ # context is temporarily modified.
2651
+ with ctx:
2652
+ # Update the context parameters to replace UNSET with None.
2653
+ ctx.params.update(unset_keys)
2654
+ # Feed these fake context parameters to the callback.
2655
+ value = self.callback(ctx, self, value)
2656
+ # Restore the UNSET values in the context parameters.
2657
+ ctx.params.update(
2658
+ {
2659
+ k: UNSET
2660
+ for k in unset_keys
2661
+ # Only restore keys that are present and still None, in case
2662
+ # the callback modified other parameters.
2663
+ if k in ctx.params and ctx.params[k] is None
2664
+ }
2665
+ )
2666
+
2667
+ return value
2668
+
2669
+ def resolve_envvar_value(self, ctx: Context) -> str | None:
2670
+ """Returns the value found in the environment variable(s) attached to this
2671
+ parameter.
2672
+
2673
+ Environment variables values are `always returned as strings
2674
+ <https://docs.python.org/3/library/os.html#os.environ>`_.
2675
+
2676
+ This method returns ``None`` if:
2677
+
2678
+ - the :attr:`envvar` property is not set on the :class:`Parameter`,
2679
+ - the environment variable is not found in the environment,
2680
+ - the variable is found in the environment but its value is empty (i.e. the
2681
+ environment variable is present but has an empty string).
2682
+
2683
+ If :attr:`envvar` is setup with multiple environment variables,
2684
+ then only the first non-empty value is returned.
2685
+
2686
+ .. caution::
2687
+
2688
+ The raw value extracted from the environment is not normalized and is
2689
+ returned as-is. Any normalization or reconciliation is performed later by
2690
+ the :class:`Parameter`'s :attr:`type`.
2691
+
2692
+ :meta private:
2693
+ """
2694
+ if not self.envvar:
2695
+ return None
2696
+
2697
+ if isinstance(self.envvar, str):
2698
+ rv = os.environ.get(self.envvar)
2699
+
2700
+ if rv:
2701
+ return rv
2702
+ else:
2703
+ for envvar in self.envvar:
2704
+ rv = os.environ.get(envvar)
2705
+
2706
+ # Return the first non-empty value of the list of environment variables.
2707
+ if rv:
2708
+ return rv
2709
+ # Else, absence of value is interpreted as an environment variable that
2710
+ # is not set, so proceed to the next one.
2711
+
2712
+ return None
2713
+
2714
+ def value_from_envvar(self, ctx: Context) -> str | cabc.Sequence[str] | None:
2715
+ """Process the raw environment variable string for this parameter.
2716
+
2717
+ Returns the string as-is or splits it into a sequence of strings if the
2718
+ parameter is expecting multiple values (i.e. its :attr:`nargs` property is set
2719
+ to a value other than ``1``).
2720
+
2721
+ :meta private:
2722
+ """
2723
+ rv = self.resolve_envvar_value(ctx)
2724
+
2725
+ if rv is not None and self.nargs != 1:
2726
+ return self.type.split_envvar_value(rv)
2727
+
2728
+ return rv
2729
+
2730
+ def handle_parse_result(
2731
+ self, ctx: Context, opts: cabc.Mapping[str, t.Any], args: list[str]
2732
+ ) -> tuple[t.Any, list[str]]:
2733
+ """Process the value produced by the parser from user input.
2734
+
2735
+ Always process the value through the Parameter's :attr:`type`, wherever it
2736
+ comes from.
2737
+
2738
+ If the parameter is deprecated, this method warn the user about it. But only if
2739
+ the value has been explicitly set by the user (and as such, is not coming from
2740
+ a default).
2741
+
2742
+ :meta private:
2743
+ """
2744
+ # Capture the slot's existing state before we mutate
2745
+ # ``_parameter_source`` so the write decision below can compare our
2746
+ # incoming source against the source of the option that already wrote
2747
+ # the slot (if any).
2748
+ existing_value = ctx.params.get(self.name, UNSET)
2749
+ existing_source = ctx.get_parameter_source(self.name)
2750
+ existing_default_explicit = ctx._param_default_explicit.get(self.name, False)
2751
+
2752
+ with augment_usage_errors(ctx, param=self):
2753
+ value, source = self.consume_value(ctx, opts)
2754
+
2755
+ # Record the source before processing so eager callbacks and type
2756
+ # conversion can inspect it. Restored after arbitration if this
2757
+ # option loses a feature-switch group.
2758
+ ctx.set_parameter_source(self.name, source)
2759
+
2760
+ # Display a deprecation warning if necessary.
2761
+ if (
2762
+ self.deprecated
2763
+ and value is not UNSET
2764
+ and source < ParameterSource.DEFAULT_MAP
2765
+ ):
2766
+ message = _(
2767
+ "DeprecationWarning: The {param_type} {name!r} is deprecated."
2768
+ "{extra_message}"
2769
+ ).format(
2770
+ param_type=self.param_type_name,
2771
+ name=self.human_readable_name,
2772
+ extra_message=_format_deprecated_suffix(self.deprecated),
2773
+ )
2774
+ echo(style(message, fg="red"), err=True)
2775
+
2776
+ # Process the value through the parameter's type.
2777
+ try:
2778
+ value = self.process_value(ctx, value)
2779
+ except Exception:
2780
+ if not ctx.resilient_parsing:
2781
+ raise
2782
+ # In resilient parsing mode, we do not want to fail the command if the
2783
+ # value is incompatible with the parameter type, so we reset the value
2784
+ # to UNSET, which will be interpreted as a missing value.
2785
+ value = UNSET
2786
+
2787
+ # Arbitrate the slot when several parameters target the same variable
2788
+ # name (feature-switch groups). See: https://github.com/pallets/click/issues/3403
2789
+ slot_empty = existing_value is UNSET
2790
+ more_explicit = existing_source is not None and source < existing_source
2791
+ same_source = existing_source is not None and source == existing_source
2792
+ auto_would_downgrade_explicit = (
2793
+ same_source
2794
+ and source == ParameterSource.DEFAULT
2795
+ and existing_default_explicit
2796
+ and not self._default_explicit
2797
+ )
2798
+ is_winner = (
2799
+ slot_empty
2800
+ or more_explicit
2801
+ or (same_source and not auto_would_downgrade_explicit)
2802
+ )
2803
+
2804
+ if is_winner:
2805
+ if self.expose_value:
2806
+ ctx.params[self.name] = value
2807
+ ctx._param_default_explicit[self.name] = self._default_explicit
2808
+ elif existing_source is not None:
2809
+ # Lost arbitration; restore the winning option's source.
2810
+ ctx.set_parameter_source(self.name, existing_source)
2811
+ # else: ctx.params[self.name] was populated by code that bypassed
2812
+ # handle_parse_result (from another option's callback for example). Keep
2813
+ # the provisional source recorded before process_value so downstream
2814
+ # lookups don't return ``None``.
2815
+
2816
+ return value, args
2817
+
2818
+ def get_help_record(self, ctx: Context) -> tuple[str, str] | None:
2819
+ return None
2820
+
2821
+ def get_usage_pieces(self, ctx: Context) -> list[str]:
2822
+ return []
2823
+
2824
+ def get_error_hint(self, ctx: Context | None) -> str:
2825
+ """Get a stringified version of the param for use in error messages to
2826
+ indicate which param caused the error.
2827
+
2828
+ .. versionchanged:: 8.4.0
2829
+ ``ctx`` can be ``None``.
2830
+ """
2831
+ hint_list = self.opts or [self.human_readable_name]
2832
+ return " / ".join(f"'{x}'" for x in hint_list)
2833
+
2834
+ def shell_complete(self, ctx: Context, incomplete: str) -> list[CompletionItem]:
2835
+ """Return a list of completions for the incomplete value. If a
2836
+ ``shell_complete`` function was given during init, it is used.
2837
+ Otherwise, the :attr:`type`
2838
+ :meth:`~click.types.ParamType[t.Any].shell_complete` function is used.
2839
+
2840
+ :param ctx: Invocation context for this command.
2841
+ :param incomplete: Value being completed. May be empty.
2842
+
2843
+ .. versionadded:: 8.0
2844
+ """
2845
+ if self._custom_shell_complete is not None:
2846
+ results = self._custom_shell_complete(ctx, self, incomplete)
2847
+
2848
+ if results and isinstance(results[0], str):
2849
+ from click.shell_completion import CompletionItem
2850
+
2851
+ results = [CompletionItem(c) for c in results]
2852
+
2853
+ return t.cast("list[CompletionItem]", results)
2854
+
2855
+ return self.type.shell_complete(ctx, self, incomplete)
2856
+
2857
+
2858
+ class Option(Parameter):
2859
+ """Options are usually optional values on the command line and
2860
+ have some extra features that arguments don't have.
2861
+
2862
+ All other parameters are passed onwards to the parameter constructor.
2863
+
2864
+ :param show_default: Show the default value for this option in its
2865
+ help text. Values are not shown by default, unless
2866
+ :attr:`Context.show_default` is ``True``. If this value is a
2867
+ string, it shows that string in parentheses instead of the
2868
+ actual value. This is particularly useful for dynamic options.
2869
+ For single option boolean flags, the default remains hidden if
2870
+ its value is ``False``.
2871
+ :param show_envvar: Controls if an environment variable should be
2872
+ shown on the help page and error messages.
2873
+ Normally, environment variables are not shown.
2874
+ :param prompt: If set to ``True`` or a non empty string then the
2875
+ user will be prompted for input. If set to ``True`` the prompt
2876
+ will be the option name capitalized. A deprecated option cannot be
2877
+ prompted.
2878
+ :param confirmation_prompt: Prompt a second time to confirm the
2879
+ value if it was prompted for. Can be set to a string instead of
2880
+ ``True`` to customize the message.
2881
+ :param prompt_required: If set to ``False``, the user will be
2882
+ prompted for input only when the option was specified as a flag
2883
+ without a value.
2884
+ :param hide_input: If this is ``True`` then the input on the prompt
2885
+ will be hidden from the user. This is useful for password input.
2886
+ :param is_flag: forces this option to act as a flag. The default is
2887
+ auto detection.
2888
+ :param flag_value: which value should be used for this flag if it's
2889
+ enabled. This is set to a boolean automatically if
2890
+ the option string contains a slash to mark two options.
2891
+ :param multiple: if this is set to `True` then the argument is accepted
2892
+ multiple times and recorded. This is similar to ``nargs``
2893
+ in how it works but supports arbitrary number of
2894
+ arguments.
2895
+ :param count: this flag makes an option increment an integer.
2896
+ :param allow_from_autoenv: if this is enabled then the value of this
2897
+ parameter will be pulled from an environment
2898
+ variable in case a prefix is defined on the
2899
+ context.
2900
+ :param help: the help string.
2901
+ :param hidden: hide this option from help outputs.
2902
+ :param attrs: Other command arguments described in :class:`Parameter`.
2903
+
2904
+ .. versionchanged:: 8.4.0
2905
+ Non-basic ``flag_value`` types (not ``str``, ``int``, ``float``, or
2906
+ ``bool``) are passed through unchanged instead of being stringified.
2907
+ Previously, ``type=click.UNPROCESSED`` was required to preserve them.
2908
+
2909
+ .. versionchanged:: 8.2
2910
+ ``envvar`` used with ``flag_value`` will always use the ``flag_value``,
2911
+ previously it would use the value of the environment variable.
2912
+
2913
+ .. versionchanged:: 8.1
2914
+ Help text indentation is cleaned here instead of only in the
2915
+ ``@option`` decorator.
2916
+
2917
+ .. versionchanged:: 8.1
2918
+ The ``show_default`` parameter overrides
2919
+ ``Context.show_default``.
2920
+
2921
+ .. versionchanged:: 8.1
2922
+ The default of a single option boolean flag is not shown if the
2923
+ default value is ``False``.
2924
+
2925
+ .. versionchanged:: 8.0.1
2926
+ ``type`` is detected from ``flag_value`` if given, for basic Python
2927
+ types (``str``, ``int``, ``float``, ``bool``).
2928
+ """
2929
+
2930
+ param_type_name = "option"
2931
+
2932
+ prompt: str | None
2933
+ confirmation_prompt: bool | str
2934
+ prompt_required: bool
2935
+ hide_input: bool
2936
+ hidden: bool
2937
+
2938
+ _flag_needs_value: bool
2939
+ is_flag: bool
2940
+ flag_value: t.Any
2941
+ type: types.ParamType[t.Any]
2942
+ default: t.Any | t.Callable[[], t.Any] | None
2943
+
2944
+ count: bool
2945
+ allow_from_autoenv: bool
2946
+ help: str | None
2947
+ show_default: bool | str | None
2948
+ show_choices: bool
2949
+ show_envvar: bool
2950
+
2951
+ def __init__(
2952
+ self,
2953
+ param_decls: cabc.Sequence[str] | None = None,
2954
+ show_default: bool | str | None = None,
2955
+ prompt: bool | str = False,
2956
+ confirmation_prompt: bool | str = False,
2957
+ prompt_required: bool = True,
2958
+ hide_input: bool = False,
2959
+ is_flag: bool | None = None,
2960
+ flag_value: t.Any = UNSET,
2961
+ multiple: bool = False,
2962
+ count: bool = False,
2963
+ allow_from_autoenv: bool = True,
2964
+ type: types.ParamType[t.Any] | t.Any | None = None,
2965
+ help: str | None = None,
2966
+ hidden: bool = False,
2967
+ show_choices: bool = True,
2968
+ show_envvar: bool = False,
2969
+ deprecated: bool | str = False,
2970
+ **attrs: t.Any,
2971
+ ) -> None:
2972
+ if help:
2973
+ help = inspect.cleandoc(help)
2974
+
2975
+ super().__init__(
2976
+ param_decls, type=type, multiple=multiple, deprecated=deprecated, **attrs
2977
+ )
2978
+
2979
+ # Phase 1: prompt-related attributes. ``_infer_flag_kind`` reads ``self.prompt``
2980
+ # and ``self.prompt_required`` so this must run first.
2981
+ if prompt is True:
2982
+ if not self.name:
2983
+ raise TypeError("'name' is required with 'prompt=True'.")
2984
+
2985
+ prompt_text = self.name.replace("_", " ").capitalize()
2986
+ elif prompt is False:
2987
+ prompt_text = None
2988
+ else:
2989
+ prompt_text = prompt
2990
+
2991
+ if deprecated:
2992
+ label = _format_deprecated_label(deprecated)
2993
+ help = f"{help} {label}" if help else label
2994
+
2995
+ self.prompt = prompt_text
2996
+ self.confirmation_prompt = confirmation_prompt
2997
+ self.prompt_required = prompt_required
2998
+ self.hide_input = hide_input
2999
+ self.hidden = hidden
3000
+
3001
+ # Phase 2: flag-kind inference.
3002
+ self.is_flag, self._flag_needs_value = self._infer_flag_kind(
3003
+ is_flag, flag_value
3004
+ )
3005
+
3006
+ # Phase 3: type inference. Override the type set by :meth:`Parameter.__init__`
3007
+ # when this option is a flag or a count.
3008
+ self.type = self._pick_type(type, flag_value, count, self.is_flag)
3009
+
3010
+ # Phase 4: store the raw ``flag_value`` and ``count`` settings.
3011
+ # ``self.flag_value`` and ``self.default`` deliberately keep the :data:`UNSET`
3012
+ # sentinel when the user didn't pass them. Auto-derived values are resolved
3013
+ # lazily in :meth:`_resolve_lazy_default` and :attr:`flag_activation_value`.
3014
+ # Keeping the raw values means ``is UNSET`` reliably answers "did the user pass
3015
+ # this?": #3403 needs it for arbitration, and any future feature needing the
3016
+ # same distinction can reuse it without reintroducing parallel "was it
3017
+ # explicit?" tracking.
3018
+ self.flag_value = flag_value
3019
+ self.count = count
3020
+ if count and self.default is UNSET:
3021
+ self.default = 0
3022
+
3023
+ self.allow_from_autoenv = allow_from_autoenv
3024
+ self.help = help
3025
+ self.show_default = show_default
3026
+ self.show_choices = show_choices
3027
+ self.show_envvar = show_envvar
3028
+
3029
+ # Phase 5: validate. Raises on illegal kwarg combinations.
3030
+ self._validate(prompt, deprecated)
3031
+
3032
+ @property
3033
+ def is_bool_flag(self) -> bool:
3034
+ """``True`` when this option is a flag with a boolean type.
3035
+
3036
+ Derived from :attr:`is_flag` and :attr:`type`; computed on access so it cannot
3037
+ drift if a subclass replaces :attr:`type` after construction.
3038
+ """
3039
+ return self.is_flag and isinstance(self.type, types.BoolParamType)
3040
+
3041
+ @property
3042
+ def flag_activation_value(self) -> t.Any:
3043
+ """Value the function receives when this flag is activated on the command line.
3044
+
3045
+ Resolves a missing :attr:`flag_value` to ``True`` for actual flag options and
3046
+ ``None`` otherwise. Used by the parser bridge (:meth:`add_to_parser`) and the
3047
+ runtime (:meth:`consume_value`) so :attr:`flag_value` can keep the :data:`UNSET`
3048
+ sentinel for "did the user pass one?" introspection.
3049
+ """
3050
+ if self.flag_value is UNSET:
3051
+ return True if self.is_flag else None
3052
+ return self.flag_value
3053
+
3054
+ def _infer_flag_kind(
3055
+ self, is_flag: bool | None, flag_value: t.Any
3056
+ ) -> tuple[bool, bool]:
3057
+ """Resolve ``is_flag`` and the parser hint ``_flag_needs_value``.
3058
+
3059
+ Returns ``(is_flag, flag_needs_value)``, where ``_flag_needs_value`` tells the
3060
+ parser this option is a flag that cannot be used standalone and needs a value.
3061
+ The parser uses it to decide whether to treat the next CLI token as the flag's
3062
+ value or as a new option. If ``prompt`` is enabled with
3063
+ ``prompt_required=False``, it opens the door for an interactive value, hence the
3064
+ initial condition. Ref: https://github.com/pallets/click/issues/3084
3065
+ """
3066
+ needs_value = self.prompt is not None and not self.prompt_required
3067
+
3068
+ if is_flag is None:
3069
+ # Implicitly a flag because flag_value was set.
3070
+ if flag_value is not UNSET:
3071
+ return True, needs_value
3072
+ # Not a flag, but when used as a flag it shows a prompt.
3073
+ if needs_value:
3074
+ return False, needs_value
3075
+ # Implicitly a flag because secondary options names were given.
3076
+ if self.secondary_opts:
3077
+ return True, needs_value
3078
+ return False, needs_value
3079
+
3080
+ if is_flag is False and not needs_value:
3081
+ # Explicit ``is_flag=False`` with a flag-like value/default still makes the
3082
+ # option flag-shaped to the parser.
3083
+ needs_value = flag_value is not UNSET or self.default is UNSET
3084
+
3085
+ return bool(is_flag), needs_value
3086
+
3087
+ def _pick_type(
3088
+ self,
3089
+ type_arg: t.Any,
3090
+ flag_value: t.Any,
3091
+ count: bool,
3092
+ is_flag: bool,
3093
+ ) -> types.ParamType[t.Any]:
3094
+ """Pick the final :class:`ParamType` for this option.
3095
+
3096
+ :meth:`Parameter.__init__` already stored ``self.type`` from the explicit
3097
+ ``type`` argument or from ``default``. This method either returns that as-is, or
3098
+ overrides it for flag and count options (which are inferred from ``flag_value``
3099
+ rather than ``default``).
3100
+ """
3101
+ if type_arg is not None:
3102
+ return self.type
3103
+
3104
+ if count:
3105
+ return types.IntRange(min=0)
3106
+
3107
+ if not is_flag:
3108
+ return self.type
3109
+
3110
+ # A flag without a flag_value is a boolean flag.
3111
+ if flag_value is UNSET or isinstance(flag_value, bool):
3112
+ return types.BoolParamType()
3113
+
3114
+ guessed: types.ParamType[t.Any] = types.convert_type(None, flag_value)
3115
+ if (
3116
+ isinstance(guessed, types.StringParamType)
3117
+ and not isinstance(flag_value, str)
3118
+ and flag_value is not None
3119
+ ):
3120
+ # The flag_value type couldn't be auto-detected (not str, int, float, or
3121
+ # bool). Since flag_value is a programmer-provided Python object, not CLI
3122
+ # input, pass it through unchanged instead of stringifying it.
3123
+ return types.UNPROCESSED
3124
+ return guessed
3125
+
3126
+ def _resolve_lazy_default(self, value: t.Any) -> t.Any:
3127
+ """Apply lazy auto-derivations to a default-style value.
3128
+
3129
+ Shared between :meth:`get_default` (the runtime path) and :meth:`to_info_dict`
3130
+ (the introspection path) so the two views cannot drift apart. Callables are
3131
+ *not* invoked here: that is :meth:`get_default`'s responsibility. Rules:
3132
+
3133
+ * ``UNSET`` resolves to ``False`` for a non-required boolean flag, and to ``()``
3134
+ for a non-required, non-prompted multi flag.
3135
+ * ``True`` resolves to :attr:`flag_value` for a non-boolean flag (the "activate
3136
+ this flag by default" shorthand). Boolean flags keep ``True`` as a literal.
3137
+ """
3138
+ if value is UNSET and self.is_flag:
3139
+ if self.multiple and not self.required and not self.prompt:
3140
+ return ()
3141
+ if self.is_bool_flag and not self.required:
3142
+ return False
3143
+ if value is True and self.is_flag and not self.is_bool_flag:
3144
+ # Use ``flag_activation_value`` so an unset ``flag_value`` resolves to
3145
+ # ``True`` (the bool-flag activation value) rather than leaking the
3146
+ # :data:`UNSET` sentinel.
3147
+ return self.flag_activation_value
3148
+ return value
3149
+
3150
+ def _validate(self, prompt: bool | str, deprecated: bool | str) -> None:
3151
+ """Raise :class:`TypeError` / :class:`ValueError` on illegal kwarg combinations.
3152
+
3153
+ Called once, after every other attribute has been assigned, so each check can
3154
+ read the final state.
3155
+ """
3156
+ if not __debug__:
3157
+ return
3158
+ if deprecated and prompt:
3159
+ raise ValueError("`deprecated` options cannot use `prompt`.")
3160
+ if self.nargs == -1:
3161
+ raise TypeError("nargs=-1 is not supported for options.")
3162
+ if not self.is_bool_flag and self.secondary_opts:
3163
+ raise TypeError("Secondary flag is not valid for non-boolean flag.")
3164
+ if self.is_bool_flag and self.hide_input and self.prompt is not None:
3165
+ raise TypeError("'prompt' with 'hide_input' is not valid for boolean flag.")
3166
+ if self.count:
3167
+ if self.multiple:
3168
+ raise TypeError("'count' is not valid with 'multiple'.")
3169
+ if self.is_flag:
3170
+ raise TypeError("'count' is not valid with 'is_flag'.")
3171
+
3172
+ def to_info_dict(self) -> dict[str, t.Any]:
3173
+ """
3174
+ .. versionchanged:: 8.5.0
3175
+ ``default`` and ``flag_value`` reflect the auto-derived values (``False``
3176
+ for unset boolean-flag defaults, ``True`` for unset boolean-flag activation
3177
+ values, etc.) when no explicit value was passed, matching what the function
3178
+ would receive at call time.
3179
+
3180
+ .. versionchanged:: 8.3.0
3181
+ Returns ``None`` for the :attr:`flag_value` if it was not set.
3182
+ """
3183
+ info_dict = super().to_info_dict()
3184
+ info_dict.update(
3185
+ default=self._hide_unset(self._resolve_lazy_default(self.default)),
3186
+ help=self.help,
3187
+ prompt=self.prompt,
3188
+ is_flag=self.is_flag,
3189
+ flag_value=self.flag_activation_value,
3190
+ count=self.count,
3191
+ hidden=self.hidden,
3192
+ )
3193
+ return info_dict
3194
+
3195
+ def get_default(
3196
+ self, ctx: Context, call: bool = True
3197
+ ) -> t.Any | t.Callable[[], t.Any] | None:
3198
+ """Return the default value for this option.
3199
+
3200
+ Several auto-derived defaults are resolved lazily here rather than eagerly in
3201
+ :meth:`__init__`. This keeps :attr:`default` raw at construction time, so
3202
+ ``self.default is UNSET`` reliably answers "did the user pass a default?" for
3203
+ feature-switch-group arbitration and for anything else that needs to distinguish
3204
+ "absent" from a chosen value. The resolution rules live in
3205
+ :meth:`_resolve_lazy_default`.
3206
+
3207
+ .. versionchanged:: 8.5.0
3208
+ ``UNSET`` defaults for boolean and multi flags are now resolved here instead
3209
+ of being coerced in :meth:`__init__`. Reading :attr:`default` directly
3210
+ returns the user-supplied value (or ``UNSET`` if none was passed) rather
3211
+ than the auto-derived one.
3212
+
3213
+ .. versionchanged:: 8.3.3
3214
+ ``default=True`` is no longer substituted with ``flag_value`` for boolean
3215
+ flags, fixing negative boolean flags like
3216
+ ``flag_value=False, default=True``.
3217
+ """
3218
+ raw = super().get_default(ctx, call=False)
3219
+ value = self._resolve_lazy_default(raw)
3220
+ # Only invoke the value as a callable when the lazy resolver passed it through
3221
+ # unchanged. If the resolver substituted ``True`` -> :attr:`flag_value`, the
3222
+ # result is the programmer-supplied ``flag_value`` (often a class or enum),
3223
+ # which must NOT be instantiated here. See
3224
+ # https://github.com/pallets/click/issues/3121.
3225
+ if value is raw and call and callable(value):
3226
+ value = value()
3227
+ return value
3228
+
3229
+ def get_error_hint(self, ctx: Context | None) -> str:
3230
+ result = super().get_error_hint(ctx)
3231
+ if self.show_envvar and self.envvar is not None:
3232
+ result += f" (env var: '{self.envvar}')"
3233
+ return result
3234
+
3235
+ def _parse_decls(
3236
+ self, decls: cabc.Sequence[str], expose_value: bool
3237
+ ) -> tuple[str, list[str], list[str]]:
3238
+ opts = []
3239
+ secondary_opts = []
3240
+ name = None
3241
+ possible_names = []
3242
+
3243
+ for decl in decls:
3244
+ if decl.isidentifier():
3245
+ if name is not None:
3246
+ raise TypeError(_("Name '{name}' defined twice").format(name=name))
3247
+ name = decl
3248
+ else:
3249
+ split_char = ";" if decl[:1] == "/" else "/"
3250
+ if split_char in decl:
3251
+ first, second = decl.split(split_char, 1)
3252
+ first = first.rstrip()
3253
+ if first:
3254
+ possible_names.append(_split_opt(first))
3255
+ opts.append(first)
3256
+ second = second.lstrip()
3257
+ if second:
3258
+ secondary_opts.append(second.lstrip())
3259
+ if first == second:
3260
+ raise ValueError(
3261
+ _(
3262
+ "Boolean option {decl!r} cannot use the"
3263
+ " same flag for true/false."
3264
+ ).format(decl=decl)
3265
+ )
3266
+ else:
3267
+ possible_names.append(_split_opt(decl))
3268
+ opts.append(decl)
3269
+
3270
+ if name is None and possible_names:
3271
+ possible_names.sort(key=lambda x: -len(x[0])) # group long options first
3272
+ name = possible_names[0][1].replace("-", "_").lower()
3273
+ if not name.isidentifier():
3274
+ name = None
3275
+
3276
+ if name is None:
3277
+ if not expose_value:
3278
+ return "", opts, secondary_opts
3279
+ raise TypeError(
3280
+ _(
3281
+ "Could not determine name for option with declarations {decls!r}"
3282
+ ).format(decls=decls)
3283
+ )
3284
+
3285
+ if not opts and not secondary_opts:
3286
+ raise TypeError(
3287
+ _(
3288
+ "No options defined but a name was passed ({name})."
3289
+ " Did you mean to declare an argument instead? Did"
3290
+ " you mean to pass '--{name}'?"
3291
+ ).format(name=name)
3292
+ )
3293
+
3294
+ return name, opts, secondary_opts
3295
+
3296
+ def add_to_parser(self, parser: _OptionParser, ctx: Context) -> None:
3297
+ if self.multiple:
3298
+ action = "append"
3299
+ elif self.count:
3300
+ action = "count"
3301
+ else:
3302
+ action = "store"
3303
+
3304
+ if self.is_flag:
3305
+ action = f"{action}_const"
3306
+
3307
+ if self.is_bool_flag and self.secondary_opts:
3308
+ parser.add_option(
3309
+ obj=self, opts=self.opts, dest=self.name, action=action, const=True
3310
+ )
3311
+ parser.add_option(
3312
+ obj=self,
3313
+ opts=self.secondary_opts,
3314
+ dest=self.name,
3315
+ action=action,
3316
+ const=False,
3317
+ )
3318
+ else:
3319
+ parser.add_option(
3320
+ obj=self,
3321
+ opts=self.opts,
3322
+ dest=self.name,
3323
+ action=action,
3324
+ # ``flag_activation_value`` resolves UNSET to the right parser-store
3325
+ # constant (``True`` for bool flags) so the raw :attr:`flag_value`
3326
+ # can keep the sentinel.
3327
+ const=self.flag_activation_value,
3328
+ )
3329
+ else:
3330
+ parser.add_option(
3331
+ obj=self,
3332
+ opts=self.opts,
3333
+ dest=self.name,
3334
+ action=action,
3335
+ nargs=self.nargs,
3336
+ )
3337
+
3338
+ def get_help_record(self, ctx: Context) -> tuple[str, str] | None:
3339
+ if self.hidden:
3340
+ return None
3341
+
3342
+ any_prefix_is_slash = False
3343
+
3344
+ def _write_opts(opts: cabc.Sequence[str]) -> str:
3345
+ nonlocal any_prefix_is_slash
3346
+
3347
+ rv, any_slashes = join_options(opts)
3348
+
3349
+ if any_slashes:
3350
+ any_prefix_is_slash = True
3351
+
3352
+ if not self.is_flag and not self.count:
3353
+ rv += f" {self.make_metavar(ctx=ctx)}"
3354
+
3355
+ return rv
3356
+
3357
+ rv = [_write_opts(self.opts)]
3358
+
3359
+ if self.secondary_opts:
3360
+ rv.append(_write_opts(self.secondary_opts))
3361
+
3362
+ help = self.help or ""
3363
+
3364
+ extra = self.get_help_extra(ctx)
3365
+ extra_items = []
3366
+ if "envvars" in extra:
3367
+ extra_items.append(
3368
+ _("env var: {var}").format(var=", ".join(extra["envvars"]))
3369
+ )
3370
+ if "default" in extra:
3371
+ extra_items.append(_("default: {default}").format(default=extra["default"]))
3372
+ if "range" in extra:
3373
+ extra_items.append(extra["range"])
3374
+ if "required" in extra:
3375
+ extra_items.append(_(extra["required"]))
3376
+
3377
+ if extra_items:
3378
+ extra_str = "; ".join(extra_items)
3379
+ help = f"{help} [{extra_str}]" if help else f"[{extra_str}]"
3380
+
3381
+ return ("; " if any_prefix_is_slash else " / ").join(rv), help
3382
+
3383
+ def get_help_extra(self, ctx: Context) -> types.OptionHelpExtra:
3384
+ extra: types.OptionHelpExtra = {}
3385
+
3386
+ if self.show_envvar:
3387
+ envvar = self.envvar
3388
+
3389
+ if envvar is None:
3390
+ if (
3391
+ self.allow_from_autoenv
3392
+ and ctx.auto_envvar_prefix is not None
3393
+ and self.name
3394
+ ):
3395
+ envvar = f"{ctx.auto_envvar_prefix}_{self.name.upper()}"
3396
+
3397
+ if envvar is not None:
3398
+ if isinstance(envvar, str):
3399
+ extra["envvars"] = (envvar,)
3400
+ else:
3401
+ extra["envvars"] = tuple(str(d) for d in envvar)
3402
+
3403
+ # Temporarily enable resilient parsing to avoid type casting
3404
+ # failing for the default. Might be possible to extend this to
3405
+ # help formatting in general.
3406
+ resilient = ctx.resilient_parsing
3407
+ ctx.resilient_parsing = True
3408
+
3409
+ try:
3410
+ default_value = self.get_default(ctx, call=False)
3411
+ finally:
3412
+ ctx.resilient_parsing = resilient
3413
+
3414
+ show_default = False
3415
+ show_default_is_str = False
3416
+
3417
+ if self.show_default is not None:
3418
+ if isinstance(self.show_default, str):
3419
+ show_default_is_str = show_default = True
3420
+ else:
3421
+ show_default = self.show_default
3422
+ elif ctx.show_default is not None:
3423
+ show_default = ctx.show_default
3424
+
3425
+ if show_default_is_str or (
3426
+ show_default and (default_value not in (None, UNSET))
3427
+ ):
3428
+ if show_default_is_str:
3429
+ default_string = f"({self.show_default})"
3430
+ elif isinstance(default_value, (list, tuple)):
3431
+ default_string = ", ".join(str(d) for d in default_value)
3432
+ elif isinstance(default_value, enum.Enum):
3433
+ default_string = default_value.name
3434
+ elif inspect.isfunction(default_value):
3435
+ default_string = _("(dynamic)")
3436
+ elif self.is_bool_flag and self.secondary_opts:
3437
+ # For boolean flags that have distinct True/False opts,
3438
+ # use the opt without prefix instead of the value.
3439
+ default_string = _split_opt(
3440
+ (self.opts if default_value else self.secondary_opts)[0]
3441
+ )[1]
3442
+ elif self.is_bool_flag and not self.secondary_opts and not default_value:
3443
+ default_string = ""
3444
+ elif isinstance(default_value, str) and default_value == "":
3445
+ default_string = '""'
3446
+ else:
3447
+ default_string = str(default_value)
3448
+
3449
+ if default_string:
3450
+ extra["default"] = default_string
3451
+
3452
+ if (
3453
+ isinstance(self.type, types._NumberRangeBase)
3454
+ # skip count with default range type
3455
+ and not (self.count and self.type.min == 0 and self.type.max is None)
3456
+ ):
3457
+ range_str = self.type._describe_range()
3458
+
3459
+ if range_str:
3460
+ extra["range"] = range_str
3461
+
3462
+ if self.required:
3463
+ extra["required"] = "required"
3464
+
3465
+ return extra
3466
+
3467
+ def prompt_for_value(self, ctx: Context) -> t.Any:
3468
+ """This is an alternative flow that can be activated in the full
3469
+ value processing if a value does not exist. It will prompt the
3470
+ user until a valid value exists and then returns the processed
3471
+ value as result.
3472
+ """
3473
+ assert self.prompt is not None
3474
+
3475
+ # Calculate the default before prompting anything to lock in the value before
3476
+ # attempting any user interaction.
3477
+ default = self.get_default(ctx)
3478
+
3479
+ # A boolean flag can use a simplified [y/n] confirmation prompt.
3480
+ if self.is_bool_flag:
3481
+ # If we have no boolean default, we force the user to explicitly provide
3482
+ # one.
3483
+ if default in (UNSET, None):
3484
+ default = None
3485
+ # Nothing prevent you to declare an option that is simultaneously:
3486
+ # 1) auto-detected as a boolean flag,
3487
+ # 2) allowed to prompt, and
3488
+ # 3) still declare a non-boolean default.
3489
+ # This forced casting into a boolean is necessary to align any non-boolean
3490
+ # default to the prompt, which is going to be a [y/n]-style confirmation
3491
+ # because the option is still a boolean flag. That way, instead of [y/n],
3492
+ # we get [Y/n] or [y/N] depending on the truthy value of the default.
3493
+ # Refs: https://github.com/pallets/click/pull/3030#discussion_r2289180249
3494
+ else:
3495
+ default = bool(default)
3496
+ return confirm(self.prompt, default)
3497
+
3498
+ # If show_default is given, provide this to `prompt` as well,
3499
+ # otherwise we use `prompt`'s default behavior
3500
+ prompt_kwargs: t.Any = {}
3501
+ if self.show_default is not None:
3502
+ prompt_kwargs["show_default"] = self.show_default
3503
+
3504
+ return prompt(
3505
+ self.prompt,
3506
+ # Use ``None`` to inform the prompt() function to reiterate until a valid
3507
+ # value is provided by the user if we have no default.
3508
+ default=self._hide_unset(default),
3509
+ type=self.type,
3510
+ hide_input=self.hide_input,
3511
+ show_choices=self.show_choices,
3512
+ confirmation_prompt=self.confirmation_prompt,
3513
+ value_proc=lambda x: self.process_value(ctx, x),
3514
+ **prompt_kwargs,
3515
+ )
3516
+
3517
+ def resolve_envvar_value(self, ctx: Context) -> str | None:
3518
+ """:class:`Option` resolves its environment variable the same way as
3519
+ :func:`Parameter.resolve_envvar_value`, but it also supports
3520
+ :attr:`Context.auto_envvar_prefix`. If we could not find an environment from
3521
+ the :attr:`envvar` property, we fallback on :attr:`Context.auto_envvar_prefix`
3522
+ to build dynamiccaly the environment variable name using the
3523
+ :python:`{ctx.auto_envvar_prefix}_{self.name.upper()}` template.
3524
+
3525
+ :meta private:
3526
+ """
3527
+ rv = super().resolve_envvar_value(ctx)
3528
+
3529
+ if rv is not None:
3530
+ return rv
3531
+
3532
+ if self.allow_from_autoenv and ctx.auto_envvar_prefix is not None and self.name:
3533
+ envvar = f"{ctx.auto_envvar_prefix}_{self.name.upper()}"
3534
+ rv = os.environ.get(envvar)
3535
+
3536
+ if rv:
3537
+ return rv
3538
+
3539
+ return None
3540
+
3541
+ def value_from_envvar(self, ctx: Context) -> t.Any:
3542
+ """For :class:`Option`, this method processes the raw environment variable
3543
+ string the same way as :func:`Parameter.value_from_envvar` does.
3544
+
3545
+ But in the case of non-boolean flags, the value is analyzed to determine if the
3546
+ flag is activated or not, and returns a boolean of its activation, or the
3547
+ :attr:`flag_value` if the latter is set.
3548
+
3549
+ This method also takes care of repeated options (i.e. options with
3550
+ :attr:`multiple` set to ``True``).
3551
+
3552
+ :meta private:
3553
+ """
3554
+ rv = self.resolve_envvar_value(ctx)
3555
+
3556
+ # Absent environment variable or an empty string is interpreted as unset.
3557
+ if rv is None:
3558
+ return None
3559
+
3560
+ # Non-boolean flags are more liberal in what they accept. But a flag being a
3561
+ # flag, its envvar value still needs to be analyzed to determine if the flag is
3562
+ # activated or not.
3563
+ if self.is_flag and not self.is_bool_flag:
3564
+ # An exact match against ``flag_value`` (a non-bool flag always has one
3565
+ # explicitly set) returns it directly. Otherwise the value is analyzed as a
3566
+ # boolean: a truthy reading activates the flag and the function receives
3567
+ # ``flag_value``; a falsy reading produces ``False``; an unrecognized
3568
+ # reading falls through as ``None``. Folding the substitution here means
3569
+ # :meth:`consume_value` no longer has to repeat it in a source-checked
3570
+ # branch.
3571
+ if rv == self.flag_value:
3572
+ return self.flag_value
3573
+ parsed = types.BoolParamType.str_to_bool(rv)
3574
+ if parsed is None:
3575
+ return None
3576
+ return self.flag_value if parsed else False
3577
+
3578
+ # Split the envvar value if it is allowed to be repeated.
3579
+ value_depth = (self.nargs != 1) + bool(self.multiple)
3580
+ if value_depth > 0:
3581
+ multi_rv = self.type.split_envvar_value(rv)
3582
+ if self.multiple and self.nargs != 1:
3583
+ multi_rv = batch(multi_rv, self.nargs) # type: ignore[assignment]
3584
+
3585
+ return multi_rv
3586
+
3587
+ return rv
3588
+
3589
+ def consume_value(
3590
+ self, ctx: Context, opts: cabc.Mapping[str, Parameter]
3591
+ ) -> tuple[t.Any, ParameterSource]:
3592
+ """For :class:`Option`, the value can be collected from an interactive prompt
3593
+ if the option is a flag that needs a value (and the :attr:`prompt` property is
3594
+ set).
3595
+
3596
+ Additionally, this method handles flag option that are activated without a
3597
+ value, in which case the :attr:`flag_value` is returned.
3598
+
3599
+ :meta private:
3600
+ """
3601
+ value, source = super().consume_value(ctx, opts)
3602
+
3603
+ # The parser emits a sentinel when a flag is allowed to be used without a value.
3604
+ # Resolve it to a prompt or to the activation value depending on the option's
3605
+ # configuration.
3606
+ if value is FLAG_NEEDS_VALUE:
3607
+ # If the option allows for a prompt, start an interaction with the user.
3608
+ if self.prompt is not None and not ctx.resilient_parsing:
3609
+ value = self.prompt_for_value(ctx)
3610
+ source = ParameterSource.PROMPT
3611
+ # Else the flag takes its activation value (resolves UNSET).
3612
+ else:
3613
+ value = self.flag_activation_value
3614
+ source = ParameterSource.COMMANDLINE
3615
+
3616
+ # Re-interpret a multiple option that the parser sent through as a list still
3617
+ # containing the FLAG_NEEDS_VALUE sentinel, replacing each occurrence with the
3618
+ # activation value.
3619
+ elif (
3620
+ self.multiple
3621
+ and value is not UNSET
3622
+ and isinstance(value, cabc.Iterable)
3623
+ and source < ParameterSource.DEFAULT_MAP
3624
+ and any(v is FLAG_NEEDS_VALUE for v in value)
3625
+ ):
3626
+ value = [
3627
+ self.flag_activation_value if v is FLAG_NEEDS_VALUE else v
3628
+ for v in value
3629
+ ]
3630
+ source = ParameterSource.COMMANDLINE
3631
+
3632
+ # The value wasn't set, or used the param's default, prompt for one to the user
3633
+ # if prompting is enabled.
3634
+ elif (
3635
+ (value is UNSET or source >= ParameterSource.DEFAULT_MAP)
3636
+ and self.prompt is not None
3637
+ and (self.required or self.prompt_required)
3638
+ and not ctx.resilient_parsing
3639
+ ):
3640
+ value = self.prompt_for_value(ctx)
3641
+ source = ParameterSource.PROMPT
3642
+
3643
+ return value, source
3644
+
3645
+ def process_value(self, ctx: Context, value: t.Any) -> t.Any:
3646
+ # process_value has to be overridden on Options in order to capture
3647
+ # `value == UNSET` cases before `type_cast_value()` gets called.
3648
+ #
3649
+ # Refs:
3650
+ # https://github.com/pallets/click/issues/3069
3651
+ if self.is_flag and not self.required and self.is_bool_flag and value is UNSET:
3652
+ value = False
3653
+
3654
+ if self.callback is not None:
3655
+ value = self.callback(ctx, self, value)
3656
+
3657
+ return value
3658
+
3659
+ # in the normal case, rely on Parameter.process_value
3660
+ return super().process_value(ctx, value)
3661
+
3662
+
3663
+ class Argument(Parameter):
3664
+ """Arguments are positional parameters to a command. They generally
3665
+ provide fewer features than options but can have infinite ``nargs``
3666
+ and are required by default.
3667
+
3668
+ All parameters are passed onwards to the constructor of :class:`Parameter`.
3669
+
3670
+ :param help: the help string.
3671
+
3672
+ .. versionchanged:: 8.5.0
3673
+ Added the ``help`` parameter.
3674
+ """
3675
+
3676
+ param_type_name = "argument"
3677
+
3678
+ def __init__(
3679
+ self,
3680
+ param_decls: cabc.Sequence[str],
3681
+ required: bool | None = None,
3682
+ help: str | None = None,
3683
+ **attrs: t.Any,
3684
+ ) -> None:
3685
+ # Auto-detect the requirement status of the argument if not explicitly set.
3686
+ if required is None:
3687
+ # The argument gets automatically required if it has no explicit default
3688
+ # value set and is setup to match at least one value.
3689
+ if attrs.get("default", UNSET) is UNSET:
3690
+ required = attrs.get("nargs", 1) > 0
3691
+ # If the argument has a default value, it is not required.
3692
+ else:
3693
+ required = False
3694
+
3695
+ if "multiple" in attrs:
3696
+ raise TypeError("__init__() got an unexpected keyword argument 'multiple'.")
3697
+
3698
+ deprecated = attrs.get("deprecated", False)
3699
+
3700
+ if help:
3701
+ help = inspect.cleandoc(help)
3702
+
3703
+ if deprecated:
3704
+ label = _format_deprecated_label(deprecated)
3705
+ help = f"{help} {label}" if help else label
3706
+
3707
+ self.help = help
3708
+
3709
+ super().__init__(param_decls, required=required, **attrs)
3710
+
3711
+ def to_info_dict(self) -> dict[str, t.Any]:
3712
+ info_dict = super().to_info_dict()
3713
+ info_dict.update(help=self.help)
3714
+ return info_dict
3715
+
3716
+ @property
3717
+ def human_readable_name(self) -> str:
3718
+ if self.metavar is not None:
3719
+ return self.metavar
3720
+ return self.name.upper()
3721
+
3722
+ def make_metavar(self, ctx: Context) -> str:
3723
+ if self.metavar is not None:
3724
+ return self.metavar
3725
+ var = self.type.get_metavar(param=self, ctx=ctx)
3726
+ if not var:
3727
+ var = self.name.upper()
3728
+ # Types like ``Choice`` and ``DateTime`` already surround their metavar
3729
+ # with square brackets to enumerate the allowed values. Reuse those
3730
+ # outer brackets as the optional-argument indicator instead of wrapping
3731
+ # the metavar in a second pair, which would produce ``[[a|b|c]]``.
3732
+ already_bracketed = var.startswith("[") and var.endswith("]")
3733
+ if self.deprecated:
3734
+ var += "!"
3735
+ if not self.required and not already_bracketed:
3736
+ var = f"[{var}]"
3737
+ if self.nargs != 1:
3738
+ var += "..."
3739
+ return var
3740
+
3741
+ def _parse_decls(
3742
+ self, decls: cabc.Sequence[str], expose_value: bool
3743
+ ) -> tuple[str, list[str], list[str]]:
3744
+ if not decls:
3745
+ if not expose_value:
3746
+ return "", [], []
3747
+ raise TypeError("Argument is marked as exposed, but does not have a name.")
3748
+ if len(decls) == 1:
3749
+ name = arg = decls[0]
3750
+ name = name.replace("-", "_").lower()
3751
+ else:
3752
+ raise TypeError(
3753
+ _(
3754
+ "Arguments take exactly one parameter declaration, got"
3755
+ " {length}: {decls}."
3756
+ ).format(length=len(decls), decls=decls)
3757
+ )
3758
+ return name, [arg], []
3759
+
3760
+ def get_usage_pieces(self, ctx: Context) -> list[str]:
3761
+ return [self.make_metavar(ctx)]
3762
+
3763
+ def get_help_record(self, ctx: Context) -> tuple[str, str] | None:
3764
+ if self.help is None:
3765
+ return None
3766
+
3767
+ return self.make_metavar(ctx), self.help
3768
+
3769
+ def get_error_hint(self, ctx: Context | None) -> str:
3770
+ if ctx is not None:
3771
+ return f"'{self.make_metavar(ctx)}'"
3772
+ return f"'{self.human_readable_name}'"
3773
+
3774
+ def add_to_parser(self, parser: _OptionParser, ctx: Context) -> None:
3775
+ parser.add_argument(dest=self.name, nargs=self.nargs, obj=self)
3776
+
3777
+
3778
+ def __getattr__(name: str) -> object:
3779
+ import warnings
3780
+
3781
+ if name == "BaseCommand":
3782
+ warnings.warn(
3783
+ "'BaseCommand' is deprecated and will be removed in Click 9.0. Use"
3784
+ " 'Command' instead.",
3785
+ DeprecationWarning,
3786
+ stacklevel=2,
3787
+ )
3788
+ return _BaseCommand
3789
+
3790
+ if name == "MultiCommand":
3791
+ warnings.warn(
3792
+ "'MultiCommand' is deprecated and will be removed in Click 9.0. Use"
3793
+ " 'Group' instead.",
3794
+ DeprecationWarning,
3795
+ stacklevel=2,
3796
+ )
3797
+ return _MultiCommand
3798
+
3799
+ raise AttributeError(name)