an old fork of the python sdk, i think this is used in feedbot.
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Ryan Rix 186e76cf57 Implement m.image type in Client 8 years ago
matrix_client Implement m.image type in Client 8 years ago
.gitignore Initial commit 9 years ago
LICENSE Initial commit 9 years ago
MANIFEST.in Add a MANIFEST.in 9 years ago
README.rst Add pypi badge to README.rst 9 years ago
setup.py Bump to 0.0.2 8 years ago

README.rst

Matrix Client SDK for Python
============================

.. image:: https://pypip.in/version/matrix-client/badge.svg?branch=master
  :target: https://pypi.python.org/pypi/matrix-client/
  :alt: Latest Version

This is a Matrix client-server SDK for Python 2.x.

Usage
=====
The SDK provides 2 layers of interaction. The low-level layer just wraps the
raw HTTP API calls. The high-level layer wraps the low-level layer and provides
an object model to perform actions on.

Client:

.. code:: python

    from matrix_client.client import MatrixClient

    client = MatrixClient("http://localhost:8008")
    token = client.register_with_password(username="foobar", password="monkey")
    room = client.create_room("my_room_alias")
    room.send_text("Hello!")


API:

.. code:: python

    from matrix_client.api import MatrixHttpApi

    matrix = MatrixHttpApi("https://matrix.org", token="some_token")
    response = matrix.initial_sync()
    response = matrix.send_message("!roomid:matrix.org", "Hello!")


Structure
=========
The SDK is split into two modules: ``api`` and ``client``.

API
---
This contains the raw HTTP API calls and has minimal business logic. You can 
set the access token (``token``) to use for requests as well as set a custom 
transaction ID (``txn_id``) which will be incremented for each request.

Client
------
This encapsulates the API module and provides object models such as ``Room``.