Skip to content

livery.strongroom._errors

livery.strongroom._errors

The store's refusals, one class per thing a caller decides on.

Every error message names what was found and what was expected, so a caller prints it and a reader knows the next action. A caller that only wants to know "did the store refuse" catches livery.strongroom.StoreError; one that retries on a lost race catches livery.strongroom.RefConflict.

Classes:

Name Description
StoreError

The store refused an operation; the message says why.

ManifestError

The root manifest is missing, malformed, or of another store.

IntegrityError

Bytes do not match their name: a landing mismatch or a corrupt object.

MissingObject

The named object is not in the store.

ErasedObject

The named object was erased; its tombstone says why.

UnknownNamespace

A ref names a namespace the store was not opened with.

RefConflict

A compare-and-swap lost: the ref does not name the expected previous digest.

WriteOnceRefused

A write-once ref already names a different digest.

NotFastForward

A monotone ref's new target does not descend from its current one.

RefTampered

A ref and its record disagree: an out-of-band edit or a torn update.

LockTimeout

A live lock on the ref was not released within the timeout.

NoSuchPending

The named pending publish does not exist: retired, committed, or never begun.

NotAGroup

The pending ref is a single publish's, not a group's.

GroupHalfApplied

A commit already applied part of the group; only a commit finishes it.

RefProtected

The ref's mutation class does not allow dropping it.

StoreError

Bases: Exception

The store refused an operation; the message says why.

ManifestError

Bases: StoreError

The root manifest is missing, malformed, or of another store.

IntegrityError

Bases: StoreError

Bytes do not match their name: a landing mismatch or a corrupt object.

MissingObject

Bases: StoreError

The named object is not in the store.

ErasedObject

Bases: StoreError

The named object was erased; its tombstone says why.

UnknownNamespace

Bases: StoreError

A ref names a namespace the store was not opened with.

RefConflict

Bases: StoreError

A compare-and-swap lost: the ref does not name the expected previous digest.

WriteOnceRefused

Bases: RefConflict

A write-once ref already names a different digest.

NotFastForward

Bases: RefConflict

A monotone ref's new target does not descend from its current one.

RefTampered

Bases: StoreError

A ref and its record disagree: an out-of-band edit or a torn update.

LockTimeout

Bases: StoreError

A live lock on the ref was not released within the timeout.

NoSuchPending

Bases: StoreError

The named pending publish does not exist: retired, committed, or never begun.

NotAGroup

Bases: StoreError

The pending ref is a single publish's, not a group's.

GroupHalfApplied

Bases: StoreError

A commit already applied part of the group; only a commit finishes it.

RefProtected

Bases: StoreError

The ref's mutation class does not allow dropping it.