Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
added --login, re-did internals to allow more parallelism
- allows for --login, --verify, --get..., -m, --listen all to be done in the same command. - allows for ephemeral use: --login, -m in one call and then wipe store and credentials (devices will accumulate in this case) - allows for non-interactive login (and send, and get, and set) - --verify remains interactive ``` --login LOGIN Login to and authenticate with the Matrix homeserver. ***THIS IS NOT YET IMPLEMENTED. PLEASE STAY TUNED.*** This requires exactly one argument, the login method. Currently two choices are offered: 'password' and 'sso'. Provide one of these methods. If you have chosen 'password', you will authenticate through your account password. You can optionally provide these additional arguments: --homeserver to specify the Matrix homeserver, --user-login to specify the log in user id, --password to specify the password, --device to specify a device name, --room-default to specify a default room for sending/listening. If you have chosen 'sso', you will authenticate through Single Sign-On. A web-browser will be started and you authenticate on the webpage. You can optionally provide these additional arguments: --homeserver to specify the Matrix homeserver, --user-login to specify the log in user id, --device to specify a device name, --room- default to specify a default room for sending/listening. See all the extra arguments for further explanations. --room-default ROOM_DEFAULT Optionally specify a room as the default room for future actions. If not specified for --login, it will be queried via the keyboard. --login stores the specified room as default room in your credentials file. This option is only used in combination with --login. A default room is needed. Specify a valid room either with --room-default or provide it via keyboard. --user-login USER_LOGIN Optional argument to specify the user for --login. This gives the otion to specify the user id for login. For '--login sso' the --user-login is not needed as user id can be obtained from server via SSO. For '-- login password', if not provided it will be queried via keyboard. A full user id like '@john:example.com', a partial user name like '@john', and a short user name like 'john' can be given. --user-login is only used by --login and ignored by all other actions. --password PASSWORD Specify a password for use by certain actions. It is an optional argument. By default --password is ignored and not used. It is used by '--login password' and '-- delete-device' actions. If not provided for --login the user will be queried via keyboard. --homeserver HOMESERVER Specify a homeserver for use by certain actions. It is an optional argument. By default --homeserver is ignored and not used. It is used by '--login' action. If not provided for --login the user will be queried via keyboard. --device DEVICE Specify a device name, for use by certain actions. It is an optional argument. By default --device is ignored and not used. It is used by '--login' action. If not provided for --login the user will be queried via keyboard. If you want the default value specify ''. Multiple devices (with different device id) may have the same device name. In short, the same device name can be assigned to multiple different devices if desired. ```
- Loading branch information