RaBe Cat Landing Page

Overengineered intranet landing page for Radio Bern RaBe.

Screenshot of page.

Usage

Navigate to page
Find services
See cat
???
PROFIT!!!

Configuration

See python app/server.py --help for usage message and configuration info.

Container

# using docker
docker run --rm -ti -p 8080:8080 ghcr.io/radiorabe/catpage
# or podman
podman run --rm -ti -p 8080:8080 ghcr.io/radiorabe/catpage

Connect to localhost:8080.

Podman-compose

cp env.example .env
$EDITOR .env
podman-compose up -d

Kubernetes

helm install catpage oci://ghcr.io/radiorabe/helm/catpage --version x.y.z

Contributing

Contributions are welcome. Please keep in mind that everything here is completely overengineered.

Development

Setup

python -mvenv venv
. ./venv/bin/activate

pipx install poetry

poetry install

Running tests

You can run our tests with pytest. Please keep in mind that we expect to keep the coverage at 100% and that this is enforced by CI.

poetry run pytest

Formating code using a pre-commit hook

There is a pre-commit hook facility that tests code for formating and validity. You should install run this on your dev env to ensure that all the code is properly formatted and your changes will pass CI.

pip install pre-commit
pre-commit install

Commiting with commitizen

This project uses conventional-changelog style commit messages to help generate proper releases. Please check out the git-cz helper to help with formatting commit messages.

npm install -g commitizen cz-conventional-changelog

Creating a Pull Request

Once your contribution is ready you can use the GitHub interface to create a pull request. Please try to keep your individual contribution self contained in a single squashed commit. This helps so that the maintainers can just hit "Squash and merge" instead of "Rebase and merge".

License

This application is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, version 3 of the License.