|
|
||
|---|---|---|
| addons | ||
| test | ||
| vendor | ||
| .gitattributes | ||
| .gitignore | ||
| .gitmodules | ||
| .gut_editor_config.json | ||
| .gutconfig.json | ||
| LICENSE | ||
| project.godot | ||
| README.md | ||
| run_tests_linux.sh | ||
matrix-godot-client
A client to the Matrix universe for the Godot Game Engine.
Matrix: https://matrix.org Godot: https://godotengine.org
Coverage
API
According to Client-Server API:
- Discovery *
Installation
The library is contained within addons/matrix-client. This directory should be put in your project's folder:
$ tree -d
.
├── addons
│ └── matrix-client
└── project.godot
Development
[TODO]
Testing
Unit tests
Unit tests do no I/O at all, and validate individual classes' behaviour. The tests are located at res://test/unit.
Integration tests
Integration tests are actual calls against a matrix server, for instance Synapse (http://github.com/matrix-org/synapse). The tests are located at res://test/integration. There are fixtures for a pre-populated and pre-configured synapse instance at res://test/integration/fixtures/synapse-data.
Running the tests
Linux 64-bit
Tests on Linux can be run within a terminal using the supplied Godot Headless binary.
The script run_tests_linux.sh will help run the tests and print a report.
$ ./run_tests_linux.sh [-d unit|integration]
If running the integration tests, the script will attempt to use docker to start a container with the image matrixdotorg/synapse:v1.23.0, and attach a copy of the data directory at res://test/integration/fixtures/synapse-data (into a directory under /tmp).
Synapse in the container will run as the UID:GID of the local user running the tests.
Windows
[TODO]
Credits
This software makes use of the following programs or libraries:
-
Godot Engine (https://godotengine.org)
Copyright (c) 2007-2020 Juan Linietsky, Ariel Manzur. Copyright (c) 2014-2020 Godot Engine contributors (cf. AUTHORS.md).
-
Godot Unit Test (GUT) (https://github.com/bitwes/Gut)
Copyright (c) 2014-2020 Butch Wesley (bitwes).
-
mime_type (https://github.com/mitsuoka/mime_type)
Database for mimetypes by file extension, published under the MIT License Copyright (c) 2020 Teruyoshi Mitsuoka