cyclonedx/cyclonedx-python repository overview

⁠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.