✨ prompt_password: support Windows

CHANGELOG.rst

@@ -5,6 +5,21 @@ huyz.general Release Notes
 .. contents:: Topics
 
 
+v1.1.0
+======
+
+Release Summary
+---------------
+
+| Release Date: 2024-08-04
+| prompt_password - support Windows
+
+
+Major Changes
+-------------
+
+- prompt_password - support Windows
+
 v1.0.4
 ======
 

README.md

@@ -47,9 +47,9 @@ Update the `title` and set `keep_fragments: true`.
 
 #### After each change
 
-Create a manual fragments in `changeslogs/fragments`.
+First, create a manual fragments in `changeslogs/fragments`.
 
-To lint the fragments:
+Then, to lint the fragments:
 
 ```shell
 antsibull-changelog lint
@@ -70,14 +70,16 @@ collections:
 ```
 
 ```shell
+# Add -f to force the update
 install.sh
 ```
 
+
 #### For a new release
 
-Create a manual fragment in `changeslogs/fragments` named `DATE_vVERSION_summary.yml` with `release_summary` property.
+First, create a manual fragment in `changeslogs/fragments` named `DATE_vVERSION_summary.yml` with `release_summary` property.
 
-Generate the changelog for the release:
+Then, generate the changelog for the release:
 
 ```shell
 antsibull-changelog release --refresh-fragments --update-existing

changelogs/changelog.yaml

@@ -59,3 +59,16 @@ releases:
     - 2023-05-12_fix_posix_dependency.yml
     - 2023-05-12_v1.0.4_summary.yml
     release_date: '2023-05-12'
+  1.1.0:
+    changes:
+      major_changes:
+      - prompt_password - support Windows
+      release_summary: '| Release Date: 2024-08-04
+
+        | prompt_password - support Windows
+
+        '
+    fragments:
+    - 2024-08-04_prompt_password_support_windows.yml
+    - 2024-08-04_v1.1.0_summary.yml
+    release_date: '2024-08-04'

changelogs/fragments/2024-08-04_prompt_password_support_windows.yml

@@ -0,0 +1,2 @@
+major_changes:
+  - prompt_password - support Windows

changelogs/fragments/2024-08-04_v1.1.0_summary.yml

@@ -0,0 +1,3 @@
+release_summary: |
+  | Release Date: 2024-08-04
+  | prompt_password - support Windows

galaxy.yml

@@ -8,7 +8,7 @@ namespace: huyz
 name: general
 
 # The version of the collection. Must be compatible with semantic versioning
-version: 1.0.4
+version: 1.1.0
 
 # The path to the Markdown (.md) readme file. This path is relative to the root of the collection
 readme: README.md

roles/prompt_password/README.md

@@ -6,6 +6,8 @@ Prompts for the `ansible_password` if not defined, with the option to also set t
 
 This avoids the need to call `ansible-playbook` with `--ask-pass` and `--ask-become-pass`.
 
+This works when `ansible_become_method` is set to `sudo` or, for Windows, `ansible.builtin.runas`.
+
 ## Installation
 
 This repo uses the FQCN convention.

roles/prompt_password/tasks/main.yml

@@ -32,4 +32,10 @@
   ansible.builtin.command: '/usr/bin/true'
   changed_when: false
   become: true
-  when: password_prompt.user_input is defined
+  when: password_prompt.user_input is defined and ansible_become_method == 'sudo'
+
+- name: WIN_SHELL | Test the password for fail-fast
+  ansible.windows.win_command: "cmd.exe /c rem"
+  changed_when: false
+  become: true
+  when: password_prompt.user_input is defined and ansible_become_method == 'ansible.builtin.runas'