Skip to main content

This is script to generate reports through Mend API v3.0

Project description

Mend Report Generation tool

This is script to generate reports through Mend API v3.0.

How To Use

$ mend-reporting-tool -h
usage: mend-reporting-tool [-h] -mendAPI MENDAPI -orgUUID ORGUUID -userEmail USEREMAIL -userKey USERKEY -projectUUID PROJECTUUID
                           [-reportType REPORTTYPE] [-format FORMAT] [-unzip UNZIP]

This is script to generate reports through Mend API v3.0.

options:
  -h, --help            show this help message and exit
  -mendAPI MENDAPI      Mend API v3.0 server hostname without https://, like `api-saas.whitesourcesoftware.com`
  -orgUUID ORGUUID      Organization UUID
  -userEmail USEREMAIL  User Email
  -userKey USERKEY      User Key
  -projectUUID PROJECTUUID
                        List of Project UUIDs separeted by ','
  -reportType REPORTTYPE
                        Report Type, for example: `vulnerabilities`, `sbom`, `spdx`, `spdx_2_3`, `cycloneDX`, `cycloneDX_1_5`,
                        `cycloneDX_1_6`. The `vulnerabilities` report type generates vulnerability report. The `sbom` report type generates    
                        `spdx` format. Optional, default: `sbom`
  -format FORMAT        Report Format, acceptable formats for `vulnerabilities` reportType: `json`, `excel`; for `sbom` reportType: `json`,    
                        `yaml`. Optional, default: `json`
  -unzip UNZIP          Extract report to the 'mend-reports' folder. Variants: yes, no. Optional, default: `no`

### Example:
mend-reporting-tool  -mendAPI $MEND_API -orgUUID $MEND_ORGANIZATION_UUID -userEmail $MEND_EMAIL  -userKey $MEND_USER_KEY -projectUUID $PROJECT_UUID -reportType sbom -format yaml -unzip yes

### Processing Project UUID: <Project_UUID>
>>> The report saved to 'report-<Project_UUID>.zip' successfully.
>>> The report 'report-<Project_UUID>.zip' extracted to 'mend-reports' folder.
>>> Deleted: report-<Project_UUID>.zip
>>> Report is ready in `mend-reports` folder.
...

# Content of `mend-reports` folder:
$ ls -l mend-reports/
-rw-r--r-- 1 alex alex 1033049 Apr 20 23:50 '<Project_Name>-project-SPDX-reportyaml'

How To Install

pip install 'mend-reporting-tool==0.2.1'

How To Install from source code

git clone https://github.com/chelyshev/mend-reporting-tool.git
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mend_reporting_tool-0.2.1.tar.gz (3.9 kB view details)

Uploaded Source

File details

Details for the file mend_reporting_tool-0.2.1.tar.gz.

File metadata

  • Download URL: mend_reporting_tool-0.2.1.tar.gz
  • Upload date:
  • Size: 3.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for mend_reporting_tool-0.2.1.tar.gz
Algorithm Hash digest
SHA256 411345c7a075de33fb30965deb15ac7e2c0b97948d766fbc2f71cdc15666ec8d
MD5 5011c28b7de6c9e4af54093ac1cf8c03
BLAKE2b-256 518350bcb131bd5f8d034681312f5f4c908502bb1f46628373167b92e1b3981d

See more details on using hashes here.

Provenance

The following attestation bundles were made for mend_reporting_tool-0.2.1.tar.gz:

Publisher: python-publish.yml on chelyshev/mend-reporting-tool

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page