From 60d51f7b49dec0e11a3ce90e00e3366b26859f08 Mon Sep 17 00:00:00 2001
From: "patchback[bot]" <45432694+patchback[bot]@users.noreply.github.com>
Date: Sun, 29 Dec 2024 14:13:11 +0100
Subject: [PATCH] [PR #9451/474546b1 backport][stable-10] facter: deprecation
 (#9459)

facter: deprecation (#9451)

* facter: deprecation

Per https://github.com/ansible-collections/community.general/pull/7356#issuecomment-1752460442 it has been agreed that this module would be replaced with the better named `facter_facts`.

* add changelog frag

* add deprecation note to the module documentation

(cherry picked from commit 474546b11712bed94987fdc5ab174276ef451c74)

Co-authored-by: Alexei Znamensky <103110+russoz@users.noreply.github.com>
---
 changelogs/fragments/9451-facter-deprecation.yml | 2 ++
 meta/runtime.yml                                 | 4 ++++
 plugins/modules/facter.py                        | 4 ++++
 3 files changed, 10 insertions(+)
 create mode 100644 changelogs/fragments/9451-facter-deprecation.yml

diff --git a/changelogs/fragments/9451-facter-deprecation.yml b/changelogs/fragments/9451-facter-deprecation.yml
new file mode 100644
index 0000000000..63924e9358
--- /dev/null
+++ b/changelogs/fragments/9451-facter-deprecation.yml
@@ -0,0 +1,2 @@
+deprecated_features:
+  - facter - module is deprecated and will be removed in community.general 12.0.0, use ``community.general.facter_facts`` instead (https://github.com/ansible-collections/community.general/pull/9451).
diff --git a/meta/runtime.yml b/meta/runtime.yml
index 5c80fe4054..427c376b0f 100644
--- a/meta/runtime.yml
+++ b/meta/runtime.yml
@@ -104,6 +104,10 @@ plugin_routing:
       tombstone:
         removal_version: 10.0.0
         warning_text: Use community.general.consul_token and/or community.general.consul_policy instead.
+    facter:
+      deprecation:
+        removal_version: 12.0.0
+        warning_text: Use community.general.facter_facts instead.
     hipchat:
       deprecation:
         removal_version: 11.0.0
diff --git a/plugins/modules/facter.py b/plugins/modules/facter.py
index 0fa286d5e6..ce9320282d 100644
--- a/plugins/modules/facter.py
+++ b/plugins/modules/facter.py
@@ -14,6 +14,10 @@ short_description: Runs the discovery program C(facter) on the remote system
 description:
   - Runs the C(facter) discovery program (U(https://github.com/puppetlabs/facter)) on the remote system, returning JSON data
     that can be useful for inventory purposes.
+deprecated:
+  removed_in: 12.0.0
+  why: The module has been replaced by M(community.general.facter_facts).
+  alternative: Use M(community.general.facter_facts) instead.
 extends_documentation_fragment:
   - community.general.attributes
 attributes: