Contributing

Contributions are welcome.

The first step to contribute is to install the package in editable mode. For any changes, check that the tests still pass as detailed below.

Local development¶

1. Clone the repository.
2. Install uv.

3. Create a venv and install signalbot with its dependencies in it (including extra dependencies to be able to run the examples)

   uv sync --group examples
   

   • You can install signalbot as an editable depedency in another repository (e.g. your own bot repository) like so

     uv add --editable ../signalbot
     

4. Install the prek hook for linting and formatting

   uv run prek install
   

Unit Testing¶

The tests can be executed with

uv run pytest

Extending signalbot¶

Adding support for a new incoming or outgoing Signal message type? See the Extending signalbot guide.

Serving the documentation locally¶

1. Install the docs dependencies

   uv sync --group docs
   

2. Run the zensical serve command

   uv run zensical serve