checkout

The checkout command allows a user to download all files of an assignment, activity, group or event he has access to. In its simples form, the command requires a single argument, namely the identification of the assignment or activity, which is either its integer identifier or a name. If the user has access to more than one object with the same name, the command will present a list of alternatives and respective indexes to choose. To actually choose one of them, the user must run the command again, adding the proper --index (or -i to make it shorter) argument.

The command can also be run without any arguments from within the directory of a tst object. In this case, tst downloads any updates in the server and applies them to the local copy. If the local copy has been changed, however, tst will notify the user and require a --overwrite option to discard and overwrite any local changes.

Syntax

tst checkout [<id>|<name>] [--index|-i <index>]

This command creates a new directory, using the id or name given, downloads the object files from the server and puts them inside the directory, along with the necessary data structure to support other tst commands.

tst checkout

This syntax can be used only within a tst directory. It downloads all updates available in the server and applies them to the local copy of the object. In this case, no directory is created.

tst checkout --overwrite

The --overwrite must be used when there are non saved local changes in the object. The --overwrite options makes tst ignore and discard local changes and overwrite the files with the data downloaded from the server.