add Docker container and helper script

Author: TimidRobot

dev/Dockerfile

@@ -0,0 +1,25 @@
+# https://docs.docker.com/engine/reference/builder/
+
+# https://hub.docker.com/_/debian
+FROM debian:bookworm-slim
+
+# Configure apt not to prompt during docker build
+ARG DEBIAN_FRONTEND=noninteractive
+
+# Configure apt to avoid installing recommended and suggested packages
+RUN apt-config dump \
+    | grep -E '^APT::Install-(Recommends|Suggests)' \
+    | sed -e's/1/0/' \
+    | tee /etc/apt/apt.conf.d/99no-recommends-no-suggests
+
+# Resynchronize the package index and install packages
+# https://docs.docker.com/build/building/best-practices/#apt-get
+RUN apt-get update && apt-get install -y \
+        curl \
+        git \
+        gir1.2-pango-1.0 \
+        libnginx-mod-http-fancyindex \
+        nginx-light \
+        python3-gi-cairo \
+        tree \
+    && rm -rf /var/lib/apt/lists/*

dev/etc-nginx-sites-available-default

@@ -0,0 +1,18 @@
+server {
+    listen 80;
+    server_name localhost;
+    root /srv/licensebuttons/www;
+    location /i {
+        fancyindex on;
+        fancyindex_header /header.html;
+        fancyindex_footer /footer-i.html;
+        fancyindex_exact_size off;
+    }
+    location / {
+        fancyindex on;
+        fancyindex_header /header.html;
+        fancyindex_footer /footer.html;
+        fancyindex_exact_size off;
+    }
+}
+# vim: ft=nginx

dev/genicons.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+#
+# Run Python code tools (isort, black, flake8)
+#
+#### SETUP ####################################################################
+
+set -o errexit
+set -o errtrace
+set -o nounset
+
+# shellcheck disable=SC2154
+trap '_es=${?};
+    printf "${0}: line ${LINENO}: \"${BASH_COMMAND}\"";
+    printf " exited with a status of ${_es}\n";
+    exit ${_es}' ERR
+
+DIR_REPO="$(cd -P -- "${0%/*}/.." && pwd -P)"
+# https://en.wikipedia.org/wiki/ANSI_escape_code
+E0="$(printf "\e[0m")"        # reset
+E30="$(printf "\e[30m")"      # black foreground
+E31="$(printf "\e[31m")"      # red foreground
+E107="$(printf "\e[107m")"    # bright white background
+
+#### FUNCTIONS ################################################################
+
+check_docker() {
+    local _msg
+    if ! docker compose exec web true 2>/dev/null; then
+        _msg='The app container/services is not avaialable.'
+        _msg="${_msg}\n       First run \`docker compose up\`."
+        error_exit "${_msg}"
+    fi
+}
+
+error_exit() {
+    # Echo error message and exit with error
+    echo -e "${E31}ERROR:${E0} ${*}" 1>&2
+    exit 1
+}
+
+icon_stats() {
+    local _count _size
+    print_header 'Icons stats'
+    echo '/srv/licensebuttons/www/i'
+    _count=$(docker compose exec web find /srv/licensebuttons/www/i -type f \
+        | wc -l | tr -d '[:space:]')
+    _size=$(docker compose exec web du -sh /srv/licensebuttons/www/i \
+        | awk '{print $1}')
+    printf '    %11s %5s\n'  'File count:' "${_count}"
+    printf '    %11s %5s\n'  'Size:' "${_size}"
+    echo
+}
+
+print_header() {
+    # Print 80 character wide black on white heading with time
+    printf "${E30}${E107}# %-69s$(date '+%T') ${E0}\n" "${@}"
+}
+
+#### MAIN #####################################################################
+
+cd "${DIR_REPO}"
+
+check_docker
+
+icon_stats
+
+print_header 'Generate icons in Docker container'
+docker compose exec web \
+    /usr/bin/python3 /srv/licensebuttons/scripts/genicons.py
+echo 'done.'
+echo
+
+icon_stats

docker-compose.yml

@@ -0,0 +1,24 @@
+# https://docs.docker.com/compose/compose-file/
+
+services:
+  web:
+    build:
+      dockerfile: dev/Dockerfile
+    command: sh -c "
+      echo 'Starting static webserver at http://127.0.0.1:8080/'
+      && nginx -g 'daemon off;'
+      "
+    init: true
+    ports:
+      - '8080:80'
+    restart: on-failure
+    volumes:
+      - .:/srv/licensebuttons
+      - ./dev/etc-nginx-sites-available-default:/etc/nginx/sites-available/default:ro
+      - ./www/cc-icons.ttf:/root/.fonts/cc-icons.ttf:ro
+      - licbuttons-www-i:/srv/licensebuttons/www/i
+    working_dir: /srv/licensebuttons
+
+volumes:
+ licbuttons-www-i:
+    name: licbuttons-www-i