Skip to main content

A tool for scanning OSS projects for dependencies and vulnerabilities

Project description

OSS Vulnerability Scanner

A comprehensive tool for scanning Open Source Software projects for dependencies, generating Software Bill of Materials (SBOM), and checking for known vulnerabilities.

Features

  • Dependency Parsing: Scans OSS projects and extracts dependencies from configuration files
  • SBOM Generation: Creates Software Bill of Materials in CycloneDX format
  • Vulnerability Checking: Queries the National Vulnerability Database (NVD) for known vulnerabilities
  • Caching: Implements caching to avoid repeated queries and improve performance
  • Visualization: Provides visual representation of vulnerability data
  • Detailed Reporting: Generates comprehensive vulnerability reports

Supported Package Managers

  • Python (requirements.txt, setup.py)
  • JavaScript (package.json)
  • Java (pom.xml)

Installation

# Clone the repository
git clone https://github.com/yourusername/ossv-scanner.git
cd ossv-scanner

# Install the package
pip install -e .

Usage

Command-Line Interface

# Scan a project
ossv-scan /path/to/project

# Generate SBOM only
ossv-scan --sbom-only /path/to/project

# Output formats
ossv-scan --output-format html /path/to/project
ossv-scan --output-format json /path/to/project

# Specify cache location
ossv-scan --cache-dir /path/to/cache /path/to/project

Python API

from ossv_scanner import Scanner

# Create a scanner instance
scanner = Scanner()

# Scan a project
results = scanner.scan('/path/to/project')

# Generate report
scanner.generate_report(results, output_format='html', output_path='report.html')

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ossv_scanner-0.1.0-py3-none-any.whl (50.7 kB view details)

Uploaded Python 3

File details

Details for the file ossv_scanner-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: ossv_scanner-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 50.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for ossv_scanner-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 5844b8c27a4554fa602e33370524e164c84a47a3f30ac4902234c51589e003cf
MD5 e6030988bd0ba291eab58259c10e1cd9
BLAKE2b-256 e8473d56e358980ee0a63f17d6fe7a952bab0ba1d946f89e7eddb0f1903d57b2

See more details on using hashes here.

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