Create Issue form/template

.github/ISSUE_TEMPLATE/01_bug_report.yml

@@ -0,0 +1,132 @@
+# DO NOT EDIT THIS FILE MANUALLY.
+# Execute the script called bug_report_creator.py to generate it.
+
+---
+body:
+- attributes:
+    value: Thanks for taking the time to fill out this bug report!
+  type: markdown
+- attributes:
+    description: (can be found in "About..." or in `metadata.json`)
+    label: Extension version/Build date
+    placeholder: ex. 4.2.1
+  id: extension_version
+  type: input
+  validations:
+    required: false
+- attributes:
+    description: (`cinnamon --version`)
+    label: Cinnamon version
+    placeholder: ex. 5.6.3
+  id: cinnamon_version
+  type: input
+  validations:
+    required: true
+- attributes:
+    description: (Mint 21.2, Arch, Fedora 38)
+    label: Distribution
+    placeholder: ex. Mint 21.2
+  id: distribution
+  type: input
+  validations:
+    required: true
+- attributes:
+    description: (AMD/NVIDIA/Intel and nouveau/kernel/package(s))
+    label: Graphics hardware *and* driver used
+    placeholder: ex. NVIDIA GeForce RTX 4060 and nouveau
+  id: graphics
+  type: input
+  validations:
+    required: false
+- attributes:
+    label: Snippet or attachment of `~/.xsession-errors`
+  id: xsession-errors
+  type: textarea
+  validations:
+    required: false
+- attributes:
+    default: 0
+    label: Extension name and maintainer
+    options:
+    - back-to-monitor@nathan818fr @nathan818fr
+    - [email protected]
+    - cinnamon-dynamic-wallpaper@TobiZog @TobiZog
+    - cinnamon-maximus@fmete
+    - [email protected] @hermes83
+    - desktop-icons-per-workspace@cardsurf @cardsurf
+    - desktop-scroller@ccadeptic23
+    - DesktopCube@yare
+    - extra-panel-settings@gr3q @gr3q
+    - Flipper@connerdev
+    - gTile@shuairan
+    - horizontal-osd@berk-karaal @berk-karaal
+    - mnemonic-5-4-window-menu@mtwebster @mtwebster
+    - mouse-shake-zoom@rcalixte @rcalixte
+    - [email protected]
+    - rnbdsh@negateWindow @rnbdsh
+    - SanitizeXsessionErrors@claudiux @claudiux
+    - ShadowParameters@mikhail-ekzi @mikhail-ekzi
+    - slider@mohammad-sn @mohammad-sn
+    - smart-panel@mohammad-sn @mohammad-sn
+    - transparent-panels-reloaded@marcelovbcfilho @marcelovbcfilho
+    - transparent-panels@germanfr @germanfr
+    - user-shadows@nathan818fr @nathan818fr
+    - watermark@germanfr @germanfr
+    - [email protected]
+    - workspace-scroller@ori
+  id: extension
+  type: dropdown
+  validations:
+    required: true
+- attributes:
+    description: Please copy and paste any relevant log output. This will be automatically
+      formatted into code, so no need for backticks.
+    label: Relevant log output
+    render: shell
+  id: logs
+  type: textarea
+  validations:
+    required: false
+- attributes:
+    description: Also tell us, what did you expect to happen?
+    label: What happened?
+    placeholder: Tell us what you see!
+    value: A bug happened!
+  id: what-happened
+  type: textarea
+  validations:
+    required: true
+- attributes:
+    description: How can this problem be reproduced?
+    label: Steps to reproduce
+    placeholder: 1. Click or type somewhere...
+  id: reproduce
+  type: textarea
+  validations:
+    required: true
+- attributes:
+    description: What should have happened
+    label: Expected behaviour
+    placeholder: No bugs...
+  id: expected
+  type: textarea
+  validations:
+    required: true
+- attributes:
+    description: Anything else that might help get this fixed faster
+    label: Other information
+    placeholder: Extra details...
+  id: other
+  type: textarea
+  validations:
+    required: false
+- attributes:
+    value: '*By submitting this issue, you agree to behave respectfully and in a mature
+      manner. If in doubt, refer to the [Golden Rule](https://en.wikipedia.org/wiki/Golden_Rule)
+      and [Github''s Community Guidelines](https://docs.github.com/en/site-policy/github-terms/github-community-guidelines).*'
+  type: markdown
+description: "If something isn't working, file a report. \U0001F527"
+labels:
+- bug
+name: "\U0001F41C Extension Bug Report"
+title: 'extension@author: Bug'

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,9 @@
+---
+blank_issues_enabled: false
+contact_links:
+  - name: 🚀 Feature Request
+    url: https://github.com/orgs/linuxmint/discussions
+    about: If you have a feature request 💡
+  - name: ❓ Linux Mint Forums
+    url: https://forums.linuxmint.com/
+    about: Please ask and answer questions here. 🏥

.github/bug_report_creator.py

@@ -0,0 +1,118 @@
+#!/usr/bin/python3
+'''
+Generate 01_bug_report.yml based on repository files
+'''
+
+import os
+import json
+import yaml
+
+dirs_blacklist = ['.git', '.github']
+
+repo_folder = os.path.realpath(os.path.abspath(os.path.join(
+                  os.path.normpath(os.path.join(os.getcwd(), *(['..'] * 1))))))
+
+HEADER = '''# DO NOT EDIT THIS FILE MANUALLY.
+# Execute the script called bug_report_creator.py to generate it.
+
+---
+'''
+
+BUG_REPORT = {'name': '🐜 Extension Bug Report',
+              'description': "If something isn't working, file a report. 🔧",
+              'title': 'extension@author: Bug',
+              'labels': ['bug'],
+              'body': [{'type': 'markdown',
+                        'attributes': {'value': 'Thanks for taking the time to fill out this bug report!'}},
+                       {'type': 'input', 'id': 'extension_version',
+                        'attributes': {'description': '(can be found in "About..." or in `metadata.json`)',
+                                       'label': 'Extension version/Build date',
+                                       'placeholder': 'ex. 4.2.1'},
+                        'validations': {'required': False}},
+                       {'type': 'input', 'id': 'cinnamon_version',
+                        'attributes': {'description': '(`cinnamon --version`)',
+                                       'label': 'Cinnamon version',
+                                       'placeholder': 'ex. 5.6.3'},
+                        'validations': {'required': True}},
+                       {'type': 'input', 'id': 'distribution',
+                        'attributes': {'description': '(Mint 21.2, Arch, Fedora 38)',
+                                       'label': 'Distribution',
+                                       'placeholder': 'ex. Mint 21.2'},
+                        'validations': {'required': True}},
+                       {'type': 'input', 'id': 'graphics',
+                        'attributes': {'description': '(AMD/NVIDIA/Intel and nouveau/kernel/package(s))',
+                                       'label': 'Graphics hardware *and* driver used',
+                                       'placeholder': 'ex. NVIDIA GeForce RTX 4060 and nouveau'},
+                        'validations': {'required': False}},
+                       {'type': 'textarea', 'id': 'xsession-errors',
+                        'attributes': {'label': 'Snippet or attachment of `~/.xsession-errors`'},
+                        'validations': {'required': False}},
+                       {'type': 'dropdown', 'id': 'extension',
+                        'attributes': {'default': 0,
+                                       'label': 'Extension name and maintainer',
+                                       'options': []},
+                        'validations': {'required': True}},
+                       {'type': 'textarea', 'id': 'logs',
+                        'attributes': {'description': 'Please copy and paste any relevant log output. This will be automatically formatted into code, so no need for backticks.',
+                                       'label': 'Relevant log output',
+                                       'render': 'shell'},
+                        'validations': {'required': False}},
+                       {'type': 'textarea', 'id': 'what-happened',
+                        'attributes': {'description': 'Also tell us, what did you expect to happen?',
+                                       'label': 'What happened?',
+                                       'placeholder': 'Tell us what you see!',
+                                       'value': 'A bug happened!'},
+                        'validations': {'required': True}},
+                       {'type': 'textarea', 'id': 'reproduce',
+                        'attributes': {'description': 'How can this problem be reproduced?',
+                                       'label': 'Steps to reproduce',
+                                       'placeholder': '1. Click or type somewhere...'},
+                        'validations': {'required': True}},
+                       {'type': 'textarea', 'id': 'expected',
+                        'attributes': {'description': 'What should have happened',
+                                       'label': 'Expected behaviour',
+                                       'placeholder': 'No bugs...'},
+                        'validations': {'required': True}},
+                       {'type': 'textarea', 'id': 'other',
+                        'attributes': {'description': 'Anything else that might help get this fixed faster',
+                                       'label': 'Other information',
+                                       'placeholder': 'Extra details...'},
+                        'validations': {'required': False}},
+                       {'type': 'markdown',
+                        'attributes': {'value': "*By submitting this issue, you agree to behave respectfully and in a mature manner. If in doubt, refer to the [Golden Rule](https://en.wikipedia.org/wiki/Golden_Rule) and [Github's Community Guidelines](https://docs.github.com/en/site-policy/github-terms/github-community-guidelines).*"}}]}
+
+
+def main():
+    """
+    List the repository directories and retrieve author information.
+    """
+    xlets_and_authors = []
+
+    try:
+        for name in os.listdir(repo_folder):
+            if name in dirs_blacklist:
+                continue
+
+            info_file_path = os.path.join(repo_folder, name, 'info.json')
+
+            if os.path.isfile(info_file_path):
+                with open(info_file_path, 'r', encoding='utf-8') as info:
+                    file_data = json.load(info)
+
+                author_value = file_data.get('author', 'none')
+                author = '' if author_value == 'none' else f' @{author_value}'
+
+                xlets_and_authors.append(f'{name}{author}')
+    finally:
+        dropdown_list = sorted(sorted(xlets_and_authors), key=str.casefold)
+        with open(os.path.join(repo_folder, '.github', 'ISSUE_TEMPLATE',
+                               '01_bug_report.yml'), 'w',
+                  encoding='utf-8') as bug_report_yaml:
+            BUG_REPORT['body'][6]['attributes']['options'] = dropdown_list
+
+            bug_report_yaml.write(HEADER)
+            yaml.dump(BUG_REPORT, bug_report_yaml)
+
+
+if __name__ == '__main__':
+    main()