fediverse-pasture 0.2.25

Helpful tools to test Fediverse Applications

Fediverse Pasture

This python package contains tools to test Fediverse applications. This package uses bovine for a lot of the Fediverse related logic. It should also be noted that the aim here is to debug issues caused by federation, thus everything involves starting a webserver and running requests against it.

Usage

For usage information, see the documentation.

With docker container

One can start the one actor server via

docker run --rm --name pasture\
    --hostname pasture-one-actor --network fediverse-pasture\
    helgekr/pasture one_actor

and then use the send tool via

docker exec pasture ./send acct:user@domain

Afterwards you should stop the container with docker stop pasture.

Development

Install the necessary dependencies via

uv sync --all-extras

To lint and check code formatting run

uv run ruff check .
uv run ruff format .

To test the code run

uv run pytest

With docker

To start the local environment in docker run

docker run --detach --rm --name pasture-dev\
    --hostname pasture-one-actor\
    --network fediverse-pasture\
    -v .:/data --workdir /data\
    -e UV_PROJECT_ENVIRONMENT=/tmp/venv\
    ghcr.io/astral-sh/uv:python3.11-alpine\
    uv run python -mfediverse_pasture.one_actor --port 80

and then

docker exec -ti -e UV_PROJECT_ENVIRONMENT=/tmp/venv pasture-dev \
    uv run python -mfediverse_pasture.send acct:user@domain

to send a message.

Releasing

Releasing is done automatically on merge to the main branch. For this to happen, the following has to be true

• There exists a milestone with the version number
• All issues in the milestone are closed
• There exists an entry in CHANGES.md
• The package version has the same version number

See https://codeberg.org/helge/release_helper

Funding

This code was created as part of Fediverse Test Framework.

A project funded through the NGI0 Core Fund, a fund established by NLnet with financial support from the European Commission's Next Generation Internet programme, under the aegis of DG Communications Networks, Content and Technology under grant agreement No 101092990.