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. |
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.