Design and implement "target platform" support about selenium-foundation

[sbabcoc]

TargetPlatform.txt

NOTE: JUnit platform support does not exhibit feature parity (not sure this is actually true)

Core implementation

• if target platform is defined, append platform name to test result output path

PlatformTargetable<P extends Enum<?>>

• defines target platform interface for test classes

TargetPlatformHandler

• declares shouldRun()
• declares getTargetedPlatform() methods
  • uses getDefaultPlatform() and platformFromString()

(TestNG) WebDriverTestNGTestSupport.beforeInvocation

• try to convert method description to JSON object
• if conversion succeeds, extract the "platform" element
• if a platform was specified:
  • invoke interface activatePlatform() method
  • store platform value in test result attribute

(TestNG) TestFlowController

• method interceptor determines which methods should run on context platform
• for each method that should run:
  • get targeted platform
  • if platform is defined, store it as JSON in method description
  • add method to list of tests to run
• context platform defined in SuiteXML takes precedence over core settings

(JUnit) TargetPlatformRule implements TestRule

• get test run platform setting (contextPlatform)
• get TargetPlatform annotation from Description
• wrap base Statement in PlatformStatement object, injecting TargetPlatform annotation

(JUnit) PlatformStatement extends Statement

• in <init>(), store targeted/default platform
• in evaluate(), propagate this value to the TargetPlatformRule

(JUnit) WebDriverJUnitTestSupport.setup (@Before method)

• if test class is targetable, get target from TargetPlatformRule
• if platform was specified, invoke interface activatePlatform() method
• otherwise, throw AssumptionViolatedException to skip the test

[sbabcoc]

This issue is resolved by the release of version 17.6.0.