Skip to content
You're viewing an older version of this GitHub Action. Do you want to see the latest version instead?
check-circle

GitHub Action

fancier-discord-webhooks

1.4 Pre-release

fancier-discord-webhooks

check-circle

fancier-discord-webhooks

This GitHub Action sends fancy and more meaningful discord messages for your commits. It includes Test results and coverage

Installation

Copy and paste the following snippet into your .yml file.

              

- name: fancier-discord-webhooks

uses: baked-libs/maven-discord-integration@1.4

Learn more about this action in baked-libs/maven-discord-integration

Choose a version

Fancier Discord Webhook

This GitHub Action can produce fancy and more meaningful discord messages for your commits.
It includes Test results and coverage.

Requirements

This currently works only for Maven projects. For Test Results and Coverage Reports you will need to use one of the following Maven plugins:

  • maven-surefire
  • maven-failsafe
  • jacoco

Inputs

id

Required This is the id of your Discord webhook, if you copy the webhook url, this will be the first part of it.

token

Required Now your Discord webhook token, it's the second part of the url.

Screenshots

The standard webhook from GitHub to Discord just dumps the commit messages right into your chat, this is fine but sometimes you just want some extra information. Did the commit introduce any new issues? Did it even compile successfully? That's what this Action is for.

Standard Webhook

old webhook

New and improved Webhook

new webhook

Changes

  • Removed the obnoxious author name and image at the top (may be a toggle in the future)
  • The branch is now clearly visible "Slimefun4:master" -> "Slimefun4 (master)"
  • The repository is now referred to by its full name, including the repository owner
  • The embed now includes a timestamp (it is actually the timestamp of the commit, not just the current date of when the webhook was sent)
  • Commit messages have slightly shorter limits and the committer is now better distinguishable from the commit message "Reduced technical debt - TheBusyBiscuit" -> "Reduced technical debt (@TheBusyBiscuit)"
  • Includes test results, passes will be prepended with a green circle, skips with yellow and failures with red.
  • It will also list the exact tests which failed (max of 4, then it will crop them)
  • An estimated test coverage is provided if you use the jacoco maven plugin.
  • Dynamic embed color changes

Dynamic Coloring

The color of the embed changes depending on the compiler and test results. Here's a breakdown:

Color Description
red The build has failed.
orange The build was successful but some tests failed.
yellow The build was successful, no tests failed but some were skipped.
green The build was successful, no tests failed and none were skipped.

Example setup

TODO