matrix

This is a minimal implementation of the endpoints matrix provides for communication inbetween the client and the server.

Functions

The basic functions availible are described below. I'm pretty sure that I won't update these farily often, so you're better of just using go doc for searching through the functionnns.

Login

func Login(username, password, homeserver string) (Authinfo, error)

Used to get an authinfo struct containing information needed by other function for functioning properly, such as the auth key needed to send messages.

Send

func Send(authinfo Authinfo, roomID string, message string) error
func SendImage(authinfo Authinfo, roomID string, image map[string]interface{}) error

Send and message or and image to a room you are in. (Sending images is done by providing a map with information on the image:

    image := map[string]interface{}{
        "msgtype": "m.image",
        "url":     mxc://matrix.emile.space/askhdlkajshdlkajhdslkjh,
        "info": map[string]interface{}{
            "h":        1080,
            "w":        1920,
            "mimetype": "image/jpeg",
            "size":     1337,
        },
        "body": "some text associated with the image",
}

Most important: the url, that actually isn't a url but a mxc URI. To get one upload your image using the upload function, you'll get that uri in the response.

Sync

func Sync(authinfo Authinfo) (RespSync, error)
func SyncPartial(authinfo Authinfo, nextBatch string, eventsChannel chan PackagedEvent) (RespSync, error)

There are two syncs available: Sync and syncPartial. Sync is used to syncronize the first time in order to get all events created. SyncPartial uses a token returned by the Sync function to fetch all events created since that token was given out (sort of a timestamp).

This allows incremental fetches.

Upload

func Upload(authinfo Authinfo, filename string, file *bytes.Buffer) (UploadResponse, error)

The upload function uploads the given buffer to the homeserver that is provided in the authinfo object. The response contains the mxc URI that can be used to send the uploaded image to another participant.