Synadm

Fixed
* Remove trailing slash from media API calls by Friskygote in https://github.com/JOJ0/synadm/pull/55

Notes
* Update instructions: https://github.com/JOJ0/synadm#update
* **Full Changelog**: https://github.com/JOJ0/synadm/compare/v0.33...v0.33.1

Improved / Changed

- Remove case-insensitive room search workaround.
- `synadm room search`, an alias for `synadm room list -n`, had a workaround built-in to support case-insensitive searches via the room list API. Since Synapse v1.25 (2021-01) this API does case-insensitivity by itself already. The workaround has been removed.
- Support full feature-set of room list command.
- `synadm room search` now supports options `--sort` and `--reverse`, which now gives it the same feature-set as the original `synadm room list` command.

New

- Support the room state API, `synadm room state` (53)
- Room power levels command (list admins, mods, ...),`synadm room power-levels`(54)

Fixed
- Several fixes and improvements in `--help` texts of `room ...` commands.

Notes
- Docs:
- https://synadm.readthedocs.io/en/latest/synadm.cli.room.html#synadm-room-state
- https://synadm.readthedocs.io/en/latest/synadm.cli.room.html#synadm-room-power-levels
- https://synadm.readthedocs.io/en/latest/synadm.cli.room.html#synadm-room-search
- Update instructions: https://github.com/JOJ0/synadm#update
* **Full Changelog**: https://github.com/JOJ0/synadm/compare/v0.32...v0.33

Improved / Changed
- Display room aliases instead of room ID's in `synadm room list`, as requested in issue 25
- Several commands now by default display human readable dates and times instead of UNIX epoch in ms. For scripting purposes the old behaviour can still be forced by passing option --ts (--timestamp):
- `synadm media list`
- `synadm user media`
- Options `--datetime/--timestamp` in `synadm regtok list` command streamlined to shortform options `--dt/--ts`


New
- Translate a room ID to room aliases and vice versa, new command: `synadm room resolve`, contributed by MacLemon
- Cleanup abandoned sessions/devices, new command `synadm user prune-devices` as requested in issue 44, contributed by nemobis



Fixed
- Activating a user without a password is now a valid use case, contributed by andir PR 39
- Add missing `synadm config` command to readthedocs commmands reference.
- Streamline help texts: Always start with a capital letter.


Notes
- Check https://synadm.readthedocs.org for details on the new commands.
- Update instructions: https://github.com/JOJ0/synadm#update

Improved / Changed
- Admin token is never shown in console or file log
- `media delete` command: Automatically retrieve local server name via Matrix API
- `media quarantine` command: Automatically retrieve local server name via Matrix API
- In human output mode use tabulate plain format for displaying results that are simple dicts. Removes rather pointless dashed lines on top and bottom of output.

New
- Registration token management, new subcommand `regtok`, contributed by govynnus

Fixed
- `matrix` subcommand added to readthedocs CLI reference
- Some english grammar fixes, contributed by neunenak
- `room delete` command: Replace deprecated post with delete method

New

`synadm` finally got some nicely rendered documentation pages hosted at https://synadm.readthedocs.io.

"Login as a user" admin API support:
- `synadm user login <user id>`
- [Have a look at the new command's docs](https://synadm.readthedocs.io/en/latest/synadm.cli.user.html#synadm-user-login)

New subcommand `matrix`supporting execution of regular Matrix commands. As a first shot a command to issue any Matrix API call has been implemented:
- `synadm matrix raw endpoint/url -m post -f data.json`
- `synadm matrix raw endpoint/url -m put -d '{"key1": "value1"}' --prompt`
- [The new command's docs](https://synadm.readthedocs.io/en/latest/synadm.cli.matrix.html#synadm-matrix-raw)

_Note that this is ment to be a convenience function in case a Synapse homeserver admin wants to quickly help users e.g set specific settings available via regular Matrix calls and not the Synapse admin API directly. Also note that it is not ment to replace the awesome Matrix CLI tools that are already out there. [matrix-commander](https://github.com/8go/matrix-commander), [matrixcli](https://github.com/saadnpq/matrixcli) to mention just a few._

The second command below `matrix` is:
- `synadm matrix login <user id>`
- [The new command's docs](https://synadm.readthedocs.io/en/latest/synadm.cli.matrix.html#synadm-matrix-login)

It implements a plain login on a Matrix server using username and password. It can even be used to retrieve a token for an admin user, e.g helpful for setting up fresh `synadm` installations. [Read about it here](https://github.com/JOJ0/synadm#getting-an-admin-token)


Improved
The README has been updated to point to the nicely rendered docs recently published at https://matrix-org.github.io/synapse/develop/usage/administration/admin_api/index.html


Notes
Update via PyPI or git as described in the update chapter: https://github.com/JOJ0/synadm#update

Thanks to the friendly people in synadm:peek-a-boo.at for reviewing, testing, discussing functionality and giving advice. And for this release, a special thanks to `hpd:hpdeifel.de` hpdeifel

Improved / Changed

- `synadm media ...` commands changed option `--days` to `--before-days` (streamlining options with history purge command)
- More automation and helpers code to make releasing "small but often" a habbit.

New

- Purge history admin API support, new commands:
- `synadm history purge <room id>`
- `synadm history purge-status <purge id>`

Notes

- This is the first synadm release to be available on PyPI. Just `pip install synadm`
https://pypi.org/project/synadm/