Merge branch 'master' into feature/improve-changed-flag

.github/workflows/code-check.yml

@@ -1,41 +1,45 @@
-name: code-check
+name: Code quality checks
 
 on:
   push:
-    branches: '*'
-    tags: '*'
-    paths-ignore: '**.md'
+    branches:
+      - '*'
+    tags:
+      - '*'
+    paths-ignore:
+      - '**.md'
 
   pull_request:
-    branches: '*'
-    tags: '*'
-    paths-ignore: '**.md'
+    branches:
+      - '*'
+    paths-ignore:
+      - '**.md'
 
 jobs:
   code-check:
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-22.04
 
     steps:
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       - name: Setup python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
-          python-version: 3.8
+          python-version: '3.12'
 
       - name: Install poetry
-        uses: snok/install-poetry@v1.3.2
+        uses: snok/install-poetry@v1.3.4
         with:
           virtualenvs-create: true
           virtualenvs-in-project: true
 
       - name: Cache venv
         id: code-check-cache
-        uses: actions/cache@v3.0.10
+        uses: actions/cache@v4
         with:
           path: .venv
-          key: code-check-python-${{ matrix.python-version }}-${{ hashFiles('**/poetry.lock') }}
+          key: code-check-python-${{ hashFiles('**/poetry.lock') }}
 
       - name: Install dependencies
         if: steps.code-check-cache.outputs.cache-hit != 'true'

.github/workflows/tests.yml

@@ -1,19 +1,23 @@
-name: tests
+name: Tests
 
 on:
   push:
-    branches: '*'
-    tags: '*'
-    paths-ignore: '**.md'
+    branches:
+      - '*'
+    tags:
+      - '*'
+    paths-ignore:
+      - '**.md'
 
   pull_request:
-    branches: '*'
-    tags: '*'
-    paths-ignore: '**.md'
+    branches:
+      - '*'
+    paths-ignore:
+      - '**.md'
 
 jobs:
   tests:
-    runs-on: ubuntu-18.04
+    runs-on: ubuntu-20.04
     strategy:
       matrix:
         include:
@@ -34,34 +38,54 @@ jobs:
             ansible-version: '4.10.0'
 
           # python 3.8
-          - python-version: '3.8'
-            ansible-version: '2.10.7'
           - python-version: '3.8'
             ansible-version: '3.4.0'
           - python-version: '3.8'
             ansible-version: '4.10.0'
           - python-version: '3.8'
             ansible-version: '5.4.0'
+          - python-version: '3.8'
+            ansible-version: '6.7.0'
 
           # python 3.9
-          - python-version: '3.9'
-            ansible-version: '2.10.7'
-          - python-version: '3.9'
-            ansible-version: '3.4.0'
           - python-version: '3.9'
             ansible-version: '4.10.0'
           - python-version: '3.9'
             ansible-version: '5.4.0'
+          - python-version: '3.9'
+            ansible-version: '6.7.0'
+          - python-version: '3.9'
+            ansible-version: '7.7.0'
 
           # python 3.10
           - python-version: '3.10'
-            ansible-version: '2.10.7'
+            ansible-version: '6.7.0'
           - python-version: '3.10'
-            ansible-version: '3.4.0'
+            ansible-version: '7.7.0'
           - python-version: '3.10'
-            ansible-version: '4.10.0'
+            ansible-version: '8.7.0'
           - python-version: '3.10'
-            ansible-version: '5.4.0'
+            ansible-version: '9.7.0'
+
+          # python 3.11
+          - python-version: '3.11'
+            ansible-version: '6.7.0'
+          - python-version: '3.11'
+            ansible-version: '7.7.0'
+          - python-version: '3.11'
+            ansible-version: '8.7.0'
+          - python-version: '3.11'
+            ansible-version: '9.7.0'
+
+          # python 3.12
+          - python-version: '3.12'
+            ansible-version: '6.7.0'
+          - python-version: '3.12'
+            ansible-version: '7.7.0'
+          - python-version: '3.12'
+            ansible-version: '8.7.0'
+          - python-version: '3.12'
+            ansible-version: '9.7.0'
 
     steps:
       - name: Checkout code

.gitpod.yml

@@ -0,0 +1,34 @@
+---
+# See: <https://www.gitpod.io/docs/configure/workspaces>
+
+
+image: caian/gitpod-dev-workspace:latest
+
+
+tasks:
+  - name: Local env
+    init: poetry install
+
+
+vscode:
+  extensions:
+    - aaron-bond.better-comments
+    - batisteo.vscode-django
+    - christian-kohler.path-intellisense
+    - donjayamanne.python-environment-manager
+    - donjayamanne.python-extension-pack
+    - eamodio.gitlens
+    - editorconfig.editorconfig
+    - exiasr.hadolint
+    - kevinrose.vsc-python-indent
+    - ms-azuretools.vscode-docker
+    - ms-python.isort
+    - ms-python.python
+    - ms-toolsai.jupyter
+    - ms-toolsai.jupyter-keymap
+    - ms-toolsai.vscode-jupyter-cell-tags
+    - ms-toolsai.vscode-jupyter-slideshow
+    - njpwerner.autodocstring
+    - redhat.vscode-yaml
+    - tamasfe.even-better-toml
+    - wholroyd.jinja

README.md

@@ -1,20 +1,16 @@
 [![Tests][workflows-shield]][workflows-url]
-[![Code Quality][lgtm-shield]][lgtm-url]
 [![GitHub tag][tag-shield]][tag-url]
 
 # ansible-stow
 
-<img src="logo.png" height="300x" align="right"/>
+<img src="logo.svg" height="270px" align="right"/>
 
 An Ansible module that interacts with [GNU Stow][stow] packages.
 
 [stow]: https://www.gnu.org/software/stow
 
-[workflows-shield]: https://img.shields.io/github/workflow/status/caian-org/ansible-stow/run-tests?label=tests&logo=github&style=for-the-badge
-[workflows-url]: https://github.com/caian-org/ansible-stow/actions/workflows/check-code-and-run-tests.yml
-
-[lgtm-shield]: https://img.shields.io/lgtm/grade/python/g/caian-org/ansible-stow.svg?logo=lgtm&style=for-the-badge
-[lgtm-url]: https://lgtm.com/projects/g/caian-org/ansible-stow/context:python
+[workflows-shield]: https://img.shields.io/github/actions/workflow/status/caian-org/ansible-stow/tests.yml?branch=master&label=tests&logo=github&style=for-the-badge
+[workflows-url]: https://github.com/caian-org/ansible-stow/actions/workflows/tests.yml
 
 [tag-shield]: https://img.shields.io/github/tag/caian-org/ansible-stow.svg?logo=git&logoColor=FFF&style=for-the-badge
 [tag-url]: https://github.com/caian-org/ansible-stow/releases
@@ -35,9 +31,9 @@ An Ansible module that interacts with [GNU Stow][stow] packages.
 
 ## Compatibility
 
-This ansible module is tested against `ansible 2.10.7 | 3.4.0 | 4.10.0 | 5.4.0` and `python >= 3.6, < 4.0`. Note that
-for `ansible >= 4.10.0`, `python >= 3.8` is required. For development (linting and other code verification) `python >=
-3.7.2` is required.
+This ansible module is tested against `ansible 2.10.7 | 3.4.0 | 4.10.0 | 5.10.0 | 6.7.0 | 7.7.0 | 8.7.0 | 9.7.0`
+and `python >= 3.6, < 4.0`. Note that for `ansible >= 4.10.0`, `python >= 3.8` is required.
+For development (linting and other code verification) `python >= 3.10` is required.
 
 For `python < 3` (legacy systems that still uses `2.x`), use the [`v0.1.3`](https://github.com/caian-org/ansible-stow/tree/v0.1.3) of this module.
 
@@ -56,7 +52,7 @@ Download the module and move it into your global Ansible library or into the
 library directory alongside your top-level playbook. E.g.:
 
 ```sh
-$ wget https://raw.githubusercontent.com/caian-org/ansible-stow/v0.1.4/stow
+$ wget https://raw.githubusercontent.com/caian-org/ansible-stow/v1.1.3/stow
 $ (sudo) mv stow /usr/share/ansible
 ```