add support for installing extensions

Author: stdevel

.ansible-lint

@@ -0,0 +1,5 @@
+---
+skip_list:
+  - no-changed-when
+  - command-instead-of-shell
+  - command-instead-of-module

README.md

@@ -52,6 +52,23 @@ This role will not install the GNOME desktop itself - it should be pre-installed
 | -------- | ------- | ----------- |
 | `gnome_additional_settings` | `true` | Additional setting/value pairs (*as list*) |
 
+### Installing extensions
+
+In order to automate installing extensions, you'll need to find:
+
+- the appropriate download URL for your GNOME Shell version
+- the extension UUID
+
+The easiest way to find these information is to browse [https://extensions.gnome.org/](the GNOME extension catalog), manually select the appropriate version and copy the download URL. Extract the archive once and read the `uuid` value from `metadata.json`.
+
+See the following YAML code for [a Podman extension](https://extensions.gnome.org/extension/1500/containers/) for GNOME 41:
+
+```yaml
+gnome_extensions:
+  - name: containers@royg
+    url: https://extensions.gnome.org/extension-data/containersroyg.v19.shell-extension.zip
+```
+
 ## Dependencies
 
 No dependencies.
@@ -83,6 +100,9 @@ Set variables if required, e.g.:
           value: ['']
         - setting: "/dummy/setting"
           state: absent
+      gnome_extensions:
+        - name: containers@royg
+          url: https://extensions.gnome.org/extension-data/containersroyg.v19.shell-extension.zip
 ```
 
 ## License

tasks/configure.yml

@@ -58,3 +58,34 @@
     state: "{{ item.state | default('present') }}"
   loop: "{{ gnome_additional_settings }}"
   when: gnome_additional_settings is defined
+
+- name: Create extension directory
+  file:
+    path: ~/.local/share/gnome-shell/extensions
+    owner: "{{ ansible_user_id }}"
+    mode: '0750'
+    state: directory
+  when: gnome_extensions is defined
+
+- name: Install extensions
+  block:
+    - name: Download archive
+      get_url:
+        url: "{{ item.url }}"
+        dest: ~/.local/share/gnome-shell/extensions/
+      loop: "{{ gnome_extensions }}"
+
+    - name: Create directory
+      file:
+        path: "~/.local/share/gnome-shell/extensions/{{ item.name }}"
+        owner: "{{ ansible_user_id }}"
+        mode: '0750'
+        state: directory
+      loop: "{{ gnome_extensions }}"
+
+    - name: Extract archive
+      unarchive:
+        src: "~/.local/share/gnome-shell/extensions/{{ item.url | basename }}"
+        dest: "~/.local/share/gnome-shell/extensions/{{ item.name }}"
+      loop: "{{ gnome_extensions }}"
+  when: gnome_extensions is defined