cvelist.rb

Description

A Ruby library for parsing the CVE JSON in the cvelist git repository.

Features

Supports downloading/updating cvelist Git repository.
Supports CVE JSON Schema v4.0

Examples

require 'cvelist'

Cloning the cvelist repository:

repo = CVEList::Repository.clone('path/to/cvelist')

Using an existing cvelist repository:

repo = CVEList::Repository.new('path/to/cvelist')

Updating an existing cvelist repository:

repo.pull!

Get the total number of CVEs in the repository:

repo.size

Access an individual CVE in the repository:

repo['CVE-2020-0001']

Enumerating over every CVE in the repository:

repo.each do |cve|
  puts cve.id
end

Enumerating over every CVE in a certain year:

repo.year(2020).each do |cve|
  puts cve.id
end

Requirements

multi_json ~> 1.0
cve_schema ~> 0.1

Install

$ gem install cvelist

Benchmark

Warming up the disk cache with a first run. This may take a while ...
Parsing all 192879 CVE .json files ...

Total:   18.285097   1.651155  19.936252 ( 20.144566)
Avg:      0.000095   0.000009   0.000103 (  0.000104)

Copyright

See LICENSE for details.