ModOrganizer2 - Python Proxy

This repository contains the Python proxy plugin for ModOrganizer2. The proxy plugin allow developers to write Python plugins for ModOrganizer2.

Setup, build, tests

This repository is part of MO2 main repositories and should usually be build using mob.

Organization

This repositories contains 5 sub-projects in src. The interface between Python and C++ is done using the pybind11 library.

• src/proxy contains the actual proxy plugin. This project is a simple interface between MO2 and the runner (see below).
  • This project generates the plugin_python.dll library.
  • TODO: this project generates the translation file (-> moved the file).
  • TODO: this project install necessary files for the plugin (Python DLL, Python libraries, etc), INCLUDING mobase.
• src/runner contains the Python runner. This is the project that instantiates a Python interpreter and load/unload Python plugins.
  • TODO: static library
• `src/pybind11-qt contains many utility stuff to interface pybind11 with Qt and PyQt.
• src/pybind11-utils contains some utility stuff pybind11. This project is header-only.
• `src/mobase contains the Python plugin interface.
  • This projects generates the mobase Python library.

Some (woefully incomplete) tests are available under tests, split in three sub-directories:

• tests/mocks simply contains mocks of uibase interfaces to be used in the two other test projects.
• tests/python contains Python tests for pytest. This project generates a bunch of Python test libraries that are then imported in Python test files (test_*.py) and tested using pytest. These tests mostly cover the pybind11 Qt and utility stuff, and some standalone MO2 classes and functions (IFileTree, GuessedString, etc).
• tests/runner contains C++ tests, using GTest Tests in this project instantiate a Python runner and then use it to check that plugins implemented in Python can be used properly on the C++ side.