github: workflows: Enable PR checks

- Enforce that the length of the commit title is at most 72.
- Enforce that the first word of the PR is followed by a colon.

Signed-off-by: Hamza Butt <hamza.butt@arm.com>

Author: theComputeKid

.github/automation/pr-title-check.py

@@ -0,0 +1,48 @@
+#!/usr/bin/python3
+
+# *******************************************************************************
+# Copyright 2024 Arm Limited and affiliates.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# *******************************************************************************
+
+import argparse
+
+# * Ensuring the first word ends in a colon.
+# TODO: Limit the first word to an acceptable list of tags.
+def __firstWordCheck(msg: str):
+    firstWord = msg.partition(" ")[0]
+    if not firstWord.endswith(":"):
+        raise ValueError(f"First word must end in a colon. Is: {firstWord}")
+
+
+# * Ensuring a character limit for the first line.
+def __numCharacterCheck(msg: str):
+    summary = msg.partition("\n")[0]
+    msgSummaryLen = len(summary)
+    if msgSummaryLen >= 72:
+        raise ValueError(f"Message summary must be less than 72. Is: {msgSummaryLen}")
+
+
+def main():
+    parser = argparse.ArgumentParser()
+    parser.add_argument("msg", help="Commit message to check.")
+    args = parser.parse_args()
+    msg: str = args.msg
+    print(f"msg: {msg}")
+    __numCharacterCheck(msg)
+    __firstWordCheck(msg)
+
+if __name__ == "__main__":
+    main()

.github/workflows/pr-check.yml

@@ -0,0 +1,30 @@
+# *******************************************************************************
+# Copyright 2024 Arm Limited and affiliates.
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# *******************************************************************************
+
+name: "PR Checks"
+
+on:
+  pull_request:
+    types: [opened, edited, synchronize, reopened]
+
+jobs:
+  title:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+      - name: Pass pull request title through script.
+        run: python3 ./.github/automation/pr-title-check.py "${{ github.event.pull_request.title }}"