Test ns3 configuration options. More...

Inheritance diagram for test-ns3.NS3ConfigureTestCase:

Collaboration diagram for test-ns3.NS3ConfigureTestCase:

Public Member Functions
	setUp (self)
	Reuse cleaning/release configuration from NS3BaseTestCase if flag is cleaned.

	test_01_Examples (self)
	Test enabling and disabling examples.

	test_02_Tests (self)
	Test enabling and disabling tests.

	test_03_EnableModules (self)
	Test enabling specific modules.

	test_04_DisableModules (self)
	Test disabling specific modules.

	test_05_EnableModulesComma (self)
	Test enabling comma-separated (waf-style) examples.

	test_06_DisableModulesComma (self)
	Test disabling comma-separated (waf-style) examples.

	test_07_Ns3rc (self)
	Test loading settings from the ns3rc config file.

	test_08_DryRun (self)
	Test dry-run (printing commands to be executed instead of running them)

	test_09_PropagationOfReturnCode (self)
	Test if ns3 is propagating back the return code from the executables called with the run command.

	test_10_CheckConfig (self)
	Test passing 'show config' argument to ns3 to get the configuration table.

	test_11_CheckProfile (self)
	Test passing 'show profile' argument to ns3 to get the build profile.

	test_12_CheckVersion (self)
	Test passing 'show version' argument to ns3 to get the build version.

	test_13_Scratches (self)
	Test if CMake target names for scratches and ns3 shortcuts are working correctly.

	test_14_MpiCommandTemplate (self)
	Test if ns3 is inserting additional arguments by MPICH and OpenMPI to run on the CI.

	test_15_InvalidLibrariesToLink (self)
	Test if CMake and ns3 fail in the expected ways when:

	test_16_LibrariesContainingLib (self)
	Test if CMake can properly handle modules containing "lib", which is used internally as a prefix for module libraries.

	test_17_CMakePerformanceTracing (self)
	Test if CMake performance tracing works and produces the cmake_performance_trace.log file.

	test_18_CheckBuildVersionAndVersionCache (self)
	Check if ENABLE_BUILD_VERSION and version.cache are working as expected.

	test_19_FilterModuleExamplesAndTests (self)
	Test filtering in examples and tests from specific modules.

	test_20_CheckFastLinkers (self)
	Check if fast linkers LLD and Mold are correctly found and configured.

	test_21_ClangTimeTrace (self)
	Check if NS3_CLANG_TIMETRACE feature is working Clang's -ftime-trace plus ClangAnalyzer report.

	test_22_NinjaTrace (self)
	Check if NS3_NINJA_TRACE feature is working Ninja's .ninja_log conversion to about://tracing json format conversion with Ninjatracing.

	test_23_PrecompiledHeaders (self)
	Check if precompiled headers are being enabled correctly.

	test_24_CheckTestSettings (self)
	Check for regressions in test object build.

	test_25_CheckBareConfig (self)
	Check for regressions in a bare ns-3 configuration.

Public Member Functions inherited from test-ns3.NS3BaseTestCase
	config_ok (self, return_code, stdout, stderr)
	Check if configuration for release mode worked normally.

Public Attributes
	ns3_executables
	ns3_executables

	ns3_modules
	ns3_modules

	type
	type contains the ns3rc variant type (deprecated python-based or current cmake-based)

Public Attributes inherited from test-ns3.NS3BaseTestCase
	ns3_executables
	ns3_executables holds a list of executables in .lock-ns3 # noqa

	ns3_modules
	ns3_modules holds a list to the modules enabled stored in .lock-ns3 # noqa

Detailed Description

Test ns3 configuration options.

Definition at line 835 of file test-ns3.py.

Member Function Documentation

◆ setUp()

test-ns3.NS3ConfigureTestCase.setUp ( self )

Reuse cleaning/release configuration from NS3BaseTestCase if flag is cleaned.

Returns: None

Reimplemented from test-ns3.NS3BaseTestCase.

Definition at line 840 of file test-ns3.py.

References test-ns3.NS3ConfigureTestCase.setUp().

Referenced by test-ns3.NS3ConfigureTestCase.setUp().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ test_01_Examples()

test-ns3.NS3ConfigureTestCase.test_01_Examples ( self )

Test enabling and disabling examples.

Returns: None

Definition at line 847 of file test-ns3.py.

References test-ns3.NS3BaseTestCase.config_ok(), and test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_02_Tests()

test-ns3.NS3ConfigureTestCase.test_02_Tests ( self )

Test enabling and disabling tests.

Returns: None

Definition at line 870 of file test-ns3.py.

References test-ns3.NS3BaseTestCase.config_ok(), and test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_03_EnableModules()

test-ns3.NS3ConfigureTestCase.test_03_EnableModules ( self )

Test enabling specific modules.

Returns: None

Definition at line 897 of file test-ns3.py.

References test-ns3.NS3BaseTestCase.config_ok(), test-ns3.get_enabled_modules(), and test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_04_DisableModules()

test-ns3.NS3ConfigureTestCase.test_04_DisableModules ( self )

Test disabling specific modules.

Returns: None

Definition at line 929 of file test-ns3.py.

References test-ns3.NS3BaseTestCase.config_ok(), test-ns3.get_enabled_modules(), test-ns3.NS3BaseTestCase.ns3_modules, test-ns3.NS3ConfigureTestCase.ns3_modules, test-ns3.NS3ExpectedUseTestCase.ns3_modules, and test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_05_EnableModulesComma()

test-ns3.NS3ConfigureTestCase.test_05_EnableModulesComma ( self )

Test enabling comma-separated (waf-style) examples.

Returns: None

Definition at line 953 of file test-ns3.py.

References test-ns3.NS3BaseTestCase.config_ok(), test-ns3.get_enabled_modules(), test-ns3.NS3BaseTestCase.ns3_modules, test-ns3.NS3ConfigureTestCase.ns3_modules, test-ns3.NS3ExpectedUseTestCase.ns3_modules, and test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_06_DisableModulesComma()

test-ns3.NS3ConfigureTestCase.test_06_DisableModulesComma ( self )

Test disabling comma-separated (waf-style) examples.

Returns: None

Definition at line 977 of file test-ns3.py.

References test-ns3.NS3BaseTestCase.config_ok(), test-ns3.get_enabled_modules(), test-ns3.NS3BaseTestCase.ns3_modules, test-ns3.NS3ConfigureTestCase.ns3_modules, test-ns3.NS3ExpectedUseTestCase.ns3_modules, and test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_07_Ns3rc()

test-ns3.NS3ConfigureTestCase.test_07_Ns3rc ( self )

Test loading settings from the ns3rc config file.

Returns: None

Definition at line 1001 of file test-ns3.py.

◆ test_08_DryRun()

test-ns3.NS3ConfigureTestCase.test_08_DryRun ( self )

Test dry-run (printing commands to be executed instead of running them)

Returns: None

Definition at line 1163 of file test-ns3.py.

References test-ns3.cmake_build_target_command, test-ns3.get_programs_list(), and test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_09_PropagationOfReturnCode()

test-ns3.NS3ConfigureTestCase.test_09_PropagationOfReturnCode ( self )

Test if ns3 is propagating back the return code from the executables called with the run command.

Returns: None

Definition at line 1219 of file test-ns3.py.

References test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_10_CheckConfig()

test-ns3.NS3ConfigureTestCase.test_10_CheckConfig ( self )

Test passing 'show config' argument to ns3 to get the configuration table.

Returns: None

Definition at line 1294 of file test-ns3.py.

References test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_11_CheckProfile()

test-ns3.NS3ConfigureTestCase.test_11_CheckProfile ( self )

Test passing 'show profile' argument to ns3 to get the build profile.

Returns: None

Definition at line 1303 of file test-ns3.py.

References test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_12_CheckVersion()

test-ns3.NS3ConfigureTestCase.test_12_CheckVersion ( self )

Test passing 'show version' argument to ns3 to get the build version.

Returns: None

Definition at line 1312 of file test-ns3.py.

References test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_13_Scratches()

test-ns3.NS3ConfigureTestCase.test_13_Scratches ( self )

Test if CMake target names for scratches and ns3 shortcuts are working correctly.

Returns: None

Definition at line 1327 of file test-ns3.py.

References test-ns3.run_ns3(), and test-ns3.run_program().

Here is the call graph for this function:

◆ test_14_MpiCommandTemplate()

test-ns3.NS3ConfigureTestCase.test_14_MpiCommandTemplate ( self )

Test if ns3 is inserting additional arguments by MPICH and OpenMPI to run on the CI.

Returns: None

Definition at line 1432 of file test-ns3.py.

References test-ns3.get_programs_list(), and test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_15_InvalidLibrariesToLink()

test-ns3.NS3ConfigureTestCase.test_15_InvalidLibrariesToLink ( self )

Test if CMake and ns3 fail in the expected ways when:

examples from modules or general examples fail if they depend on a library with a name shorter than 4 characters or are disabled when a library is nonexistent
a module library passes the configuration but fails to build due to a missing library
Returns
None

Definition at line 1489 of file test-ns3.py.

References test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_16_LibrariesContainingLib()

test-ns3.NS3ConfigureTestCase.test_16_LibrariesContainingLib ( self )

Test if CMake can properly handle modules containing "lib", which is used internally as a prefix for module libraries.

Returns: None

Definition at line 1600 of file test-ns3.py.

References test-ns3.cmake_build_target_command, and test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_17_CMakePerformanceTracing()

test-ns3.NS3ConfigureTestCase.test_17_CMakePerformanceTracing ( self )

Test if CMake performance tracing works and produces the cmake_performance_trace.log file.

Returns: None

Definition at line 1646 of file test-ns3.py.

References test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_18_CheckBuildVersionAndVersionCache()

test-ns3.NS3ConfigureTestCase.test_18_CheckBuildVersionAndVersionCache ( self )

Check if ENABLE_BUILD_VERSION and version.cache are working as expected.

Returns: None

Definition at line 1667 of file test-ns3.py.

◆ test_19_FilterModuleExamplesAndTests()

test-ns3.NS3ConfigureTestCase.test_19_FilterModuleExamplesAndTests ( self )

Test filtering in examples and tests from specific modules.

Returns: None

Definition at line 1749 of file test-ns3.py.

References test-ns3.NS3BaseTestCase.config_ok(), test-ns3.get_enabled_modules(), test-ns3.get_programs_list(), test-ns3.NS3BaseTestCase.ns3_executables, test-ns3.NS3BuildBaseTestCase.ns3_executables, test-ns3.NS3ConfigureTestCase.ns3_executables, test-ns3.NS3ExpectedUseTestCase.ns3_executables, test-ns3.NS3BaseTestCase.ns3_modules, test-ns3.NS3ConfigureTestCase.ns3_modules, test-ns3.NS3ExpectedUseTestCase.ns3_modules, and test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_20_CheckFastLinkers()

test-ns3.NS3ConfigureTestCase.test_20_CheckFastLinkers ( self )

Check if fast linkers LLD and Mold are correctly found and configured.

Returns: None

Definition at line 1797 of file test-ns3.py.

References test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_21_ClangTimeTrace()

test-ns3.NS3ConfigureTestCase.test_21_ClangTimeTrace ( self )

Check if NS3_CLANG_TIMETRACE feature is working Clang's -ftime-trace plus ClangAnalyzer report.

Returns: None

Definition at line 1864 of file test-ns3.py.

References test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_22_NinjaTrace()

test-ns3.NS3ConfigureTestCase.test_22_NinjaTrace ( self )

Check if NS3_NINJA_TRACE feature is working Ninja's .ninja_log conversion to about://tracing json format conversion with Ninjatracing.

Returns: None

Definition at line 1923 of file test-ns3.py.

References test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_23_PrecompiledHeaders()

test-ns3.NS3ConfigureTestCase.test_23_PrecompiledHeaders ( self )

Check if precompiled headers are being enabled correctly.

Returns: None

Definition at line 2011 of file test-ns3.py.

References test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_24_CheckTestSettings()

test-ns3.NS3ConfigureTestCase.test_24_CheckTestSettings ( self )

Check for regressions in test object build.

Returns: None

Definition at line 2030 of file test-ns3.py.

References test-ns3.run_ns3().

Here is the call graph for this function:

◆ test_25_CheckBareConfig()

test-ns3.NS3ConfigureTestCase.test_25_CheckBareConfig ( self )

Check for regressions in a bare ns-3 configuration.

Returns: None

Definition at line 2045 of file test-ns3.py.

References test-ns3.NS3BaseTestCase.config_ok(), and test-ns3.run_ns3().

Here is the call graph for this function:

Member Data Documentation

◆ ns3_executables

test-ns3.NS3ConfigureTestCase.ns3_executables

ns3_executables

Definition at line 859 of file test-ns3.py.

Referenced by test-ns3.NS3BuildBaseTestCase.test_07_OutputDirectory(), test-ns3.NS3ExpectedUseTestCase.test_14_EnableSudo(), and test-ns3.NS3ConfigureTestCase.test_19_FilterModuleExamplesAndTests().

◆ ns3_modules

test-ns3.NS3ConfigureTestCase.ns3_modules

ns3_modules

Definition at line 911 of file test-ns3.py.

Referenced by test-ns3.NS3ConfigureTestCase.test_04_DisableModules(), test-ns3.NS3ConfigureTestCase.test_05_EnableModulesComma(), test-ns3.NS3ConfigureTestCase.test_06_DisableModulesComma(), and test-ns3.NS3ConfigureTestCase.test_19_FilterModuleExamplesAndTests().

◆ type

test-ns3.NS3ConfigureTestCase.type

type contains the ns3rc variant type (deprecated python-based or current cmake-based)

Definition at line 1035 of file test-ns3.py.

The documentation for this class was generated from the following file:

utils/tests/test-ns3.py

Public Member Functions

Public Attributes

Detailed Description

Member Function Documentation

◆ setUp()

◆ test_01_Examples()

◆ test_02_Tests()

◆ test_03_EnableModules()

◆ test_04_DisableModules()

◆ test_05_EnableModulesComma()

◆ test_06_DisableModulesComma()

◆ test_07_Ns3rc()

◆ test_08_DryRun()

◆ test_09_PropagationOfReturnCode()

◆ test_10_CheckConfig()

◆ test_11_CheckProfile()

◆ test_12_CheckVersion()

◆ test_13_Scratches()

◆ test_14_MpiCommandTemplate()

◆ test_15_InvalidLibrariesToLink()

◆ test_16_LibrariesContainingLib()

◆ test_17_CMakePerformanceTracing()

◆ test_18_CheckBuildVersionAndVersionCache()

◆ test_19_FilterModuleExamplesAndTests()

◆ test_20_CheckFastLinkers()

◆ test_21_ClangTimeTrace()

◆ test_22_NinjaTrace()

◆ test_23_PrecompiledHeaders()

◆ test_24_CheckTestSettings()

◆ test_25_CheckBareConfig()

Member Data Documentation

◆ ns3_executables

◆ ns3_modules

◆ type