{"id":27629,"library":"c-uuid-v7","title":"c-uuid-v7","description":"A fast UUID v7 generator implemented as a CPython C extension, version 0.0.11. Provides a simple interface for generating time-ordered UUIDs compliant with RFC 9562. Released periodically with performance improvements.","status":"active","version":"0.0.11","language":"python","source_language":"en","source_url":"https://github.com/stevesimmons/c-uuid-v7","tags":["uuid","uuid-v7","c-extension","performance"],"install":[{"cmd":"pip install c-uuid-v7","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"Python's stdlib uuid module does not have uuid7; must use this C extension.","wrong":"from uuid import uuid7","symbol":"UUIDv7","correct":"from c_uuid_v7 import UUIDv7"}],"quickstart":{"code":"from c_uuid_v7 import UUIDv7\n\n# Generate a single UUID v7\nuid = UUIDv7()\nprint(uid)  # e.g., 018f3a6e-1b2c-7a3d-8e4f-5a6b7c8d9e0f\n\n# Generate as hex string\nhex_str = uid.hex\nprint(hex_str)\n\n# Generate as bytes\nbytes_val = uid.bytes\nprint(bytes_val)","lang":"python","description":"Generate a UUID v7 using the C extension. The UUIDv7 class can be instantiated directly and provides .hex and .bytes properties."},"warnings":[{"fix":"Upgrade to Python 3.10 or later.","message":"Requires Python >=3.10; on older Python versions, installing from source may fail or produce errors.","severity":"breaking","affected_versions":"0.0.0 to 0.0.11"},{"fix":"Use `from c_uuid_v7 import UUIDv7; uid = UUIDv7()`.","message":"The library exports only UUIDv7, not a function like 'uuid7()' or 'generate()'. Users may mistakenly try to call uuid7() or import from uuid module.","severity":"gotcha","affected_versions":"all"},{"fix":"For cross-process monotonicity, consider using a coordinator or additional sequence counter.","message":"Generated UUIDs are time-ordered but not guaranteed to be strictly monotonic across multiple processes due to clock skew or high concurrency; rely on them for ordering within a single process only.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run `pip install --upgrade c-uuid-v7` and verify the installation with `pip show c-uuid-v7`.","cause":"The library may not be installed correctly, or you have a different package with a similar name.","error":"ImportError: cannot import name 'UUIDv7' from 'c_uuid_v7'"},{"fix":"Install with `pip install c-uuid-v7` and import as `from c_uuid_v7 import UUIDv7`.","cause":"The package is not installed or the import path is wrong (e.g., using hyphen instead of underscore).","error":"ModuleNotFoundError: No module named 'c_uuid_v7'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}