client: docker: complete build overhaul, optimize

This commit brings a complete overhaul of the build system:

- Creates a separation of concerns for 'local' and 'remote' building
  * 'local' is built locally via the docker-finance `build` command
  * 'remote' is built *outside* of the docker-finance `build` command
    (pushed to a remote registry and then pulled by the 'local' build)
  * Related refactoring
    - Dockerfiles
    - `lib_gen`

- Adds remote image 'hledger-suite'
  * Provides the latest versions of all `hledger` related binaries
  * No longer relies on package maintainers / out-dated packages

- Adds remote image 'docker-finance'
  * Provides base image for 'finance' and 'dev-tools' images
    - tags 'archlinux' | 'ubuntu' | 'dev-tools'

- Removes previous `hledger` related build modules
  * Removes building any `hledger` related binaries locally

- Removes 'experimental' build
  * End-user can use local custom Dockerfile and/or custom tag instead

- Updates the 'default' | 'slim' | 'tiny' | 'micro' build types
  * Refactors build type requirements into separate build modules
    - Adds 'fetch' module
    - Adds 'track' module
    - Adds 'user' module
      * creates container user *after* base and all other modules
      * allows for quick re-building across multiple local users
    - Updates 'root' module
  * `lib_docker`
    - Updates usage help
    - Adds build modules per build type

- Huge optimizations
  * Vastly improves build times
    - ~60% faster w/ a fresh build
    - ~60%-90% faster rebuild (depending on image type)
  * Vastly improves image sizes
    - e.g., 'default' Arch Linux image size is ~50% smaller

client/Dockerfiles/remote/docker-finance/dev-tools/Dockerfile.dev-tools

@@ -0,0 +1,81 @@
+# docker-finance | modern accounting for the power-user
+#
+# Copyright (C) 2021-2024 Aaron Fiore (Founder, Evergreen Crypto LLC)
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+FROM ubuntu:rolling
+
+RUN apt-get update -y
+
+# Add builder user (for `composer` and non-root building)
+RUN useradd -m -s /bin/bash -r builder
+
+#
+# 'dev-tools' linters
+#
+
+# Bash
+RUN apt-get install -y shfmt shellcheck
+
+# C++
+RUN apt-get install -y clang-format cppcheck cpplint
+
+# PHP
+RUN apt-get install -y composer
+
+USER builder
+WORKDIR /usr/local/lib/php
+
+RUN composer require -n --dev friendsofphp/php-cs-fixer
+RUN composer require -n --dev phpstan/phpstan
+
+USER root
+RUN echo "export PATH=\"\$PATH:/usr/local/lib/php/vendor/bin\"" >>/etc/bash.bashrc
+
+#
+# 'finance' dependencies (`fetch` APIs)
+#
+
+RUN apt-get install -y php php-bcmath php-curl php-gmp
+
+USER builder
+WORKDIR /usr/local/lib/php
+
+RUN composer require -n ozdemirburak/json-csv
+RUN composer require -n ccxt/ccxt
+# "Sunsetted" Coinbase Pro
+RUN composer require -n mocking-magician/coinbase-pro-sdk
+
+#
+# 'dev-tools' misc.
+#
+
+USER root
+
+# Doxygen
+RUN apt-get install -y doxygen graphviz
+
+# docker-finance `version` command
+RUN apt-get install -y yq
+
+#
+# Entrypoint
+#
+
+COPY ./entrypoint.bash /entrypoint.bash
+RUN chmod a+rx /entrypoint.bash
+ENTRYPOINT ["/entrypoint.bash"]
+
+# vim: sw=2 sts=2 si ai et

client/Dockerfiles/remote/docker-finance/dev-tools/docker-compose.yml

@@ -0,0 +1,26 @@
+# docker-finance | modern accounting for the power-user
+#
+# Copyright (C) 2024 Aaron Fiore (Founder, Evergreen Crypto LLC)
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+services:
+  dev-tools:
+    image: evergreencrypto/docker-finance:dev-tools
+    container_name: evergreencrypto_docker-finance_dev-tools
+    build:
+      dockerfile: Dockerfile.dev-tools
+# TODO: add labels
+
+# vim: sw=2 sts=2 si ai et

client/Dockerfiles/remote/docker-finance/dev-tools/entrypoint.bash

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+# docker-finance | modern accounting for the power-user
+#
+# Copyright (C) 2021-2024 Aaron Fiore (Founder, Evergreen Crypto LLC)
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+# Keep container running
+tail -f /dev/null
+
+exec "$@"