Submits rr traces to Pernosco for debugging.

The following environment variables must be set:

• PERNOSCO_USER: User ID in email address form.
• PERNOSCO_USER_SECRET_KEY: Secret key. Be careful about sharing this.
• PERNOSCO_GROUP: Group to upload to, e.g. public. Influences who can access the trace and who gets billed.

The openssl, tar, zstdmt and aws tools must be installed. The best way to install aws is

sudo pip3 install awscli --upgrade

Ubuntu and Debian packages can have issues.

You will need Python 3.8 or later installed. If your default Python is not 3.8 or later, run python3.8 pernosco-submit ... below.

You must use rr master, at least commit 6116360abd43b2098efcd8f37a6e6bab61ca7a79.

Run

pernosco-submit upload [--title <string>] [--url <url>] <rr-trace-dir> [<source-dir>...]

The rr trace directory will be packaged and uploaded. This may take a while and send gigabytes of data to Amazon S3.

pernosco-submit scans the trace to identify relevant source files. For source files in git or Mercurial repositories that pernosco-submit knows about, whose plaintext source can be loaded from some Web server, pernosco-submit adds metadata to the upload so that the Pernosco client will load the source directly from that server. (We gladly accept pull requests to extend that support.) For source files not in a supported repository (including files generated by the build), or modified locally, pernosco-submit will upload the file as part of the submission only if the file's realpath is under one of the listed <source-dir>s. This is to reduce the likelihood of pernosco-submit accidentally uploading confidental files. Thus, if you want locally modified and non-repository files to be available in the Pernosco client, you must whitelist directories containing them by passing them as <source-dir> parameters to pernosco-submit.

The --title option lets you specify a title for the upload. This title is quoted in notification emails from Pernosco, appears in the browser tab title for a Pernosco session, and appears in the top right of the Pernosco window. The --url option lets you specify a URL which the title text links to.

Ensure git, hg and git-cinnabar are installed.

Then in the pernosco-submit checkout directory, run

tests/main.py