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/root/test/unit/random.hh

@@ -0,0 +1,144 @@
+// 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)
+//! \note File intended to be loaded into ROOT.cern framework / Cling interpreter
+//! \since docker-finance 1.0.0
+
+#ifndef CONTAINER_SRC_ROOT_TEST_UNIT_RANDOM_HH_
+#define CONTAINER_SRC_ROOT_TEST_UNIT_RANDOM_HH_
+
+#include <gtest/gtest.h>
+
+#include <cstdint>
+#include <limits>
+#include <type_traits>
+
+#include "../common/random.hh"
+
+//! \namespace docker_finance
+//! \since docker-finance 1.0.0
+namespace docker_finance
+{
+//! \namespace docker_finance::tests
+//! \brief docker-finance common test framework
+//! \ingroup cpp_tests
+//! \since docker-finance 1.0.0
+namespace tests
+{
+//! \namespace docker_finance::tests::unit
+//! \brief docker-finance unit test cases
+//! \ingroup cpp_tests
+//! \since docker-finance 1.0.0
+namespace unit
+{
+//! \brief Generic random generator interface (specializations) fixture
+//! \since docker-finance 1.0.0
+template <typename t_interface>
+struct RandomInterfaceFixture : public ::testing::Test, protected t_interface
+{
+};
+
+//! \brief Primary random generator interface fixture w/ mockup impl
+//! \since docker-finance 1.0.0
+struct RandomInterface : public RandomInterfaceFixture<tests::RandomInterface>
+{
+};
+
+TEST_F(RandomInterface, generate)
+{
+  ASSERT_EQ(random.generate(), std::numeric_limits<uint32_t>::max());
+}
+
+//! \brief Generic random generator fixture
+//! \since docker-finance 1.0.0
+template <typename t_impl>
+struct RandomFixture : public ::testing::Test, protected t_impl
+{
+ protected:
+  void generate()
+  {
+    // NOTE: Why auto? Because no accidental type casting or under/overflow
+    auto one = t_impl::random.generate();
+    static_assert(std::is_same_v<decltype(one), uint32_t>);
+
+    auto two = t_impl::random.generate();
+    static_assert(std::is_same_v<decltype(two), uint32_t>);
+
+    ASSERT_LE(one, std::numeric_limits<uint32_t>::max());  // 0xFFFFFFFFul
+    ASSERT_GE(one, 0);
+
+    ASSERT_LE(two, std::numeric_limits<uint32_t>::max());
+    ASSERT_GE(two, 0);
+
+    // Exceedingly rare (tests the obvious, but is not an accurate entropy test)
+    ASSERT_NE(one, two);
+  };
+};
+
+//
+// Botan
+//
+
+//! \brief Botan random number fixture
+//! \since docker-finance 1.0.0
+struct RandomBotan : public RandomFixture<tests::RandomBotan_Impl>
+{
+};
+
+TEST_F(RandomBotan, generate)
+{
+  ASSERT_NO_THROW(generate());
+}
+
+//
+// Crypto++
+//
+
+//! \brief Crypto++ random number fixture
+//! \since docker-finance 1.0.0
+struct RandomCryptoPP : public RandomFixture<tests::RandomCryptoPP_Impl>
+{
+};
+
+TEST_F(RandomCryptoPP, generate)
+{
+  ASSERT_NO_THROW(generate());
+}
+
+//
+// libsodium
+//
+
+//! \brief libsodium random number fixture
+//! \since docker-finance 1.0.0
+struct RandomLibsodium : public RandomFixture<tests::RandomLibsodium_Impl>
+{
+};
+
+TEST_F(RandomLibsodium, generate)
+{
+  ASSERT_NO_THROW(generate());
+}
+}  // namespace unit
+}  // namespace tests
+}  // namespace docker_finance
+
+#endif  // CONTAINER_SRC_ROOT_TEST_UNIT_RANDOM_HH_
+
+// # vim: sw=2 sts=2 si ai et