Python API wrapper for Rocket.Chat
Project description
rocketchat_API
Python API wrapper for Rocket.Chat
Installation
- From pypi:
pip3 install rocketchat_API
- From GitHub:
Clone our repository and
python3 setup.py install
Requirements
- requests==2.18.4
Usage
from pprint import pprint
from rocketchat_API.rocketchat import RocketChat
proxyDict = {
"http" : "http://127.0.0.1:3128",
"https" : "https://127.0.0.1:3128",
}
rocket = RocketChat('user', 'pass', server_url='https://demo.rocket.chat', proxies=proxyDict)
pprint(rocket.me().json())
pprint(rocket.channels_list().json())
pprint(rocket.chat_post_message('good news everyone!', channel='GENERAL', alias='Farnsworth').json())
pprint(rocket.channels_history('GENERAL', count=5).json())
note: every method returns a requests Response object.
Method parameters
Only required parameters are explicit on the RocketChat class but you can still use all other parameters. For a detailed parameters list check the Rocket chat API
API coverage
Most of the API methods are already implemented. If you are interested in a specific call just open an issue or open a pull request.
note: Library updated to work with Rocket.Chat >= 0.66.0
Tests
We are actively testing :)
Tests run on a Rocket.Chat Docker container so install Docker and docker-compose. To start test server do docker-compose -f docker-compose-test-setver.yml up
and to take test server down docker-compose -f docker-compose-test-setver.yml down
Contributing
You can contribute by doing Pull Requests. (It may take a while to merge your code but if it's good it will be merged). Please, try to implement tests for all your code and use a PEP8 compliant code style.
Reporting bugs and asking for features is also contributing ;) Feel free to help us grow by registering issues.
We hang out here if you want to talk.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
File details
Details for the file rocketchat_API-0.6.19-py3-none-any.whl
.
File metadata
- Download URL: rocketchat_API-0.6.19-py3-none-any.whl
- Upload date:
- Size: 7.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 644050501f1b60156b403c8db9d8318aa33bf7eaf17621cf88a5f9e6cb1705f0 |
|
MD5 | 2bd6a11accba9f4e83512dd96751f22f |
|
BLAKE2b-256 | 8551f55766616dd7115115b2a59311691ff0384fdc92300c43086d8cb98687ca |
File details
Details for the file rocketchat_API-0.6.19-py2-none-any.whl
.
File metadata
- Download URL: rocketchat_API-0.6.19-py2-none-any.whl
- Upload date:
- Size: 7.5 kB
- Tags: Python 2
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 56f8399cc64e0aa7fae9afe2af1d88c7809df7bb089b122d1cf5b258ea70b05a |
|
MD5 | 16d1e63aafa9d4ea8737bc189875ef3f |
|
BLAKE2b-256 | 4f0bb3ec4d896b4394dbe18c106d7aae37e607cacc8913ab4b9a4e6a55e3bdb1 |