ci: add static+dynamic analysis steps on push

fix: yaml linting

fix: python linting

fix: python formatting

.forgejo/workflows/ci.yml

@@ -0,0 +1,39 @@
+---
+on: [push]  # yamllint disable-line rule:truthy
+
+jobs:
+  static-analysis:
+    name: Static analysis
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Yaml formatting
+        id: yaml-format
+        run: pipx run yamllint .
+        continue-on-error: true
+      - name: Python formatting
+        id: python-format
+        run: pipx run black . --check
+        continue-on-error: true
+      - name: Job status
+        if: |
+          ${{ steps.yaml-format.outcome != 'success' }} ||
+          ${{ steps.python-format.outcome != 'success' }}
+        run: exit 1
+  dynamic-analysis:
+    name: Dynamic analysis
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install dependencies
+        run: |
+          pip install -r ./requirements.txt
+          pipx install pylint
+          pipx ensurepath
+      - name: Python linting
+        id: python-linting
+        run: pylint **/*.py
+        continue-on-error: true
+      - name: Job status
+        if: ${{ steps.python-linting.outcome != 'success' }}
+        run: exit 1

.yamllint.yaml

@@ -0,0 +1,6 @@
+---
+extends: default
+
+rules:
+  line-length:
+    max: 120

action.yml

@@ -1,3 +1,4 @@
+---
 name: Post build status to Discord
 
 inputs:

main.py

@@ -1,3 +1,10 @@
+"""
+Push status to Discord action
+
+Pushes provided build status data to Discord as a new message or as
+an edit to an existing message.
+"""
+
 import sys
 import typing
 import datetime
@@ -13,12 +20,22 @@ COLORS = {
 
 
 class EmbedField(typing.TypedDict):
+    """
+    Single embedded field
+    See: https://discord.com/developers/docs/resources/message#embed-object-embed-field-structure
+    """
+
     name: str
     value: str
     inline: bool
 
 
 class Embed(typing.TypedDict):
+    """
+    Single message embed
+    See: https://discord.com/developers/docs/resources/message#embed-object-embed-field-structure
+    """
+
     color: str
     title: str
     fields: list[EmbedField]
@@ -37,10 +54,6 @@ class MessageState(typing.TypedDict):
     embeds: list[Embed]
 
 
-class Context(typing.TypedDict):
-    message: MessageState
-
-
 if __name__ == "__main__":
     (
         webhook_url,