| Files | Last commit | Last update |
|---|---|---|
| 11 months ago | ||
| 11 months ago | ||
| 11 months ago | ||
| 11 months ago | ||
| 11 months ago | ||
| 11 months ago | ||
| 10 months ago | ||
| 11 months ago | ||
| 10 months ago |
Runtime 模块测试
Copyright (c) 2025 Huawei Technologies Co., Ltd. openUBMC is licensed under Mulan PSL v2. You can use this software according to the terms and conditions of the Mulan PSL v2. You may obtain a copy of Mulan PSL v2 at: http://license.coscl.org.cn/MulanPSL2 THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE. See the Mulan PSL v2 for more details.
概述
本文档描述了 Runtime 模块的测试用例。Runtime 模块是 MC++ 库的运行时基础模块,提供了运行时上下文管理、执行器抽象、线程池管理、立即执行上下文等核心功能。
测试文件列表
Runtime 模块包含以下测试文件:
test_runtime_basic.cpp- 基本用法示例测试test_runtime_context.cpp- 运行时上下文测试test_executor.cpp- 执行器包装器测试test_any_executor.cpp- 轻量级执行器包装器测试test_thread_list.cpp- 线程列表管理测试
详细测试用例
test_runtime_basic.cpp
基本用法示例测试(4 个用例):
BasicUsageExample- 测试基本用法示例,包括 IO 执行器和 work 执行器的使用ExecutorObjectUsage- 测试执行器对象的使用方式ExecutorTagUsage- 测试执行器标签的使用方式EmbeddedSystemScenario- 测试嵌入式系统场景下的使用
test_runtime_context.cpp
运行时上下文测试(35 个用例,已优化):
BasicInitializeAndStart- 测试基础初始化和启动DuplicateStart- 测试重复启动IoExecutorBasicPost- 测试 IO 执行器基础 post 操作SystemExecutorBasicPost- 测试系统执行器基础 post 操作DeferOperation- 测试延迟操作DispatchOperation- 测试分发操作MultiThreadIoExecutor- 测试多线程 IO 执行器MixedExecutorUsage- 测试混合执行器使用ExecutorLifetime- 测试执行器生命周期DuplicateInitialize- 测试重复初始化EnsureStartFromUninitialized- 测试从未初始化状态确保启动EnsureStartFromInitialized- 测试从已初始化状态确保启动EnsureStartFromStopped- 测试从已停止状态确保启动(会抛出异常)StopWhenNotRunning- 测试未运行时停止JoinWhenEmpty- 测试空线程列表时 joinGetThreadCount- 测试获取线程数ZeroThreadsUsesDefault- 测试零线程使用默认值ThreadCountExceedsMax- 测试线程数超过最大值ImmediateExecutorBasic- 测试立即执行器基础功能ImmediateContextBasic- 测试立即上下文基础功能PostToContexts- 测试向上下文投递任务DeferToContexts- 测试向上下文延迟投递任务DispatchToContexts- 测试向上下文分发任务MakeStrands- 测试创建 strand 执行器ContextRestartAfterStop- 测试停止后上下文重启IsStoppedUninitialized- 测试未初始化状态的 is_stoppedDestructorWithoutStop- 测试未停止时的析构函数ThreadCountEdgeCases- 测试线程数边缘情况StartImplWithNonEmptyThreads- 测试线程列表非空时启动JoinWhenThreadListEmpty- 测试线程列表为空时 joinStartImplBothThreadListsNonEmpty- 测试两个线程列表都不为空时启动IsStoppedStateStopped- 测试停止状态的 is_stoppedThreadExceptionHandling- 测试线程异常处理
test_executor.cpp
执行器包装器测试(43 个用例,已优化):
BasicConstruction- 测试基础构造DefaultConstruction- 测试默认构造CopySemantics- 测试拷贝语义MoveSemantics- 测试移动语义PostOperation- 测试 post 操作DeferOperation- 测试 defer 操作DispatchOperation- 测试 dispatch 操作ComparisonOperations- 测试比较操作WrappingDifferentExecutorTypes- 测试包装不同类型的执行器StrandSerialExecution- 测试 strand 串行执行ExceptionHandling- 测试异常处理LifecycleManagement- 测试生命周期管理SharedSemantics- 测试共享语义CopyConstructionWithNullptr- 测试 nullptr 拷贝构造CopyAssignmentSelfAssignment- 测试自赋值拷贝CopyAssignmentWithNullptr- 测试 nullptr 拷贝赋值MoveAssignmentSelfAssignment- 测试自赋值移动EqualitySameImplPointer- 测试相同 impl 指针的相等性EqualityWithNullptr- 测试与 nullptr 的相等性InequalityOperator- 测试不等操作符WorkLifecycleWithNullptr- 测试 nullptr 的工作生命周期ContextWithNullptrThrows- 测试 nullptr 的 context 抛出异常DestructorWithMultipleReferences- 测试多引用的析构函数DestructorWithSingleReference- 测试单引用的析构函数CopyAssignmentBothNullptr- 测试两个 nullptr 的拷贝赋值CopyAssignmentReleaseReturnsFalse- 测试 release 返回 false 的拷贝赋值EqualityEqualReturnsFalse- 测试 equal 返回 false 的相等性(已合并EqualDifferentTypes的功能)ContextThrowsException- 测试 context 抛出异常EqualityOneNullptr- 测试一个 nullptr 的相等性EqualityBothNonNullptrDifferent- 测试两个非 nullptr 但不同的相等性CopyAssignmentSelf- 测试自赋值拷贝CopyAssignmentThisNullptr- 测试 this 为 nullptr 的拷贝赋值CopyAssignmentReleaseReturnsTrue- 测试 release 返回 true 的拷贝赋值CopyAssignmentOtherNullptr- 测试 other 为 nullptr 的拷贝赋值CopyAssignmentOtherNonNullptr- 测试 other 非 nullptr 的拷贝赋值MoveAssignmentSelf- 测试自赋值移动MoveAssignmentOtherNullptr- 测试 other 为 nullptr 的移动赋值OnWorkStartedWithValidExecutor- 测试有效执行器的 on_work_startedOnWorkFinishedWithValidExecutor- 测试有效执行器的 on_work_finishedContextWithValidExecutor- 测试有效执行器的 contextPostDeferDispatchInvalidExecutor- 测试无效执行器的 post/defer/dispatchPostDeferDispatchWithCustomAllocator- 测试自定义分配器的 post/defer/dispatch
test_any_executor.cpp
轻量级执行器包装器测试(39 个用例):
BasicConstruction- 测试基础构造DefaultConstruction- 测试默认构造CopySemantics- 测试拷贝语义MoveSemantics- 测试移动语义PostOperation- 测试 post 操作DeferOperation- 测试 defer 操作DispatchOperation- 测试 dispatch 操作ComparisonOperations- 测试比较操作StrandWrapping- 测试 strand 包装ValidWithInvalidRuntimeExecutor- 测试无效 runtime executor 的 validEqualitySameTypeSameValue- 测试相同类型相同值的相等性InequalityOperator- 测试不等操作符WorkLifecycleWithMonostate- 测试 monostate 的工作生命周期ContextWithMonostateThrows- 测试 monostate 的 context 抛出异常OperationsWithMonostateThrows- 测试 monostate 的操作抛出异常ConstructionFromSystemExecutor- 测试从 system executor 构造ConstructionFromRuntimeExecutor- 测试从 runtime executor 构造EqualitySameTypeDifferentValue- 测试相同类型不同值的相等性EqualityMonostateBoth- 测试两个 monostate 的相等性EqualitySameExecutor- 测试相同执行器的相等性ValidBoostAsioExecutor- 测试 boost::asio 执行器的 validConstructionFromArbitraryExecutor- 测试从任意执行器构造ValidRuntimeExecutorReturnsFalse- 测试 runtime executor valid 返回 falseValidRuntimeExecutorReturnsTrue- 测试 runtime executor valid 返回 trueEqualitySameIndexDifferentExec- 测试相同 index 不同执行器的相等性EqualitySameIndexSameExec- 测试相同 index 相同执行器的相等性SystemExecutorContext- 测试 system executor 的 contextRuntimeExecutorContext- 测试 runtime executor 的 contextSystemExecutorValid- 测试 system executor 的 validSystemExecutorEquality- 测试 system executor 的相等性RuntimeExecutorEquality- 测试 runtime executor 的相等性SystemExecutorOnWorkStarted- 测试 system executor 的 on_work_startedRuntimeExecutorOnWorkStarted- 测试 runtime executor 的 on_work_startedSystemExecutorOnWorkFinished- 测试 system executor 的 on_work_finishedRuntimeExecutorOnWorkFinished- 测试 runtime executor 的 on_work_finishedConstGetExecutor- 测试 const 版本的 get_executorTemplateConstructor- 测试模板构造函数PostDeferDispatchAllExecutorTypes- 测试所有执行器类型的 post/defer/dispatchPostDeferDispatchWithCustomAllocator- 测试自定义分配器的 post/defer/dispatch
test_thread_list.cpp
线程列表管理测试(32 个用例,已优化):
ThreadNodeBasic- 测试线程节点基础功能ThreadNodeMove- 测试线程节点移动ThreadNodeJoinable- 测试线程节点可 join 性ThreadNodeGetId- 测试线程节点获取 IDThreadNodeJoinWhenNotJoinable- 测试不可 join 时 joinThreadListBasic- 测试线程列表基础功能StartThreadsWithoutIndex- 测试不带索引启动线程StartThreadsWithIndex- 测试带索引启动线程AddThread- 测试添加线程RemoveThreadSuccess- 测试成功移除线程(已合并RemoveThreadFound的功能)RemoveThreadWithNullptr- 测试移除 nullptr 线程RemoveThreadNotInList- 测试移除不在列表中的线程(已合并RemoveThreadNotFound的功能)JoinAll- 测试等待所有线程Clear- 测试清空线程列表GetThreadCount- 测试获取线程数Empty- 测试检查线程列表是否为空VisitThreads- 测试访问线程VisitThreadsConst- 测试常量访问线程JoinAllWhenEmpty- 测试空列表时 join allClearWhenEmpty- 测试空列表时 clearMixedAddRemove- 测试混合添加和移除DestructorWaitsForThreads- 测试析构函数等待线程ThreadNodeDestructorNotJoinable- 测试不可 join 的线程节点析构StartThreadsZeroCount- 测试零线程数启动StartThreadsZeroCountWithIndex- 测试零线程数带索引启动ClearThenReuse- 测试清空后重用VisitThreadsEmpty- 测试访问空线程列表VisitThreadsConstEmpty- 测试常量访问空线程列表ThreadNodeDestructorJoinable- 测试可 join 的线程节点析构ThreadNodeJoinWhenJoinable- 测试可 join 时 joinRemoveThreadFoundInLoop- 测试在循环中找到并移除线程RemoveThreadNotFoundAfterLoop- 测试循环后未找到线程
运行测试
运行所有 runtime 模块测试
# 运行所有模块测试
meson test -C builddir
# 或者使用 ninja
ninja -C builddir test
注意:
- meson 构建配置中只有一个测试注册(
libmcpp unit tests),不能使用--suite runtime运行特定模块测试 - 要通过 meson 传递参数给测试可执行文件,使用
--test-args选项 - 推荐直接运行可执行文件,更简单直接
运行特定测试文件
# 测试基本用法(所有用例)- 直接运行可执行文件(推荐)
./builddir/tests/libmcpp_test --gtest_filter="RuntimeBasicTest.*"
# 或通过 meson 传递参数
meson test -C builddir --test-args="--gtest_filter=RuntimeBasicTest.*"
# 测试运行时上下文(所有用例)
./builddir/tests/libmcpp_test --gtest_filter="RuntimeContextTest.*"
meson test -C builddir --test-args="--gtest_filter=RuntimeContextTest.*"
# 测试执行器包装器(所有用例)
./builddir/tests/libmcpp_test --gtest_filter="ExecutorTest.*"
meson test -C builddir --test-args="--gtest_filter=ExecutorTest.*"
# 测试轻量级执行器包装器(所有用例)
./builddir/tests/libmcpp_test --gtest_filter="AnyExecutorTest.*"
meson test -C builddir --test-args="--gtest_filter=AnyExecutorTest.*"
# 测试线程列表管理(所有用例)
./builddir/tests/libmcpp_test --gtest_filter="ThreadListTest.*"
meson test -C builddir --test-args="--gtest_filter=ThreadListTest.*"
运行特定测试用例
# 使用 gtest 过滤器运行特定用例(直接运行可执行文件,推荐)
./builddir/tests/libmcpp_test --gtest_filter="RuntimeContextTest.BasicInitializeAndStart"
# 或通过 meson 传递参数
meson test -C builddir --test-args="--gtest_filter=RuntimeContextTest.BasicInitializeAndStart"
# 运行多个测试用例(使用通配符)
./builddir/tests/libmcpp_test --gtest_filter="ExecutorTest.Copy*"
meson test -C builddir --test-args="--gtest_filter=ExecutorTest.Copy*"
测试统计
- 测试文件总数: 5 个
- 测试用例总数: 129 个(已优化,删除了重复的测试用例)
- 测试覆盖的功能模块:
- Runtime Context(运行时上下文)
- Executor(执行器包装器)
- Any Executor(轻量级执行器包装器)
- Thread List(线程列表管理)
- Immediate Context/Executor(立即执行上下文和执行器)
代码覆盖率
当前测试覆盖率:
- Line Coverage: 约 78.2%
- Branch Coverage: 约 33.5%
- Function Coverage: 约 93.6%
调试测试
# 使用 gdb 调试测试
gdb --args ./builddir/tests/libmcpp_test --gtest_filter="RuntimeContextTest.BasicInitializeAndStart"
# 启用详细输出(直接运行可执行文件)
./builddir/tests/libmcpp_test --gtest_filter="RuntimeContextTest.*" --verbose
# 或通过 meson 启用详细输出
meson test -C builddir --verbose --test-args="--gtest_filter=RuntimeContextTest.*"
测试注意事项
- meson test 命令格式: meson 构建配置中只有一个测试注册(
libmcpp unit tests),要传递参数给测试可执行文件,使用--test-args选项。格式:meson test -C builddir --test-args="--gtest_filter=..."。注意不要在--test-args中使用引号包裹整个参数,gtest_filter 的值可以用引号。 - 直接运行可执行文件: 推荐直接运行
./builddir/tests/libmcpp_test,这样更简单直接,不需要通过 meson。 - 并发测试:
test_thread_list.cpp包含并发安全性测试,需要多线程环境支持。 - runtime_context 生命周期:
test_runtime_context.cpp测试 runtime_context 的完整生命周期,包括初始化、启动、停止和清理。测试使用TestWithRuntime基类,在测试前后自动管理 runtime_context 的状态。 - 执行器引用计数:
test_executor.cpp测试执行器的引用计数机制,包括拷贝、移动和析构时的引用计数管理。 - variant 类型执行器:
test_any_executor.cpp测试使用std::variant实现的轻量级执行器包装器,避免虚函数开销。 - 线程异常处理:
test_runtime_context.cpp中的ThreadExceptionHandling测试验证线程中的异常处理机制,确保异常不会导致程序崩溃。 - 测试隔离: runtime 模块的测试使用
TestWithRuntime基类,在测试前后自动重置 runtime_context 状态,确保测试之间的独立性。 - 线程池管理:
test_thread_list.cpp测试线程池的生命周期管理,包括启动、停止、清理和并发操作。 - 执行器类型: runtime 模块支持多种执行器类型,包括 boost::asio 执行器、strand 执行器、immediate 执行器等,测试覆盖了各种执行器的使用场景。