| .github | Loading last commit info... | |
| assets/images | ||
| scripts | ||
| src | ||
| .gitignore | ||
| COPYING | ||
| License.html | ||
| README.md | ||
| pom.xml |
Tigase TTS-NG
XMPP funcional test framework with sizeable suite of tests based on the jaxmpp2 and TestNG framework as a successor of tigase-testsuite
Current results for Tigase XMPP Server can be found on our pages: Stable and Snapshot releases
Features
- Over 200 funcional XMPP tests:
- Core XMPP
- MultiUserChat
- PubSub
- MAM
- Easy, automatic operation
- Easy way to add more tests
- (Optional) Downloading latest release of Tigase XMPP Server
- (Optional) Automatic preparaion of the database, supports:
- MySQL
- PostgreSQL
- Derby
- MongoDB
- MS SQL Server
How to Start
Running
The whole suite execution can be handled via $ ./scripts/tests-runner.sh shell script. Executing it without any parameters will yield help:
$ ./scripts/tests-runner.sh
Run selected or all tests for defined server
----
--all-tests [(database)] :: Run all available tests
(database) is an array, if database is missing tests will be run against all configured ones
possible values: derby, mysql, postgresql, sqlserver, mongodb
--custom <package.Class[#method]]> [(database)] :: Run defined test, accepts wildcards, eg.:
--custom tigase.tests.util.RetrieveVersion
--help :: print this help
----
Special parameters only at the beginning of the parameters list
--debug|-d Turns on debug mode
--skip-rebuild-tts|-srb Turns off rebuilding TTS-NG and only runs already build tests
--skip-summary-page-get|-sp Turns off automatic generation of Summary Page
--download-latest|-dl Turns on downloading latest Tigase Server release
--reload-db|-db Turns on reloading database
--start-server|-serv Turns on starting Tigase server
-----------
Other possible parameters are in following order:
[server-dir] [server-ip]
You should copy scripts/tests-runner-settings.dist.sh to scripts/tests-runner-settings.sh and adjust settings before running.
Adding new tests
The easiest way to add new test is to extend tigase.tests.AbstractTest (AbstractTest.java), take a look at ExampleJaxmppTest.java to get general idea:
package tigase.tests;
import org.testng.annotations.Test;
import tigase.jaxmpp.j2se.Jaxmpp;
import tigase.tests.utils.Account;
import static org.testng.Assert.assertTrue;
import static tigase.TestLogger.log;
public class ExampleJaxmppTest
extends AbstractTest {
@Test(groups = {"examples"}, description = "Simple test verifying logging in by the user")
public void SimpleLoginTest() {
try {
log("This is test case");
Jaxmpp contact = getAdminAccount().createJaxmpp().setConnected(true).build();
assertTrue(contact.isConnected(), "contact was not connected");
if (contact.isConnected()) {
contact.disconnect();
}
Account createUserAccount = createAccount().setLogPrefix("test_user").build();
Jaxmpp createJaxmpp = createUserAccount.createJaxmpp().build();
createJaxmpp.login(true);
assertTrue(createJaxmpp.isConnected(), "contact was not connected");
} catch (Exception e) {
fail(e);
}
}
}
Support
When looking for support, please first search for answers to your question in the available online channels:
- Our online documentation: Tigase TTS-NG Docs
- Our online forums: Tigase Forums
- Our online Knowledge Base Tigase KB
If you didn't find an answer in the resources above, feel free to submit your question to either our community portal or open a support ticket
Compilation
It's a Maven project therefore after cloning the repository you can easily build it with:
mvn -Pdist clean install
License
Official Tigase repository is available at: https://github.com/tigase/tigase-tts-ng/.
Copyright (c) 2004 Tigase, Inc.
Licensed under AGPL License Version 3. Other licensing options available upon request.