Installation

For proper installation you need to clone project from git.

Surroundings

The service can be installed on Windows 10 and CentOS 8 (not tested on other system versions).

Required predefined dependencies:

  • Python of version 3.12 is required.

  • It is strongly recommended to create virtual surroundings for python dependencies installation.

  • Python setuptools module can be installed via pip (pip install setuptools).

  • MATCHERLiB, environment variable MATCHER_ROOT with path to MATCHERLiB.

Dependencies installation

After surroundings installation launch pip install with “-r requirements.txt” parameter.

pip install -r requirements.txt

Configuration

After dependencies installation configuration file should be set. File is placed in “./luna_python_matcher/configs/config.conf”.

First launch and testing

If all previous actions are executed successfully, server is ready to work. To start server please launch run.py script. While start you can add arguments: server message port, servicing the server and not default config for a service. By default 5100 port is used. Also it possible to run service with config from luna-configurator (see configurator). Example running “python-matcher” service:

./run.py --port=5100 --config=./configs/devconfig.conf

Example running “python-matcher-proxy” service:

./run.py --service-type=proxy --port=5110 --config=./configs/devconfig.conf

After server is started, testing is recommended. To perform testing execute command

python -m unittest tests.unittests_main

All tests should perform successfully.