1.3. Autograded Code

Your client application must implement the following 8 functions defined in client.go.

  1. InitUser (username string, password string) (userdataptr *User, err error)

  2. GetUser (username string, password string) (userdataptr *User, err error)

  3. StoreFile (filename string, content []byte)

  4. LoadFile (filename string) (content []byte, err error)

  5. AppendToFile (filename string, content []byte) (err error)

  6. CreateInvitation (filename string, recipientUsername string) (invitationPtr UUID, err error)

  7. AcceptInvitation (senderUsername string, invitationPtr UUID, filename string) error

  8. RevokeAccess (filename string, recipientUsername string) error

You are allowed and encouraged to write any structs or helper functions to aid your implementation, but all of your code must be contained in client.go.

Your implementation of these 8 functions MUST satisfy all of the Design Requirements. The API of these required functions is documented in Client Application API.

We will test your client application with a series of functionality and security tests to determine your code score. Due to the nature of computer security, most of the tests are hidden. Some test results are available before the deadline, and others will only be available after the deadline.

Each failed code test will incur a multiplicative penalty on your score. This means that each subsequent failed test has less impact on your grade. This emulates an environment where the existence of a vulnerability is more important than the exact scope of the vulnerability.

As discussed in Test Coverage, your implementation must, at the very least, not panic on the basic functionality tests provided in client_test.go. However, an implementation that panics on the provided tests will not receive a code score of zero for the code portion of the total grade.

The autograder will run multiple fixed random seeds for each test. Because your code must be robust to failures, we will take the lowest score across these multiple runs as the score for your code. Thus, any nondeterminism introduced by your code will be penalized.

1.3.1. Autograder rules

Your client application code will be run in an isolated sandbox and autograded against a series of hidden tests.

Adversarial behavior by your client will be considered cheating and dealt with accordingly.

The autograder flags and rejects any submission that:

  • Imports additional libraries (you can only use the existing libraries imported in client.go).

  • Spawns other processes.

  • Reads or writes to the file system.

  • Creates any network connections.

  • Attacks the autograder by returning excessively long output.