Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
CoverageDB
✓ from cocotb_coverage.coverage import CoverageDB
✗ from cocotb_coverage import CoverageDB
CoverageDB must be imported from the submodule 'coverage'.
coverage_db
✓ from cocotb_coverage.coverage import coverage_db
✗ from cocotb_coverage import coverage_db
Singleton instance is in the coverage submodule.
Minimal cocotb test with coverage export.
import cocotb
from cocotb.clock import Clock
from cocotb.triggers import Timer
from cocotb_coverage.coverage import coverage_db
@cocotb.test()
async def test_coverage_example(dut):
cocotb.start_soon(Clock(dut.clk, 10, 'ns').start())
await Timer(5, 'ns')
# Example coverage (requires user-defined covergroups)
coverage_db.export_to_xml(filename="coverage.xml")
Errors
Common errors & fixes
AttributeError: module 'cocotb_coverage' has no attribute 'coverage_db'
Importing from wrong module level.
fixUse 'from cocotb_coverage.coverage import coverage_db' instead.
ImportError: cannot import name 'CoverageDB' from 'cocotb_coverage'
Wrong import path.
fixUse 'from cocotb_coverage.coverage import CoverageDB'.
Upgrade
Version history
2.0latest on PyPI · released Oct 3, 2025
Audit
Dependencies
cocotbrequiredRequired for simulation framework