As a requirements manager I want the traceability report to mention the GitHub location of each item which comes from a file inside a git repository (hosted on my company's GitHub Enterprise server), so that I can - map the traceability report to a commit SHA, and - easily navigate to the corresponding location.
The location shall include: - the full URL including the git commit SHA, - and the line number (if applicable).
Note: - The assumption is that, the repository will be checked out locally by the user or CI system, and the URL to the remote repository will be given as input to the LOBSTER tool suite. That is, the tool suite does not have to detect the commit SHA on its own. - The line number is optional, because otherwise it is impossible to represent files as a whole by a LOBSTER item.
The user does not provide a valid path to a configuration file, but the lobster-online_report tool generates valid output nevertheless, potentially based on irrelevant report file. For example, the lobster-online tool might consider the current working directory as source of report file, and these do in fact contain links to real requirements, such that lobster-online_report would compute a non-zero coverage value.
The user provides an invalid configuration file, but the lobster-online_report tool generates valid output nevertheless, potentially based on irrelevant report file. This includes cases where the config file: - contains invalid data, - is missing required keys or attributes,
The test shall verify that the GitHub reference (URL, commit SHA, and line number if applicable) for each item in the output matches the expected values from the input and repository configuration. Example: If an item is from a file tracked in git, the output must contain the correct GitHub URL, commit SHA, and line number.
The test shall verify that the lobster-online_report tool exits with a non-zero return code when the config file does not exist. Example: Verify that the lobster-online_report tool throws an error when a non-existent config file is provided.
IF the provided repository root directory contains a ".git" directory, THEN the tool shall write the output in the LOBSTER interchange format to the file given in the "out" parameter AND exit with a zero return code.
Issues:
missing up reference
missing reference to Software Requirements
missing reference to System Tests
Build Reference: main | Timestamp: 2025-09-18 11:06:21+00:00 UTC