Building openMotor from source¶
1. Install prerequisites¶
openMotor
uses PyQt
, which in turn relies on Qt 5. To compile the UI
views, you will need to have Qt installed. The easiest way to do this is by
installing QtCreator, which will also give you access to the Qt Designer to
edit the view files. You can download QtCreator here.
You also need to install openMotor’s dependencies. The easiest way to do this is with pip, inside a virtual environment:
*nix¶
$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install -r requirements.txt
Windows¶
PS> python -m venv .venv
PS> .venv/Scripts/Activate.ps1
(.venv) PS> pip install -r requirements.txt
If you get a security error, try using Set-ExecutionPolicy to loosen your environment security settings.
3. Install openMotor in development mode¶
This will let you import the Python modules as if it were a normal package, but is not necessary for the UI to work.
$ pip install -e .
Building the Documentation¶
The documentation is written with Sphinx, and uses reStructuredText. The necessary dependencies are included in the requirements file, so if you’ve built from source you should be all set to build.
Run the following steps to build the docs:
$ cd ./docs
$ sphinx-build -b html . _build
The build artifacts should now be present in ./docs/_build, and can be opened in a normal web browser.