Great question! I've run into this exact issue before—${SUITE_SOURCE} is actually a read-only variable, which is why setting it doesn't affect the logs. Let's walk through a few reliable solutions to get your repository links showing up in the Source field instead of local file paths:

Robot Framework's listener interface is perfect for intercepting and modifying log events during test execution. Here's a simple Python listener that replaces local file paths with your repository links:

class SourceLinkListener:
    ROBOT_LISTENER_API_VERSION = 3

    def __init__(self, repo_base_url):
        # 传入你的仓库基础链接，比如"https://github.com/yourusername/yourrepo/blob/main/"
        self.repo_base_url = repo_base_url

    def log_message(self, message):
        if message.source:
            # 截取测试文件的相对路径（替换成你本地项目的根目录路径）
            relative_path = message.source.split("/path/to/your/local/project/")[-1]
            # 替换为仓库链接
            message.source = f"{self.repo_base_url}{relative_path}"

使用步骤： #

1. Save this script as source_link_listener.py in your project directory.
2. Run your tests with the listener enabled, passing your repo URL as a parameter:

robot --listener source_link_listener.py:https://github.com/yourusername/yourrepo/blob/main/ your_test_suite.robot

This method works dynamically during test runs, making it ideal for CI/CD pipelines where local paths might vary across environments.

If you prefer not to use a listener, you can modify Robot Framework's built-in HTML log template to render repository links directly:

1. Locate the default template directory (usually in your Python site-packages: Lib/site-packages/robot/reporting/templates).
2. Copy the log.html template to your local project folder (never modify the original directly—updates to Robot Framework will overwrite it).
3. In your copied template, search for instances of ${message.source} and replace them with logic that appends the relative path to your repo URL. For example:

   <!-- Replace this -->
   <span class="source">${message.source}</span>
   <!-- With something like this -->
   <span class="source">
       <a href="https://github.com/yourusername/yourrepo/blob/main/${message.source.split('/local/project/path/')[-1]}" target="_blank">
           ${message.source.split('/local/project/path/')[-1]}
       </a>
   </span>
   

4. Run your tests with the custom template:

robot --log-template ./custom_log.html your_test_suite.robot

If you want a simpler, one-off fix, you can modify the generated log file after tests finish. Here's a quick Python script to replace local paths with repo links:

# Update these values to match your setup
LOCAL_PROJECT_PATH = "/path/to/your/local/project/"
REPO_BASE_URL = "https://github.com/yourusername/yourrepo/blob/main/"

# Read and modify the log file
with open("log.html", "r") as log_file:
    log_content = log_file.read()

updated_content = log_content.replace(LOCAL_PROJECT_PATH, REPO_BASE_URL)

with open("log.html", "w") as updated_log:
    updated_log.write(updated_content)

Just run this script right after your test command completes.

内容的提问来源于stack exchange，提问作者Arpitha