Merge branch 'ivan-hc:main' into apptui

.github/ISSUE_TEMPLATE/add-appimages-only.md

@@ -0,0 +1,24 @@
+---
+name: Add AppImages only
+about: Suggest AppImages for this database
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+To help us make adding AppImages quicker and easier, please try to follow the following two syntaxes.
+
+## If available on Github.com
+- name (lowercase, this will be the command to use)
+- repository (URL, DO NOT use direct download link)
+
+## If available on other sites
+- name (lowercase, this will be the command to use)
+- main site, repository or reference web page (URL, DO NOT use direct download link)
+- download page (if different from the main page)
+- description of the application
+
+--------------------------------------------------
+
+# List of AppImages to add

.github/ISSUE_TEMPLATE/add-portable-apps--not-appimages-.md

@@ -0,0 +1,38 @@
+---
+name: Add portable apps (NOT AppImages)
+about: Suggest applications for this database
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+To help us make adding applications quicker and easier, please try to follow the following two syntaxes.
+
+## If available on Github.com
+- name (lowercase, this will be the command to use)
+- repository (URL, DO NOT use direct download link)
+
+## If available on other sites
+- name (lowercase, this will be the command to use)
+- main site, repository or reference web page (URL, DO NOT use direct download link)
+- download page (if different from the main page)
+- description of the application
+
+# Important!
+The two syntaxes mentioned above are enough for programs that can only be used from the command line.
+
+However, for graphical programs and programs that require integration into the menu, and therefore a launcher, also add the following two pieces of information:
+- URL to the application icon
+- the .desktop* file, you can choose whether...
+  - add a URL to the .desktop file, if it exists
+  - paste the content of the file directly
+  - drag a text file into your comment
+  - provide only the following desktop entries, so that we can create a minimal and unofficial launcher
+    - Name=
+    - Exec=
+    - Categories=
+
+--------------------------------------------------
+
+# List of portable applications to add

.github/ISSUE_TEMPLATE/bug-report--applications-only-.md

@@ -0,0 +1,22 @@
+---
+name: Bug report (applications only)
+about: Create a report to fix installation and integration of the available apps
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+# Premise
+"AM"/"AppMan" is just a tool to provide applications easily and quickly and is only responsible for integrating the AppImages into the system and installing the various programs available, respecting the following order (refer to the option "-d" to download the installation script without installing it):
+- creation of the base directories and the removal script
+- download of the package
+- creation of the version file and the update script
+- possibly, extraction of the icons and .desktop files, if needed
+
+The malfunction of the installation scripts will then be taken into account. On the contrary, any malfunction related to individual applications is the responsibility of the related developer or packager. Refer to the option "-a" to know the sources of each program listed here, so you can contact them to report the bug.
+
+--------------------------------------------------
+
+## Please, describe the bug
+Write here

.github/ISSUE_TEMPLATE/bug-report--generic-.md

@@ -0,0 +1,34 @@
+---
+name: Bug report (generic)
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+# Premise
+"AM"/"AppMan" is just a tool to provide applications easily and quickly and is only responsible for integrating the AppImages into the system and installing the various programs available, respecting the following order (refer to the option "-d" to download the installation script without installing it):
+- creation of the base directories and the removal script
+- download of the package
+- creation of the version file and the update script
+- possibly, extraction of the icons and .desktop files, if needed
+
+The malfunction of the installation scripts will then be taken into account. On the contrary, any malfunction related to individual applications is the responsibility of the related developer or packager. Refer to the option "-a" to know the sources of each program listed here, so you can contact them to report the bug.
+
+--------------------------------------------------
+
+## Are you using "AM" or "AppMan"?
+Write here
+
+## What GNU/Linux distribution are you using it on?
+Write here
+
+## Please, describe the bug
+Write here
+
+## What are the steps/commands to perform?
+Write here
+
+## What is the expected behavior?
+Write here

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,17 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+# Is your feature request related to a problem? Please describe.
+Write here
+
+# Describe the solution you'd like
+Write here
+
+# Describe alternatives you've considered
+Write here

.github/ISSUE_TEMPLATE/questions-and-answers--free-speech-.md

@@ -0,0 +1,10 @@
+---
+name: Questions and answers (free speech)
+about: Are you insecure? Ask whatever you want.
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+

.github/workflows/lint-shell.yml

@@ -0,0 +1,34 @@
+---
+name: 🐶 SHELL check 🧪
+on:
+  workflow_dispatch:
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  reviewdog:
+    permissions:
+      checks: write
+      contents: read
+      pull-requests: write
+    name: shellcheck
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: haya14busa/action-cond@v1
+        id: reporter
+        with:
+          cond: ${{ github.event_name == 'pull_request' }}
+
+      - uses: reviewdog/action-shellcheck@v1
+        with:
+          reporter: ${{ steps.reporter.outputs.value }}
+          github_token: ${{ secrets.github_token }}
+          path: |
+            "."
+            modules
+          exclude: "./programs/*"
+          check_all_files_with_shebangs: true
+          level: error
+          shellcheck_flags: '--external-sources --severity=error'

.github/workflows/lint-shellcheck.yml

@@ -0,0 +1,18 @@
+name: "Lint Shellcheck 🐚"
+
+on:
+  pull_request:
+    branches: '**'
+  workflow_dispatch:
+
+jobs:
+  shellcheck:
+    name: Shellcheck
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Run ShellCheck
+        uses: ludeeus/action-shellcheck@master
+        with:
+          format: gcc
+          severity: error

.github/workflows/lint-yaml.yml

@@ -0,0 +1,29 @@
+---
+name: 🐶 YAML check 🧪
+on:
+  push:
+    branches: '**'
+    path: .github/workflows/*.yml
+  pull_request:
+    branches: '**'
+    path: .github/workflows/*.yml
+  workflow_dispatch:
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+jobs:
+  yamllint:
+    name: yaml lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: haya14busa/action-cond@v1
+        id: reporter
+        with:
+          cond: ${{ github.event_name == 'pull_request' }}
+      - uses: reviewdog/action-yamllint@v1
+        with:
+          reporter: ${{ steps.reporter.outputs.value }}
+          github_token: ${{ secrets.github_token }}
+          yamllint_flags: '-d relaxed .github/'
+          level: error

.github/workflows/test-apps.yml

@@ -0,0 +1,61 @@
+name: "Apps test 🧪"
+
+env:
+  TERM: xterm
+
+on:
+  workflow_dispatch:
+    branches: '**'
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+
+  am:
+    name: test all Apps 📝
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: test all Apps
+        run: |
+          printf '\tSetting up environment...\n'
+          printf '\n\tCreating directory structure...\n'
+          mkdir -p results
+          printf '\n\tMaking needed files executable...\n'
+          chmod +x ./INSTALL
+          printf '\n\tInstalling AM...\n'
+          sudo ./INSTALL
+          printf '\n'
+          echo -e "Installed version: $(am version)\n\n"
+          apps=$(cut -d' ' -f2 < /opt/am/x86_64-apps)
+          count=$(echo "${apps}" | wc -l)
+          echo "available apps: $count"
+          for app in ${apps}; do
+            echo '-------------------------------------------------------------'
+            am -f -less
+            echo '-------------------------------------------------------------'
+            am -i $app && echo "OK: $app" >> results/good || \
+            echo "FAIL! $app" >> results/bad
+            echo '-------------------------------------------------------------'
+            am -f --less
+            echo '-------------------------------------------------------------'
+            am -R $app && echo "OK: $app" >> results/removed || \
+            echo "REMOVE! $app" >> results/noremoved
+            echo '-------------------------------------------------------------'
+            am -f --less
+            echo '-------------------------------------------------------------'
+          done
+          good=$(cat results/good | wc -l)
+          bad=$(cat results/bad | wc -l)
+          removed=$(cat results/removed | wc -l)
+          noremoved=$(cat results/noremoved | wc -l)
+          echo -e "\n\n"
+          echo "all/runed/ok/failed/removed/not"
+          echo "$count/$n/$good/$bad/$removed/$noremoved"
+          echo -e "\n\n"
+          printf '\n\tTest finished\n'
+      - uses: actions/upload-artifact@v4
+        with:
+          name: results
+          path: results