Rapporto#

Harvest information from Git, GitHub, Opsgenie, and Slack, create reports in Markdown format, animations in video formats, and publish them in different ways. DWIM, with notable Caveats.

Features#

DWIM:: Harvest, report, summarize, and notify like you always wanted to.
Polyglot:: Inquire Git, GitHub, Opsgenie, and Slack, and easily extend it for other services.
Flexibility:: Use as a standalone program or as a library in your own programs.
Interoperability:: The output is using Markdown format and other standards across the board, so you can use it on services like Discord, Discourse, GitHub, Slack, and many more.

Attention

With great power comes great responsibility. Rapporto is a powerful tool, please use it responsibly.

Synopsis#

GitHub#

Actions

Report about CI failures on GHA.#

rapporto github actions --repository=acme/acme-examples

Activity

Report about user activity on GitHub in PPP format.#

rapporto github activity --organization=python --author=AA-Turner --when="2025W04"

Attention

Report about bugs and similar important items on GitHub.#

rapporto github attention --organization=python --when="2025W07"

Backup

Full GitHub project backup using github-backup.#

rapporto github backup --all --pull-details --prefer-ssh --token="${GH_TOKEN}" --repository=kotori daq-tools

Opsgenie#

Export alerts

Report about Opsgenie alerts.#

rapporto opsgenie export-alerts --when="-7d"

Slack#

Export conversation

Export Slack conversation thread.#

rapporto slack export https://acme.slack.com/archives/D018V8WDABA/p1738873838427919

Installation#

See Rapporto Installation.

Usage#

See Rapporto Sources and Rapporto Reports.

Contribute#

See Rapporto Sandbox.

Quick links#

Contribute#

Contributions are very much welcome. The program is still in its infancy, and needs all support it can get. It is managed on GitHub, and provides relevant instructions for installing a development Sandbox.