chore: include archival notice in README

This commit is contained in:
Jan Christian Grünhage 2020-08-04 12:57:13 +00:00
parent b43403f4f0
commit 484ecb1d44
1 changed files with 2 additions and 62 deletions

View File

@ -1,62 +1,2 @@
# Matrix Ansible Modules
This repo contains a few ansible modules for working with matrix rooms.
## Installation
To install these modules so that you can use them, put them into `~/.ansible/plugins/modules/` or for global installation, install them to `/usr/share/ansible/plugins/modules/`.
## Requirements
- **nio:** The modules require matrix-nio to be required on the target. Some bugs and missing features were found during the development of these modules, which have been fixed in the case of bugs and implemented in the case of missing features. Until they are merged upstream, you have to install the matrix-nio library from source using https://github.com/poljar/matrix-nio/pull/102.
- **Python >= 3.5:** The modules make extensive use of async/await, so only Python 3.5 or later are supported. These modules have only been tested with Python 3.8 so far.
## Usage
For a usage example including all modules, look at the example playbook below.
```yaml
- hosts: localhost
vars:
matrix:
homeserver: https://example.org
user: username
password: s3cr3t
alias: '#some-alias:example.org'
message: "Set room name in"
tasks:
- matrix_login:
hs_url: "{{ matrix.homeserver }}"
user_id: "{{ matrix.user }}"
password: "{{ matrix.password }}"
register: login_result
- matrix_room:
hs_url: "{{ matrix.homeserver }}"
token: "{{ login_result.token }}"
alias: "{{ matrix.alias }}"
register: room_result
- matrix_state:
hs_url: "{{ matrix.homeserver }}"
token: "{{ login_result.token }}"
room_id: "{{ room_result.room_id }}"
event_type: "m.room.name"
state_key: ""
content:
name: "test room name"
register: state_result
- matrix_notification:
hs_url: "{{ matrix.homeserver }}"
token: "{{ login_result.token }}"
room_id: "{{ room_result.room_id }}"
msg_plain: "{{ matrix.message }} {{ state_result.event_id}}"
msg_html: "{{ matrix.message }} {{ state_result.event_id}}"
when: state_result.changed
- matrix_logout:
hs_url: "{{ matrix.homeserver }}"
token: "{{ login_result.token }}"
```
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
## License
[AGPLv3](https://choosealicense.com/licenses/agpl-3.0/)
# ARCHIVAL NOTICE
The modules in this repo have been merged into https://gitlab.com/famedly/ansible/collections/matrix, where new development will happen.