flowdock module: deprecation (ansible-collections#6930)

* flowdock module: deprecation * add changelog frag
valeriopoggi · Jul 17, 2023 · 1485317 · 1485317
1 parent 8aa3c88
commit 1485317
Show file tree

Hide file tree

Showing 3 changed files with 12 additions and 0 deletions.
diff --git a/changelogs/fragments/6930-deprecate-flowdock.yml b/changelogs/fragments/6930-deprecate-flowdock.yml
@@ -0,0 +1,2 @@
+deprecated_features:
+  - flowdock - module relies entirely on no longer responsive API endpoints, and it will be removed in community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/6930).
diff --git a/meta/runtime.yml b/meta/runtime.yml
@@ -804,6 +804,10 @@ plugin_routing:
         warning_text: You are using an internal name to access the community.general.flatpak_remote
           modules. This has never been supported or documented, and will stop working
           in community.general 9.0.0.
+    flowdock:
+      deprecation:
+        removal_version: 9.0.0
+        warning_text: This module relies on HTTPS APIs that do not exist anymore and there is no clear path to update.
     notification.flowdock:
       redirect: community.general.flowdock
       deprecation:

diff --git a/plugins/modules/flowdock.py b/plugins/modules/flowdock.py
@@ -11,6 +11,12 @@
 
 DOCUMENTATION = '''
 ---
+
+deprecated:
+  removed_in: 9.0.0
+  why: the endpoints this module relies on do not exist any more and do not resolve to IPs in DNS.
+  alternative: no known alternative at this point
+
 module: flowdock
 author: "Matt Coddington (@mcodd)"
 short_description: Send a message to a flowdock
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,2 @@
		deprecated_features:
		- flowdock - module relies entirely on no longer responsive API endpoints, and it will be removed in community.general 9.0.0 (https://github.com/ansible-collections/community.general/pull/6930).