Merge branch 'weechat:main' into master

Author: freshprince

.github/ISSUE_TEMPLATE/bug_report.md

@@ -6,7 +6,7 @@ labels: bug
 
 ---
 
-<!-- Please do not report any security issue here, see file Contributing.md -->
+<!-- Please do not report any security issue here, see file CONTRIBUTING.md -->
 
 ## Script / WeeChat
 

.github/ISSUE_TEMPLATE/config.yml

@@ -1 +1,5 @@
+# SPDX-FileCopyrightText: 2020-2025 Sébastien Helleu <[email protected]>
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
 blank_issues_enabled: false

.github/pull_request_template.md

@@ -2,17 +2,17 @@
 
 <!-- MANDATORY INFO: -->
 
-- Script name: 
-- Version: 
+- Script name: 
+- Version: 
 
 <!-- Optional: external dependencies (other than WeeChat and standard interpreter libraries) -->
-- Requirements: 
+- Requirements: 
 
 <!-- Optional: fill only if you are sure that a specific WeeChat version is required -->
-- Min WeeChat version: 
+- Min WeeChat version: 
 
 <!-- Optional: tags for script (see list of tags on https://weechat.org/scripts/), new tags are allowed -->
-- Script tags: 
+- Script tags: 
 
 ## Description
 
@@ -24,26 +24,26 @@
 
 <!-- To fill only if you are adding a new script -->
 
-<!-- Please validate and check each item with "[x]" (see file Contributing.md) -->
+<!-- Please validate and check each item with "[x]" (see file CONTRIBUTING.md) -->
 
 - [ ] Single commit, single file added
 - [ ] Commit message: `New script name.py: short description…`
 - [ ] No similar script already exists
 - [ ] Name: max 32 chars, only lower case letters, digits and underscores
 - [ ] Unique name, does not already exist in repository
 - [ ] No shebang on the first line
-- [ ] Comment in script with name/pseudo, e-mail and license
+- [ ] Comment in script with name/pseudo, e-mail and license using [SPDX](https://spdx.dev/) tags (see [Contributing guide](https://github.com/weechat/scripts/blob/main/CONTRIBUTING.md#copyright-and-license))
 - [ ] Only English in code/comments
 - [ ] Pure WeeChat API used, no extra API
-- [ ] Function `hook_process` is used for any blocking call
+- [ ] Function `hook_url`, `hook_process` or `hook_process_hashtable` is used for any blocking call
 - [ ] For Python script: works with Python 3 (Python 2 support is optional)
 - [ ] Score 100 / 100 displayed by [weechat-script-lint](https://github.com/weechat/weechat-script-lint)
 
 ## Checklist (script update)
 
 <!-- To fill only if you are updating an existing script -->
 
-<!-- Please validate and check each item with "[x]" (see file Contributing.md) -->
+<!-- Please validate and check each item with "[x]" (see file CONTRIBUTING.md) -->
 
 - [ ] Author has been contacted
 - [ ] Single commit, single file added
@@ -56,7 +56,7 @@
 
 <!-- To fill only if you are deleting an existing script -->
 
-<!-- Please validate and check each item with "[x]" (see file Contributing.md) -->
+<!-- Please validate and check each item with "[x]" (see file CONTRIBUTING.md) -->
 
 - [ ] Author has been contacted
 - [ ] Single commit, single file deleted

.github/workflows/ci.yml

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2021-2025 Sébastien Helleu <[email protected]>
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
 name: CI
 
 on:
@@ -6,15 +10,15 @@ on:
 
 jobs:
   check-scripts:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     name: Check scripts
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Set up Python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
-          python-version: "3.10"
+          python-version: "3.12"
       - name: Install dependencies
         run: pip install weechat-script-lint
       - name: Check scripts
-        run: make partial-check
+        run: make check

.github/workflows/reuse.yml

@@ -0,0 +1,22 @@
+# SPDX-FileCopyrightText: 2025 Sébastien Helleu <[email protected]>
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+name: REUSE Compliance Check
+
+on:
+  - push
+  - pull_request
+
+jobs:
+
+  test:
+
+    runs-on: ubuntu-24.04
+
+    steps:
+
+      - uses: actions/checkout@v4
+
+      - name: REUSE Compliance Check
+        uses: fsfe/reuse-action@v4

.mailmap

@@ -1,3 +1,7 @@
+# SPDX-FileCopyrightText: 2014-2025 Sébastien Helleu <[email protected]>
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
 # Map author and committer names and email addresses to canonical real names
 # and email addresses.
 #

Contributing.md CONTRIBUTING.mdContributing.md renamed to CONTRIBUTING.md

@@ -1,3 +1,9 @@
+<!--
+SPDX-FileCopyrightText: 2014-2025 Sébastien Helleu <[email protected]>
+
+SPDX-License-Identifier: GPL-3.0-or-later
+-->
+
 # Contributing to WeeChat scripts
 
 ## Reporting an issue
@@ -19,6 +25,8 @@ Thank you for your help!
 
 New scripts are added with pull requests against master branch of this repository, using the pull request template called `Add script`.
 
+### Guidelines
+
 **Important:** please fill the pull request template and follow **all** these rules, otherwise your new script will be rejected:
 
 - pull request:
@@ -34,16 +42,32 @@ New scripts are added with pull requests against master branch of this repositor
   - do **NOT** use the word "weechat" in the script name: for example prefer `notify.py` to `weechat_notify.py` (the script is only for WeeChat)
 - script content:
   - do **NOT** use a shebang on the first line (like `#!/usr/bin/perl`), this is not needed
-  - write a comment at the beginning with your name (or pseudo), your e-mail and the chosen license (which must be free)
-  - consider using [Semantic versioning ](https://semver.org/) (recommended, not mandatory); only digits and dots are allowed in version
+  - write a comment at the beginning with your name (or pseudo), your e-mail and the chosen license, which must be free (see [Copyright and license](#copyright-and-license))
+  - consider using [Semantic versioning](https://semver.org/) (recommended, not mandatory); only digits and dots are allowed in version
   - use only English for code and comments
   - do **NOT** use an extra API between WeeChat and your script (like Ruby gem "WeeChat"), use the standard WeeChat API only
-  - use function [hook_process](https://weechat.org/files/doc/stable/weechat_plugin_api.en.html#_hook_process) or [hook_process_hashtable](https://weechat.org/files/doc/stable/weechat_plugin_api.en.html#_hook_process_hashtable) if your script is doing something blocking (like fetching URL), to not block WeeChat
+  - use function [hook_url](https://weechat.org/files/doc/stable/weechat_plugin_api.en.html#_hook_url) (WeeChat ≥ 4.1.0), [hook_process](https://weechat.org/files/doc/stable/weechat_plugin_api.en.html#_hook_process) or [hook_process_hashtable](https://weechat.org/files/doc/stable/weechat_plugin_api.en.html#_hook_process_hashtable) if your script is doing something blocking (like fetching URL), to not block WeeChat
   - make your Python script compatible with Python 3.x, the support of Python 2.x is now optional
   - use the official WeeChat URL: [https://weechat.org](https://weechat.org) (`https` and no `www.`) in any link to the WeeChat website.
 
 Your script is automatically checked in CI, see [Automatic checks on scripts](#automatic-checks-on-scripts).
 
+### Copyright and license
+
+The copyright and license must be present in header, using [SPDX](https://spdx.dev/) tags, see the [list of licenses](https://spdx.org/licenses/).
+
+Example of header in a Python script:
+
+<!-- REUSE-IgnoreStart -->
+
+```python
+# SPDX-FileCopyrightText: 2025 Your Name <[email protected]>
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+```
+
+<!-- REUSE-IgnoreEnd -->
+
 ## Updating a script
 
 ### Contacting the author

LICENSES/0BSD.txt

@@ -0,0 +1,5 @@
+Copyright (C) YEAR by AUTHOR EMAIL
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.