postgresql_set: deprecate the module in favor of postgresql_alter_system

README.md

@@ -134,7 +134,6 @@ Our AZP CI includes testing with the following docker images / PostgreSQL versio
   - [postgresql_pg_hba](https://docs.ansible.com/ansible/latest/collections/community/postgresql/postgresql_pg_hba_module.html)
   - [postgresql_privs](https://docs.ansible.com/ansible/latest/collections/community/postgresql/postgresql_privs_module.html)
   - [postgresql_alter_system](https://docs.ansible.com/ansible/latest/collections/community/postgresql/postgresql_alter_system_module.html) (will replace `postgresql_set`)
-  - [postgresql_set](https://docs.ansible.com/ansible/latest/collections/community/postgresql/postgresql_set_module.html) (will get deprecated in 4.0.0 and removed in 5.0.0)
   - [postgresql_schema](https://docs.ansible.com/ansible/latest/collections/community/postgresql/postgresql_schema_module.html)
   - [postgresql_tablespace](https://docs.ansible.com/ansible/latest/collections/community/postgresql/postgresql_tablespace_module.html)
   - [postgresql_query](https://docs.ansible.com/ansible/latest/collections/community/postgresql/postgresql_query_module.html)

changelogs/fragments/6-set_deprecate.yml

@@ -0,0 +1,2 @@
+deprecated_features:
+- "postgresql_set - the module has been deprecated and will be removed in ``community.postgresql 5.0.0``. Please use the ``community.postgresql.postgresql_alter_system`` module instead (https://github.com/ansible-collections/community.postgresql/issues/823)."

meta/runtime.yml

@@ -31,3 +31,7 @@ plugin_routing:
       deprecation:
         removal_version: 4.0.0
         warning_text: Use postgresql_ext instead.
+    postgresql_set:
+      deprecation:
+        removal_version: 5.0.0
+        warning_text: Use postgresql_alter_system instead.

plugins/modules/postgresql_set.py

@@ -12,6 +12,10 @@
 ---
 module: postgresql_set
 short_description: Change a PostgreSQL server configuration parameter
+deprecated:
+  removed_in: "5.0.0"
+  why: It has been replaced with a better-designed module.
+  alternative: Use M(community.postgresql.postgresql_alter_system) instead.
 description:
    - "IMPORTANT: If your PostgreSQL server version is 14 or later,
      use the M(community.postgresql.postgresql_alter_system) module instead as it will