Wrath & Glory Space Hulk Generator

The Wrath & Glory Space Hulk Generator contains a random map generator for Cubicle7's Warhammer 40k role-playing game Wrath & Glory.

State

Maintained

Description

This repository contains the generator as well as the app that is hosted at the Streamlit app.

A description of the app is given in APP_ABOUT.md.

Use Cases

An initial analysis of the use cases for the generator is given in USE_CASES.md.

Installation

Currently, there is no stand-alone installation. To locally use the project, e.g. for making code changes,

1. Install the external dependencies from packages.txt (e.g. the graphviz backend)
2. Install uv
3. Run the app via uv run streamlit run streamlit_app.py from the repository root

Contributing

If you have any improvement suggestions or feature requests or if you found bugs, simply open an issue.

Or event better create a pull request (PR) with the recommended code change. If you create a PR, Please make sure to add/update the unittests accordingly.

Unittests

Run the unittests via pytest + coverage with:

uv run pytest --cov

Linting & Formatting

Prek is used for linting and formatting the code via pre-commit hooks. To run the checks manually, use:

prek run --all-files

License

See LICENSE