matlab/agent-skills-playground / demos/requirements-based-verification/skills/simulink-test-sequence-from-ears
simulink-test-sequence-from-ears
VerifiedGenerate Simulink Test Sequence blocks and harnesses from EARS requirements. Use when asked to create a test case from a requirement, generate tests from a .slreqx file, or verify a Simulink model with requirement-based tests.
| File | Kind | Size |
|---|---|---|
| LICENSE.md | markdown | 1.4 KB |
| SKILL.md | skill md | 5.6 KB |
| references/workflow-details.md | markdown | 15.1 KB |
| scripts/addPreconditionSteps.m | other | 1.4 KB |
| scripts/analizeRequirements.m | other | 2.9 KB |
| scripts/analyzeRequirements.m | other | 279 B |
| scripts/buildHarnessesFromApprovedYaml.m | other | 6.7 KB |
| scripts/collectSkillContext.m | other | 29.7 KB |
| scripts/compileHarnessModel.m | other | 326 B |
| scripts/configureEventDriven.m | other | 1.8 KB |
| scripts/configureStateDriven.m | other | 1.9 KB |
| scripts/configureTestSequence.m | other | 1.6 KB |
| scripts/configureUbiquitous.m | other | 1.5 KB |
| scripts/configureUnwantedBehavior.m | other | 1.9 KB |
| scripts/generateMappingReviewFromRequirements.m | other | 29.7 KB |
| scripts/generateSignalMappingsFromYaml.m | other | 4.3 KB |
| scripts/generateTestSequencesFromRequirements.m | other | 4.7 KB |
| scripts/parseEARSPattern.m | other | 2.3 KB |
| scripts/prepareWritableBuildWorkspace.m | other | 1.5 KB |
| scripts/readMappingReviewYaml.m | other | 6.6 KB |
| scripts/writeMappingReviewYaml.m | other | 9.2 KB |
scripts/buildHarnessesFromApprovedYaml.m
View on GitHubfunction result = buildHarnessesFromApprovedYaml(modelName, yamlPath, varargin)
%BUILDHARNESSESFROMAPPROVEDYAML Generate harnesses from an approved YAML file.
% RESULT = buildHarnessesFromApprovedYaml(MODELNAME, YAMLPATH) converts the
% approved YAML review file into signalMappings and creates associated
% external harnesses directly against the source model by default.
%
% RESULT = buildHarnessesFromApprovedYaml(..., 'AssociateWithSourceModel', false)
% uses the legacy staged-build fallback. That mode generates harnesses in a
% writable temp workspace and copies the resulting .slx files back into the
% source directory, but those copied files are not registered as harnesses
% on the source model.
parser = inputParser;
addParameter(parser, 'SourceDir', pwd, @(x) ischar(x) || isstring(x));
addParameter(parser, 'DestinationRoot', tempdir, @(x) ischar(x) || isstring(x));
addParameter(parser, 'OutputFolderName', 'test_harnesses', @(x) ischar(x) || isstring(x));
addParameter(parser, 'CopyHarnessesBack', true, @(x) islogical(x) || isnumeric(x));
addParameter(parser, 'AssociateWithSourceModel', true, @(x) islogical(x) || isnumeric(x));
parse(parser, varargin{:});
sourceDir = char(parser.Results.SourceDir);
destinationRoot = char(parser.Results.DestinationRoot);
outputFolderName = char(parser.Results.OutputFolderName);
copyHarnessesBack = logical(parser.Results.CopyHarnessesBack);
associateWithSourceModel = logical(parser.Results.AssociateWithSourceModel);
yamlSourcePath = resolveSourcePath(sourceDir, yamlPath);
sourceHarnessFolder = fullfile(sourceDir, outputFolderName);
sourceModelPath = fullfile(sourceDir, [modelName '.slx']);
if associateWithSourceModel
ensureSourceModelWritable(sourceModelPath);
originalDir = pwd;
cleaner = onCleanup(@() cd(originalDir));
cd(sourceDir);
signalMappings = generateSignalMappingsFromYaml(yamlSourcePath);
generateTestSequencesFromRequirements(modelName, signalMappings, 'OutputFolder', sourceHarnessFolder);
result = struct();
result.source_dir = string(sourceDir);
result.build_dir = "";
result.output_folder = string(sourceHarnessFolder);
result.source_output_folder = string(sourceHarnessFolder);
result.yaml_source_path = string(yamlSourcePath);
result.yaml_build_path = "";
result.copied_harnesses = collectHarnesses(sourceHarnessFolder);
result.test_sequence_blocks = deriveTestSequenceBlocks(result.copied_harnesses);
result.association_mode = "associated_external_harness";
return;
end
buildInfo = prepareWritableBuildWorkspace(sourceDir, 'DestinationRoot', destinationRoot);
buildDir = char(buildInfo.build_dir);
outputFolder = fullfile(buildDir, outputFolderName);
yamlBuildPath = fullfile(buildDir, relativeSourcePath(sourceDir, yamlSourcePath));
if ~isfile(yamlBuildPath)
% The YAML lives outside the staged copy (or in an excluded folder).
copyfile(yamlSourcePath, yamlBuildPath);
end
originalDir = pwd;
cleaner = onCleanup(@() cd(originalDir));
cd(buildDir);
signalMappings = generateSignalMappingsFromYaml(yamlBuildPath);
generateTestSequencesFromRequirements(modelName, signalMappings, 'OutputFolder', outputFolder);
copiedHarnesses = strings(0,1);
if copyHarnessesBack && exist(outputFolder, 'dir')
if ~exist(sourceHarnessFolder, 'dir')
mkdir(sourceHarnessFolder);
end
harnessFiles = dir(fullfile(outputFolder, '*.slx'));
for i = 1:numel(harnessFiles)
copyfile(fullfile(outputFolder, harnessFiles(i).name), fullfile(sourceHarnessFolder, harnessFiles(i).name));
copiedHarnesses(end+1,1) = string(fullfile(sourceHarnessFolder, harnessFiles(i).name)); %#ok<AGROW>
end
end
result = struct();
result.source_dir = string(sourceDir);
result.build_dir = string(buildDir);
result.output_folder = string(outputFolder);
result.source_output_folder = string(sourceHarnessFolder);
result.yaml_source_path = string(yamlSourcePath);
result.yaml_build_path = string(yamlBuildPath);
result.copied_harnesses = copiedHarnesses;
result.test_sequence_blocks = deriveTestSequenceBlocks(result.copied_harnesses);
result.association_mode = "copied_standalone_harness_files";
end
function path = resolveSourcePath(sourceDir, inputPath)
inputPath = char(inputPath);
if isfile(inputPath)
path = inputPath;
else
path = fullfile(sourceDir, inputPath);
end
end
function relPath = relativeSourcePath(sourceDir, sourcePath)
sourceDir = canonicalExistingFolder(sourceDir);
sourcePath = canonicalExistingPath(sourcePath);
% Windows paths are case-insensitive, and dir does not normalize case.
prefix = sourceDir + filesep;
if startsWith(sourcePath, prefix, 'IgnoreCase', ispc)
relPath = char(extractAfter(sourcePath, strlength(prefix)));
elseif strlength(sourcePath) == strlength(sourceDir) && startsWith(sourcePath, sourceDir, 'IgnoreCase', ispc)
relPath = '';
else
[~, name, ext] = fileparts(char(sourcePath));
relPath = [name ext];
end
end
function path = canonicalExistingPath(path)
entries = dir(path);
if isempty(entries)
error('Path not found: %s', path);
end
path = string(fullfile(entries(1).folder, entries(1).name));
end
function path = canonicalExistingFolder(path)
entries = dir(path);
if isempty(entries)
error('Folder not found: %s', path);
end
path = string(entries(1).folder);
end
function ensureSourceModelWritable(modelPath)
if ~isfile(modelPath)
error('Source model file not found: %s', modelPath);
end
[status, attributes] = fileattrib(modelPath);
if status && isfield(attributes, 'UserWrite') && ~attributes.UserWrite
error(['Source model is not writable: %s\n' ...
'Associated external harness creation updates and saves the owner model. ' ...
'Set ''AssociateWithSourceModel'', false only if you want copied harness files without source-model association.'], modelPath);
end
end
function harnessPaths = collectHarnesses(folderPath)
harnessPaths = strings(0,1);
if ~exist(folderPath, 'dir')
return;
end
harnessFiles = dir(fullfile(folderPath, '*.slx'));
for i = 1:numel(harnessFiles)
harnessPaths(end+1,1) = string(fullfile(folderPath, harnessFiles(i).name)); %#ok<AGROW>
end
end
function blockPaths = deriveTestSequenceBlocks(harnessPaths)
blockPaths = strings(0,1);
for i = 1:numel(harnessPaths)
[~, harnessName] = fileparts(char(harnessPaths(i)));
blockPaths(end+1,1) = string([harnessName '/Test Sequence']); %#ok<AGROW>
end
end
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |