LUMIERA.clone/src/lib/random.cpp
Ichthyostega 9c74466778 Tests: build an link a test-support library
This is something I wanted to clean-up since a very long time indeed,
but always postponed it, since it requires a lot of nasty clean-up and disentangling....

Several parts had been stashed away into `src/lib/test`, which are not really related:
 * the testrunner and testsuite builder
 * generic helper utilities
 * specialised test-support facilities, e.g. the EventLog

This changeset introduces a new top-level test folder and a namespace `::test`
Code from this folder is linked into a shared library `libtestsupport.so`,
which resides in the linkage hierarchy between »Vessel« and »Vault«,
yet is no longer part of the Lumiera application and only linked into the test-suite.
2026-03-06 23:16:32 +01:00

111 lines
2.5 KiB
C++
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/*
random.cpp - storage and implementation for random number framework
Copyright (C)
2024, Hermann Vosseler <Ichthyostega@web.de>
  **Lumiera** 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 2 of the License, or (at your
  option) any later version. See the file COPYING for further details.
* *****************************************************************/
/** @file random.cpp
** Implementation details and common storage for random number generation.
** @todo 3/2024 work out how some executions or performances are configured reproducibly.
*/
#include "lib/random.hpp"
#include <string>
using std::string;
namespace lib {
namespace {
const string ENTROPY_SOURCE_SPEC{"/dev/random"};
class EntropyNucleus
: public SeedNucleus
{
std::random_device entropySource_;
uint64_t
getSeed() override
{
return entropySource_();
}
public:
EntropyNucleus(string const& SPEC)
: entropySource_{SPEC}
{ }
};
class EternalNucleus
: public SeedNucleus
{
uint64_t
getSeed() override
{
return LIFE_AND_UNIVERSE_4EVER;
}
};
/** static global entropy source instance */
EntropyNucleus entropyNucleus{ENTROPY_SOURCE_SPEC};
/// @todo this one should somehow be configurable
EternalNucleus eternalNucleus;
Random::Seed defaultNucleus{defaultGen};
}
Random defaultGen{eternalNucleus};
Random entropyGen{entropyNucleus};
SeedNucleus&
seedFromDefaultGen()
{
return defaultNucleus;
}
SeedNucleus::~SeedNucleus() { }
void
randomiseRandomness()
{
entropyGen.reseed(entropyNucleus);
defaultGen.reseed(entropyNucleus);
}
/**
* @remark this is a general-purpose util mostly used in unit-tests
* to generate a short string item that looks readable; probabilities
* of individual letters were chosen non-uniformely to improve readability.
*/
string
randStr (size_t len)
{
static const string alpha{"aaaabbccdddeeeeeffgghiiiiiijjkkllmmnnnoooopqqrrssttuuuuvwwxxxxxxxxxyyyyzz0123456789"};
static const size_t MAXCH{alpha.size()};
string garbage(len,'\0');
size_t p = len;
while (p)
garbage[--p] = alpha[rani (MAXCH)];
return garbage;
}
} // namespace lib