chore: Template upgrade

.copier-answers.yml

@@ -1,5 +1,5 @@
 # Changes here will be overwritten by Copier
-_commit: 0.16.5
+_commit: 1.1.1
 _src_path: gh:pawamoy/copier-pdm
 author_email: pawamoy@pm.me
 author_fullname: Timothée Mazzucotelli

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,32 +1,61 @@
 ---
 name: Bug report
-about: Create a report to help us improve
-title: ''
+about: Create a bug report to help us improve.
+title: "bug: "
 labels: unconfirmed
-assignees: ''
-
+assignees: [pawamoy]
 ---
 
-**Describe the bug**
-A clear and concise description of what the bug is.
+### Description of the bug
+<!-- Please provide a clear and concise description of what the bug is. -->
+
+### To Reproduce
+<!-- Please provide a Minimal Reproducible Example (MRE) if possible.
+     Try to boil down the problem to a few lines of code.
+     Your code should run by simply copying and pasting it.
+
+     Example:
+
+     ```
+     git clone https://github.com/username/repro
+     cd repro
+     python -m venv .venv
+     . .venv/bin/activate
+     pip install -r requirements.txt
+     ...  # command or code showing the issue
+     ```
+-->
+
+```
+WRITE MRE / INSTRUCTIONS HERE
+```
+
+### Full traceback
+<!-- Please provide the full error message / traceback if any, by pasting it in the code block below.
+     No screenshots! -->
+
+<details><summary>Full traceback</summary>
+
+```python
+PASTE TRACEBACK HERE
+```
+
+</details>
 
-**To Reproduce**
-Steps to reproduce the behavior:
-1. Go to '...'
-2. Run command '...'
-3. Scroll down to '...'
-4. See error
+### Expected behavior
+<!-- Please provide a clear and concise description of what you expected to happen. -->
 
-**Expected behavior**
-A clear and concise description of what you expected to happen.
+### Environment information
+<!-- Please run the following command in your repository and paste its output below it,
+     redacting sensitive information. -->
 
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
+```bash
+git-changelog --debug-info  # | xclip -selection clipboard
+```
 
-**System (please complete the following information):**
-- `git-changelog` version: [e.g. 0.2.1]
-- Python version: [e.g. 3.8]
-- OS: [Windows/Linux]
+PASTE OUTPUT HERE
 
-**Additional context**
-Add any other context about the problem here.
+### Additional context
+<!-- Add any other relevant context about the problem here,
+     like links to other issues or pull requests, screenshots, etc.
+-->

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+- name: I have a question / I need help
+  url: https://github.com/pawamoy/git-changelog/discussions/new?category=q-a
+  about: Ask and answer questions in the Discussions tab.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,20 +1,19 @@
 ---
 name: Feature request
-about: Suggest an idea for this project
-title: ''
+about: Suggest an idea for this project.
+title: "feature: "
 labels: feature
-assignees: ''
-
+assignees: pawamoy
 ---
 
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+### Is your feature request related to a problem? Please describe.
+<!-- A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]. -->
 
-**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
+### Describe the solution you'd like
+<!-- A clear and concise description of what you want to happen. -->
 
-**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
+### Describe alternatives you've considered
+<!-- A clear and concise description of any alternative solutions or features you've considered. -->
 
-**Additional context**
-Add any other context or screenshots about the feature request here.
+### Additional context
+<!-- Add any other context or screenshots about the feature request here. -->

CONTRIBUTING.md

@@ -46,8 +46,9 @@ on multiple Python versions, you run the task directly with `pdm run duty TASK`.
 The Makefile detects if a virtual environment is activated,
 so `make` will work the same with the virtualenv activated or not.
 
-If you work in VSCode,
-[see examples of tasks and run configurations](https://pawamoy.github.io/copier-pdm/work/#vscode-setup).
+If you work in VSCode, we provide
+[an action to configure VSCode](https://pawamoy.github.io/copier-pdm/work/#vscode-setup)
+for the project.
 
 ## Development
 

Makefile

@@ -18,7 +18,8 @@ BASIC_DUTIES = \
 	docs \
 	docs-deploy \
 	format \
-	release
+	release \
+	vscode
 
 QUALITY_DUTIES = \
 	check-quality \

README.md

@@ -55,11 +55,13 @@ Automatic Changelog generator using Jinja2 templates. From git logs to change lo
 ## Installation
 
 With `pip`:
+
 ```bash
 pip install git-changelog
 ```
 
 With [`pipx`](https://github.com/pipxproject/pipx):
+
 ```bash
 python3.8 -m pip install --user pipx
 pipx install git-changelog

config/ruff.toml

@@ -78,6 +78,9 @@ ignore = [
 "src/*/cli.py" = [
     "T201",  # Print statement
 ]
+"src/*/debug.py" = [
+    "T201",  # Print statement
+]
 "scripts/*.py" = [
     "INP001",  # File is part of an implicit namespace package
     "T201",  # Print statement

config/vscode/launch.json

@@ -0,0 +1,36 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "python (current file)",
+            "type": "python",
+            "request": "launch",
+            "program": "${file}",
+            "console": "integratedTerminal",
+            "justMyCode": false
+        },
+        {
+            "name": "test",
+            "type": "python",
+            "request": "launch",
+            "module": "pytest",
+            "justMyCode": false,
+            "args": [
+                "-c=config/pytest.ini",
+                "-vvv",
+                "--no-cov",
+                "--dist=no",
+                "tests",
+                "-k=${input:tests_selection}"
+            ]
+        }
+    ],
+    "inputs": [
+        {
+            "id": "tests_selection",
+            "type": "promptString",
+            "description": "Tests selection",
+            "default": ""
+        }
+    ]
+}

config/vscode/settings.json

@@ -0,0 +1,52 @@
+{
+    "files.watcherExclude": {
+        "**/__pypackages__/**": true,
+        "**/.venv*/**": true,
+        "**/venv*/**": true
+    },
+    "[python]": {
+        "editor.defaultFormatter": "ms-python.black-formatter"
+    },
+    "python.autoComplete.extraPaths": [
+        "__pypackages__/3.8/lib",
+        "__pypackages__/3.9/lib",
+        "__pypackages__/3.10/lib",
+        "__pypackages__/3.11/lib",
+        "__pypackages__/3.12/lib"
+    ],
+    "python.analysis.extraPaths": [
+        "__pypackages__/3.8/lib",
+        "__pypackages__/3.9/lib",
+        "__pypackages__/3.10/lib",
+        "__pypackages__/3.11/lib",
+        "__pypackages__/3.12/lib"
+    ],
+    "black-formatter.args": [
+        "--config=config/black.toml"
+    ],
+    "mypy-type-checker.args": [
+        "--config-file=config/mypy.ini"
+    ],
+    "python.testing.unittestEnabled": false,
+    "python.testing.pytestEnabled": true,
+    "python.testing.pytestArgs": [
+        "--config-file=config/pytest.ini"
+    ],
+    "ruff.format.args": [
+        "--config=config/ruff.toml"
+    ],
+    "ruff.lint.args": [
+        "--config=config/ruff.toml"
+    ],
+    "yaml.schemas": {
+        "https://squidfunk.github.io/mkdocs-material/schema.json": "mkdocs.yml"
+    },
+    "yaml.customTags": [
+        "!ENV scalar",
+        "!ENV sequence",
+        "!relative scalar",
+        "tag:yaml.org,2002:python/name:materialx.emoji.to_svg",
+        "tag:yaml.org,2002:python/name:materialx.emoji.twemoji",
+        "tag:yaml.org,2002:python/name:pymdownx.superfences.fence_code_format"
+    ]
+}

config/vscode/tasks.json

@@ -0,0 +1,93 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "changelog",
+            "type": "shell",
+            "command": "pdm run duty changelog"
+        },
+        {
+            "label": "check",
+            "type": "shell",
+            "command": "pdm run duty check"
+        },
+        {
+            "label": "check-quality",
+            "type": "shell",
+            "command": "pdm run duty check-quality"
+        },
+        {
+            "label": "check-types",
+            "type": "shell",
+            "command": "pdm run duty check-types"
+        },
+        {
+            "label": "check-docs",
+            "type": "shell",
+            "command": "pdm run duty check-docs"
+        },
+        {
+            "label": "check-dependencies",
+            "type": "shell",
+            "command": "pdm run duty check-dependencies"
+        },
+        {
+            "label": "check-api",
+            "type": "shell",
+            "command": "pdm run duty check-api"
+        },
+        {
+            "label": "clean",
+            "type": "shell",
+            "command": "pdm run duty clean"
+        },
+        {
+            "label": "docs",
+            "type": "shell",
+            "command": "pdm run duty docs"
+        },
+        {
+            "label": "docs-deploy",
+            "type": "shell",
+            "command": "pdm run duty docs-deploy"
+        },
+        {
+            "label": "format",
+            "type": "shell",
+            "command": "pdm run duty format"
+        },
+        {
+            "label": "lock",
+            "type": "shell",
+            "command": "pdm lock -G:all"
+        },
+        {
+            "label": "release",
+            "type": "shell",
+            "command": "pdm run duty release ${input:version}"
+        },
+        {
+            "label": "setup",
+            "type": "shell",
+            "command": "bash scripts/setup.sh"
+        },
+        {
+            "label": "test",
+            "type": "shell",
+            "command": "pdm run duty test coverage",
+            "group": "test"
+        },
+        {
+            "label": "vscode",
+            "type": "shell",
+            "command": "pdm run duty vscode"
+        }
+    ],
+    "inputs": [
+        {
+            "id": "version",
+            "type": "promptString",
+            "description": "Version"
+        }
+    ]
+}

docs/credits.md

@@ -3,6 +3,8 @@ hide:
 - toc
 ---
 
+<!-- blacken-docs:off -->
 ```python exec="yes"
 --8<-- "scripts/gen_credits.py"
 ```
+<!-- blacken-docs:on -->

docs/css/mkdocstrings.css

@@ -9,6 +9,7 @@ a.external::after,
 a.autorefs-external::after {
   /* https://primer.style/octicons/arrow-up-right-24 */
   mask-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18.25 15.5a.75.75 0 00.75-.75v-9a.75.75 0 00-.75-.75h-9a.75.75 0 000 1.5h7.19L6.22 16.72a.75.75 0 101.06 1.06L17.5 7.56v7.19c0 .414.336.75.75.75z"></path></svg>');
+  -webkit-mask-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18.25 15.5a.75.75 0 00.75-.75v-9a.75.75 0 00-.75-.75h-9a.75.75 0 000 1.5h7.19L6.22 16.72a.75.75 0 101.06 1.06L17.5 7.56v7.19c0 .414.336.75.75.75z"></path></svg>');
   content: ' ';
 
   display: inline-block;