Documentation around distributed locustfile (-f -) is lacking

[gregersn]

Prerequisites

• I am using the latest version of Locust
• I am reporting a bug, not asking a question

Description

The documentation says

The -f - argument tells Locust to get the locustfile from master instead of from its local filesystem. This feature was introduced in Locust 2.23.0.

But it does not mention that this will not work if you follow the suggested ways of structuring test code into multiple files.

ModuleNotFoundError: No module named 'common'

Documentation should either be updated to mention this, or there should be ways of distributing all required code to run tests.

Command line

locust -f - --worker --master-host --process -1

Locustfile contents

N/A

Python version

N/A

Locust version

N/A

Operating system

N/A

[cyberw]

I agree, we could improve the docs at the very least (serving multiple files is a bit thorny), that's why it was never implemented.

Updated the docs in 6422848

[cyberw]

Maybe we could give an error message if multiple files were specified on master, but I dont know if that is a priority.

[github-actions]

This issue is stale because it has been open 60 days with no activity. Remove stale label or comment or this will be closed in 20 days.