CTY Values¶
The pyvider.cty.values module defines the CtyValue class, which represents immutable, type-safe data instances in the cty system.
🤖 AI-Generated Content
This documentation was generated with AI assistance and is still being audited. Some, or potentially a lot, of this information may be inaccurate. Learn more.
Key concepts:
- Immutability - Once created, CtyValue instances cannot be modified. All operations return new values.
- Type safety - Every value has an associated CtyType that governs its structure and operations
- Special values - Support for null values (CtyValue.null(type)) and unknown values (CtyValue.unknown(type))
- Marks - Ability to attach metadata to values without modifying the value itself
- Raw value access - Use the .raw_value property to access the underlying Python value
Creating Values: You should always create values through type validation (my_type.validate(data)) rather than constructing CtyValue directly. The validation process ensures type safety and proper initialization.
Accessing Data: Values support Python's standard access patterns - use value['attr'] for object attributes, value[index] for list/tuple elements, and iteration (for item in list_value) for collections.
For detailed value documentation, see: User Guide: Working with Values