Deprecate postgresql_lang (#559) (#562)

* lang deprecated

* lang deprecated

* lang deprecated

* postgresql_lang

Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>

* lang deprecated

---------

Co-authored-by: Andrew Klychkov <aaklychkov@mail.ru>
(cherry picked from commit 5655558)

Co-authored-by: Pavel Rabel <128324708+elpavel@users.noreply.github.com>

Author: patchback[bot]

changelogs/fragments/559-postgresql_lang-deprecate.yml

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

meta/runtime.yml

@@ -25,3 +25,9 @@ action_groups:
     - postgresql_tablespace
     - postgresql_user
     - postgresql_user_obj_stat_info
+plugin_routing:
+  modules:
+    postgresql_lang:
+      deprecation:
+        removal_version: 4.0.0
+        warning_text: Use postgresql_ext instead.

plugins/modules/postgresql_lang.py

@@ -12,6 +12,10 @@
 ---
 module: postgresql_lang
 short_description: Adds, removes or changes procedural languages with a PostgreSQL database
+deprecated:
+  removed_in: "4.0.0"
+  why: As of PostgreSQL 9.1, most procedural languages have been made into extensions.
+  alternative: Use M(community.postgresql.postgresql_ext) instead.
 description:
 - Adds, removes or changes procedural languages with a PostgreSQL database.
 - This module allows you to add a language, remote a language or change the trust
@@ -168,6 +172,8 @@
   sample: ['CREATE LANGUAGE "acme"']
 '''
 
+# WARNING - The postgresql_lang module has been deprecated and will be removed in community.postgresql 4.0.0.
+
 from ansible.module_utils.basic import AnsibleModule
 from ansible_collections.community.postgresql.plugins.module_utils.database import check_input
 from ansible_collections.community.postgresql.plugins.module_utils.postgres import (