6.2.6 Using raco congame
The raco congame command provides tools for uploading and testing studies from the command line. DrRacket’s Upload Study button uses the same upload mechanism under the hood, and the login credentials are shared between the CLI and DrRacket.
raco congame ‹command› ‹option› ... ‹arg› ...
6.2.6.1 raco congame login
raco congame login
Logs in to a Congame server. The command prompts for a server URL, defaulting to
http://127.0.0.1:5100 (i.e., the local Docker container). It then opens a browser window
where you authenticate with the server. Once authentication is complete, your credentials are saved
and used for future uploads —
6.2.6.2 raco congame logout
raco congame logout
Clears stored login credentials. This is useful when you need to switch to a different server —
6.2.6.3 raco congame upload
raco congame upload ‹study-id› ‹path›
Uploads the study at ‹path› to the server you are currently logged in to. The ‹study-id› should match the identifier used in your defstudy expression.
The command packages the study file and any of its dependencies into an archive and sends it to the server. On success, it opens a browser to the study’s admin page. If you are not logged in, it will prompt you to log in first.
6.2.6.4 raco congame simulate
raco congame simulate ‹slug›
Opens multiple browser sessions enrolled in the study instance identified by ‹slug›, for testing studies that involve coordination between participants.
The raco congame simulate command accepts the following flags:
--host ‹host› —
the Congame server URL. Defaults to http://127.0.0.1:5100. -n ‹num› —
the number of simultaneous browser sessions to open. Must be a positive integer. Defaults to 2.