Merge pull request #331 into master

50245cf0 client/container: completion: add TODOs for `bash-completion` (Aaron Fiore)
8bc196ef client: manifest: archlinux: add `bash-completion` package to base (Aaron Fiore)
65aa5ef9 client: Dockerfiles: remote: archlinux: add `bash-completion` package to base (Aaron Fiore)

client/Dockerfiles/remote/docker-finance/finance/Dockerfile.archlinux

@@ -49,6 +49,7 @@ RUN pacman -Syu \
 
 # Base packages
 RUN pacman -Syu \
+  bash-completion \
   bc \
   csvkit \
   vim \

client/docker-finance.yaml

@@ -36,6 +36,7 @@ container:
         commands:
       base:
         packages:
+          - "bash-completion"
           - "bc"
           - "csvkit"
           - "vim"

client/src/docker/completion.bash

@@ -17,6 +17,28 @@
 # You should have received a copy of the GNU General Public License
 # along with this program. If not, see <https://www.gnu.org/licenses/>.
 
+# TODO:
+#
+#  - Refactor using `bash-completion` "library" but keep backward compatibility,
+#    as this would otherwise break the "no more than 3 dependencies" approach to client-side `dfi`.
+#
+#  - When possible, add completion to existing `dfi` arguments that aren't completing
+#    * e.g., `dfi archlinux/${USER}:default edit type=` -> `dfi archlinux/${USER}:default edit type=rules...`
+#
+#  The not-so-straightforward resolution to this TODO hinges on the fact that
+#  the default delim for all `dfi` completion is the `=` character (which also exists in `COMP_WORDBREAKS`).
+#
+#  One resolution can be found in:
+#
+#    - https://github.com/scop/bash-completion/blob/c63826f8678e7d1fd36cf188bf1ba2eccaf2552e/completions-core/dd.bash
+#
+#  See also:
+#
+#   - https://github.com/scop/bash-completion/tree/main/completions-core
+#   - https://github.com/scop/bash-completion/blob/c63826f8678e7d1fd36cf188bf1ba2eccaf2552e/bash_completion#L1105-L1132
+#   - https://github.com/scop/bash-completion/blob/c63826f8678e7d1fd36cf188bf1ba2eccaf2552e/bash_completion#L1450-L1454
+#   - https://github.com/scop/bash-completion/blob/c63826f8678e7d1fd36cf188bf1ba2eccaf2552e/bash_completion#L2964-L2968
+
 # WARNING: because of completion, the docker-finance environment file
 # is never read. Ergo, for debugging, you'll need to run the following
 # with log-level 1 or 2:

container/src/finance/completion.bash

@@ -2,7 +2,7 @@
 
 # docker-finance | modern accounting for the power-user
 #
-# Copyright (C) 2024-2025 Aaron Fiore (Founder, Evergreen Crypto LLC)
+# Copyright (C) 2024-2026 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
@@ -17,6 +17,28 @@
 # You should have received a copy of the GNU General Public License
 # along with this program. If not, see <https://www.gnu.org/licenses/>.
 
+# TODO:
+#
+#  - Refactor using `bash-completion` "library".
+#    * i.e., remove direct access to COMP* and use what's available, etc.
+#
+#  - Add completion to existing `dfi` arguments that aren't completing.
+#    * e.g., `dfi profile/subprofile edit type=` -> `dfi profile/subprofile edit type=rules...`
+#
+#  The not-so-straightforward resolution to this TODO hinges on the fact that
+#  the default delim for all `dfi` completion is the `=` character (which also exists in `COMP_WORDBREAKS`).
+#
+#  One resolution can be found in:
+#
+#    - https://github.com/scop/bash-completion/blob/c63826f8678e7d1fd36cf188bf1ba2eccaf2552e/completions-core/dd.bash
+#
+#  See also:
+#
+#   - https://github.com/scop/bash-completion/tree/main/completions-core
+#   - https://github.com/scop/bash-completion/blob/c63826f8678e7d1fd36cf188bf1ba2eccaf2552e/bash_completion#L1105-L1132
+#   - https://github.com/scop/bash-completion/blob/c63826f8678e7d1fd36cf188bf1ba2eccaf2552e/bash_completion#L1450-L1454
+#   - https://github.com/scop/bash-completion/blob/c63826f8678e7d1fd36cf188bf1ba2eccaf2552e/bash_completion#L2964-L2968
+
 # shellcheck disable=SC2154
 [ "$DOCKER_FINANCE_DEBUG" == 2 ] && set -xv