DEVELOPMENT.md

Contributing

Setting up project for the first time

1. Write all dependencies into pyproject.toml
2. Create venv (python -m venv .venv) and activate it (".venv\scripts\activate" or "source .venv/bin/activate")
3. Update pip (python -m pip install -U pip)
4. Install pip-tools (pip install pip-tools)
5. Update/Create requirements.txt (when dependencies have been updated in pyproject.toml)
   • with Development dependencies

     pip-compile --extra dev

   • or only with Runtime dependencies

     pip-compile

6. Install dependencies (pip install -U -r requirements.txt)
7. Install project into local venv (pip install -e .[dev])

Creating whl and publish

1. Install 'setuptools' (pip install setuptools)
2. Run CreatePipWheel Script

Generate documentation in Word format

Install Pandoc

pandoc -s README.md -M title="imbus TestBench - Robot Code Generator" -M subtitle=Benutzerhandbuch -M toc-title=Inhaltsverzeichnis --toc -o Benutzerhandbuch.docx