Vh d dl mZmZmZ eZdZdZdZd dl Z d dl
m Z m Z dZ
d dlmZ dZd
Zd Zed k( r e yy# e$ r e j$ Z
d ZY .w xY w)
)absolute_importdivisionprint_functionu
author: "Jan Christian Grünhage (@jcgruenhage)"
module: matrix
short_description: Send notifications to matrix
description:
- This module sends html formatted notifications to matrix rooms.
extends_documentation_fragment:
- community.general.attributes
attributes:
check_mode:
support: full
diff_mode:
support: none
options:
msg_plain:
type: str
description:
- Plain text form of the message to send to matrix, usually markdown.
required: true
msg_html:
type: str
description:
- HTML form of the message to send to matrix.
required: true
room_id:
type: str
description:
- ID of the room to send the notification to.
required: true
hs_url:
type: str
description:
- URL of the homeserver, where the CS-API is reachable.
required: true
token:
type: str
description:
- Authentication token for the API call. If provided, O(user_id) and O(password) are not required.
user_id:
type: str
description:
- The user ID of the user.
password:
type: str
description:
- The password to log in with.
requirements:
- matrix-client (Python library)
a+
- name: Send matrix notification with token
community.general.matrix:
msg_plain: "**hello world**"
msg_html: "hello world"
room_id: "!12345678:server.tld"
hs_url: "https://matrix.org"
token: "{{ matrix_auth_token }}"
- name: Send matrix notification with user_id and password
community.general.matrix:
msg_plain: "**hello world**"
msg_html: "hello world"
room_id: "!12345678:server.tld"
hs_url: "https://matrix.org"
user_id: "ansible_notification_bot"
password: "{{ matrix_auth_password }}"
N)
AnsibleModulemissing_required_lib) MatrixClientTFc
t t dd t dd t dd t dd t ddd t dd t ddd } t dd }t | d d
ggd d
ggd d ggd }t s |j t d
t
|j r|S t |j d }|j d
|j d
|j _
n.|j |j d |j d d |j |j d }|j |j d |j d |j di | y )NstrT)typerequiredF)r r
no_log) msg_plainmsg_htmlroom_idhs_urltokenuser_idpassword )changedmessager r r )
argument_specmutually_exclusiverequired_one_ofrequired_togethersupports_check_modez
matrix-client)msg exceptionr )syncr r r )dictr matrix_found fail_jsonr MATRIX_IMP_ERR
check_moder paramsapir login join_room send_html exit_json) module_argsresultmoduleclientrooms l/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/community/general/plugins/modules/matrix.py
run_moduler3 ` sr ED1540%$/.d;%%055>K F
! ' 12$g./ %z23 F 1/ Bn]
&--1
2F
}}W )!==1
V]]9-v}}Z/Hu U FMM) 4 5DNN6==,fmmK.HIF v c t y )N)r3 r! r4 r2 mainr6 s Lr4 __main__)
__future__r r r r
__metaclass__
DOCUMENTATIONEXAMPLESRETURN tracebackansible.module_utils.basicr r r% matrix_client.clientr r# ImportError
format_excr3 r6 __name__r! r4 r2 rC s C B
0
d &
J1
L* Z zF q )Y))+NLs > AA