serde.pickle

 1"""
 2Serialize and Deserialize in Pickle format.
 3"""
 4
 5import pickle
 6from typing import overload, Any, Optional
 7
 8from .compat import T
 9from .de import Deserializer, from_dict
10from .se import Serializer, to_dict
11
12__all__ = ["from_pickle", "to_pickle"]
13
14
15class PickleSerializer(Serializer[bytes]):
16    @classmethod
17    def serialize(cls, obj: Any, **opts: Any) -> bytes:
18        return pickle.dumps(obj, **opts)
19
20
21class PickleDeserializer(Deserializer[bytes]):
22    @classmethod
23    def deserialize(cls, data: bytes, **opts: Any) -> Any:
24        return pickle.loads(data, **opts)
25
26
27def to_pickle(
28    obj: Any,
29    cls: Optional[Any] = None,
30    se: type[Serializer[bytes]] = PickleSerializer,
31    reuse_instances: bool = False,
32    convert_sets: bool = True,
33    **opts: Any,
34) -> bytes:
35    return se.serialize(
36        to_dict(obj, c=cls, reuse_instances=reuse_instances, convert_sets=convert_sets), **opts
37    )
38
39
40@overload
41def from_pickle(
42    c: type[T], data: bytes, de: type[Deserializer[bytes]] = PickleDeserializer, **opts: Any
43) -> T: ...
44
45
46@overload
47def from_pickle(
48    c: Any, data: bytes, de: type[Deserializer[bytes]] = PickleDeserializer, **opts: Any
49) -> Any: ...
50
51
52# For Union, Optional etc.
53def from_pickle(
54    c: Any, data: bytes, de: type[Deserializer[bytes]] = PickleDeserializer, **opts: Any
55) -> Any:
56    return from_dict(c, de.deserialize(data, **opts), reuse_instances=False)