ansible-core 2.18.5rc1__py3-none-any.whl → 2.19.0b2__py3-none-any.whl

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 (710) hide show
  1. ansible/_internal/__init__.py +53 -0
  2. ansible/_internal/_ansiballz.py +265 -0
  3. ansible/_internal/_collection_proxy.py +47 -0
  4. ansible/_internal/_datatag/__init__.py +0 -0
  5. ansible/_internal/_datatag/_tags.py +130 -0
  6. ansible/_internal/_datatag/_utils.py +19 -0
  7. ansible/_internal/_datatag/_wrappers.py +33 -0
  8. ansible/_internal/_errors/__init__.py +0 -0
  9. ansible/_internal/_errors/_captured.py +128 -0
  10. ansible/_internal/_errors/_handler.py +91 -0
  11. ansible/_internal/_errors/_utils.py +310 -0
  12. ansible/_internal/_json/__init__.py +203 -0
  13. ansible/_internal/_json/_legacy_encoder.py +34 -0
  14. ansible/_internal/_json/_profiles/__init__.py +0 -0
  15. ansible/_internal/_json/_profiles/_cache_persistence.py +55 -0
  16. ansible/_internal/_json/_profiles/_inventory_legacy.py +40 -0
  17. ansible/_internal/_json/_profiles/_legacy.py +197 -0
  18. ansible/_internal/_locking.py +21 -0
  19. ansible/_internal/_plugins/__init__.py +0 -0
  20. ansible/_internal/_plugins/_cache.py +57 -0
  21. ansible/_internal/_task.py +78 -0
  22. ansible/_internal/_templating/__init__.py +10 -0
  23. ansible/_internal/_templating/_access.py +86 -0
  24. ansible/_internal/_templating/_chain_templar.py +63 -0
  25. ansible/_internal/_templating/_datatag.py +95 -0
  26. ansible/_internal/_templating/_engine.py +588 -0
  27. ansible/_internal/_templating/_errors.py +28 -0
  28. ansible/_internal/_templating/_jinja_bits.py +1066 -0
  29. ansible/_internal/_templating/_jinja_common.py +332 -0
  30. ansible/_internal/_templating/_jinja_patches.py +44 -0
  31. ansible/_internal/_templating/_jinja_plugins.py +345 -0
  32. ansible/_internal/_templating/_lazy_containers.py +633 -0
  33. ansible/_internal/_templating/_marker_behaviors.py +103 -0
  34. ansible/_internal/_templating/_transform.py +63 -0
  35. ansible/_internal/_templating/_utils.py +107 -0
  36. ansible/_internal/_wrapt.py +1052 -0
  37. ansible/_internal/_yaml/__init__.py +0 -0
  38. ansible/_internal/_yaml/_constructor.py +240 -0
  39. ansible/_internal/_yaml/_dumper.py +62 -0
  40. ansible/_internal/_yaml/_errors.py +166 -0
  41. ansible/_internal/_yaml/_loader.py +66 -0
  42. ansible/_internal/ansible_collections/ansible/_protomatter/README.md +11 -0
  43. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/action/debug.py +36 -0
  44. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/filter/apply_trust.py +19 -0
  45. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/filter/dump_object.py +18 -0
  46. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/filter/finalize.py +16 -0
  47. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/filter/origin.py +18 -0
  48. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/filter/python_literal_eval.py +24 -0
  49. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/filter/python_literal_eval.yml +33 -0
  50. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/filter/tag_names.py +16 -0
  51. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/filter/true_type.py +17 -0
  52. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/filter/unmask.py +49 -0
  53. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/lookup/config.py +21 -0
  54. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/lookup/config.yml +2 -0
  55. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/test/tagged.py +15 -0
  56. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/test/tagged.yml +19 -0
  57. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/test/tagged_with.py +18 -0
  58. ansible/_internal/ansible_collections/ansible/_protomatter/plugins/test/tagged_with.yml +19 -0
  59. ansible/cli/__init__.py +159 -89
  60. ansible/cli/_ssh_askpass.py +47 -0
  61. ansible/cli/adhoc.py +14 -7
  62. ansible/cli/arguments/option_helpers.py +154 -7
  63. ansible/cli/config.py +43 -68
  64. ansible/cli/console.py +10 -8
  65. ansible/cli/doc.py +62 -53
  66. ansible/cli/galaxy.py +27 -20
  67. ansible/cli/inventory.py +28 -26
  68. ansible/cli/playbook.py +4 -12
  69. ansible/cli/pull.py +51 -11
  70. ansible/cli/scripts/ansible_connection_cli_stub.py +7 -7
  71. ansible/cli/vault.py +12 -11
  72. ansible/compat/__init__.py +2 -2
  73. ansible/config/base.yml +166 -112
  74. ansible/config/manager.py +52 -49
  75. ansible/constants.py +3 -4
  76. ansible/errors/__init__.py +277 -235
  77. ansible/executor/interpreter_discovery.py +28 -149
  78. ansible/executor/module_common.py +426 -493
  79. ansible/executor/play_iterator.py +22 -27
  80. ansible/executor/playbook_executor.py +11 -11
  81. ansible/executor/powershell/async_watchdog.ps1 +97 -102
  82. ansible/executor/powershell/async_wrapper.ps1 +202 -151
  83. ansible/executor/powershell/become_wrapper.ps1 +89 -144
  84. ansible/executor/powershell/bootstrap_wrapper.ps1 +24 -9
  85. ansible/executor/powershell/coverage_wrapper.ps1 +82 -135
  86. ansible/executor/powershell/exec_wrapper.ps1 +462 -196
  87. ansible/executor/powershell/module_manifest.py +417 -265
  88. ansible/executor/powershell/module_wrapper.ps1 +169 -186
  89. ansible/executor/powershell/psrp_fetch_file.ps1 +41 -0
  90. ansible/executor/powershell/psrp_put_file.ps1 +122 -0
  91. ansible/executor/powershell/winrm_fetch_file.ps1 +46 -0
  92. ansible/executor/powershell/winrm_put_file.ps1 +36 -0
  93. ansible/executor/process/worker.py +161 -96
  94. ansible/executor/stats.py +5 -5
  95. ansible/executor/task_executor.py +268 -258
  96. ansible/executor/task_queue_manager.py +124 -90
  97. ansible/executor/task_result.py +183 -78
  98. ansible/galaxy/__init__.py +2 -2
  99. ansible/galaxy/api.py +22 -18
  100. ansible/galaxy/collection/__init__.py +1 -1
  101. ansible/galaxy/collection/concrete_artifact_manager.py +8 -11
  102. ansible/galaxy/dependency_resolution/dataclasses.py +14 -4
  103. ansible/galaxy/dependency_resolution/providers.py +1 -1
  104. ansible/galaxy/dependency_resolution/reporters.py +81 -0
  105. ansible/galaxy/role.py +4 -8
  106. ansible/galaxy/token.py +28 -21
  107. ansible/inventory/data.py +47 -57
  108. ansible/inventory/group.py +44 -72
  109. ansible/inventory/helpers.py +9 -0
  110. ansible/inventory/host.py +32 -54
  111. ansible/inventory/manager.py +78 -34
  112. ansible/keyword_desc.yml +1 -1
  113. ansible/module_utils/_internal/__init__.py +55 -0
  114. ansible/module_utils/_internal/_ambient_context.py +58 -0
  115. ansible/module_utils/_internal/_ansiballz.py +133 -0
  116. ansible/module_utils/_internal/_concurrent/_daemon_threading.py +1 -0
  117. ansible/module_utils/_internal/_dataclass_annotation_patch.py +64 -0
  118. ansible/module_utils/_internal/_dataclass_validation.py +217 -0
  119. ansible/module_utils/_internal/_datatag/__init__.py +928 -0
  120. ansible/module_utils/_internal/_datatag/_tags.py +38 -0
  121. ansible/module_utils/_internal/_debugging.py +31 -0
  122. ansible/module_utils/_internal/_errors.py +30 -0
  123. ansible/module_utils/_internal/_json/__init__.py +63 -0
  124. ansible/module_utils/_internal/_json/_legacy_encoder.py +26 -0
  125. ansible/module_utils/_internal/_json/_profiles/__init__.py +410 -0
  126. ansible/module_utils/_internal/_json/_profiles/_fallback_to_str.py +73 -0
  127. ansible/module_utils/_internal/_json/_profiles/_module_legacy_c2m.py +31 -0
  128. ansible/module_utils/_internal/_json/_profiles/_module_legacy_m2c.py +35 -0
  129. ansible/module_utils/_internal/_json/_profiles/_module_modern_c2m.py +35 -0
  130. ansible/module_utils/_internal/_json/_profiles/_module_modern_m2c.py +33 -0
  131. ansible/module_utils/_internal/_json/_profiles/_tagless.py +50 -0
  132. ansible/module_utils/_internal/_patches/__init__.py +66 -0
  133. ansible/module_utils/_internal/_patches/_dataclass_annotation_patch.py +55 -0
  134. ansible/module_utils/_internal/_patches/_socket_patch.py +34 -0
  135. ansible/module_utils/_internal/_patches/_sys_intern_patch.py +34 -0
  136. ansible/module_utils/_internal/_plugin_exec_context.py +49 -0
  137. ansible/module_utils/_internal/_testing.py +0 -0
  138. ansible/module_utils/_internal/_traceback.py +89 -0
  139. ansible/module_utils/ansible_release.py +2 -2
  140. ansible/module_utils/api.py +1 -2
  141. ansible/module_utils/basic.py +152 -120
  142. ansible/module_utils/common/_utils.py +24 -28
  143. ansible/module_utils/common/collections.py +1 -2
  144. ansible/module_utils/common/dict_transformations.py +2 -2
  145. ansible/module_utils/common/file.py +2 -2
  146. ansible/module_utils/common/json.py +90 -84
  147. ansible/module_utils/common/locale.py +2 -2
  148. ansible/module_utils/common/messages.py +108 -0
  149. ansible/module_utils/common/parameters.py +27 -24
  150. ansible/module_utils/common/process.py +2 -2
  151. ansible/module_utils/common/respawn.py +41 -19
  152. ansible/module_utils/common/sentinel.py +66 -0
  153. ansible/module_utils/common/sys_info.py +8 -8
  154. ansible/module_utils/common/text/converters.py +16 -37
  155. ansible/module_utils/common/validation.py +35 -24
  156. ansible/module_utils/common/warnings.py +86 -25
  157. ansible/module_utils/common/yaml.py +29 -3
  158. ansible/module_utils/compat/datetime.py +33 -21
  159. ansible/module_utils/compat/paramiko.py +21 -10
  160. ansible/module_utils/compat/typing.py +6 -5
  161. ansible/module_utils/connection.py +2 -2
  162. ansible/module_utils/csharp/Ansible.Basic.cs +14 -11
  163. ansible/module_utils/csharp/Ansible.Become.cs +1 -0
  164. ansible/module_utils/csharp/Ansible._Async.cs +517 -0
  165. ansible/module_utils/datatag.py +46 -0
  166. ansible/module_utils/distro/__init__.py +2 -2
  167. ansible/module_utils/facts/ansible_collector.py +4 -5
  168. ansible/module_utils/facts/collector.py +13 -14
  169. ansible/module_utils/facts/compat.py +4 -4
  170. ansible/module_utils/facts/default_collectors.py +1 -1
  171. ansible/module_utils/facts/hardware/aix.py +34 -0
  172. ansible/module_utils/facts/hardware/base.py +1 -1
  173. ansible/module_utils/facts/hardware/darwin.py +1 -3
  174. ansible/module_utils/facts/hardware/freebsd.py +2 -2
  175. ansible/module_utils/facts/hardware/linux.py +4 -4
  176. ansible/module_utils/facts/namespace.py +1 -1
  177. ansible/module_utils/facts/network/base.py +1 -1
  178. ansible/module_utils/facts/network/fc_wwn.py +1 -2
  179. ansible/module_utils/facts/network/iscsi.py +1 -2
  180. ansible/module_utils/facts/network/nvme.py +1 -2
  181. ansible/module_utils/facts/other/facter.py +1 -2
  182. ansible/module_utils/facts/other/ohai.py +2 -3
  183. ansible/module_utils/facts/system/apparmor.py +1 -2
  184. ansible/module_utils/facts/system/caps.py +1 -1
  185. ansible/module_utils/facts/system/chroot.py +1 -2
  186. ansible/module_utils/facts/system/cmdline.py +1 -2
  187. ansible/module_utils/facts/system/date_time.py +5 -3
  188. ansible/module_utils/facts/system/distribution.py +9 -8
  189. ansible/module_utils/facts/system/dns.py +1 -1
  190. ansible/module_utils/facts/system/env.py +1 -2
  191. ansible/module_utils/facts/system/fips.py +7 -20
  192. ansible/module_utils/facts/system/loadavg.py +1 -2
  193. ansible/module_utils/facts/system/local.py +1 -2
  194. ansible/module_utils/facts/system/lsb.py +1 -2
  195. ansible/module_utils/facts/system/pkg_mgr.py +1 -2
  196. ansible/module_utils/facts/system/platform.py +1 -2
  197. ansible/module_utils/facts/system/python.py +1 -2
  198. ansible/module_utils/facts/system/selinux.py +1 -1
  199. ansible/module_utils/facts/system/service_mgr.py +1 -2
  200. ansible/module_utils/facts/system/ssh_pub_keys.py +1 -1
  201. ansible/module_utils/facts/system/systemd.py +1 -1
  202. ansible/module_utils/facts/system/user.py +1 -2
  203. ansible/module_utils/facts/utils.py +3 -3
  204. ansible/module_utils/facts/virtual/base.py +1 -1
  205. ansible/module_utils/facts/virtual/sunos.py +3 -15
  206. ansible/module_utils/facts/virtual/sysctl.py +3 -16
  207. ansible/module_utils/json_utils.py +2 -2
  208. ansible/module_utils/parsing/convert_bool.py +1 -1
  209. ansible/module_utils/service.py +18 -21
  210. ansible/module_utils/splitter.py +7 -7
  211. ansible/module_utils/testing.py +31 -0
  212. ansible/module_utils/urls.py +60 -31
  213. ansible/modules/add_host.py +4 -4
  214. ansible/modules/apt.py +60 -46
  215. ansible/modules/apt_key.py +19 -12
  216. ansible/modules/apt_repository.py +19 -16
  217. ansible/modules/assemble.py +6 -6
  218. ansible/modules/assert.py +4 -4
  219. ansible/modules/async_status.py +10 -12
  220. ansible/modules/async_wrapper.py +8 -3
  221. ansible/modules/blockinfile.py +6 -7
  222. ansible/modules/command.py +10 -17
  223. ansible/modules/copy.py +57 -144
  224. ansible/modules/cron.py +20 -15
  225. ansible/modules/deb822_repository.py +8 -9
  226. ansible/modules/debconf.py +5 -5
  227. ansible/modules/debug.py +4 -4
  228. ansible/modules/dnf.py +8 -8
  229. ansible/modules/dnf5.py +39 -13
  230. ansible/modules/dpkg_selections.py +4 -4
  231. ansible/modules/expect.py +8 -10
  232. ansible/modules/fail.py +4 -4
  233. ansible/modules/fetch.py +4 -4
  234. ansible/modules/file.py +174 -133
  235. ansible/modules/find.py +19 -17
  236. ansible/modules/gather_facts.py +3 -3
  237. ansible/modules/get_url.py +59 -53
  238. ansible/modules/getent.py +7 -9
  239. ansible/modules/git.py +28 -25
  240. ansible/modules/group.py +6 -6
  241. ansible/modules/group_by.py +4 -4
  242. ansible/modules/hostname.py +13 -29
  243. ansible/modules/import_playbook.py +6 -6
  244. ansible/modules/import_role.py +6 -6
  245. ansible/modules/import_tasks.py +6 -6
  246. ansible/modules/include_role.py +6 -6
  247. ansible/modules/include_tasks.py +6 -6
  248. ansible/modules/include_vars.py +6 -6
  249. ansible/modules/iptables.py +86 -73
  250. ansible/modules/known_hosts.py +10 -10
  251. ansible/modules/lineinfile.py +5 -5
  252. ansible/modules/meta.py +4 -4
  253. ansible/modules/mount_facts.py +2 -2
  254. ansible/modules/package.py +4 -4
  255. ansible/modules/package_facts.py +22 -10
  256. ansible/modules/pause.py +6 -6
  257. ansible/modules/ping.py +6 -6
  258. ansible/modules/pip.py +10 -11
  259. ansible/modules/raw.py +4 -4
  260. ansible/modules/reboot.py +6 -6
  261. ansible/modules/replace.py +9 -13
  262. ansible/modules/rpm_key.py +7 -8
  263. ansible/modules/script.py +4 -4
  264. ansible/modules/service.py +7 -8
  265. ansible/modules/service_facts.py +87 -10
  266. ansible/modules/set_fact.py +5 -5
  267. ansible/modules/set_stats.py +4 -4
  268. ansible/modules/setup.py +2 -2
  269. ansible/modules/shell.py +6 -6
  270. ansible/modules/slurp.py +6 -6
  271. ansible/modules/stat.py +9 -23
  272. ansible/modules/subversion.py +15 -15
  273. ansible/modules/systemd.py +6 -6
  274. ansible/modules/systemd_service.py +6 -6
  275. ansible/modules/sysvinit.py +6 -6
  276. ansible/modules/tempfile.py +5 -6
  277. ansible/modules/template.py +6 -6
  278. ansible/modules/unarchive.py +32 -11
  279. ansible/modules/uri.py +33 -26
  280. ansible/modules/user.py +53 -34
  281. ansible/modules/validate_argument_spec.py +10 -7
  282. ansible/modules/wait_for.py +32 -27
  283. ansible/modules/wait_for_connection.py +6 -6
  284. ansible/modules/yum_repository.py +6 -6
  285. ansible/parsing/ajson.py +14 -32
  286. ansible/parsing/dataloader.py +99 -54
  287. ansible/parsing/mod_args.py +28 -44
  288. ansible/parsing/plugin_docs.py +21 -86
  289. ansible/parsing/quoting.py +1 -1
  290. ansible/parsing/splitter.py +27 -12
  291. ansible/parsing/utils/addresses.py +24 -24
  292. ansible/parsing/utils/jsonify.py +5 -1
  293. ansible/parsing/utils/yaml.py +32 -61
  294. ansible/parsing/vault/__init__.py +319 -87
  295. ansible/parsing/yaml/__init__.py +0 -18
  296. ansible/parsing/yaml/dumper.py +6 -120
  297. ansible/parsing/yaml/loader.py +6 -39
  298. ansible/parsing/yaml/objects.py +43 -335
  299. ansible/playbook/__init__.py +1 -1
  300. ansible/playbook/attribute.py +8 -3
  301. ansible/playbook/base.py +182 -132
  302. ansible/playbook/block.py +26 -24
  303. ansible/playbook/collectionsearch.py +1 -15
  304. ansible/playbook/conditional.py +3 -77
  305. ansible/playbook/handler.py +8 -2
  306. ansible/playbook/helpers.py +41 -53
  307. ansible/playbook/included_file.py +31 -27
  308. ansible/playbook/loop_control.py +2 -2
  309. ansible/playbook/play.py +85 -44
  310. ansible/playbook/play_context.py +12 -17
  311. ansible/playbook/playbook_include.py +14 -15
  312. ansible/playbook/role/__init__.py +24 -26
  313. ansible/playbook/role/definition.py +15 -17
  314. ansible/playbook/role/include.py +2 -4
  315. ansible/playbook/role/metadata.py +10 -11
  316. ansible/playbook/role_include.py +3 -3
  317. ansible/playbook/taggable.py +13 -8
  318. ansible/playbook/task.py +188 -118
  319. ansible/playbook/task_include.py +5 -5
  320. ansible/plugins/__init__.py +68 -21
  321. ansible/plugins/action/__init__.py +209 -176
  322. ansible/plugins/action/add_host.py +1 -1
  323. ansible/plugins/action/assemble.py +1 -1
  324. ansible/plugins/action/assert.py +54 -66
  325. ansible/plugins/action/copy.py +7 -11
  326. ansible/plugins/action/debug.py +37 -31
  327. ansible/plugins/action/dnf.py +3 -4
  328. ansible/plugins/action/fail.py +1 -1
  329. ansible/plugins/action/fetch.py +4 -5
  330. ansible/plugins/action/gather_facts.py +7 -6
  331. ansible/plugins/action/group_by.py +1 -1
  332. ansible/plugins/action/include_vars.py +10 -11
  333. ansible/plugins/action/package.py +3 -6
  334. ansible/plugins/action/pause.py +2 -2
  335. ansible/plugins/action/script.py +15 -8
  336. ansible/plugins/action/service.py +6 -11
  337. ansible/plugins/action/set_fact.py +3 -12
  338. ansible/plugins/action/set_stats.py +3 -8
  339. ansible/plugins/action/template.py +35 -59
  340. ansible/plugins/action/unarchive.py +1 -1
  341. ansible/plugins/action/validate_argument_spec.py +5 -5
  342. ansible/plugins/action/wait_for_connection.py +1 -1
  343. ansible/plugins/become/__init__.py +31 -8
  344. ansible/plugins/become/runas.py +71 -0
  345. ansible/plugins/become/su.py +13 -8
  346. ansible/plugins/become/sudo.py +19 -0
  347. ansible/plugins/cache/__init__.py +35 -44
  348. ansible/plugins/cache/base.py +8 -0
  349. ansible/plugins/cache/jsonfile.py +10 -16
  350. ansible/plugins/cache/memory.py +6 -12
  351. ansible/plugins/callback/__init__.py +284 -179
  352. ansible/plugins/callback/default.py +99 -92
  353. ansible/plugins/callback/junit.py +44 -39
  354. ansible/plugins/callback/minimal.py +28 -25
  355. ansible/plugins/callback/oneline.py +28 -21
  356. ansible/plugins/callback/tree.py +16 -11
  357. ansible/plugins/connection/__init__.py +47 -34
  358. ansible/plugins/connection/local.py +150 -54
  359. ansible/plugins/connection/paramiko_ssh.py +21 -18
  360. ansible/plugins/connection/psrp.py +76 -165
  361. ansible/plugins/connection/ssh.py +301 -78
  362. ansible/plugins/connection/winrm.py +58 -140
  363. ansible/plugins/doc_fragments/action_common_attributes.py +14 -14
  364. ansible/plugins/doc_fragments/action_core.py +6 -6
  365. ansible/plugins/doc_fragments/backup.py +2 -2
  366. ansible/plugins/doc_fragments/checksum_common.py +27 -0
  367. ansible/plugins/doc_fragments/constructed.py +6 -2
  368. ansible/plugins/doc_fragments/decrypt.py +2 -2
  369. ansible/plugins/doc_fragments/default_callback.py +2 -2
  370. ansible/plugins/doc_fragments/files.py +2 -2
  371. ansible/plugins/doc_fragments/inventory_cache.py +2 -2
  372. ansible/plugins/doc_fragments/result_format_callback.py +2 -2
  373. ansible/plugins/doc_fragments/return_common.py +2 -2
  374. ansible/plugins/doc_fragments/template_common.py +4 -4
  375. ansible/plugins/doc_fragments/url.py +17 -1
  376. ansible/plugins/doc_fragments/url_windows.py +2 -2
  377. ansible/plugins/doc_fragments/validate.py +2 -2
  378. ansible/plugins/doc_fragments/vars_plugin_staging.py +2 -2
  379. ansible/plugins/filter/__init__.py +6 -2
  380. ansible/plugins/filter/b64decode.yml +22 -0
  381. ansible/plugins/filter/b64encode.yml +22 -0
  382. ansible/plugins/filter/bool.yml +11 -4
  383. ansible/plugins/filter/core.py +225 -108
  384. ansible/plugins/filter/encryption.py +32 -32
  385. ansible/plugins/filter/flatten.yml +3 -2
  386. ansible/plugins/filter/human_to_bytes.yml +1 -1
  387. ansible/plugins/filter/mathstuff.py +30 -37
  388. ansible/plugins/filter/password_hash.yml +8 -0
  389. ansible/plugins/filter/regex_search.yml +1 -4
  390. ansible/plugins/filter/split.yml +1 -1
  391. ansible/plugins/filter/to_nice_yaml.yml +0 -4
  392. ansible/plugins/filter/to_yaml.yml +0 -4
  393. ansible/plugins/filter/unvault.yml +1 -1
  394. ansible/plugins/filter/urls.py +1 -1
  395. ansible/plugins/filter/urlsplit.py +8 -9
  396. ansible/plugins/filter/vault.yml +14 -9
  397. ansible/plugins/filter/win_basename.yml +6 -1
  398. ansible/plugins/filter/win_dirname.yml +5 -0
  399. ansible/plugins/inventory/__init__.py +97 -77
  400. ansible/plugins/inventory/advanced_host_list.py +7 -5
  401. ansible/plugins/inventory/auto.py +11 -4
  402. ansible/plugins/inventory/constructed.py +21 -24
  403. ansible/plugins/inventory/generator.py +16 -11
  404. ansible/plugins/inventory/host_list.py +7 -5
  405. ansible/plugins/inventory/ini.py +78 -44
  406. ansible/plugins/inventory/script.py +189 -119
  407. ansible/plugins/inventory/toml.py +16 -126
  408. ansible/plugins/inventory/yaml.py +10 -8
  409. ansible/plugins/list.py +3 -3
  410. ansible/plugins/loader.py +197 -82
  411. ansible/plugins/lookup/__init__.py +21 -4
  412. ansible/plugins/lookup/config.py +21 -35
  413. ansible/plugins/lookup/csvfile.py +3 -2
  414. ansible/plugins/lookup/dict.py +1 -6
  415. ansible/plugins/lookup/env.py +12 -9
  416. ansible/plugins/lookup/file.py +5 -8
  417. ansible/plugins/lookup/first_found.py +86 -55
  418. ansible/plugins/lookup/indexed_items.py +1 -10
  419. ansible/plugins/lookup/ini.py +14 -13
  420. ansible/plugins/lookup/items.py +1 -1
  421. ansible/plugins/lookup/lines.py +8 -1
  422. ansible/plugins/lookup/list.py +1 -1
  423. ansible/plugins/lookup/nested.py +2 -18
  424. ansible/plugins/lookup/password.py +5 -5
  425. ansible/plugins/lookup/pipe.py +5 -7
  426. ansible/plugins/lookup/sequence.py +18 -8
  427. ansible/plugins/lookup/subelements.py +1 -4
  428. ansible/plugins/lookup/template.py +42 -36
  429. ansible/plugins/lookup/together.py +0 -12
  430. ansible/plugins/lookup/unvault.py +1 -5
  431. ansible/plugins/lookup/url.py +2 -8
  432. ansible/plugins/lookup/vars.py +16 -24
  433. ansible/plugins/shell/__init__.py +2 -2
  434. ansible/plugins/shell/cmd.py +2 -2
  435. ansible/plugins/shell/powershell.py +39 -22
  436. ansible/plugins/shell/sh.py +3 -2
  437. ansible/plugins/strategy/__init__.py +159 -184
  438. ansible/plugins/strategy/debug.py +2 -2
  439. ansible/plugins/strategy/free.py +16 -31
  440. ansible/plugins/strategy/host_pinned.py +2 -2
  441. ansible/plugins/strategy/linear.py +41 -41
  442. ansible/plugins/terminal/__init__.py +4 -4
  443. ansible/plugins/test/__init__.py +7 -2
  444. ansible/plugins/test/core.py +55 -21
  445. ansible/plugins/test/files.py +1 -1
  446. ansible/plugins/test/mathstuff.py +3 -3
  447. ansible/plugins/test/uri.py +3 -3
  448. ansible/plugins/vars/host_group_vars.py +7 -14
  449. ansible/release.py +2 -2
  450. ansible/template/__init__.py +370 -944
  451. ansible/utils/__init__.py +0 -18
  452. ansible/utils/_ssh_agent.py +657 -0
  453. ansible/utils/collection_loader/__init__.py +52 -5
  454. ansible/utils/collection_loader/_collection_config.py +5 -6
  455. ansible/utils/collection_loader/_collection_finder.py +79 -93
  456. ansible/utils/collection_loader/_collection_meta.py +13 -8
  457. ansible/utils/display.py +433 -63
  458. ansible/utils/encrypt.py +27 -19
  459. ansible/utils/fqcn.py +2 -2
  460. ansible/utils/hashing.py +2 -2
  461. ansible/utils/helpers.py +2 -2
  462. ansible/utils/listify.py +8 -8
  463. ansible/utils/lock.py +2 -2
  464. ansible/utils/path.py +4 -4
  465. ansible/utils/plugin_docs.py +14 -13
  466. ansible/utils/sentinel.py +4 -62
  467. ansible/utils/singleton.py +2 -0
  468. ansible/utils/ssh_functions.py +1 -1
  469. ansible/utils/unsafe_proxy.py +23 -332
  470. ansible/utils/vars.py +51 -8
  471. ansible/utils/version.py +2 -2
  472. ansible/vars/clean.py +5 -5
  473. ansible/vars/hostvars.py +60 -90
  474. ansible/vars/manager.py +206 -282
  475. ansible/vars/reserved.py +8 -9
  476. ansible_core-2.19.0b2.dist-info/BSD-3-Clause.txt +28 -0
  477. {ansible_core-2.18.5rc1.dist-info → ansible_core-2.19.0b2.dist-info}/METADATA +5 -4
  478. ansible_core-2.19.0b2.dist-info/RECORD +1072 -0
  479. {ansible_core-2.18.5rc1.dist-info → ansible_core-2.19.0b2.dist-info}/WHEEL +1 -1
  480. ansible_test/_data/completion/docker.txt +7 -7
  481. ansible_test/_data/completion/remote.txt +6 -6
  482. ansible_test/_data/completion/windows.txt +1 -0
  483. ansible_test/_data/requirements/ansible.txt +2 -2
  484. ansible_test/_data/requirements/sanity.ansible-doc.txt +3 -3
  485. ansible_test/_data/requirements/sanity.changelog.txt +1 -1
  486. ansible_test/_data/requirements/sanity.import.plugin.txt +2 -2
  487. ansible_test/_data/requirements/sanity.pylint.txt +4 -4
  488. ansible_test/_data/requirements/sanity.validate-modules.txt +2 -2
  489. ansible_test/_data/requirements/sanity.yamllint.txt +1 -1
  490. ansible_test/_data/requirements/units.txt +1 -0
  491. ansible_test/_internal/__init__.py +1 -0
  492. ansible_test/_internal/ansible_util.py +2 -0
  493. ansible_test/_internal/become.py +1 -0
  494. ansible_test/_internal/bootstrap.py +1 -0
  495. ansible_test/_internal/cache.py +1 -0
  496. ansible_test/_internal/cgroup.py +1 -0
  497. ansible_test/_internal/ci/__init__.py +1 -0
  498. ansible_test/_internal/ci/azp.py +1 -0
  499. ansible_test/_internal/ci/local.py +1 -0
  500. ansible_test/_internal/classification/__init__.py +1 -0
  501. ansible_test/_internal/classification/common.py +1 -0
  502. ansible_test/_internal/classification/csharp.py +1 -0
  503. ansible_test/_internal/classification/powershell.py +1 -0
  504. ansible_test/_internal/classification/python.py +1 -0
  505. ansible_test/_internal/cli/__init__.py +1 -0
  506. ansible_test/_internal/cli/actions.py +1 -0
  507. ansible_test/_internal/cli/argparsing/__init__.py +1 -0
  508. ansible_test/_internal/cli/argparsing/actions.py +1 -0
  509. ansible_test/_internal/cli/argparsing/argcompletion.py +1 -0
  510. ansible_test/_internal/cli/argparsing/parsers.py +1 -0
  511. ansible_test/_internal/cli/commands/__init__.py +11 -0
  512. ansible_test/_internal/cli/commands/coverage/__init__.py +1 -0
  513. ansible_test/_internal/cli/commands/coverage/analyze/__init__.py +1 -0
  514. ansible_test/_internal/cli/commands/coverage/analyze/targets/__init__.py +1 -0
  515. ansible_test/_internal/cli/commands/coverage/analyze/targets/combine.py +1 -0
  516. ansible_test/_internal/cli/commands/coverage/analyze/targets/expand.py +1 -0
  517. ansible_test/_internal/cli/commands/coverage/analyze/targets/filter.py +1 -0
  518. ansible_test/_internal/cli/commands/coverage/analyze/targets/generate.py +1 -0
  519. ansible_test/_internal/cli/commands/coverage/analyze/targets/missing.py +1 -0
  520. ansible_test/_internal/cli/commands/coverage/combine.py +1 -0
  521. ansible_test/_internal/cli/commands/coverage/erase.py +1 -0
  522. ansible_test/_internal/cli/commands/coverage/html.py +1 -0
  523. ansible_test/_internal/cli/commands/coverage/report.py +1 -0
  524. ansible_test/_internal/cli/commands/coverage/xml.py +1 -0
  525. ansible_test/_internal/cli/commands/env.py +1 -0
  526. ansible_test/_internal/cli/commands/integration/__init__.py +1 -0
  527. ansible_test/_internal/cli/commands/integration/network.py +1 -0
  528. ansible_test/_internal/cli/commands/integration/posix.py +1 -0
  529. ansible_test/_internal/cli/commands/integration/windows.py +1 -0
  530. ansible_test/_internal/cli/commands/sanity.py +9 -0
  531. ansible_test/_internal/cli/commands/shell.py +1 -0
  532. ansible_test/_internal/cli/commands/units.py +1 -0
  533. ansible_test/_internal/cli/compat.py +1 -0
  534. ansible_test/_internal/cli/completers.py +1 -0
  535. ansible_test/_internal/cli/converters.py +1 -0
  536. ansible_test/_internal/cli/environments.py +1 -0
  537. ansible_test/_internal/cli/epilog.py +1 -0
  538. ansible_test/_internal/cli/parsers/__init__.py +1 -0
  539. ansible_test/_internal/cli/parsers/base_argument_parsers.py +1 -0
  540. ansible_test/_internal/cli/parsers/helpers.py +1 -0
  541. ansible_test/_internal/cli/parsers/host_config_parsers.py +1 -0
  542. ansible_test/_internal/cli/parsers/key_value_parsers.py +1 -0
  543. ansible_test/_internal/cli/parsers/value_parsers.py +1 -0
  544. ansible_test/_internal/commands/__init__.py +1 -0
  545. ansible_test/_internal/commands/coverage/__init__.py +2 -1
  546. ansible_test/_internal/commands/coverage/analyze/__init__.py +1 -0
  547. ansible_test/_internal/commands/coverage/analyze/targets/__init__.py +1 -0
  548. ansible_test/_internal/commands/coverage/analyze/targets/combine.py +1 -0
  549. ansible_test/_internal/commands/coverage/analyze/targets/expand.py +1 -0
  550. ansible_test/_internal/commands/coverage/analyze/targets/filter.py +1 -0
  551. ansible_test/_internal/commands/coverage/analyze/targets/generate.py +1 -0
  552. ansible_test/_internal/commands/coverage/analyze/targets/missing.py +1 -0
  553. ansible_test/_internal/commands/coverage/combine.py +2 -1
  554. ansible_test/_internal/commands/coverage/erase.py +1 -0
  555. ansible_test/_internal/commands/coverage/html.py +1 -0
  556. ansible_test/_internal/commands/coverage/report.py +1 -0
  557. ansible_test/_internal/commands/coverage/xml.py +1 -0
  558. ansible_test/_internal/commands/env/__init__.py +2 -0
  559. ansible_test/_internal/commands/integration/__init__.py +4 -0
  560. ansible_test/_internal/commands/integration/cloud/__init__.py +1 -0
  561. ansible_test/_internal/commands/integration/cloud/acme.py +2 -1
  562. ansible_test/_internal/commands/integration/cloud/aws.py +1 -0
  563. ansible_test/_internal/commands/integration/cloud/azure.py +1 -0
  564. ansible_test/_internal/commands/integration/cloud/cs.py +1 -0
  565. ansible_test/_internal/commands/integration/cloud/digitalocean.py +1 -0
  566. ansible_test/_internal/commands/integration/cloud/galaxy.py +3 -2
  567. ansible_test/_internal/commands/integration/cloud/hcloud.py +1 -0
  568. ansible_test/_internal/commands/integration/cloud/httptester.py +2 -1
  569. ansible_test/_internal/commands/integration/cloud/nios.py +2 -1
  570. ansible_test/_internal/commands/integration/cloud/opennebula.py +1 -0
  571. ansible_test/_internal/commands/integration/cloud/openshift.py +1 -0
  572. ansible_test/_internal/commands/integration/cloud/scaleway.py +1 -0
  573. ansible_test/_internal/commands/integration/cloud/vcenter.py +1 -0
  574. ansible_test/_internal/commands/integration/cloud/vultr.py +1 -0
  575. ansible_test/_internal/commands/integration/coverage.py +1 -0
  576. ansible_test/_internal/commands/integration/filters.py +1 -0
  577. ansible_test/_internal/commands/integration/network.py +1 -0
  578. ansible_test/_internal/commands/integration/posix.py +1 -0
  579. ansible_test/_internal/commands/integration/windows.py +1 -0
  580. ansible_test/_internal/commands/sanity/__init__.py +16 -1
  581. ansible_test/_internal/commands/sanity/ansible_doc.py +1 -0
  582. ansible_test/_internal/commands/sanity/bin_symlinks.py +1 -0
  583. ansible_test/_internal/commands/sanity/compile.py +1 -0
  584. ansible_test/_internal/commands/sanity/ignores.py +1 -0
  585. ansible_test/_internal/commands/sanity/import.py +1 -0
  586. ansible_test/_internal/commands/sanity/integration_aliases.py +1 -0
  587. ansible_test/_internal/commands/sanity/pep8.py +1 -0
  588. ansible_test/_internal/commands/sanity/pslint.py +1 -0
  589. ansible_test/_internal/commands/sanity/pylint.py +24 -26
  590. ansible_test/_internal/commands/sanity/shellcheck.py +1 -0
  591. ansible_test/_internal/commands/sanity/validate_modules.py +1 -0
  592. ansible_test/_internal/commands/sanity/yamllint.py +1 -0
  593. ansible_test/_internal/commands/shell/__init__.py +1 -0
  594. ansible_test/_internal/commands/units/__init__.py +1 -0
  595. ansible_test/_internal/compat/__init__.py +1 -0
  596. ansible_test/_internal/compat/packaging.py +1 -0
  597. ansible_test/_internal/compat/yaml.py +1 -0
  598. ansible_test/_internal/completion.py +1 -0
  599. ansible_test/_internal/config.py +2 -0
  600. ansible_test/_internal/connections.py +1 -0
  601. ansible_test/_internal/constants.py +1 -0
  602. ansible_test/_internal/containers.py +1 -0
  603. ansible_test/_internal/content_config.py +1 -0
  604. ansible_test/_internal/core_ci.py +1 -0
  605. ansible_test/_internal/coverage_util.py +11 -10
  606. ansible_test/_internal/data.py +1 -0
  607. ansible_test/_internal/delegation.py +1 -0
  608. ansible_test/_internal/dev/__init__.py +1 -0
  609. ansible_test/_internal/dev/container_probe.py +1 -0
  610. ansible_test/_internal/diff.py +3 -2
  611. ansible_test/_internal/docker_util.py +2 -1
  612. ansible_test/_internal/encoding.py +1 -0
  613. ansible_test/_internal/executor.py +1 -0
  614. ansible_test/_internal/git.py +1 -0
  615. ansible_test/_internal/host_configs.py +1 -0
  616. ansible_test/_internal/host_profiles.py +1 -0
  617. ansible_test/_internal/http.py +1 -0
  618. ansible_test/_internal/init.py +1 -0
  619. ansible_test/_internal/inventory.py +35 -3
  620. ansible_test/_internal/io.py +1 -0
  621. ansible_test/_internal/metadata.py +1 -0
  622. ansible_test/_internal/payload.py +1 -0
  623. ansible_test/_internal/provider/__init__.py +1 -0
  624. ansible_test/_internal/provider/layout/__init__.py +1 -0
  625. ansible_test/_internal/provider/layout/ansible.py +1 -0
  626. ansible_test/_internal/provider/layout/collection.py +1 -0
  627. ansible_test/_internal/provider/layout/unsupported.py +1 -0
  628. ansible_test/_internal/provider/source/__init__.py +1 -0
  629. ansible_test/_internal/provider/source/git.py +1 -0
  630. ansible_test/_internal/provider/source/installed.py +1 -0
  631. ansible_test/_internal/provider/source/unsupported.py +1 -0
  632. ansible_test/_internal/provider/source/unversioned.py +1 -0
  633. ansible_test/_internal/provisioning.py +1 -0
  634. ansible_test/_internal/pypi_proxy.py +6 -5
  635. ansible_test/_internal/python_requirements.py +1 -0
  636. ansible_test/_internal/ssh.py +1 -0
  637. ansible_test/_internal/target.py +1 -0
  638. ansible_test/_internal/test.py +3 -2
  639. ansible_test/_internal/thread.py +1 -0
  640. ansible_test/_internal/timeout.py +1 -0
  641. ansible_test/_internal/util.py +1 -0
  642. ansible_test/_internal/util_common.py +5 -2
  643. ansible_test/_internal/venv.py +1 -0
  644. ansible_test/_util/controller/sanity/code-smell/action-plugin-docs.py +1 -0
  645. ansible_test/_util/controller/sanity/code-smell/changelog/sphinx.py +1 -0
  646. ansible_test/_util/controller/sanity/code-smell/changelog.py +1 -0
  647. ansible_test/_util/controller/sanity/code-smell/empty-init.py +1 -0
  648. ansible_test/_util/controller/sanity/code-smell/line-endings.py +1 -0
  649. ansible_test/_util/controller/sanity/code-smell/no-assert.py +1 -0
  650. ansible_test/_util/controller/sanity/code-smell/no-get-exception.py +1 -0
  651. ansible_test/_util/controller/sanity/code-smell/no-illegal-filenames.py +1 -0
  652. ansible_test/_util/controller/sanity/code-smell/no-smart-quotes.py +1 -0
  653. ansible_test/_util/controller/sanity/code-smell/replace-urlopen.py +1 -0
  654. ansible_test/_util/controller/sanity/code-smell/runtime-metadata.py +28 -1
  655. ansible_test/_util/controller/sanity/code-smell/shebang.py +1 -0
  656. ansible_test/_util/controller/sanity/code-smell/symlinks.py +1 -0
  657. ansible_test/_util/controller/sanity/code-smell/use-argspec-type-path.py +1 -0
  658. ansible_test/_util/controller/sanity/code-smell/use-compat-six.py +1 -0
  659. ansible_test/_util/controller/sanity/integration-aliases/yaml_to_json.py +2 -1
  660. ansible_test/_util/controller/sanity/pep8/current-ignore.txt +4 -0
  661. ansible_test/_util/controller/sanity/pylint/config/ansible-test-target.cfg +7 -5
  662. ansible_test/_util/controller/sanity/pylint/config/ansible-test.cfg +7 -5
  663. ansible_test/_util/controller/sanity/pylint/config/code-smell.cfg +7 -5
  664. ansible_test/_util/controller/sanity/pylint/config/collection.cfg +3 -5
  665. ansible_test/_util/controller/sanity/pylint/config/default.cfg +7 -7
  666. ansible_test/_util/controller/sanity/pylint/plugins/deprecated.py +1 -13
  667. ansible_test/_util/controller/sanity/pylint/plugins/hide_unraisable.py +1 -0
  668. ansible_test/_util/controller/sanity/pylint/plugins/string_format.py +1 -8
  669. ansible_test/_util/controller/sanity/pylint/plugins/unwanted.py +1 -8
  670. ansible_test/_util/controller/sanity/validate-modules/validate_modules/main.py +55 -28
  671. ansible_test/_util/controller/sanity/validate-modules/validate_modules/module_args.py +12 -5
  672. ansible_test/_util/controller/sanity/validate-modules/validate_modules/schema.py +13 -2
  673. ansible_test/_util/controller/sanity/validate-modules/validate_modules/utils.py +1 -0
  674. ansible_test/_util/controller/sanity/yamllint/yamllinter.py +35 -17
  675. ansible_test/_util/controller/tools/collection_detail.py +1 -0
  676. ansible_test/_util/controller/tools/yaml_to_json.py +2 -1
  677. ansible_test/_util/target/pytest/plugins/ansible_forked.py +6 -1
  678. ansible_test/_util/target/pytest/plugins/ansible_pytest_collections.py +2 -1
  679. ansible_test/_util/target/pytest/plugins/ansible_pytest_coverage.py +1 -0
  680. ansible_test/_util/target/sanity/compile/compile.py +1 -0
  681. ansible_test/_util/target/sanity/import/importer.py +15 -16
  682. ansible_test/_util/target/setup/bootstrap.sh +9 -20
  683. ansible_test/_util/target/setup/probe_cgroups.py +1 -0
  684. ansible_test/_util/target/setup/quiet_pip.py +1 -0
  685. ansible_test/_util/target/setup/requirements.py +35 -27
  686. ansible_test/_util/target/tools/virtualenvcheck.py +2 -1
  687. ansible_test/_util/target/tools/yamlcheck.py +2 -1
  688. ansible/compat/selectors.py +0 -32
  689. ansible/errors/yaml_strings.py +0 -138
  690. ansible/executor/action_write_locks.py +0 -44
  691. ansible/executor/discovery/python_target.py +0 -47
  692. ansible/executor/powershell/module_powershell_wrapper.ps1 +0 -86
  693. ansible/executor/powershell/module_script_wrapper.ps1 +0 -22
  694. ansible/module_utils/compat/importlib.py +0 -26
  695. ansible/module_utils/compat/selectors.py +0 -32
  696. ansible/module_utils/pycompat24.py +0 -73
  697. ansible/parsing/yaml/constructor.py +0 -178
  698. ansible/template/native_helpers.py +0 -251
  699. ansible/template/template.py +0 -43
  700. ansible/template/vars.py +0 -77
  701. ansible/utils/native_jinja.py +0 -11
  702. ansible/vars/fact_cache.py +0 -71
  703. ansible_core-2.18.5rc1.dist-info/RECORD +0 -992
  704. {ansible_core-2.18.5rc1.dist-info → ansible_core-2.19.0b2.dist-info}/Apache-License.txt +0 -0
  705. {ansible_core-2.18.5rc1.dist-info → ansible_core-2.19.0b2.dist-info}/COPYING +0 -0
  706. {ansible_core-2.18.5rc1.dist-info → ansible_core-2.19.0b2.dist-info}/MIT-license.txt +0 -0
  707. {ansible_core-2.18.5rc1.dist-info → ansible_core-2.19.0b2.dist-info}/PSF-license.txt +0 -0
  708. {ansible_core-2.18.5rc1.dist-info → ansible_core-2.19.0b2.dist-info}/entry_points.txt +0 -0
  709. {ansible_core-2.18.5rc1.dist-info → ansible_core-2.19.0b2.dist-info}/simplified_bsd.txt +0 -0
  710. {ansible_core-2.18.5rc1.dist-info → ansible_core-2.19.0b2.dist-info}/top_level.txt +0 -0
@@ -1,329 +1,42 @@
1
- # PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
2
- # --------------------------------------------
3
- #
4
- # 1. This LICENSE AGREEMENT is between the Python Software Foundation
5
- # ("PSF"), and the Individual or Organization ("Licensee") accessing and
6
- # otherwise using this software ("Python") in source or binary form and
7
- # its associated documentation.
8
- #
9
- # 2. Subject to the terms and conditions of this License Agreement, PSF hereby
10
- # grants Licensee a nonexclusive, royalty-free, world-wide license to reproduce,
11
- # analyze, test, perform and/or display publicly, prepare derivative works,
12
- # distribute, and otherwise use Python alone or in any derivative version,
13
- # provided, however, that PSF's License Agreement and PSF's notice of copyright,
14
- # i.e., "Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
15
- # 2011, 2012, 2013, 2014 Python Software Foundation; All Rights Reserved" are
16
- # retained in Python alone or in any derivative version prepared by Licensee.
17
- #
18
- # 3. In the event Licensee prepares a derivative work that is based on
19
- # or incorporates Python or any part thereof, and wants to make
20
- # the derivative work available to others as provided herein, then
21
- # Licensee hereby agrees to include in any such work a brief summary of
22
- # the changes made to Python.
23
- #
24
- # 4. PSF is making Python available to Licensee on an "AS IS"
25
- # basis. PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
26
- # IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND
27
- # DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
28
- # FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT
29
- # INFRINGE ANY THIRD PARTY RIGHTS.
30
- #
31
- # 5. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
32
- # FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
33
- # A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON,
34
- # OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
35
- #
36
- # 6. This License Agreement will automatically terminate upon a material
37
- # breach of its terms and conditions.
38
- #
39
- # 7. Nothing in this License Agreement shall be deemed to create any
40
- # relationship of agency, partnership, or joint venture between PSF and
41
- # Licensee. This License Agreement does not grant permission to use PSF
42
- # trademarks or trade name in a trademark sense to endorse or promote
43
- # products or services of Licensee, or any third party.
44
- #
45
- # 8. By copying, installing or otherwise using Python, Licensee
46
- # agrees to be bound by the terms and conditions of this License
47
- # Agreement.
48
- #
49
- # Original Python Recipe for Proxy:
50
- # http://code.activestate.com/recipes/496741-object-proxying/
51
- # Author: Tomer Filiba
1
+ # Copyright: (c) 2023, Ansible Project
2
+ # GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
52
3
 
4
+ # deprecated: description="deprecate unsafe_proxy module" core_version="2.23"
5
+ # DTFIX-RELEASE: add full unit test coverage
53
6
  from __future__ import annotations
54
7
 
55
- import sys
56
- import types
57
- import warnings
58
- from sys import intern as _sys_intern
59
8
  from collections.abc import Mapping, Set
60
9
 
61
10
  from ansible.module_utils.common.text.converters import to_bytes, to_text
62
11
  from ansible.module_utils.common.collections import is_sequence
63
- from ansible.utils.native_jinja import NativeJinjaText
12
+ from ansible._internal._datatag._tags import TrustedAsTemplate
13
+ from ansible.module_utils.six import binary_type, text_type
64
14
 
15
+ import typing as t
65
16
 
66
17
  __all__ = ['AnsibleUnsafe', 'wrap_var']
67
18
 
19
+ T = t.TypeVar('T')
68
20
 
69
- class AnsibleUnsafe(object):
70
- __UNSAFE__ = True
71
21
 
22
+ class AnsibleUnsafe:
23
+ def __new__(cls, value):
24
+ return TrustedAsTemplate.untag(value)
72
25
 
73
- class AnsibleUnsafeBytes(bytes, AnsibleUnsafe):
74
- def _strip_unsafe(self):
75
- return super().__bytes__()
76
26
 
77
- def __reduce__(self, /):
78
- return (self.__class__, (self._strip_unsafe(),))
27
+ class AnsibleUnsafeBytes(bytes):
28
+ def __new__(cls, value):
29
+ return TrustedAsTemplate.untag(value)
79
30
 
80
- def __str__(self, /): # pylint: disable=invalid-str-returned
81
- return self.decode()
82
31
 
83
- def __bytes__(self, /): # pylint: disable=invalid-bytes-returned
84
- return self
32
+ class AnsibleUnsafeText(str):
33
+ def __new__(cls, value):
34
+ return TrustedAsTemplate.untag(value)
85
35
 
86
- def __repr__(self, /): # pylint: disable=invalid-repr-returned
87
- return AnsibleUnsafeText(super().__repr__())
88
36
 
89
- def __format__(self, format_spec, /): # pylint: disable=invalid-format-returned
90
- return AnsibleUnsafeText(super().__format__(format_spec))
91
-
92
- def __getitem__(self, key, /):
93
- if isinstance(key, int):
94
- return super().__getitem__(key)
95
- return self.__class__(super().__getitem__(key))
96
-
97
- def __reversed__(self, /):
98
- return self[::-1]
99
-
100
- def __add__(self, value, /):
101
- return self.__class__(super().__add__(value))
102
-
103
- def __radd__(self, value, /):
104
- return self.__class__(value.__add__(self))
105
-
106
- def __mul__(self, value, /):
107
- return self.__class__(super().__mul__(value))
108
-
109
- __rmul__ = __mul__
110
-
111
- def __mod__(self, value, /):
112
- return self.__class__(super().__mod__(value))
113
-
114
- def __rmod__(self, value, /):
115
- return self.__class__(super().__rmod__(value))
116
-
117
- def capitalize(self, /):
118
- return self.__class__(super().capitalize())
119
-
120
- def center(self, width, fillchar=b' ', /):
121
- return self.__class__(super().center(width, fillchar))
122
-
123
- def decode(self, /, encoding='utf-8', errors='strict'):
124
- return AnsibleUnsafeText(super().decode(encoding=encoding, errors=errors))
125
-
126
- def removeprefix(self, prefix, /):
127
- return self.__class__(super().removeprefix(prefix))
128
-
129
- def removesuffix(self, suffix, /):
130
- return self.__class__(super().removesuffix(suffix))
131
-
132
- def expandtabs(self, /, tabsize=8):
133
- return self.__class__(super().expandtabs(tabsize))
134
-
135
- def join(self, iterable_of_bytes, /):
136
- return self.__class__(super().join(iterable_of_bytes))
137
-
138
- def ljust(self, width, fillchar=b' ', /):
139
- return self.__class__(super().ljust(width, fillchar))
140
-
141
- def lower(self, /):
142
- return self.__class__(super().lower())
143
-
144
- def lstrip(self, chars=None, /):
145
- return self.__class__(super().lstrip(chars))
146
-
147
- def partition(self, sep, /):
148
- cls = self.__class__
149
- return tuple(cls(e) for e in super().partition(sep))
150
-
151
- def replace(self, old, new, count=-1, /):
152
- return self.__class__(super().replace(old, new, count))
153
-
154
- def rjust(self, width, fillchar=b' ', /):
155
- return self.__class__(super().rjust(width, fillchar))
156
-
157
- def rpartition(self, sep, /):
158
- cls = self.__class__
159
- return tuple(cls(e) for e in super().rpartition(sep))
160
-
161
- def rstrip(self, chars=None, /):
162
- return self.__class__(super().rstrip(chars))
163
-
164
- def split(self, /, sep=None, maxsplit=-1):
165
- cls = self.__class__
166
- return [cls(e) for e in super().split(sep=sep, maxsplit=maxsplit)]
167
-
168
- def rsplit(self, /, sep=None, maxsplit=-1):
169
- cls = self.__class__
170
- return [cls(e) for e in super().rsplit(sep=sep, maxsplit=maxsplit)]
171
-
172
- def splitlines(self, /, keepends=False):
173
- cls = self.__class__
174
- return [cls(e) for e in super().splitlines(keepends=keepends)]
175
-
176
- def strip(self, chars=None, /):
177
- return self.__class__(super().strip(chars))
178
-
179
- def swapcase(self, /):
180
- return self.__class__(super().swapcase())
181
-
182
- def title(self, /):
183
- return self.__class__(super().title())
184
-
185
- def translate(self, table, /, delete=b''):
186
- return self.__class__(super().translate(table, delete=delete))
187
-
188
- def upper(self, /):
189
- return self.__class__(super().upper())
190
-
191
- def zfill(self, width, /):
192
- return self.__class__(super().zfill(width))
193
-
194
-
195
- class AnsibleUnsafeText(str, AnsibleUnsafe):
196
- def _strip_unsafe(self, /):
197
- return super().__str__()
198
-
199
- def __reduce__(self, /):
200
- return (self.__class__, (self._strip_unsafe(),))
201
-
202
- def __str__(self, /): # pylint: disable=invalid-str-returned
203
- return self
204
-
205
- def __repr__(self, /): # pylint: disable=invalid-repr-returned
206
- return self.__class__(super().__repr__())
207
-
208
- def __format__(self, format_spec, /): # pylint: disable=invalid-format-returned
209
- return self.__class__(super().__format__(format_spec))
210
-
211
- def __getitem__(self, key, /):
212
- return self.__class__(super().__getitem__(key))
213
-
214
- def __iter__(self, /):
215
- cls = self.__class__
216
- return (cls(c) for c in super().__iter__())
217
-
218
- def __reversed__(self, /):
219
- return self[::-1]
220
-
221
- def __add__(self, value, /):
222
- return self.__class__(super().__add__(value))
223
-
224
- def __radd__(self, value, /):
225
- return self.__class__(value.__add__(self))
226
-
227
- def __mul__(self, value, /):
228
- return self.__class__(super().__mul__(value))
229
-
230
- __rmul__ = __mul__
231
-
232
- def __mod__(self, value, /):
233
- return self.__class__(super().__mod__(value))
234
-
235
- def __rmod__(self, value, /):
236
- return self.__class__(super().__rmod__(value))
237
-
238
- def capitalize(self, /):
239
- return self.__class__(super().capitalize())
240
-
241
- def casefold(self, /):
242
- return self.__class__(super().casefold())
243
-
244
- def center(self, width, fillchar=' ', /):
245
- return self.__class__(super().center(width, fillchar))
246
-
247
- def encode(self, /, encoding='utf-8', errors='strict'):
248
- return AnsibleUnsafeBytes(super().encode(encoding=encoding, errors=errors))
249
-
250
- def removeprefix(self, prefix, /):
251
- return self.__class__(super().removeprefix(prefix))
252
-
253
- def removesuffix(self, suffix, /):
254
- return self.__class__(super().removesuffix(suffix))
255
-
256
- def expandtabs(self, /, tabsize=8):
257
- return self.__class__(super().expandtabs(tabsize))
258
-
259
- def format(self, /, *args, **kwargs):
260
- return self.__class__(super().format(*args, **kwargs))
261
-
262
- def format_map(self, mapping, /):
263
- return self.__class__(super().format_map(mapping))
264
-
265
- def join(self, iterable, /):
266
- return self.__class__(super().join(iterable))
267
-
268
- def ljust(self, width, fillchar=' ', /):
269
- return self.__class__(super().ljust(width, fillchar))
270
-
271
- def lower(self, /):
272
- return self.__class__(super().lower())
273
-
274
- def lstrip(self, chars=None, /):
275
- return self.__class__(super().lstrip(chars))
276
-
277
- def partition(self, sep, /):
278
- cls = self.__class__
279
- return tuple(cls(e) for e in super().partition(sep))
280
-
281
- def replace(self, old, new, count=-1, /):
282
- return self.__class__(super().replace(old, new, count))
283
-
284
- def rjust(self, width, fillchar=' ', /):
285
- return self.__class__(super().rjust(width, fillchar))
286
-
287
- def rpartition(self, sep, /):
288
- cls = self.__class__
289
- return tuple(cls(e) for e in super().rpartition(sep))
290
-
291
- def rstrip(self, chars=None, /):
292
- return self.__class__(super().rstrip(chars))
293
-
294
- def split(self, /, sep=None, maxsplit=-1):
295
- cls = self.__class__
296
- return [cls(e) for e in super().split(sep=sep, maxsplit=maxsplit)]
297
-
298
- def rsplit(self, /, sep=None, maxsplit=-1):
299
- cls = self.__class__
300
- return [cls(e) for e in super().rsplit(sep=sep, maxsplit=maxsplit)]
301
-
302
- def splitlines(self, /, keepends=False):
303
- cls = self.__class__
304
- return [cls(e) for e in super().splitlines(keepends=keepends)]
305
-
306
- def strip(self, chars=None, /):
307
- return self.__class__(super().strip(chars))
308
-
309
- def swapcase(self, /):
310
- return self.__class__(super().swapcase())
311
-
312
- def title(self, /):
313
- return self.__class__(super().title())
314
-
315
- def translate(self, table, /):
316
- return self.__class__(super().translate(table))
317
-
318
- def upper(self, /):
319
- return self.__class__(super().upper())
320
-
321
- def zfill(self, width, /):
322
- return self.__class__(super().zfill(width))
323
-
324
-
325
- class NativeJinjaUnsafeText(NativeJinjaText, AnsibleUnsafeText):
326
- pass
37
+ class NativeJinjaUnsafeText(str):
38
+ def __new__(cls, value):
39
+ return TrustedAsTemplate.untag(value)
327
40
 
328
41
 
329
42
  def _wrap_dict(v):
@@ -343,6 +56,7 @@ def _wrap_set(v):
343
56
 
344
57
 
345
58
  def wrap_var(v):
59
+ # maintain backward compat by recursively *un* marking TrustedAsTemplate
346
60
  if v is None or isinstance(v, AnsibleUnsafe):
347
61
  return v
348
62
 
@@ -352,11 +66,9 @@ def wrap_var(v):
352
66
  v = _wrap_set(v)
353
67
  elif is_sequence(v):
354
68
  v = _wrap_sequence(v)
355
- elif isinstance(v, NativeJinjaText):
356
- v = NativeJinjaUnsafeText(v)
357
- elif isinstance(v, bytes):
69
+ elif isinstance(v, binary_type):
358
70
  v = AnsibleUnsafeBytes(v)
359
- elif isinstance(v, str):
71
+ elif isinstance(v, text_type):
360
72
  v = AnsibleUnsafeText(v)
361
73
 
362
74
  return v
@@ -368,24 +80,3 @@ def to_unsafe_bytes(*args, **kwargs):
368
80
 
369
81
  def to_unsafe_text(*args, **kwargs):
370
82
  return wrap_var(to_text(*args, **kwargs))
371
-
372
-
373
- def _is_unsafe(obj):
374
- return getattr(obj, '__UNSAFE__', False) is True
375
-
376
-
377
- def _intern(string):
378
- """This is a monkey patch for ``sys.intern`` that will strip
379
- the unsafe wrapper prior to interning the string.
380
-
381
- This will not exist in future versions.
382
- """
383
- if isinstance(string, AnsibleUnsafeText):
384
- string = string._strip_unsafe()
385
- return _sys_intern(string)
386
-
387
-
388
- if isinstance(sys.intern, types.BuiltinFunctionType):
389
- sys.intern = _intern
390
- else:
391
- warnings.warn("skipped sys.intern patch; appears to have already been patched", RuntimeWarning)
ansible/utils/vars.py CHANGED
@@ -20,17 +20,19 @@ from __future__ import annotations
20
20
  import keyword
21
21
  import secrets
22
22
  import uuid
23
+ import typing as t
23
24
 
24
25
  from collections.abc import MutableMapping, MutableSequence
25
26
  from json import dumps
26
27
 
27
28
  from ansible import constants as C
28
29
  from ansible import context
30
+ from ansible._internal import _json
29
31
  from ansible.errors import AnsibleError, AnsibleOptionsError
30
- from ansible.module_utils.six import string_types
32
+ from ansible.module_utils.datatag import native_type_name
31
33
  from ansible.module_utils.common.text.converters import to_native, to_text
32
34
  from ansible.parsing.splitter import parse_kv
33
-
35
+ from ansible.parsing.dataloader import DataLoader
34
36
 
35
37
  _MAXSIZE = 2 ** 32
36
38
  cur_id = 0
@@ -178,19 +180,18 @@ def merge_hash(x, y, recursive=True, list_merge='replace'):
178
180
  return x
179
181
 
180
182
 
181
- def load_extra_vars(loader):
183
+ def load_extra_vars(loader: DataLoader) -> dict[str, t.Any]:
182
184
 
183
185
  if not getattr(load_extra_vars, 'extra_vars', None):
184
- extra_vars = {}
186
+ extra_vars: dict[str, t.Any] = {}
185
187
  for extra_vars_opt in context.CLIARGS.get('extra_vars', tuple()):
186
- data = None
187
188
  extra_vars_opt = to_text(extra_vars_opt, errors='surrogate_or_strict')
188
189
  if extra_vars_opt is None or not extra_vars_opt:
189
190
  continue
190
191
 
191
192
  if extra_vars_opt.startswith(u"@"):
192
193
  # Argument is a YAML file (JSON is a subset of YAML)
193
- data = loader.load_from_file(extra_vars_opt[1:])
194
+ data = loader.load_from_file(extra_vars_opt[1:], trusted_as_template=True)
194
195
  elif extra_vars_opt[0] in [u'/', u'.']:
195
196
  raise AnsibleOptionsError("Please prepend extra_vars filename '%s' with '@'" % extra_vars_opt)
196
197
  elif extra_vars_opt[0] in [u'[', u'{']:
@@ -205,7 +206,7 @@ def load_extra_vars(loader):
205
206
  else:
206
207
  raise AnsibleOptionsError("Invalid extra vars data supplied. '%s' could not be made into a dictionary" % extra_vars_opt)
207
208
 
208
- setattr(load_extra_vars, 'extra_vars', extra_vars)
209
+ load_extra_vars.extra_vars = extra_vars
209
210
 
210
211
  return load_extra_vars.extra_vars
211
212
 
@@ -251,7 +252,7 @@ def isidentifier(ident):
251
252
 
252
253
  Originally posted at https://stackoverflow.com/a/29586366
253
254
  """
254
- if not isinstance(ident, string_types):
255
+ if not isinstance(ident, str):
255
256
  return False
256
257
 
257
258
  if not ident.isascii():
@@ -264,3 +265,45 @@ def isidentifier(ident):
264
265
  return False
265
266
 
266
267
  return True
268
+
269
+
270
+ def validate_variable_name(name: object) -> None:
271
+ """Validate the given variable name is valid, raising an AnsibleError if it is not."""
272
+ if isinstance(name, str) and isidentifier(name):
273
+ return
274
+
275
+ if isinstance(name, (str, int, float, bool, type(None))):
276
+ key_description = f'name {str(name)!r}' # show common scalar key names as strings
277
+ else:
278
+ key_description = 'name'
279
+
280
+ if not isinstance(name, str):
281
+ key_description += f' of type {native_type_name(name)!r}' # show the type name of all non-string keys
282
+
283
+ raise AnsibleError(
284
+ message=f'Invalid variable {key_description}.',
285
+ help_text='Variable names must be strings starting with a letter or underscore character, and contain only letters, numbers and underscores.',
286
+ obj=name,
287
+ )
288
+
289
+
290
+ def transform_to_native_types(
291
+ value: object,
292
+ redact: bool = True,
293
+ ) -> object:
294
+ """
295
+ Recursively transform the given value to Python native types.
296
+ Potentially sensitive values such as individually vaulted variables will be redacted unless ``redact=False`` is passed.
297
+ Which values are considered potentially sensitive may change in future releases.
298
+ Types which cannot be converted to Python native types will result in an error.
299
+ """
300
+ avv = _json.AnsibleVariableVisitor(
301
+ convert_mapping_to_dict=True,
302
+ convert_sequence_to_list=True,
303
+ convert_custom_scalars=True,
304
+ convert_to_native_values=True,
305
+ apply_transforms=True,
306
+ encrypted_string_behavior=_json.EncryptedStringBehavior.REDACT if redact else _json.EncryptedStringBehavior.DECRYPT,
307
+ )
308
+
309
+ return avv.visit(value)
ansible/utils/version.py CHANGED
@@ -11,7 +11,7 @@ from ansible.module_utils.compat.version import LooseVersion, Version
11
11
  # Regular expression taken from
12
12
  # https://semver.org/#is-there-a-suggested-regular-expression-regex-to-check-a-semver-string
13
13
  SEMVER_RE = re.compile(
14
- r'''
14
+ r"""
15
15
  ^
16
16
  (?P<major>0|[1-9]\d*)
17
17
  \.
@@ -30,7 +30,7 @@ SEMVER_RE = re.compile(
30
30
  (?P<buildmetadata>[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*)
31
31
  )?
32
32
  $
33
- ''',
33
+ """,
34
34
  flags=re.X
35
35
  )
36
36
 
ansible/vars/clean.py CHANGED
@@ -42,7 +42,7 @@ def module_response_deepcopy(v):
42
42
  backwards compatibility, in case we need to extend this function
43
43
  to handle our specific needs:
44
44
 
45
- * ``ansible.executor.task_result.TaskResult.clean_copy``
45
+ * ``ansible.executor.task_result._RawTaskResult.as_callback_task_result``
46
46
  * ``ansible.vars.clean.clean_facts``
47
47
  * ``ansible.vars.namespace_facts``
48
48
  """
@@ -94,9 +94,9 @@ def strip_internal_keys(dirty, exceptions=None):
94
94
 
95
95
 
96
96
  def remove_internal_keys(data):
97
- '''
97
+ """
98
98
  More nuanced version of strip_internal_keys
99
- '''
99
+ """
100
100
  for key in list(data.keys()):
101
101
  if (key.startswith('_ansible_') and key != '_ansible_parsed') or key in C.INTERNAL_RESULT_KEYS:
102
102
  display.warning("Removed unexpected internal key in module return: %s = %s" % (key, data[key]))
@@ -114,7 +114,7 @@ def remove_internal_keys(data):
114
114
 
115
115
 
116
116
  def clean_facts(facts):
117
- ''' remove facts that can override internal keys or otherwise deemed unsafe '''
117
+ """ remove facts that can override internal keys or otherwise deemed unsafe """
118
118
  data = module_response_deepcopy(facts)
119
119
 
120
120
  remove_keys = set()
@@ -157,7 +157,7 @@ def clean_facts(facts):
157
157
 
158
158
 
159
159
  def namespace_facts(facts):
160
- ''' return all facts inside 'ansible_facts' w/o an ansible_ prefix '''
160
+ """ return all facts inside 'ansible_facts' w/o an ansible_ prefix """
161
161
  deprefixed = {}
162
162
  for k in facts:
163
163
  if k.startswith('ansible_') and k not in ('ansible_local',):