A lot of stuff --- TODO improve the name...

.editorconfig

@@ -11,3 +11,5 @@ shell_variant        = bash # --language-variant
 space_redirects      = true  # like -sr
 switch_case_indent   = true  # like -ci
 trim_trailing_whitespace = true
+
+# TODO add config for ps1

.github/workflows/README.md

@@ -0,0 +1,45 @@
+# README
+
+## TODO
+
+- add build test for Android (Temrux)
+- add run test for my .vimrc (maybe add it to the dotfiles repo instead)
+- draw dependency graph here
+- in matrix executions - if one branch fails, the whole task should fail also (though the tests should be executed)
+- clean the Actions logs (delete or hide outdated logs)
+
+## Problems
+
+- snaps and flatpacks in Docker containers (consider making them work or avoiding them)
+
+## Triggers strategy (TODO)
+
+- use matrix for versions of the same distro
+- separate action for each distro with separate paths filters
+- the test itself will be a callable action that will be called from distro actions
+- changes in WSL_Ubuntu will trigger checks of everything as everything depends on
+  stuff in that directory (github action for WSL_Ubuntu will call everything itself
+  and everything will be made callable) - name the test "Test_Everything"
+- pull_request event will also trigger Test_Everything
+- TODO - but read Github Actions documentation first. Maybe there is even more elegant way.
+
+## Triggers
+
+- for push only stuff that was influenced by the change will be checked
+- for pull request everything will be run always (regardless whether files in question changed or not) - the point of this is not to forget anything when changing filenames or adding new files
+
+## Example GitHub actions from similar repos
+
+### Dotfile managers
+
+1. <https://github.com/bevry/dorothy/blob/master/.github/workflows/dorothy-workflow.yml>
+2. Markdown management:
+    <https://github.com/isocpp/CppCoreGuidelines/blob/master/.github/workflows/build.yml>
+    <https://github.com/isocpp/CppCoreGuidelines/blob/master/scripts/Makefile>
+
+### Other repos
+
+
+## TODO CI checks to add
+
+1. Check .md files with spellchecker

.github/workflows/UbuntuGH.yml

@@ -0,0 +1,52 @@
+name: Ubuntu GH 
+
+on:
+  push:
+    branches: [ "devel", "testing", "stable", "LTS" ]
+    paths:
+    - '*.sh'
+    - 'CommonInitScripts/**.sh*'
+    - 'UbuntuCLI/**.sh'
+    - 'Ubuntu_22.04/**.sh'
+    - '.github/workflows/UbuntuGH.yml'
+  pull_request:
+    branches: [ "devel", "testing", "stable", "LTS" ]
+
+jobs:
+  build:
+    name: ${{ matrix.install-gui }}
+    runs-on: ubuntu-22.04
+    strategy:
+      matrix:
+        install-gui: ['GNOME', 'NO GUI'] # TODO add this to containers.yml
+    steps:
+    - name: Update APT & upgrade
+      run: sudo apt-get update -y && sudo apt-get upgrade -y
+    # TODO - BUG - use the correct respective branch - check that it is resolved
+    - name: ${{ matrix.install-gui }}
+      run: |
+          if [[ "${{ matrix.install-gui }}" == 'GNOME' ]]; then
+              sudo apt-get install -y ubuntu-desktop-minimal
+          fi
+    - uses: actions/checkout@v4
+    - name: print `github.ref=${{ github.ref }}` and `github.sha=${{ github.sha }}`
+      run: "echo Ref: ${{ github.ref }}, SHA: ${{ github.sha }}"
+
+    - name: Running iniPC script for the 1st time should not fail.
+      run: ./run_init.sh --noninteractive
+    - name: save ~/ for idempotency test
+      run: cp -r ~/ /tmp/old_home/
+    - name: Running iniPC script for the 2nd time should not fail.
+      run: ./run_init.sh --noninteractive
+
+    # TODO split this command to multiple lines
+    # TODO also test that the first run of initPC script does change the state of home dir
+    # TODO - test whether the test works as expected
+    - name: The initPC script should be idempotent on ~/ directory (WIP - needs testing)
+      run: |
+        cd ~
+        pwd
+        find . -type f \( ! -iname "*.log" ! -path "*/.dotfiles/logs/HEAD" \
+        ! -path "*work/_temp/*" ! -path "./runners/*" \
+        ! -name ".wget-hsts"  \) -print0 |
+        xargs -0 -I{} bash -c 'if ! diff "$1" "/tmp/old_home/$1"; then echo "diff failed for: $1"; exit 1; fi' bash {}

.github/workflows/codacy.yml

@@ -15,10 +15,10 @@ name: Codacy Security Scan
 
 on:
   push:
-    branches: [ "stable", "testing", "devel", "minimal" ]
+    branches: [ "stable", "testing", "devel", "LTS" ]
   pull_request:
     # The branches below must be a subset of the branches above
-    branches: [ "stable", "testing", "devel", "minimal" ]
+    branches: [ "stable", "testing", "devel", "LTS" ]
   schedule:
     - cron: '20 13 * * 3'
 

.github/workflows/containers.yml

@@ -0,0 +1,82 @@
+name: Containers
+
+# TODO try using platform matrix and a single file for Ubuntu and Debian
+# TODO - set trigger paths, remove unnecessary commands, unify with Ubuntu script
+# TODO test
+# TODO merge WSL_Debian and WSL_Ubuntu_22.04 CI into a single .yml file
+# TODO Debian fails to build because of this bug: https://github.com/llvm/llvm-project/issues/62475
+# TODO - problem - changes in e.g. Kali Linux will thanks to the matrix trigger CI pipeline also for Debian etc. which might not be needed
+# TODO add correct trigger paths (e.g. for PopOS etc.)
+# TODO output of try_platform for Ubuntu does not show in logs
+# TODO change * to ** in all workflows (to support nested directories)
+
+on:
+  push:
+    # TODO add relevant paths resp. rewrite as described in the readme
+    branches: [ "devel", "testing", "stable", "LTS" ]
+    paths:
+    - '**.sh'
+    - '.github/workflows/containers.yml'
+  pull_request:
+    branches: [ "devel", "testing", "stable", "LTS" ]
+
+jobs:
+  distro-test:
+    continue-on-error: true
+    runs-on: ubuntu-22.04
+    name: ${{ matrix.container }}
+    strategy:
+      matrix: # TODO add gnome as an additional row in the matrix
+        container:
+          - 'ubuntu:23.04' # https://hub.docker.com/_/ubuntu
+          - 'ubuntu:22.04'
+          - 'ubuntu:rolling'
+          - 'debian:12' # https://hub.docker.com/_/debian
+          - 'debian:testing'
+          - 'kalilinux/kali-rolling' # https://hub.docker.com/r/kalilinux/kali-rolling
+          - 'nycticoracs/pop_os:22.04' # PopOS TODO add link
+    container:
+      image: ${{ matrix.container }}
+    # TODO exit on push with commit message "Add a TODO"
+
+    # TODO - consider making these steps some kind of subroutine
+    # or some other way to avoid redundant runs in the matrix
+    # consider using dependencies for that: https://stackoverflow.com/questions/58457140/dependencies-between-workflows-on-github-actions 
+    steps: # TODO - exit if the change was in the path that is not a dependency
+      # - name: "set APT to non-interactive"
+      #   shell: bash
+      #   run: "echo 'debconf debconf/frontend select Noninteractive' | debconf-set-selections"
+      - name: "Update APT"
+        run: "apt-get update -y"
+      - name: "Install `git` and `sudo`"
+        run: "apt-get install -y git sudo"
+      - name: "Checkout repo"
+        uses: actions/checkout@v4
+      - name: print `github.ref=${{ github.ref }}`
+        run: echo ${{ github.ref }}
+      - name: print `github.sha=${{ github.sha }}`
+        run: echo ${{ github.sha }}
+      - name: "cat /etc/os-release"
+        run: cat /etc/os-release
+      - name: Running iniPC script for the 1st time should not fail.
+        run: ./run_init.sh --noninteractive
+      - name: save ~/ for idempotency test
+        run: cp -r ~/ /tmp/old_home/
+      - name: Running iniPC script for the 2nd time should not fail.
+        run: ./run_init.sh --noninteractive
+      # TODO split this command to multiple lines
+      # TODO also test that the first run of initPC script does change the state of home dir
+      # TODO - test whether the test works as expected
+      # TODO sync the idempotency test between linux distros (this is the most recent)
+      - name: The initPC script should be idempotent on ~/ directory (WIP - needs testing)
+        run: |
+          cd ~
+          pwd
+          find . -type f \( ! -iname "*.log" ! -path "*/.dotfiles/logs/HEAD" \
+          ! -path "*work/_temp/*" ! -path "./runners/*" \
+          ! -path "./x/helix/target/release/.fingerprint/*" \
+          ! -path "./.cargo/registry/index/*" \
+          ! -path "./x/helix/target/release/build/helix-term*" \
+          ! -path "./x/helix/target/.rustc_info.json" \
+          ! -name ".wget-hsts"  \) -print0 |
+          xargs -0 -I{} bash -c 'if ! diff -C 30 "/tmp/old_home/$1" "$1"; then echo "diff failed for: $1"; exit 1; fi' bash {}

.github/workflows/fast_forward_merge.yml

@@ -2,6 +2,8 @@ on:
   issue_comment:
     types: [created]
 
+# TODO the action is broken - fix
+
 jobs:
   fast_forward_job:
     name: Fast Forward Merge
@@ -10,9 +12,8 @@ jobs:
     steps:
       # To use this repository's private action, you must check out the repository
       - name: Checkout
-        uses: actions/checkout@v3
-      - name: Fast Forward PR
-        id: ff-action
+        uses: actions/checkout@v3                
+      - name: Fast Forward PR        
         uses: endre-spotlab/[email protected]
         with:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/pop.yml

@@ -0,0 +1,67 @@
+# TODO - move to containers.yml
+
+name: Pop_OS - iniPC script
+
+# TODO try using platform matrix and a single file for Ubuntu and Debian
+# TODO - set trigger paths, remove unnecessary commands, unify with Ubuntu script
+# TODO test
+# TODO fix PopOS init script itself...
+# TODO standardize workflow names
+
+on:
+  push:
+    branches: [ "devel", "testing", "stable", "minimal" ]
+    paths:
+    - 'run_init.sh'
+    - 'prelude.sh'
+    - 'CommonInitScripts/*.sh*'
+    - '.github/workflows/pop.yml'
+    - 'WSL_Ubuntu_22.04/*.sh'
+    - 'PopOS_22.04/*.sh'
+  pull_request:
+    branches: [ "devel", "testing", "stable", "minimal" ]
+    paths:
+    - 'run_init.sh'
+    - 'prelude.sh'
+    - 'CommonInitScripts/*.sh*'
+    - '.github/workflows/pop.yml'
+    - 'WSL_Ubuntu_22.04/*.sh'
+    - 'PopOS_22.04/*.sh'
+
+# TODO try caching the PopOS container
+# see: https://docs.github.com/en/actions/using-workflows/caching-dependencies-to-speed-up-workflows
+jobs:
+  build:
+    runs-on: ubuntu-22.04
+    container: "nycticoracs/pop_os:22.04"
+    steps:
+      # - name: "set APT to non-interactive"
+      #   shell: bash
+      #   run: "echo 'debconf debconf/frontend select Noninteractive' | debconf-set-selections"
+      - name: "Update APT"
+        run: "apt-get update -y"
+      - name: "Install git"
+        run: "apt-get install -y git sudo"
+      - name: "checkout repo"
+        uses: actions/checkout@v4
+      - name: print `github.ref=${{ github.ref }}`
+        run: echo ${{ github.ref }}
+      - name: print `github.sha=${{ github.sha }}`
+        run: echo ${{ github.sha }}
+      - name: Running iniPC script for the 1st time should not fail.
+        run: ./run_init.sh --noninteractive
+      - name: save ~/ for idempotency test
+        run: cp -r ~/ /tmp/old_home/
+      - name: Running iniPC script for the 2nd time should not fail.
+        run: ./run_init.sh --noninteractive
+      # TODO split this command to multiple lines
+      # TODO also test that the first run of initPC script does change the state of home dir
+      # TODO - test whether the test works as expected
+      - name: The initPC script should be idempotent on ~/ directory (WIP - needs testing)
+        run: |
+          cd ~
+          pwd
+          find . -type f \( ! -iname "*.log" ! -path "*/.dotfiles/logs/HEAD" \
+          ! -path "*work/_temp/*" ! -path "./runners/*" \
+          ! -name ".wget-hsts"  \) -print0 |
+          xargs -0 -I{} bash -c 'if ! diff "$1" "/tmp/old_home/$1"; then echo "diff failed for: $1"; exit 1; fi' bash {}

.github/workflows/pre-commit-hook.yml

@@ -0,0 +1,25 @@
+name: pre-commit hook
+
+on:
+  push:
+    branches: [ "devel", "testing", "stable", "LTS" ]
+  pull_request:
+    branches: [ "devel", "testing", "stable", "LTS" ]
+
+jobs:
+  build:
+    # name: ${{ matrix.install-gui }}
+    runs-on: ubuntu-22.04
+
+    steps:
+    - name: Update APT
+      run: sudo apt-get update -y
+    - name: Install dependencies
+      run: sudo apt install -y shfmt shellcheck
+
+    - uses: actions/checkout@v4
+    - name: print `github.ref=${{ github.ref }}` and `github.sha=${{ github.sha }}`
+      run: "echo Ref: ${{ github.ref }}, SHA: ${{ github.sha }}"
+
+    - name: pre-commit hook should not fail
+      run: ./pre-commit-hook.sh