ObjectStore

A flat keyed store with conditional writes.

Functions

funcget(key) -> tuple[bytes, str] | None

Return an object's bytes and entity tag, or None when it does not exist.

paramkeystr

Returns

tuple[bytes, str] | None

funcput(key, data, if_match=None, if_absent=False) -> str

Write an object and return its new entity tag.

paramkeystr

Object key.

paramdatabytes

Its new content.

paramif_matchstr | None

= None

Write only while the object still has this entity tag.

paramif_absentbool

= False

Write only when the object does not exist.

Returns

str

funcdelete(key, if_match=None) -> None

Remove an object; a missing one is not an error.

paramkeystr

paramif_matchstr | None

= None

Returns

None

funclist(prefix='') -> dict[str, str]

Return the entity tag of every object whose key starts with prefix.

paramprefixstr

= ''

Returns

dict[str, str]