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

container/src/finance/lib/internal/fetch/utils/utils.php

@@ -0,0 +1,156 @@
+<?php
+
+// 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/>.
+
+/**
+ * @file
+ * @author Aaron Fiore (Founder, Evergreen Crypto LLC)
+ * @since docker-finance 1.0.0
+ */
+
+//! @since docker-finance 1.0.0
+namespace docker_finance\utils
+{
+    require_once('php/vendor/autoload.php');  //!< JsonCsv
+
+    /**
+     * @brief Environment mapper
+     * @details From CLI<->PHP
+     * @ingroup php_utils
+     * @since docker-finance 1.0.0
+     */
+    class Env
+    {
+        // @phpstan-ignore-next-line
+        private $env = [];  //!< Environment "map"
+
+        //! @brief Set environment (from shell environment)
+        public function set_env(string $key, string $value): void
+        {
+            $this->env[$key] = $value;
+        }
+
+        //! @return String value of given environment key
+        public function get_env(string $key): string
+        {
+            if (!array_key_exists($key, $this->env)) {
+                CLI::throw_fatal("invalid environment key");
+            }
+
+            return $this->env[$key];
+        }
+    }
+
+    /**
+     * @brief CLI logger
+     * @ingroup php_utils
+     * @since docker-finance 1.0.0
+     */
+    class CLI
+    {
+        public static function print_custom(string $message): void
+        {
+            fwrite(STDOUT, $message);
+        }
+
+        public static function print_normal(string $message): void
+        {
+            fwrite(STDOUT, "\e[0m$message\e[0m\n");
+        }
+
+        public static function print_info(string $message): void
+        {
+            fwrite(STDOUT, "\e[32m[INFO] $message\e[0m\n");
+        }
+
+        public static function print_warning(string $message): void
+        {
+            fwrite(STDOUT, "\e[33;1m[WARN] $message\e[0m\n");
+        }
+
+        public static function print_error(string $message): void
+        {
+            fwrite(STDERR, "\e[31;1m[ERROR] $message\e[0m\n");
+        }
+
+        public static function print_debug(mixed $message): void
+        {
+            if (getenv('DOCKER_FINANCE_DEBUG') == "true") {
+                $bt = debug_backtrace();
+                fwrite(STDERR, "\e[33m[DEBUG] {$bt[1]['file']}:{$bt[1]['line']} -> {$bt[1]['function']} -> ");
+
+                if (is_string($message)) {
+                    fwrite(STDERR, "$message \e[0m\n");
+                } else {
+                    print_r($message);
+                    fwrite(STDERR, "\e[0m\n");
+                }
+            }
+        }
+
+        public static function print_fatal(string $message): void
+        {
+            fwrite(STDERR, "\e[41;1m[FATAL] $message\e[0m\n");
+        }
+
+        // TODO: indicate to caller(s) that program will exit
+        public static function throw_fatal(string $message): void
+        {
+            throw new \Exception("\e[41;1m[FATAL] $message\e[0m\n");
+        }
+    }
+
+    /**
+     * @brief JSON handler
+     * @ingroup php_utils
+     * @since docker-finance 1.0.0
+     */
+    class Json
+    {
+        /**
+         * @brief Writes JSON data to CSV file
+         * @param string $data JSON encoded data
+         * @param string $file CSV file (path) to write
+         */
+        public static function write_csv(string $data, string $file): void
+        {
+            $tmpfile = tmpfile();
+            if (!$tmpfile) {
+                CLI::throw_fatal("could not create JSON tmpfile");
+            }
+
+            $tmp = stream_get_meta_data($tmpfile)['uri'];
+            file_put_contents($tmp, $data, LOCK_EX);
+
+            // Write CSV file
+            try {
+                $json = new \OzdemirBurak\JsonCsv\File\Json($tmp);
+                $json->setConversionKey('utf8_encoding', 'true');
+                $json->convertAndSave($file);
+                chmod($file, 0600);
+            } catch (\Throwable $e) {
+                CLI::print_fatal($e->getMessage());
+                fclose($tmpfile);
+            }
+
+            fclose($tmpfile);
+        }
+    }
+}  // namespace docker_finance\utils\error
+
+# vim: sw=4 sts=4 si ai et