The “Results” of a run are the set of files that your code generates or modifies when it runs. You can view the results of a given run through the Runs tab of your project. Or you can view the latest results on the Results tab of your project.
Results branching behavior¶
By default, when your code finishes running, Domino will save its results (i.e., any new files it produced) back into your project folder. This means those changes will be downloaded the next time you sync your project.
If your code generates large results that you don’t need to synchronize each time, you can set your project to save results to isolated “results branches.” Your results will be accessible through the web interface (and permanently saved), but they won’t automatically be accessible to subsequent runs, or automatically downloaded to your computer.
You can control this behavior on your project’s settings page, under the “result behavior” section.
Downloading results from an isolated branch¶
You can download isolated results from the UI as well as the CLI.
From the UI, select the run from the runs page, and click “view results”. From there you can choose to download each results file.
With the CLI, you can use the
domino download-results command. For
details on usage syntax, please run
domino help download-results.
Controlling which files are shown in the results dashboard¶
If many files get changed during a run it might be difficult to navigate
or get a high level summary. To control which files should be rendered
as results, you can create a special file in your project folder called
.dominoresults (note the leading period). If this file exists and
has entries, Domino will only render results that match patterns in the
Including single files in the results dashboard¶
To include only specific files of interest, your “.dominoresults” file
must list the relative path to those, each on a new line. Use the
following example to display only
files located in the top level directory of the project.
Using patterns with wildcard characters¶
Domino can use wildcards patterns in “.dominoresults”. This allows you to specify groups of files you want to be displayed. The following example will limit the files to PDF documents in the top-level directory, all PNG files in a directory images and text files arbitrarily deep in sub-directories of the project.
*.pdf results/*.png **/*.txt