Setup & Tests¶

This section guides you through everything you need to know to develop the software: build it and make changes.

Clone the Repository¶

git clone https://github.com/niccokunzmann/open-web-calendar
cd open-web-calendar

Code Quality¶

We use ruff to improve the code quality. Please install pre-commit before committing. It will ensure that the code is formatted and linted as expected using ruff.

pre-commit install

To format the code before commit without the pre-commit hook, run this:

tox -e ruff

Running the App¶

Optional: Install virtualenv and Python3 and create a virtual environment.
```
virtualenv -p python3 ENV
source ENV/bin/activate
```
Install the packages.
```
pip install -r requirements.txt
```
Start the app.
```
python3 app.py
```

You can configure the app through environment variables.

Running Tests¶

To run the tests, we use tox. tox tests all different Python versions which we want to be compatible to.

pip install tox

Run all tests:

tox

Run a specific Python version:

tox -e py39

Browser Testing¶

We use selenium to test the app in different browsers. By default, Firefox is used. You can test the features like this:

tox -e web

If you like to change the browser, use

tox -e web -- -D browser=firefox
tox -e web -- -D browser=chrome

You can also change the layout of the window to test the responsive design:

tox -e web -- -D window=375x812 # iPhone11 size

Documentation¶

You can build the documentation with tox, too. It is located in the docs directory.

tox -e docs -- build # ./site
tox -e docs -- serve

We are using mkdocs with the material theme.