[feature/releaser] Automate assigning/unassigning issues #571

I've created four GitHub Actions workflow files to automate issue assignment/unassignment.

Created Workflows:
1. issue-assignment.yml – Auto-response to 'assign me' requests
2. pr-issue-link.yml – Auto-assign on PR
3. stale-pr-management.yml – Stale PR management (tracks contributor inactivity only)
4. pr-reopen-reassign.yml – Handle contributor follow-up

Fixes #571

Author: Eeshu-Yadav

.github/workflows/issue-assignment.yml

@@ -0,0 +1,34 @@
+name: Issue Assignment Bot
+
+on:
+  issue_comment:
+    types: [created]
+
+permissions:
+  issues: write
+
+jobs:
+  respond-to-assign-request:
+    runs-on: ubuntu-latest
+    if: github.event.issue.pull_request == null
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.9"
+
+      - name: Install dependencies
+        run: pip install -e .[bots]
+
+      - name: Run issue assignment bot
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPOSITORY: ${{ github.repository }}
+          GITHUB_EVENT_NAME: ${{ github.event_name }}
+          EVENT_DATA: ${{ toJson(github.event) }}
+        run: |
+          echo "$EVENT_DATA" > event.json
+          python -m openwisp_utils.bots.auto_assign issue_assignment event.json

.github/workflows/pr-issue-link.yml

@@ -0,0 +1,33 @@
+name: PR Issue Auto-Assignment
+
+on:
+  pull_request_target:
+    types: [opened, reopened]
+
+permissions:
+  issues: write
+  pull-requests: read
+
+jobs:
+  auto-assign-issue:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.9"
+
+      - name: Install dependencies
+        run: pip install -e .[bots]
+
+      - name: Run issue assignment bot
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPOSITORY: ${{ github.repository }}
+          GITHUB_EVENT_NAME: ${{ github.event_name }}
+        run: |
+          echo '${{ toJson(github.event) }}' > event.json
+          python -m openwisp_utils.bots.auto_assign issue_assignment event.json

.github/workflows/pr-reopen-reassign.yml

@@ -0,0 +1,60 @@
+name: PR Reopen Reassignment
+
+on:
+  pull_request_target:
+    types: [reopened]
+  issue_comment:
+    types: [created]
+
+permissions:
+  issues: write
+  pull-requests: read
+
+jobs:
+  reassign-on-reopen:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request_target' && github.event.action == 'reopened'
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.9"
+
+      - name: Install dependencies
+        run: pip install -e .[bots]
+
+      - name: Reassign issues on PR reopen
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPOSITORY: ${{ github.repository }}
+          GITHUB_EVENT_NAME: ${{ github.event_name }}
+        run: |
+          echo '${{ toJson(github.event) }}' > event.json
+          python -m openwisp_utils.bots.auto_assign pr_reopen event.json
+
+  handle-pr-activity:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'issue_comment' && github.event.issue.pull_request
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.9"
+
+      - name: Install dependencies
+        run: pip install -e .[bots]
+
+      - name: Handle PR activity
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPOSITORY: ${{ github.repository }}
+          GITHUB_EVENT_NAME: ${{ github.event_name }}
+        run: |
+          echo '${{ toJson(github.event) }}' > event.json
+          python -m openwisp_utils.bots.auto_assign pr_reopen event.json

.github/workflows/stale-pr-management.yml

@@ -0,0 +1,31 @@
+name: Stale PR Management
+
+on:
+  schedule:
+    - cron: "0 0 * * *"
+  workflow_dispatch:
+
+permissions:
+  issues: write
+  pull-requests: write
+
+jobs:
+  manage-stale-prs-python:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.9"
+
+      - name: Install dependencies
+        run: pip install -e .[bots]
+
+      - name: Run stale PR bot
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPOSITORY: ${{ github.repository }}
+        run: python -m openwisp_utils.bots.auto_assign stale_pr

openwisp_utils/bots/__init__.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python3
+
+import sys
+
+
+def main():
+    """Entry point for all bot functionality"""
+    if len(sys.argv) < 2:
+        print("Usage: python -m openwisp_utils.bots.auto_assign <bot_type> [args...]")
+        print("Available bot types: issue_assignment, stale_pr, pr_reopen")
+        return 1
+
+    bot_type = sys.argv[1]
+
+    try:
+        if bot_type == "issue_assignment":
+            from .issue_assignment_bot import main as issue_main
+
+            sys.argv = [sys.argv[0]] + sys.argv[2:]
+            issue_main()
+        elif bot_type == "stale_pr":
+            from .stale_pr_bot import main as stale_main
+
+            stale_main()
+        elif bot_type == "pr_reopen":
+            from .pr_reopen_bot import main as pr_main
+
+            sys.argv = [sys.argv[0]] + sys.argv[2:]
+            pr_main()
+        else:
+            print(f"Unknown bot type: {bot_type}")
+            print("Available bot types: issue_assignment, stale_pr, pr_reopen")
+            return 1
+
+        return 0
+    except Exception as e:
+        print(f"Error running {bot_type} bot: {e}")
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())