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

1
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
1 Introduction
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
2 ============
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
3
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
4 This repository allows building the latest aioxmpp test suite into a convenient portable Docker image, which can
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
5 be used to launch the tests inside a container, pointed towards the XMPP server of your choice.
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
6
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
7 Building
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
8 ========
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
9
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
10 In the repository, run:
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
11
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
12 docker build -t aioxmpp-tests .
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
13
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
14 Running
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
15 =======
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
16
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
17 docker run --rm -e SERVER_HOST=localhost -e SERVER_PORT=5222 aioxmpp-tests
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
18
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
19 Limitations
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
20 ===========
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
21
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
22 Currently only the anonymous provisioner is used, which requires anonymous authentication to be enabled
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
23 on the server. For this reason it attempts to connect to the XMPP host 'anon.localhost', assuming this
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
24 to allow anonymous authentication. If you need to specify a different XMPP host, this is currently not
e4381b6a52ce Add README
Matthew Wild <mwild1@gmail.com>
parents:
diff changeset
25 implemented, but patches welcome (it's trivial to do).

mercurial