[doc] update requirements for all consul modules/lookups (#10863)

* [doc] update requirements for consul_kv module

python-consul has been unmaintained for a while. It uses a legacy way of passing the Consul token when sending requests. This leads to warning messages in Consul log, and will eventually break communication. Using the maintained py-consul library ensures compatibility to newer Consul versions.

* [doc] replace all python-consul occurrences with py-consul

* [fix] tests and possible pip server errors

* [chore] remove referencce to python-consul in comment

---------

Co-authored-by: Sebastian Damm <sebastian.damm@pascom.net>

tests/integration/targets/consul/tasks/main.yml

@@ -21,11 +21,13 @@
       register: result
       until: result is success
       when: ansible_distribution_file_variety|default() == 'RedHat' and ansible_distribution_major_version is version('6', '<=')
-    - name: Install python-consul
+    - name: Install py-consul
       pip:
-        name: python-consul
+        name: py-consul
         extra_args: "-c {{ remote_constraints }}"
       register: result
+      retries: 3
+      delay: 5
       until: result is success
     - name: Generate privatekey
       community.crypto.openssl_privatekey: