riffdb-errors 0.1.0

First-party RiffDB runtime crate (riffdb-errors)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48

#![forbid(unsafe_code)]
//! Durable primary fencing is a bounded refusal, never retry or unfence authority.
// req: REP-005
use riffdb_errors::{
    ApplicationError, ApplicationErrorCategory, ApplicationErrorCode, ApplicationErrorContext,
    ApplicationOperation, ApplicationRecoveryAction, ErrorClass, PublicError, PublicErrorDetails,
    PublicErrorKind, PublicErrorStatusCode, RecoveryAction,
};

#[test]
fn primary_fenced_is_a_contextless_durable_refusal_without_retry_or_unfence_guidance() {
    let error = PublicError::primary_fenced();
    assert_eq!(error.kind(), PublicErrorKind::PrimaryFenced);
    assert_eq!(error.code(), "primary_fenced");
    assert_eq!(error.safe_message(), "primary is durably fenced");
    assert_eq!(error.details(), &PublicErrorDetails::None);
    assert!(error.incident_id().is_none());
    assert_eq!(error.kind().class(), ErrorClass::FailedPrecondition);
    assert_eq!(
        error.kind().status_code(),
        PublicErrorStatusCode::FailedPrecondition
    );
    assert_eq!(
        error.kind().recovery_action(),
        RecoveryAction::ContactOperator
    );
    let application = ApplicationError::from_public_error(
        &error,
        ApplicationOperation::ExecuteCommand,
        ApplicationErrorContext::empty(),
    );
    let code = application.code();
    assert_eq!(code, ApplicationErrorCode::PrimaryFenced);
    assert_eq!(code.as_str(), "RDB-REP-0102");
    assert_eq!(code.category(), ApplicationErrorCategory::Control);
    assert_eq!(
        code.recovery_action(),
        ApplicationRecoveryAction::ContactOperator
    );
    assert!(code.fixes().is_empty());
    assert!(
        error
            .clone()
            .with_application_code_hint(ApplicationErrorCode::FollowerMode)
            .is_err()
    );
    assert!(error.with_application_code_hint(code).is_ok());
}