installation.rst 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758
  1. Installation
  2. ============
  3. Installation of the Modelverse is rather simple, as is its simple usage.
  4. We first introduce the dependencies of the Modelverse, followed by installation instructions for the Modelverse itself.
  5. To check whether or not the installation was successful, users can run the enclosed tests.
  6. Dependencies
  7. ------------
  8. The Modelverse reference implementation is relatively dependency-free.
  9. As its code is written in Python 2, a working Python 2.7 interpreter is necessary.
  10. Python 3 should also be supported, although then a Python 3 compatible version of SCCD has to be used as well.
  11. The `SCCD <https://msdl.uantwerpen.be/git/simon/SCCD>`_ module needs to be installed for both the client and server.
  12. Full installation instructions can be found on the project website.
  13. To run the tests, the `pytest <http://docs.pytest.org/en/latest/>`_ module must be installed.
  14. Pip
  15. ^^^
  16. To install all dependencies automatically, using Pip, a *requirements.txt* file is provided.
  17. This can be invoked as follows::
  18. pip install -r requirements.txt
  19. PyPy
  20. ^^^^
  21. In case you want to use PyPy, offering increased performance, you need to install both dependencies in PyPy as well.
  22. For SCCD, you can simply install it using PyPy instead of CPython.
  23. For pytest, you also need to install all of pytest's dependencies, and pytest itself.
  24. The easiest way to do this is through *pip*, which you also have to install first for PyPy::
  25. wget https://msdl.uantwerpen.be/files/get-pip.py
  26. pypy get-pip.py --user
  27. pypy -m pip install pytest --user
  28. Installation
  29. ------------
  30. The Modelverse is merely a set of Python scripts, and there is no real installation, except for its dependencies.
  31. As such, you will only have to download the `Modelverse source code <https://msdl.uantwerpen.be/git/yentl/modelverse>`_.
  32. You can now run the scripts in the *scripts/* directory using Python.
  33. In the next section, we go deeper into the relevant scripts.
  34. Tests
  35. -----
  36. To make sure that everything is working correctly, you can execute the tests with the script *scripts/run_tests.sh*, executed as follows::
  37. python scripts/run_tests.py
  38. If you prefer to use PyPy, or any other Python interpreter, you can simply replace *python* with the alternative interpreter.
  39. The tests, and all other components of the Modelverse, will make sure that all subsequently spawned instances use the same interpreter.