Integration tests for command-line parameter override functionality. More...

Inherits org.lflang.tests.TestBase.

Public Member Functions
	CCliTest ()
void	testCommandLineActionOverride ()
	Test that –min_delay and –min_spacing override action timing.
void	testCommandLineDeadlineFederatedOverride ()
	Test that CLI overrides propagate through the launch script in federated execution.
void	testCommandLineDeadlineOverride ()
	Test that –deadline_time and –execution_time override deadline behavior.
void	testCommandLineParameterOverride ()
	Test that –period, –expected, and –value override timer behavior and double parameter.
void	testCommandLineStringBoolOverride ()
	Test that –value and –use_default override string and bool parameters.

Static Public Member Functions
static TestLevel	pathToLevel (Path path)
	Static function for converting a path to its associated test level.
static void	runSingleTestAndPrintResults (LFTest test, Class<? extends TestBase > testClass, TestLevel level)
	Run a test, print results on stderr.
static String	stackTraceToString (Throwable t)

Static Public Attributes
static final String	THICK_LINE
	Content separator used in test output, 78 characters wide.
static final String	THIN_LINE
	Content separator used in test output, 78 characters wide.

Protected Member Functions
void	applyDefaultConfiguration (TargetConfig config)
	Adjust target configuration for all runs of this test class.
ProcessBuilder	getExecCommand (LFTest test) throws TestError
	Return a preconfigured ProcessBuilder for executing the test program.
GeneratorArguments	getGeneratorArguments ()
	Return generator arguments suitable for testing.
final void	runTestsAndPrintResults (Target target, Predicate< TestCategory > selected, TestLevel level, Transformer transformer, Configurator configurator, boolean copy)
	Run selected tests for a given target and configurator up to the specified level.
void	runTestsFor (List< Target > subset, String description, Predicate< TestCategory > selected, Transformer transformer, Configurator configurator, TestLevel level, boolean copy)
	Run tests in the given selection for a subset of given targets.
void	runTestsForTargets (String description, Predicate< TestCategory > selected, Transformer transformer, Configurator configurator, TestLevel level, boolean copy)
	Run tests in the given selection for all targets enabled in this class.
boolean	supportsSingleThreadedExecution ()
	Whether to enable threading.

Static Protected Member Functions
static boolean	isLinux ()
	Determine whether the current platform is Linux.
static boolean	isMac ()
	Determine whether the current platform is MacOS.
static boolean	isWindows ()
	Determine whether the current platform is Windows.
static void	printTestHeader (Target target, String description)
	Print a header that describes a collection of tests.

Package Functions
void	resetCliArgs ()

Package Attributes
JavaIoFileSystemAccess	fileAccess
LFGenerator	generator
Provider< ResourceSet >	resourceSetProvider
TestRegistry	testRegistry
IResourceValidator	validator

Detailed Description

Integration tests for command-line parameter override functionality.

Verifies that main reactor parameters can be overridden via command-line arguments and that the overridden values propagate correctly to child reactors, including timers and deadlines.

Uses a ThreadLocal so that the CLI arguments set in each test method are visible to the runner instance created reflectively by TestBase#runSingleTestAndPrintResults, which executes on the same thread. This is safe for concurrent test execution.

Author: Edward A. Lee

Constructor & Destructor Documentation

◆ CCliTest()

org.lflang.tests.runtime.CCliTest.CCliTest ( )

Member Function Documentation

◆ applyDefaultConfiguration()

void org.lflang.tests.TestBase.applyDefaultConfiguration ( TargetConfig config )

protectedinherited

Adjust target configuration for all runs of this test class.

Reimplemented in org.lflang.tests.runtime.PythonTest, and org.lflang.tests.serialization.SerializationTest.

◆ getExecCommand()

ProcessBuilder org.lflang.tests.runtime.CCliTest.getExecCommand ( LFTest test ) throws TestError

protected

Return a preconfigured ProcessBuilder for executing the test program.

Parameters

test	The test to get the execution command for.

Reimplemented from org.lflang.tests.TestBase.

◆ getGeneratorArguments()

GeneratorArguments org.lflang.tests.TestBase.getGeneratorArguments ( )

protectedinherited

Return generator arguments suitable for testing.

◆ isLinux()

boolean org.lflang.tests.TestBase.isLinux ( )

staticprotectedinherited

Determine whether the current platform is Linux.

Returns: true if the current platform is Linux, false otherwise.

◆ isMac()

boolean org.lflang.tests.TestBase.isMac ( )

staticprotectedinherited

Determine whether the current platform is MacOS.

Returns: true if the current platform is MacOS, false otherwise.

◆ isWindows()

boolean org.lflang.tests.TestBase.isWindows ( )

staticprotectedinherited

Determine whether the current platform is Windows.

Returns: true if the current platform is Windwos, false otherwise.

◆ pathToLevel()

TestLevel org.lflang.tests.TestBase.pathToLevel ( Path path )

staticinherited

Static function for converting a path to its associated test level.

Author: Anirudh Rengarajan

◆ printTestHeader()

void org.lflang.tests.TestBase.printTestHeader	(	Target	target,
		String	description )

staticprotectedinherited

Print a header that describes a collection of tests.

Parameters

target	The target for which the tests are being performed.
description	A string the describes the collection of tests.

◆ resetCliArgs()

void org.lflang.tests.runtime.CCliTest.resetCliArgs ( )

package

◆ runSingleTestAndPrintResults()

void org.lflang.tests.TestBase.runSingleTestAndPrintResults	(	LFTest	test,
		Class<? extends TestBase >	testClass,
		TestLevel	level )

staticinherited

Run a test, print results on stderr.

Parameters

test	Test case.
testClass	The test class that will execute the test. This is target-specific, it may provide some target-specific configuration. We pass a class and not a new instance because this method needs to ensure the object is properly injected, and so, it needs to control its entire lifecycle.
level	Level to which to run the test.

◆ runTestsAndPrintResults()

final void org.lflang.tests.TestBase.runTestsAndPrintResults	(	Target	target,
		Predicate< TestCategory >	selected,
		TestLevel	level,
		Transformer	transformer,
		Configurator	configurator,
		boolean	copy )

protectedinherited

Run selected tests for a given target and configurator up to the specified level.

Parameters

target	The target to run tests for.
selected	A predicate that given a test category returns whether it should be included in this test run or not.
level	The test level.
transformer	The transformer to apply to tests.
configurator	A procedure for configuring the tests.
copy	Whether to work on copies of tests in the test. registry.

◆ runTestsFor()

void org.lflang.tests.TestBase.runTestsFor	(	List< Target >	subset,
		String	description,
		Predicate< TestCategory >	selected,
		Transformer	transformer,
		Configurator	configurator,
		TestLevel	level,
		boolean	copy )

protectedinherited

Run tests in the given selection for a subset of given targets.

Parameters

subset	The subset of targets to run the selected tests for.
description	A string that describes the collection of tests.
selected	A predicate that given a test category returns whether it should be included in this test run or not.
transformer	The transformer to apply to tests.
configurator	A procedure for configuring the tests.
level	The test level.
copy	Whether to work on copies of tests in the test. registry.

◆ runTestsForTargets()

void org.lflang.tests.TestBase.runTestsForTargets	(	String	description,
		Predicate< TestCategory >	selected,
		Transformer	transformer,
		Configurator	configurator,
		TestLevel	level,
		boolean	copy )

protectedinherited

Run tests in the given selection for all targets enabled in this class.

Parameters

description	A string that describes the collection of tests.
selected	A predicate that given a test category returns whether it should be included in this test run or not.
transformer	The transformer to apply to tests.
configurator	A procedure for configuring the tests.
level	The test level.
copy	Whether to work on copies of tests in the test. registry.

◆ stackTraceToString()

String org.lflang.tests.TestBase.stackTraceToString ( Throwable t )

staticinherited

◆ supportsSingleThreadedExecution()

boolean org.lflang.tests.TestBase.supportsSingleThreadedExecution ( )

protectedinherited

Whether to enable threading.

Reimplemented in org.lflang.tests.runtime.CTest, and org.lflang.tests.runtime.PythonTest.

◆ testCommandLineActionOverride()

void org.lflang.tests.runtime.CCliTest.testCommandLineActionOverride ( )

Test that –min_delay and –min_spacing override action timing.

With defaults (min_delay=1ns, min_spacing=10ns), overriding to min_delay=10us and min_spacing=100us changes when the action fires. The test verifies that elapsed times match the overridden values.

◆ testCommandLineDeadlineFederatedOverride()

void org.lflang.tests.runtime.CCliTest.testCommandLineDeadlineFederatedOverride ( )

Test that CLI overrides propagate through the launch script in federated execution.

With defaults (execution_time=100ms, deadline_time=50ms) a deadline violation occurs. The CLI override sets execution_time=10ms and deadline_time=500ms with expect_violation=0, so NO violation occurs, proving the launch script forwards arguments to federates.

◆ testCommandLineDeadlineOverride()

void org.lflang.tests.runtime.CCliTest.testCommandLineDeadlineOverride ( )

Test that –deadline_time and –execution_time override deadline behavior.

With defaults (execution_time=100ms, deadline_time=50ms) a deadline violation occurs. The CLI override sets execution_time=10ms and deadline_time=200ms, so NO violation occurs, proving both overrides took effect.

◆ testCommandLineParameterOverride()

void org.lflang.tests.runtime.CCliTest.testCommandLineParameterOverride ( )

Test that –period, –expected, and –value override timer behavior and double parameter.

With defaults (period=1s, expected=6, value=3.14159), overriding to period=500ms changes the firing count to 11, and overriding value=2.71828 changes the double sent on each output.

◆ testCommandLineStringBoolOverride()

void org.lflang.tests.runtime.CCliTest.testCommandLineStringBoolOverride ( )

Test that –value and –use_default override string and bool parameters.

With default use_default=false and value="Hello, world!", overriding value to "Goodbye!" should cause the Print reactor to expect "Goodbye!". Running with –use_default true should ignore the value parameter and use the hardcoded default.

Member Data Documentation

◆ fileAccess

JavaIoFileSystemAccess org.lflang.tests.TestBase.fileAccess

packageinherited

◆ generator

LFGenerator org.lflang.tests.TestBase.generator

packageinherited

◆ resourceSetProvider

Provider<ResourceSet> org.lflang.tests.TestBase.resourceSetProvider

packageinherited

◆ testRegistry

TestRegistry org.lflang.tests.TestBase.testRegistry

packageinherited

◆ THICK_LINE

final String org.lflang.tests.TestBase.THICK_LINE

staticinherited

Initial value:

                                  =
"=============================================================================="
    + System.lineSeparator()

Content separator used in test output, 78 characters wide.

◆ THIN_LINE

final String org.lflang.tests.TestBase.THIN_LINE

staticinherited

Initial value:

                                 =
"------------------------------------------------------------------------------"
    + System.lineSeparator()

Content separator used in test output, 78 characters wide.

◆ validator

IResourceValidator org.lflang.tests.TestBase.validator

packageinherited

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

/Users/runner/work/lingua-franca/lingua-franca/core/src/integrationTest/java/org/lflang/tests/runtime/CCliTest.java

Public Member Functions

Static Public Member Functions

Static Public Attributes

Protected Member Functions

Static Protected Member Functions

Package Functions

Package Attributes

Detailed Description

Constructor & Destructor Documentation

◆ CCliTest()

Member Function Documentation

◆ applyDefaultConfiguration()

◆ getExecCommand()

◆ getGeneratorArguments()

◆ isLinux()

◆ isMac()

◆ isWindows()

◆ pathToLevel()

◆ printTestHeader()

◆ resetCliArgs()

◆ runSingleTestAndPrintResults()

◆ runTestsAndPrintResults()

◆ runTestsFor()

◆ runTestsForTargets()

◆ stackTraceToString()

◆ supportsSingleThreadedExecution()

◆ testCommandLineActionOverride()

◆ testCommandLineDeadlineFederatedOverride()

◆ testCommandLineDeadlineOverride()

◆ testCommandLineParameterOverride()

◆ testCommandLineStringBoolOverride()

Member Data Documentation

◆ fileAccess

◆ generator

◆ resourceSetProvider

◆ testRegistry

◆ THICK_LINE

◆ THIN_LINE

◆ validator