A Python toolkit for loading, unifying, and enriching Vulnerability-Fixing Commit (VFC) datasets.

Plenty of VFC datasets exist, but they differ in schema, content, and completeness. Some were built years ago and contain stale data, such as project URLs that have since moved between hosting platforms. vfc_datasets loads the datasets through a single interface and yields a shared DatasetEntry. Transformations let you deduplicate, filter, sanitize, and enrich entries with commit data (message, diff, files changed, timestamp).

Open the repo in VS Code and run Reopen in Container to use the provisioned devcontainer.

Alternatively, install into your own environment (requires Python 3.12+):

pip install -e .

All settings have sensible defaults. To override them, copy .env.example to .env and adjust as needed.

See examples/ for scripts covering loading, combining, transforming, and enriching entries with commit data.

Issues and PRs are very welcome, especially for new VFC datasets:

• Adding one: see vfc_datasets/commit_level/ and vfc_datasets/function_level/ for reference implementations.
• Suggesting one: open an issue pointing to the dataset.

If you use any of these datasets for your research, please cite the original dataset authors. Paper titles and URLs are available via DatasetClass.metadata.paper_url.

If you find our toolkit useful, please consider citing it as:

TODO