CycloneDX Python Module

The CycloneDX module for Python creates a valid CycloneDX Software Bill-of-Materials (SBOM) containing an aggregate of all project dependencies. CycloneDX is a lightweight BOM specification that is easily created, machine readable, and simple to parse.

Usage

Freezing

A bill-of-material such as CycloneDX expects exact version numbers. Therefore requirements.txt must be frozen. This can be accomplished via:

    $ pip freeze > requirements.txt

Execution

    $ docker run cyclonedx/cyclonedx-python [OPTIONS]

Options

By default, requirements.txt will be read from the current working directory and the resulting bom.xml will also be created in the current working directory. These options can be overwritten as follows:

• -i - the alternate filename to a frozen requirements.txt
• -o - the bom file to create

License

Permission to modify and redistribute is granted under the terms of the Apache 2.0 license.