README.md for Interoperability Data¶

This repository represents interoperability data and the tools to generate it for the Fediverse.

Website¶

The website is generated from the data using tools found in work. Getting a development version running can be achieved via

cd work
poetry install
./build_docs.sh
poetry run mkdocs serve

All commands will take some time.

Data¶

Data is contained in data. The subsections describe how it is generated

Setup¶

Save a codeberg read token for packages into .secrets/package_read_secret. Then run

./tools/download_dockerfiles.sh

The folder fediverse-pasture should now be populated. This folder contains the docker compose files used to run the various Fediverse applications.

Alternatively, the package can be downloaded from the fediverse-pasture repository.

Running tests¶

By executing

./run.sh $APPLICATION $VERSION

you can generate the support tables. The data file will be in data/. The available versions for the applications can be found here.

New version of fediverse-pasture-inputs¶

On a new release of fediverse-pasture-inputs update INPUTS_VERSION in run.sh to the latest release. Then generate a run script for the latest container versions via

cd tools
poetry run python build_for_versions.sh > ../run_for_versions.sh
cd ..
chmod +x run_for_versions.sh

Then run for the new versions via

./run_for_versions.sh