RocketChat Token Support

[caronc]

Description:

Related issue (if applicable): #210

Added token support to the ?mode= list. The syntax is:

• {schema}://{user}:{token}@{host}:{port}/{targets}
• {schema}://{user}:{token}@{host}/{targets}

Note: {schema} is either rocket or rockets

this is similar to {schema}://{user}:{password}@{host}:{port}/{targets}. Apprise tries to detect if it was a {password} or {token} based on it's length. If the value specified is >32 characters, then it assumes ?mode=token, otherwise it will use ?mode=basic.

You can always specific the mode=<val> to enforce what you meant.

If you specify a {user}/{token}, then authentication HTTP requests are skipped and the X-User-Id and X-Auth-Token are pre-populated in the headers in advance.

Checklist

• The code change is tested and works locally.
• There is no commented out code in this PR.
• No lint errors (use flake8)
• 100% test coverage

Testing

Anyone can help test this source code as follows:

# Create a virtual environment to work in as follows:
python3 -m venv apprise

# Change into our new directory
cd apprise

# Activate our virtual environment
source bin/activate

# Install the branch
pip install git+https://github.com/caronc/apprise.git@210-rocket-token-support

# Test out the changes with the following command:
apprise -t "Test Title" -b "Test Message" \
  "rocket://user:token@rocket.server?mode=token"

[caronc]

This branch needs testing; hopefully @portalzine or @xgaia can give it a shot (instructions above) and let me know?

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (31a4f2e) 99.27% compared to head (a17cebc) 99.27%.
Report is 1 commits behind head on master.

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #1060   +/-   ##
=======================================
  Coverage   99.27%   99.27%           
=======================================
  Files         135      135           
  Lines       17600    17611   +11     
  Branches     3592     3596    +4     
=======================================
+ Hits        17472    17483   +11     
  Misses        119      119           
  Partials        9        9           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[portalzine]

Currently running it from the apprise-api. Will do a fresh pure branch install later this week and let you know ...

[portalzine]

Tested this with the latest release and I am always getting:
Failed to send Rocket.Chat token:notification: Channel/RoomId is wrong format, or missing from server., error=400.
Tried varies formats:

1. rockets://userid:token@chat.myhost.com/@username?mode=token
2. rockets://userid:token@chat.myhost.com/#channel?mode=token
3. rockets://userid:token@chat.myhost.com?mode=token&channel=#channel

3 - sends no error message, but never sends the notification itself (no errors in the apprise logs).

Token is fine and channel exists.

The workaround using the api directly works fine json://chat.myhost.com/api/v1/chat.postMessage, which means that there is something else.