mirror of
https://github.com/ansible-collections/community.general.git
synced 2026-02-04 16:01:55 +00:00
138 lines
3.5 KiB
Python
138 lines
3.5 KiB
Python
#!/usr/bin/python
|
|
#
|
|
# Copyright Ansible Project
|
|
# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
|
|
from __future__ import annotations
|
|
|
|
DOCUMENTATION = r"""
|
|
module: typetalk
|
|
short_description: Send a message to typetalk
|
|
description:
|
|
- Send a message to typetalk using typetalk API.
|
|
deprecated:
|
|
removed_in: 13.0.0
|
|
why: The typetalk service will be discontinued on Dec 2025. See U(https://nulab.com/blog/company-news/typetalk-sunsetting/).
|
|
alternative: There is none.
|
|
extends_documentation_fragment:
|
|
- community.general.attributes
|
|
attributes:
|
|
check_mode:
|
|
support: none
|
|
diff_mode:
|
|
support: none
|
|
options:
|
|
client_id:
|
|
type: str
|
|
description:
|
|
- OAuth2 client ID.
|
|
required: true
|
|
client_secret:
|
|
type: str
|
|
description:
|
|
- OAuth2 client secret.
|
|
required: true
|
|
topic:
|
|
type: int
|
|
description:
|
|
- Topic ID to post message.
|
|
required: true
|
|
msg:
|
|
type: str
|
|
description:
|
|
- Message body.
|
|
required: true
|
|
requirements: [json]
|
|
author: "Takashi Someda (@tksmd)"
|
|
"""
|
|
|
|
EXAMPLES = r"""
|
|
- name: Send a message to typetalk
|
|
community.general.typetalk:
|
|
client_id: 12345
|
|
client_secret: 12345
|
|
topic: 1
|
|
msg: install completed
|
|
"""
|
|
|
|
import json
|
|
from urllib.parse import urlencode
|
|
|
|
from ansible.module_utils.basic import AnsibleModule
|
|
from ansible.module_utils.urls import ConnectionError, fetch_url
|
|
|
|
|
|
def do_request(module, url, params, headers=None):
|
|
data = urlencode(params)
|
|
if headers is None:
|
|
headers = dict()
|
|
headers = dict(
|
|
headers,
|
|
**{
|
|
"User-Agent": "Ansible/typetalk module",
|
|
},
|
|
)
|
|
r, info = fetch_url(module, url, data=data, headers=headers)
|
|
if info["status"] != 200:
|
|
exc = ConnectionError(info["msg"])
|
|
exc.code = info["status"]
|
|
raise exc
|
|
return r
|
|
|
|
|
|
def get_access_token(module, client_id, client_secret):
|
|
params = {
|
|
"client_id": client_id,
|
|
"client_secret": client_secret,
|
|
"grant_type": "client_credentials",
|
|
"scope": "topic.post",
|
|
}
|
|
res = do_request(module, "https://typetalk.com/oauth2/access_token", params)
|
|
return json.load(res)["access_token"]
|
|
|
|
|
|
def send_message(module, client_id, client_secret, topic, msg):
|
|
"""
|
|
send message to typetalk
|
|
"""
|
|
try:
|
|
access_token = get_access_token(module, client_id, client_secret)
|
|
url = f"https://typetalk.com/api/v1/topics/{topic}"
|
|
headers = {
|
|
"Authorization": f"Bearer {access_token}",
|
|
}
|
|
do_request(module, url, {"message": msg}, headers)
|
|
return True, {"access_token": access_token}
|
|
except ConnectionError as e:
|
|
return False, e
|
|
|
|
|
|
def main():
|
|
module = AnsibleModule(
|
|
argument_spec=dict(
|
|
client_id=dict(required=True),
|
|
client_secret=dict(required=True, no_log=True),
|
|
topic=dict(required=True, type="int"),
|
|
msg=dict(required=True),
|
|
),
|
|
supports_check_mode=False,
|
|
)
|
|
|
|
if not json:
|
|
module.fail_json(msg="json module is required")
|
|
|
|
client_id = module.params["client_id"]
|
|
client_secret = module.params["client_secret"]
|
|
topic = module.params["topic"]
|
|
msg = module.params["msg"]
|
|
|
|
res, error = send_message(module, client_id, client_secret, topic, msg)
|
|
if not res:
|
|
module.fail_json(msg=f"fail to send message with response code {error.code}")
|
|
|
|
module.exit_json(changed=True, topic=topic, msg=msg)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|