`yggdrasil.pickle.ser`¶

ser ¶

Raised when a header cannot be parsed from the buffer.

Raised when an unknown codec id is encountered.

Raised when encoded metadata is malformed.

Bases: RuntimeError

Base exception for yggdrasil.pickle.ser.

Serialized(head: Header, data: IO)

Bases: ABC, Generic[T]

module_and_name(obj: Any, *, fallback: str = '') -> tuple[str, str]

Return (module, qualname) for obj.

Robust across Python objects, including many C-extension / PyArrow objects where module may be missing or misleading.

dump(
    obj: Any,
    fp: IO[bytes] | Path | str,
    *,
    metadata: Mapping[bytes, bytes] | None = None,
    codec: int | None = None
) -> None

Serialise obj and write it to fp (file-like, :class:~pathlib.Path, or str path).

dumps(
    obj: Any,
    *,
    metadata: Mapping[bytes, bytes] | None = None,
    codec: int | None = None,
    b64: bool = False
) -> bytes | str

Serialise obj to bytes, or to a URL-safe base-64 str when b64 is True.

load(
    fp: IO[bytes] | Path | str,
    *,
    unpickle: bool = True,
    clean_corrupted: bool = False,
    default: Any = None
) -> Any

Read a serialised payload from fp and optionally unpickle it.

loads(s: bytes | str, *, unpickle: bool = True) -> Any

Deserialise from s (bytes or URL-safe base-64 str).

serialize(
    obj: Any,
    *,
    metadata: Mapping[bytes, bytes] | None = None,
    codec: int | None = None
) -> Serialized

Wrap obj in a :class:Serialized instance without writing to a buffer.