Requirements and Specification
System Requirements
lobster/tools/core/online_report/requirements.trlc
TRLC System_requirement core_online_report_req.Valid_Git_Repository
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.
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
TRLC System_requirement_aspect core_online_report_req.Invalid_Git_Repository
OTHERWISE the tool shall exit with a non-zero return code and display an error message indicating that the repository is not a valid Git repository.
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Software Requirements
TRLC Software_requirement core_online_report_req.Dummy_Requirement
This is not really a requirement. It will be used only to generate a minimal tracing report for each tool. It can be deleted as soon as all the tools get their real requirements.
Issues:
missing reference to Code
missing reference to Software Test
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
TRLC Software_requirement core_online_report_req.Dummy_Requirement_Unit_Test
This is not really a requirement. It will be used only to generate a minimal tracing report for each tool. It can be deleted as soon as all the tools get their real requirements.
Issues:
missing reference to Code
missing reference to Software Test
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Implementation
Code
lobster/tools/core/online_report/online_report.py
Python Function online_report.is_git_main_module
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Python Function online_report.is_dir_in_git_submodule
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Python Function online_report.is_dir_in_git_main_module
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Python Function online_report.find_repo_main_root
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Python Function online_report.path_starts_with_subpath
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Python Function online_report.parse_git_root
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Python Function online_report.add_github_reference_to_items
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Python Function online_report.get_git_commit_hash_repo_and_path
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Python Function online_report.get_hash_for_git_commit
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Python Function online_report.get_summary
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Python Constructor online_report.OnlineReportTool.__init__
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Python Method online_report.OnlineReportTool._run_impl
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Python Function online_report.main
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Verification and Validation
System Test
tests_system/lobster_online_report/test_git_repo_different_location.py
PyUnit Test test_git_repo_different_location.NonGitRepositoryTest.test_non_git_repository_with_repo_root:25
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
PyUnit Test test_git_repo_different_location.NonGitRepositoryTest.test_non_git_repository_without_repo_root:40
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
tests_system/lobster_online_report/test_git_repository.py
PyUnit Test test_git_repository.GitRepositoryTest.test_invalid_git_repository:15
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
PyUnit Test test_git_repository.GitRepositoryTest.test_valid_git_repository:30
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
Software Test
tests_unit/lobster_online_report/test_online_report.py
PyUnit Test test_online_report.LobsterOnlineReportTests.test_print_summary_same_values:13
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
PyUnit Test test_online_report.LobsterOnlineReportTests.test_print_summary_different_values:21
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC
PyUnit Test test_online_report.LobsterOnlineReportTests.test_commit_hash_for_main_repo:31
Build Reference: f8fd7fec387000b9da849c4c0ec20550b9334106 | Timestamp: 2025-08-05 14:16:58+00:00 UTC