How amramer101/vulnera works
Vulnera is a Rust HTTP API for dependency and repository vulnerability analysis. The main flow accepts a manifest or repository request, parses package dependencies, looks up vulnerabilities across advisory sources, and returns an analysis report with optional safe-version recommendations. Separate branches cover vulnerability browsing, popular packages, health/metrics, repository fetching, caching, and registry version lookup. The graph follows the documented layered design; edges are limited to relationships shown in excerpts, the source index, or README. Many parser and controller details were not sampled, so their internal links are omitted.
Main entry points: services.rs Analysis Services · routes.rs HTTP Routes · analysis.rs Analysis Controller · api_clients Advisory Clients
Components 22
HTTP API
- HTTP Routes
src/presentation/routes.rs - Analysis Controller
src/presentation/controllers/analysis.rs - Health Controller
src/presentation/controllers/health.rs - API Models
src/presentation/models.rs - HTTP Middleware
src/presentation/middleware.rs
Analysis Application
- Analysis Services
src/application/services.rs - Use Cases
src/application/use_cases.rs - Configuration
src/config.rs
Infrastructure
- Manifest Parsers
src/infrastructure/parsers - Repository Fetching
src/infrastructure/repository_source - Advisory Repository
src/infrastructure/repositories.rs - Advisory Clients
src/infrastructure/api_clients - Filesystem Cache
src/infrastructure/cache/file_cache.rs - Package Registries
src/infrastructure/registries/mod.rs - Resilience
src/infrastructure/resilience.rs
Domain Model
- Package Data
src/domain/entities.rs - Domain Services
src/domain/services.rs - Domain Values
src/domain/value_objects.rs
Other components
- API Client
- OSV
- NVD
- GitHub Advisories
Connections 22
- API Client → HTTP Routes: sends requests
README.md - HTTP Routes → Analysis Controller: routes analysis
src/presentation/routes.rs - HTTP Routes → Health Controller: routes health
src/presentation/routes.rs - Analysis Controller → API Models: uses DTOs
src/presentation/controllers/analysis.rs - Analysis Controller → Analysis Services: invokes analysis
src/presentation/controllers/analysis.rs - Analysis Controller → Repository Fetching: analyzes repositories
README.md - HTTP Routes → HTTP Middleware: applies middleware
src/presentation/routes.rs - Analysis Services → Manifest Parsers: parses manifests
src/application/services.rs - Analysis Services → Repository Fetching: fetches repository files
src/application/services.rs - Analysis Services → Advisory Repository: queries advisories
- Analysis Services → Filesystem Cache: reads and writes
src/application/services.rs - Analysis Services → Package Registries: looks up versions
src/application/services.rs - Analysis Services → Package Data: processes packages
- Advisory Repository → Advisory Clients: uses clients
src/infrastructure/repositories.rs - Advisory Clients → OSV: queries advisories
README.md - Advisory Clients → NVD: queries advisories
README.md - Advisory Clients → GitHub Advisories: queries advisories
README.md - Manifest Parsers → Package Data: creates packages
- Repository Fetching → API Client: fetches repository
README.md - Analysis Services → Domain Services: uses domain logic
- Package Data → Domain Values: uses values
src/domain/entities.rs - Health Controller → API Models: returns health data
src/presentation/controllers/health.rs