comments

comments is a cattle_grid based Fediverse application that allows bringing comments to static sites.

Development

One can run the server via

uv run uvicorn comments:app --port 2313

the rabbitmq backend can be configured via COMMENTS_AMQP_URL.

docker-compose

If the cattle_grid docker environment is running, one can run one for this server via

docker compose up

The docker container might need to be build via the ./update_docker.sh script. This script ensures that its requirements match the development environment.

Running behave tests

Download the fediverse features via

uv run fediverse-features

Then start a runner with

docker compose run --rm --name runner comments-app /bin/sh

Then after the nginx container has started, you run the behave tests with

behave

Tests etc

Run tests and lint with

uv run pytest
uv run pyright
uv run ruff format
uv run ruff check

Writing schemas

uv run python -mcomments openapi
uv run python -mcomments asyncapi

These can then be viewed by

uv run mkdocs serve