On this page:
6.2.6.1 raco congame login
6.2.6.2 raco congame logout
6.2.6.3 raco congame upload
6.2.6.4 raco congame simulate

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 — both via raco congame upload and via DrRacket’s Upload Study button.

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 — for example, from a local development server to a production server. After logging out, the next upload (whether from the CLI or from DrRacket) will prompt you to log in again with a new server address.

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.