On this page:

Related topics:


Semmle Core: optional command used to convert snapshots downloaded from LGTM for use with the QL command-line tools.


The unexportSnapshot tool is used to convert an exported snapshot (that is, a snapshot that has been converted to a format suitable for analysis by LGTM or the QL plugins and extensions) to a format that can be used with your version of the QL command-line tools. If the exported snapshot was generated using an older version of the QL command-line tools or LGTM, the command will also upgrade the snapshot to a compatible version.


This tool is run from the command line as follows:

 odasa unexportSnapshot [--verbose] [--verbosity <level>] [--output-directory <directory>] [--project-name <project>] [--no-upgrade] [--debug] <snapshot>


The unexportSnapshot tool supports the following flags.




Optional, the directory to write the unexported snapshot to.

Default: the current working directory.


Optional, the name of the project to generate.

Default: "project".


Optional, do not upgrade the database if it's out of date. If you specify this flag and an out of date snapshot is provided, the command will fail.

Default: upgrade the snapshot if it is out of date.


Optional, if the command fails, leave any generated files on disk for further inspection.

Default: delete and files created before the command fails.

<exported-snapshot>.zip-revision-2019-March-1--22-12-12.zipOptional, define the snapshot to convert for use with the QL command-line tools.


When you run this tool, it unzips the specified snapshot and populates the snapshot metadata, where possible. If you do not set the --no-upgrade flag, the unexported snapshot is automatically upgraded for use with your version of the QL command-line tools. 

Known limitations

The generated snapshot will not be compatible with all snapshot commands. In particular, exported snapshots do not contain build information, so it will not be possible to create new snapshots.