API Reference

CVSS Parser provides a complete set of Go language APIs for parsing, calculating, and processing CVSS (Common Vulnerability Scoring System) vectors.

Package Structure

CVSS Parser contains three main packages:

📦 cvss

Core package containing CVSS data structures, score calculators, and distance calculation functionality.

Main Types:

• Cvss3x - CVSS 3.x vector representation
• Calculator - CVSS score calculator
• DistanceCalculator - Vector distance calculator

📦 parser

Parsing package responsible for parsing CVSS vector strings into structured data.

Main Types:

• Cvss3xParser - CVSS 3.x vector string parser
• VectorParser - Generic vector parser interface

📦 vector

Vector package providing unified interfaces and implementations for all CVSS metrics.

Main Types:

• Vector - Unified interface for all metrics
• Specific implementations for base, temporal, and environmental metrics

Quick Navigation

🚀 Getting Started

• 5-Minute Quick Start - Fastest way to get started
• Basic Examples - Simple usage examples

📚 Core Packages

• CVSS Package Guide - Core functionality introduction
• Parser Usage - String parsing
• Vector Analysis - Metric interfaces

💡 Practical Examples

• JSON Processing - Data serialization
• Batch Processing - Batch vector parsing
• Similarity Analysis - Vector comparison

Quick Start

Basic Usage

package main

import (
    "fmt"
    "log"

    "github.com/scagogogo/cvss-parser/pkg/cvss"
    "github.com/scagogogo/cvss-parser/pkg/parser"
)

func main() {
    // Parse CVSS vector
    p := parser.NewCvss3xParser("CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H")
    vector, err := p.Parse()
    if err != nil {
        log.Fatalf("Parse failed: %v", err)
    }

    // Calculate score
    calculator := cvss.NewCalculator(vector)
    score, err := calculator.Calculate()
    if err != nil {
        log.Fatalf("Calculation failed: %v", err)
    }

    fmt.Printf("CVSS Score: %.1f\n", score)
    fmt.Printf("Severity: %s\n", calculator.GetSeverityRating(score))
}

Advanced Features

// Vector comparison
distCalc := cvss.NewDistanceCalculator(vector1, vector2)
distance := distCalc.EuclideanDistance()

// JSON serialization
jsonData, err := json.Marshal(vector)

API Design Principles

🎯 Type Safety

All APIs use strong typing to catch errors at compile time:

type Calculator interface {
    Calculate() (float64, error)
    GetSeverityRating(score float64) string
}

🔧 Flexible Configuration

Support multiple configuration options to adapt to different needs:

// Strict mode parsing
parser := parser.NewCvss3xParser(vectorStr)
parser.SetStrictMode(true)

// Tolerant mode parsing
parser.SetStrictMode(false)

📊 Rich Error Information

Provide detailed error information to help with debugging:

if err != nil {
    switch e := err.(type) {
    case *parser.ParseError:
        fmt.Printf("Parse error: %s (position: %d)", e.Message, e.Position)
    case *cvss.CalculationError:
        fmt.Printf("Calculation error: %s", e.Message)
    }
}

Performance Characteristics

⚡ High Performance

• Zero-allocation parser design
• Optimized calculation algorithms
• Memory-friendly data structures

📈 Scalability

• Support for batch processing
• Concurrent-safe design
• Pluggable component architecture

Version Compatibility

CVSS Parser Version	CVSS Specification Support	Go Version Requirement
v1.x	CVSS 3.0, 3.1	Go 1.19+
v2.x	CVSS 3.0, 3.1, 4.0	Go 1.21+

Best Practices

🛡️ Error Handling

Always check errors and provide appropriate handling:

vector, err := parser.Parse()
if err != nil {
    log.Printf("Parse failed: %v", err)
    return
}

🔄 Resource Management

For large data processing, consider using object pools:

var parserPool = sync.Pool{
    New: func() interface{} {
        return parser.NewCvss3xParser("")
    },
}

📊 Performance Monitoring

Use built-in performance metrics:

start := time.Now()
score, err := calculator.Calculate()
duration := time.Since(start)
log.Printf("Calculation took: %v", duration)

Next Steps

• Getting Started - 5-minute quick start guide
• CVSS Package Deep Dive - Core functionality overview
• Example Code - Practical usage examples
• Best Practices - Production environment recommendations

Getting Help

If you encounter issues while using the API:

1. Check the FAQ
2. Browse Example Code
3. Submit issues on GitHub
4. Join Community Discussions