Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space SDmaster and version 1.23
Dont print
Panel
borderColor#39B54A
bgColor#ffffff
titleColor#39B54A
titleBGColor#ffffff

On this page:

Table of Contents
maxLevel2

Related topics:

HIDDEN

Excerpt
hiddentrue

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

Purpose

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.

Usage

This tool is run from the command line as follows:

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

Flags

The unexportSnapshot tool supports the following flags.

FlagsValueExampleNotes
--verbose--

Include Page
_--verbose
_--verbose

--verbosity<level>2

Include Page
_--verbosity
_--verbosity

--output-directory-
projects

Optional, the directory to write the unexported snapshot to.

Default: the current working directory.

--project-name<project>myproject

Optional, the name of the project to generate.

Default: "project".

--no-upgrade-

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.

--debug--

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.


Results

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.