docker-finance | modern accounting for the power-user
Dedicated to Michael Morgan: a beautiful, beautiful soul.
---
Internal signing keys:
Aaron Fiore (sole author)
- 518A22F85BEFD32BCC99C48603F90C4F35E0213E
- 31ECA5C347A0CC0815EDE730A3EACCFCDA7E685E
- C8187C585CB07A4DA81CC0F37318B50EBE9C0DA8
Internal repositories (rebased from):
Staging:
$ git log -n1 --pretty=format:"%H"
c8e0cd66f6c89fa7b3c62f72fb524a4cc454b7b6
$ git rev-list --max-parents=0 HEAD
ac3863b8c234755855f1aea3a07a853122decdf2
Private:
$ git log -n1 --pretty=format:"%H"
69bb3591eaa2990a9637832bb484690e00c4f926
$ git rev-list --max-parents=0 HEAD
a5c1cc9fb593c4cf09bc0adfef6cb6d2964511ae
This commit is contained in:
197
client/src/docker/docker.bash
Executable file
197
client/src/docker/docker.bash
Executable file
@@ -0,0 +1,197 @@
|
||||
#!/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/>.
|
||||
|
||||
#
|
||||
# Implementation
|
||||
#
|
||||
|
||||
source "$(dirname "$(realpath -s $0)")/src/docker/lib/lib_docker.bash" || exit 1
|
||||
|
||||
#
|
||||
# Execute
|
||||
#
|
||||
|
||||
function main()
|
||||
{
|
||||
[ -z "$global_basename" ] && lib_utils::die_fatal
|
||||
[ -z "$global_arg_delim_1" ] && lib_utils::die_fatal
|
||||
[ -z "$global_arg_delim_2" ] && lib_utils::die_fatal
|
||||
|
||||
local _usage="
|
||||
\e[32mDescription:\e[0m
|
||||
|
||||
The 'docker' in 'docker-finance'
|
||||
|
||||
\e[32mUsage:\e[0m
|
||||
|
||||
$ $global_basename <instance> <command> [args]
|
||||
|
||||
\e[32mInstance:\e[0m
|
||||
|
||||
<platform/user:tag>
|
||||
|
||||
platform \e[34;3mBase image platform (default: archlinux)\e[0m
|
||||
user \e[34;3mUser to bind-mount with (default: ${USER})\e[0m
|
||||
tag \e[34;3mImage tag type to use (default: latest)\e[0m
|
||||
|
||||
\e[32mCommand:\e[0m
|
||||
|
||||
Environment (all platforms):
|
||||
|
||||
gen \e[34;3mGenerate docker-finance environment\e[0m
|
||||
edit \e[34;3mEdit existing client-side configuration file [arg]\e[0m
|
||||
|
||||
All platforms:
|
||||
|
||||
build \e[34;3mBuild docker-finance image\e[0m
|
||||
backup \e[34;3mBackup existing instance image\e[0m
|
||||
rm \e[34;3mRemove image, remove network (also stops container, if running)\e[0m
|
||||
|
||||
up \e[34;3mCreate network, bring up unique container, open shell\e[0m
|
||||
down \e[34;3mStop and remove container, remove network\e[0m
|
||||
start \e[34;3mStart existing container\e[0m
|
||||
stop \e[34;3mStop running container\e[0m
|
||||
|
||||
run \e[34;3mSpawn a container with given command (container removed on exit)\e[0m
|
||||
shell \e[34;3mOpen shell into running container\e[0m
|
||||
|
||||
Dev-tools platform:
|
||||
|
||||
license \e[34;3mAdd a license to a docker-finance file\e[0m
|
||||
linter \e[34;3mLint docker-finance source files\e[0m
|
||||
doxygen \e[34;3mGenerate Doxygen for docker-finance file\e[0m
|
||||
|
||||
\e[32mOptional:\e[0m
|
||||
|
||||
[args] \e[34;3mCommand argument(s)\e[0m
|
||||
|
||||
\e[32mExamples:\e[0m
|
||||
|
||||
\e[37;2m#\e[0m
|
||||
\e[37;2m# Finance platform\e[0m
|
||||
\e[37;2m#\e[0m
|
||||
|
||||
\e[37;2m# Setup an alias for latest <platform${global_arg_delim_1}user:tag>\e[0m
|
||||
$ alias docker-finance=\"$0 archlinux${global_arg_delim_1}${USER}:latest\"
|
||||
|
||||
\e[37;2m# Generate environment and build image\e[0m
|
||||
$ docker-finance gen && docker-finance build
|
||||
|
||||
\e[37;2m# Bring up container, open shell (type 'exit' to leave)\e[0m
|
||||
$ docker-finance up
|
||||
|
||||
\e[37;2m# In another shell (or after you exit), open a container root shell\e[0m
|
||||
$ docker-finance shell user${global_arg_delim_2}root
|
||||
|
||||
\e[37;2m# In another shell (or after you exit), edit client/container variables\e[0m
|
||||
$ docker-finance edit type${global_arg_delim_2}env
|
||||
|
||||
\e[37;2m# Spawn a container with given command (removed after command finishes)\e[0m
|
||||
\e[37;2m# NOTE: incredibly useful when used with your host's crontab\e[0m
|
||||
$ docker-finance run 'finance family/alice fetch all=price'
|
||||
|
||||
\e[37;2m# Bring down running container (stop and remove container & network)\e[0m
|
||||
$ docker-finance down
|
||||
|
||||
\e[37;2m# Backup image, delete old image, build new image\e[0m
|
||||
$ docker-finance backup && docker-finance rm && docker-finance build
|
||||
|
||||
\e[37;2m#\e[0m
|
||||
\e[37;2m# Dev-tools platform\e[0m
|
||||
\e[37;2m#\e[0m
|
||||
|
||||
\e[37;2m# Setup an alias for dev-tools\e[0m
|
||||
$ alias docker-finance_dev-tools=\"$0 dev-tools${global_arg_delim_1}${USER}:latest\"
|
||||
|
||||
\e[37;2m# Generate environment and build image\e[0m
|
||||
$ docker-finance_dev-tools gen && docker-finance_dev-tools build
|
||||
|
||||
\e[37;2m# Spawn a container with given command (removed after command finishes)\e[0m
|
||||
$ docker-finance_dev-tools run 'shellcheck --version'
|
||||
|
||||
\e[37;2m# Lint entire docker-finance source\e[0m
|
||||
$ docker-finance_dev-tools linter type=bash,php,c++
|
||||
|
||||
\e[37;2m# Generate Doxygen for docker-finance source\e[0m
|
||||
$ docker-finance_dev-tools doxygen gen
|
||||
"
|
||||
|
||||
#
|
||||
# "Constructor" (initilizes client environment)
|
||||
#
|
||||
|
||||
lib_docker::docker "$@" || lib_utils::die_usage "$_usage"
|
||||
|
||||
#
|
||||
# Command facade
|
||||
#
|
||||
|
||||
[ -z "$global_command" ] && lib_utils::die_fatal
|
||||
case "$global_command" in
|
||||
gen)
|
||||
lib_docker::gen "${@:3}"
|
||||
;;
|
||||
edit)
|
||||
lib_docker::edit "${@:3}"
|
||||
;;
|
||||
build)
|
||||
lib_docker::build "${@:3}"
|
||||
;;
|
||||
up)
|
||||
lib_docker::up "${@:3}"
|
||||
;;
|
||||
down)
|
||||
lib_docker::down "${@:3}"
|
||||
;;
|
||||
start)
|
||||
lib_docker::start "${@:3}"
|
||||
;;
|
||||
stop)
|
||||
lib_docker::stop "${@:3}"
|
||||
;;
|
||||
rm)
|
||||
lib_docker::rm "${@:3}"
|
||||
;;
|
||||
run)
|
||||
lib_docker::run "${@:3}"
|
||||
;;
|
||||
shell)
|
||||
lib_docker::shell "${@:3}"
|
||||
;;
|
||||
backup)
|
||||
lib_docker::backup "${@:3}"
|
||||
;;
|
||||
license)
|
||||
lib_docker::license "${@:3}"
|
||||
;;
|
||||
linter)
|
||||
lib_docker::linter "${@:3}"
|
||||
;;
|
||||
doxygen)
|
||||
lib_docker::doxygen "${@:3}"
|
||||
;;
|
||||
*)
|
||||
lib_utils::die_usage "$_usage"
|
||||
;;
|
||||
esac
|
||||
}
|
||||
|
||||
main "$@"
|
||||
|
||||
# vim: sw=2 sts=2 si ai et
|
||||
Reference in New Issue
Block a user