Fediverse-Action

About

Post notification to fediverse social web when code is updated. Currently it was tested with Mastodon service, Support for other ActivityPub services like pleroma or GNUsocial is also welcome.

Usage

Join fediverse

If you didn't before register to an instance of mastodon network:
- example: https://mastodon.social

Once registered and logged, go to settings page to create an application:
- example: https://mastodon.social/settings/profile

Go to "Settings" / "Development" / "New Application"
- example: https://mastodon.social/settings/applications/
- example: https://mastodon.social/settings/applications/new

Fill application name: mastodon-lite (or anything else), ignore other fields

Submit to generate application
- example: https://mastodon.social/settings/applications

Go to application details and note "access token"
- example: "B4DC0D-DeadBeef1BadCode-1TODO-1TODOtodoTODO"

Add secret to github

From your project page:
- https://github.com/${org}/${project}/settings/secrets

Add new secret with name "MASTODON_ACCESS_TOKEN" and the previous encoded string as value.

Commit config file

To enable this "action" in any of your github hosted project, a configuration file should be located in ".github/workflow/" subdir, just like:

https://raw.githubusercontent.com/rzr/fediverse-action/master/.github/workflows/fediverse-action.yml

Back to your project you can create ".github/workflows/fediverse-action.yml" file by applying this patch from shell:

curl "https://github.com/rzr/color-sensor-js/commit/867de15f.patch"  | git am

git push

Or pick it from:

https://github.com/rzr/fediverse-action/commit/40dc4bccfb3d8b6efd26327a412b73bbe2f7113d.patch

Then check action's status on github, a default message should then appears on a "mastodon.social" profile, something like:

https://mastodon.social/@tizenhelper/103781386501900694

https://mastodon.social/tags/FediVerseAction

Note default "mastodon.social" server will be used unless you override a host value:

        with:

          access-token: ${{ secrets.MASTODON_ACCESS_TOKEN }}

          host: "social.bau-ha.us" # custom host if not "mastodon.social" (default)

Example:

https://github.com/Tarnyko/test-mastodon/commit/414d3191c5a394caac5ed67fe40de24caf063498

Default message will link to your repo URL.

Customize commit message

Once posting is verified, then apply this next change to overload default message with your project's latest git commit message.

curl "https://github.com/rzr/color-sensor-js/commit/cb4512fe.patch" | git am

git push

https://github.com/abandonware/bmp085-sensor/commit/5701e5c3

(...)

    steps:

      - uses: actions/checkout@v1

      - id: log

        run: echo "::set-output name=message::$(git log --no-merges -1 --oneline)"

      - uses: rzr/fediverse-action@master

        with:

          access-token: ${{ secrets.MASTODON_ACCESS_TOKEN }}

          message: "https://github.com/${{ github.repository }}/commit/${{ steps.log.outputs.message }} ~ #FediVerseAction"

Feel free to edit "message" input with anything you prefer.

Examples:

https://github.com/abandonware/bmp085-sensor/commit/5701e5c3e0773fedc65b5477a45005783a30cb63

https://mastodon.social/@tizenhelper/103810982954496420

If you need to be less verbose you can filter on "Release x.y.z" commit messages only:

https://github.com/abandonware/node-i2c/commit/1837c8111e5d5bb609824a5981716cbfc28a05cd.patch

https://github.com/abandonware/node-i2c/commit/16ce8ec0796efa723079a5103791e57cfe13652b

https://github.com/rzr/pinball-table-hurd/commit/53f85ccab02c9820e34edbc937c8f358c9b8ec83

As a reference, config file should look like this:

# YAML

---

name: fediverse-action

on: [push]

jobs:

  post:

    runs-on: ubuntu-latest

    steps:

      - uses: actions/checkout@v1

      - id: log

        run: echo "::set-output name=message::$(git log --no-merges -1 --oneline)"

      - if: "contains(steps.log.outputs.message, 'Release ')"

        uses: rzr/fediverse-action@master

        with:

          access-token: ${{ secrets.MASTODON_ACCESS_TOKEN }}

          message: "https://github.com/${{ github.repository }}# ${{ steps.log.outputs.message }} ~ #FediVerseAction"

          host: "mamot.fr" # If not using default "mastodon.social"