Read-only mirrors. Development, issues and pull requests are on GitHub.

summaryrefslogtreecommitdiffhomepage
path: root/src/Progmasoft/Catch3/Generators/Vector.hpp
diff options
context:
space:
mode:
authorLeitwolf2026-10-02 15:53:33 +0300
committerGitHub2026-10-02 15:53:33 +0300
commit00bd15ded1dd732472156aece844e7696454bd3a (patch)
tree61e94c3bd1684b4caa256bc34e380c272b67cdb6 /src/Progmasoft/Catch3/Generators/Vector.hpp
parentfebb5b1e244174da0985b9994f8d5ed1676950e8 (diff)
parent5d55a3226360fae1eaa5ef91908b0fa7d7d07234 (diff)
downloadcatch3-00bd15ded1dd732472156aece844e7696454bd3a.tar.gz
Merge pull request #1 from Progmasoft/feature/property-combinators
Add composite property generators, single-trial replay and stable counterexample printing
Diffstat (limited to 'src/Progmasoft/Catch3/Generators/Vector.hpp')
-rw-r--r--src/Progmasoft/Catch3/Generators/Vector.hpp60
1 files changed, 60 insertions, 0 deletions
diff --git a/src/Progmasoft/Catch3/Generators/Vector.hpp b/src/Progmasoft/Catch3/Generators/Vector.hpp
new file mode 100644
index 00000000..65c81e3b
--- /dev/null
+++ b/src/Progmasoft/Catch3/Generators/Vector.hpp
@@ -0,0 +1,60 @@
+// Copyright (c) 2026 Progmasoft.
+// SPDX-License-Identifier: MPL-2.0 WITH AdditionRef-Progmasoft-Exception-1.1
+#pragma once
+
+#include <Progmasoft/Catch3/Detail/Sequence.hpp>
+#include <Progmasoft/Catch3/Generator.hpp>
+#include <cstddef>
+#include <utility>
+#include <vector>
+
+namespace Progmasoft::Catch3
+{
+
+ /// Generates vectors whose length lies in the inclusive size range and
+ /// whose elements come from @p element, drawn in index order.
+ ///
+ /// Shrinking first shortens the vector, then simplifies single elements
+ /// with the element generator's own candidates; see
+ /// Detail::ShrinkSequence for the exact order. A shrunk vector never
+ /// becomes shorter than @p minimumSize, so a property may rely on it.
+ template<typename ValueType>
+ [[nodiscard]] Generator<std::vector<ValueType>>
+ Vector(Generator<ValueType> element,
+ std::size_t minimumSize = 0,
+ std::size_t maximumSize = 32)
+ {
+ if (minimumSize > maximumSize)
+ {
+ Detail::RejectInvalidArgument(
+ "Vector requires minimumSize <= maximumSize");
+ }
+ if (maximumSize > Detail::kMaximumSequenceLength)
+ {
+ Detail::RejectInvalidArgument(
+ "Vector maximumSize exceeds the supported sequence length");
+ }
+
+ return MakeGenerator<std::vector<ValueType>>(
+ [element, minimumSize, maximumSize](Random &random) {
+ const std::size_t size
+ = random.Between(minimumSize, maximumSize);
+ std::vector<ValueType> values;
+ values.reserve(size);
+ for (std::size_t index = 0; index < size; ++index)
+ {
+ values.push_back(element.Generate(random));
+ }
+ return values;
+ },
+ [element, minimumSize](const std::vector<ValueType> &value) {
+ return Detail::ShrinkSequence(
+ value,
+ minimumSize,
+ [&element](const ValueType &item) {
+ return element.Shrink(item);
+ });
+ });
+ }
+
+} // namespace Progmasoft::Catch3