Skip to main content

Python API wrapper for Rocket.Chat

Project description

rocketchat_API

Python API wrapper for Rocket.Chat

Codacy Badge Build Status codecov PyPI Say Thanks!

Installation

  • From pypi: pip3 install rocketchat_API
  • From GitHub: Clone our repository and python3 setup.py install

Requirements

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.65.1

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

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

rocketchat_API-0.6.17-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

rocketchat_API-0.6.17-py2-none-any.whl (7.2 kB view details)

Uploaded Python 2

File details

Details for the file rocketchat_API-0.6.17-py3-none-any.whl.

File metadata

File hashes

Hashes for rocketchat_API-0.6.17-py3-none-any.whl
Algorithm Hash digest
SHA256 2c0755d5c1db64e7dc6b70d01956656c7434f027d2931852c6a5efefee3aa724
MD5 595745edc29189e76c5919c11ebb65c9
BLAKE2b-256 8d7398b225c0609a26e3eaafd8a12541d962b8bd8859f68af9dafe2185dc2ae1

See more details on using hashes here.

File details

Details for the file rocketchat_API-0.6.17-py2-none-any.whl.

File metadata

File hashes

Hashes for rocketchat_API-0.6.17-py2-none-any.whl
Algorithm Hash digest
SHA256 13fb2f5b50d311d3a5fb6bbfd592a12e1a4c78da59467125fd6af4feebe529fe
MD5 e537e7bf48cf7ebca6003413de91dba2
BLAKE2b-256 739247e71b554739ea1df122b9f4fe95ad25ae48c427a3ec377c885a96d09812

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page