User Guide: CLI: Basic Converter Commands

DV8 Console Commands - Basic File Converter Commands

Basic File Converter Commands

These converter commands allow users to import and export DV8 files into XML or JSON files.  Each command below links to its detailed description and example usage:

DV8 Clustering File Importer: Convert an input file (JSON/XML) into a DV8 clustering file (*.dv8-clsx): core:convert-cluster

DV8 Matrix File Importer: Convert an input file (JSON/XML) into a DV8 dependency matrix file (*.dv8-dsm): core:convert-matrix

DV8 Clustering File Exporter: Export a DV8 clustering file (*.dv8-clsx) as XML or JSON: core:export-cluster

DV8 Matrix File Exporter: Export a DV8 dependency matrix (*.dv8-dsm) as XML or JSON: core:export-matrix

    DV8 Clustering File Importer

    This command converts an input file (JSON/XML) into a clustering file (*.dv8-clsx).

    Usage

    dv8-console core:convert-cluster [-h] [-outputFile <OUTPUTFILE>] [-xml] INPUT_FILE

    Input

    A clustering file in JSON or XML format.

    Options

    • outputFile: Specifies the output file to create (*.dv8-clsx).
    • xml: Indicates that the input file is in XML format. Without this option, the tool expects a JSON file by default.

    Example

    dv8-console core:convert-cluster -outputFile clustering.dv8-clsx clustering.json

    DV8 Matrix File Importer

    This command converts an input file (JSON/XML) into a dependency matrix file (*.dv8-dsm).

    Usage

    dv8-console core:convert-matrix [-dependPath <MAPPING_FILE>] [-h] [-outputFile <OUTPUTFILE>] [-xml] INPUT_FILE

    Input

    A DSM file in JSON or XML format.

    Options

    • dependPath: Specifies the location of the dependency type mapping file for customized dependency types.
    • outputFile: Specifies the output file to create (*.dv8-dsm).
    • xml: Indicates that the input file is in XML format. Without this option, the tool expects a JSON file by default.

    Example

    dv8-console core:convert-matrix -outputFile structure-dsm.dv8-dsm structure-dsm.json

    DV8 Clustering File Exporter

    This command exports a clustering file into an XML or JSON file.

    Usage

    dv8-console core:export-cluster [-h] [-outputFile <OUTPUTFILE>] [-xml] INPUT_FILE

    Input

    A clustering file (*.dv8-clsx) generated by DV8.

    Options

    • outputFile: Specifies the output file to create.
    • xml: Exports the clustering in XML format. Without this option, the tool outputs a JSON file by default.

    Example

    dv8-console core:export-cluster -outputFile clustering.json clustering.dv8-clsx

    DV8 Matrix File Exporter

    This command exports a dependency matrix as an XML or JSON file.

    Usage

    dv8-console core:export-matrix [-h] [-outputFile <OUTPUTFILE>] [-xml] INPUT_FILE

    Input

    A DSM file (*.dv8-dsm) generated by DV8.

    Options

    • outputFile: Specifies the output file to create.
    • xml: Exports the dependency matrix in XML format. Without this option, the tool outputs a JSON file by default.

    Example

    dv8-console core:export-matrix -outputFile structure-dsm.json structure-dsm.dv8-dsm