Dcc-Json Toolkit

The tool offers a set of tools for both users and developers for the Digital Calibration Certificate (DCC) files. The functionality of the tool allows:

• Caching locally any released dcc.xsd file, together with all its required imports.
• Validation of any DCC file, printing all the possible issues it has.
• Bidirectional conversion XML-JSON for DCC files.

Setup

Python Environment

The package is installable via pip:

pip install dcc-json-toolkit

The basic installation allows working directly with any DCC Schema. There are also some additional requirements for those interested:

• pip install dcc-json-toolkit[content] to allow validating the contents.

Alternatively, all additional requirements can be installed with the following command:

pip install dcc-json-toolkit[full]

[!Note] This method is recommended for any Linux system or to integrate the tool at any development.

Windows executable

The executable file provides access to all the commandline tools without the need of extra installation. This option is recommended for those users that do not require Python.

To obtain the executable, access the GitLab Project Releases page, then download the file under the Packages section for the desired release.

==================================================
                DccJsonToolkit
==================================================

Write the name of the tool you want to use (followed by its arguments):
   1. dcc-validate : Validate existing DCC files.
   2. dcc-cache : Manage the local cache.
   3. dcc2json : Exports a DCC (.xml) file into a JSON file.
   4. json2dcc : Creates a DCC file from JSON data.

If you don't know what the tool does, write '-h' after its name. For example, 'dcc-validate -h'. Then press ENTER.

[!Warning] The executable works only on Windows OS.

Usage

Commandline Tools

• DCC-JSON file conversion: Use either dcc2json or json2dcc.
• DCC file validation: Use dcc-validate to display all errors of a DCC file or to compare it with a different XSD version. The comparison is quite helpful to control the upgrade of any DCC to the next released XSD version.
• Cache Manager: Use dcc-cache to control cached versions and see the absolute path for every cache.

Read more about the CLI tools.

Developer Tools

If you plan to integrate some of the functionality onto your own code, all functionalities can be recreated with the use of DccSchema.

from dcc_json_toolkit import DccSchema

schema = DccSchema("3.3.0")
dcc_as_dict = schema.to_dict("./path/to/dcc.xml")

Read the complete official documentation.