typehash-1.4.0.3: Create a unique hash value for a type.

Data.TypeHash

Description

Produce a hash for a type that is unique for that type. The hash takes both actual type names and type structure into account.

The purpose of the hash of a type is to be able to store the type of a persisted value together with the value. By comparing the type hash of a persisted value and the hash of expected type we can know if the persistened value is of the correct type.

The type hash uses a cryptographic hash and can only be used to test equality.

The type code preserves the exact structure of the type and can be used to check if one type is convertible to another in various ways.

This module uses the reflection offered by Typeable and Data to extract the information.

Synopsis

Documentation

typeCode :: Data a => a -> TypeCodeSource

Turn the type of the value into a type code.

convertibleIso :: TypeCode -> TypeCode -> BoolSource

Are the types strongly isomorphic, only allows change of type names.

convertibleWithReadShow :: TypeCode -> TypeCode -> BoolSource

Can read . show convert the first type to the second? Allows changing type names, allows permuting and/or adding constructors to the new type, also allows permuting named fields of a constructor.

convertibleWithJSON :: TypeCode -> TypeCode -> BoolSource

Can the generic JSON serializer and deserializer convert the first type to the second. Allows changing type names, allows permuting and/or adding constructors to the new type, also allows permuting and/or deleting named fields of a constructor. Furhermore, allows types with a single constructor to change constructor name.

typeHash :: Data a => a -> TypeHashSource

Turn the type of the value into a type hash.