crv.core.constants

Experimental API

crv.core.constants

CRV core IO-facing defaults.

Defines partitioning and compression defaults consumed by downstream IO layers. This module is zero-IO and uses only the Python standard library.

Notes

• Downstream writers/readers compute bucket as tick // TICK_BUCKET_SIZE.
• Parquet/Arrow writers size row groups and set compression according to these values.
• Changes to these constants should follow spec/ADR updates.

References

• specs: src/crv/core/.specs/spec-0.1.md, spec-0.2.md
• ADR: src/crv/core/.specs/adr-2025-09-20-core-schema-0.1-and-graphedit-normalization.md

crv.core.constants.TICK_BUCKET_SIZE module-attribute

TICK_BUCKET_SIZE: int = 100

crv.core.constants.ROW_GROUP_SIZE module-attribute

ROW_GROUP_SIZE: int = 128 * 1024

crv.core.constants.COMPRESSION module-attribute

COMPRESSION: typing.Literal['zstd', 'lz4', 'snappy'] = 'zstd'