README

Wed, 03 May 2017 12:16:14 +0100

author
Matthew Wild <mwild1@gmail.com>
date
Wed, 03 May 2017 12:16:14 +0100
changeset 1
e4381b6a52ce
permissions
-rw-r--r--

Add README

Introduction
============

This repository allows building the latest aioxmpp test suite into a convenient portable Docker image, which can
be used to launch the tests inside a container, pointed towards the XMPP server of your choice.

Building
========

In the repository, run:

    docker build -t aioxmpp-tests .

Running
=======

    docker run --rm -e SERVER_HOST=localhost -e SERVER_PORT=5222 aioxmpp-tests

Limitations
===========

Currently only the anonymous provisioner is used, which requires anonymous authentication to be enabled
on the server. For this reason it attempts to connect to the XMPP host 'anon.localhost', assuming this
to allow anonymous authentication. If you need to specify a different XMPP host, this is currently not
implemented, but patches welcome (it's trivial to do).

mercurial