use std::sync::Arc;
use kafka_client_core::DescribeFeaturesMachineError;
use crate::{
EngineConfig,
admin::AdminCompletionNotifier,
clock::MonotonicClock,
driver::{DescribeFeaturesCall, DriverOwner},
};
use super::{
DescribeFeaturesAdmissionErrorKind, DescribeFeaturesDeliveryStatus,
DescribeFeaturesFailureKind, DescribeFeaturesHost, DescribeFeaturesHostError,
DescribeFeaturesOutcome, DescribeFeaturesTurn,
host::{DESCRIBE_FEATURES_RESULT_BYTES, DESCRIBE_FEATURES_RETAINED_BYTES},
};
#[test]
fn admission_reserves_terminal_and_full_envelope_before_submission() {
let (mut notifier, ports) =
AdminCompletionNotifier::start().unwrap_or_else(|error| panic!("notifier: {error}"));
let mut host = DescribeFeaturesHost::new(ports.describe_features);
let capture = deadline();
let admission = host
.try_admit(capture.now(), capture.operation_deadline())
.unwrap_or_else(|error| panic!("admit resource query: {error:?}"));
assert!(admission.fault.is_none());
let operation_bytes = host.retained_bytes_for_test();
assert!(operation_bytes > DESCRIBE_FEATURES_RESULT_BYTES);
assert!(operation_bytes < DESCRIBE_FEATURES_RETAINED_BYTES);
let DescribeFeaturesTurn::Submit(submission) = host
.turn(capture.now())
.unwrap_or_else(|error| panic!("submission turn: {error}"))
else {
panic!("submission expected");
};
let (operation_id, submitted_deadline, result_limit) = submission.into_parts();
assert_eq!(submitted_deadline, capture.operation_deadline());
assert_eq!(result_limit, DESCRIBE_FEATURES_RESULT_BYTES);
let mut extra_observers = Vec::new();
while let Ok(extra) = host.try_admit(capture.now(), capture.operation_deadline()) {
extra_observers.push(extra.observer);
}
assert_eq!(
1 + extra_observers.len(),
DESCRIBE_FEATURES_RETAINED_BYTES / operation_bytes
);
assert!(matches!(
host.try_admit(capture.now(), capture.operation_deadline()),
Err(DescribeFeaturesAdmissionErrorKind::RetainedBytes)
));
drop(admission.observer);
drop(extra_observers);
host.reject_handoff(operation_id)
.unwrap_or_else(|error| panic!("reject inspected handoff: {error}"));
host.recover_after_driver_shutdown()
.unwrap_or_else(|error| panic!("recover host: {error}"));
drop(host);
stop_notifier(&mut notifier);
}
#[test]
fn untouched_shutdown_is_definitely_unsent_and_reclaimable() {
let (mut notifier, ports) =
AdminCompletionNotifier::start().unwrap_or_else(|error| panic!("notifier: {error}"));
let mut host = DescribeFeaturesHost::new(ports.describe_features);
let capture = deadline();
let admission = host
.try_admit(capture.now(), capture.operation_deadline())
.unwrap_or_else(|error| panic!("admit resource query: {error:?}"));
host.recover_after_driver_shutdown()
.unwrap_or_else(|error| panic!("recover untouched query: {error}"));
let DescribeFeaturesOutcome::Failed(failure) = admission
.observer
.wait()
.unwrap_or_else(|error| panic!("observe recovery: {error}"))
else {
panic!("failure expected");
};
assert_eq!(failure.kind(), DescribeFeaturesFailureKind::DriverRejected);
assert_eq!(failure.delivery(), DescribeFeaturesDeliveryStatus::NotSent);
let _progress = host
.turn(capture.now())
.unwrap_or_else(|error| panic!("reclaim turn: {error}"));
assert_eq!(host.retained_bytes_for_test(), 0);
drop(host);
stop_notifier(&mut notifier);
}
#[test]
fn handed_off_without_a_returned_call_cannot_forge_recovery_evidence() {
let (mut notifier, ports) =
AdminCompletionNotifier::start().unwrap_or_else(|error| panic!("notifier: {error}"));
let mut host = DescribeFeaturesHost::new(ports.describe_features);
let capture = deadline();
let admission = host
.try_admit(capture.now(), capture.operation_deadline())
.unwrap_or_else(|error| panic!("admit resource query: {error:?}"));
let DescribeFeaturesTurn::Submit(_submission) = host
.turn(capture.now())
.unwrap_or_else(|error| panic!("handoff turn: {error}"))
else {
panic!("submission expected");
};
assert!(matches!(
host.recover_after_driver_shutdown(),
Err(DescribeFeaturesHostError::InvalidHandoff)
));
drop((admission, host));
stop_notifier(&mut notifier);
}
#[test]
fn recovered_call_remains_retained_when_core_rejects_terminal_fact() {
let (mut notifier, ports) =
AdminCompletionNotifier::start().unwrap_or_else(|error| panic!("notifier: {error}"));
let mut host = DescribeFeaturesHost::new(ports.describe_features);
let capture = deadline();
let admission = host
.try_admit(capture.now(), capture.operation_deadline())
.unwrap_or_else(|error| panic!("admit resource query: {error:?}"));
host.retain_recovered_call_for_test();
assert!(matches!(
host.settle_recovered_transport_for_test(),
Err(DescribeFeaturesHostError::Machine(
DescribeFeaturesMachineError::InvalidState
))
));
assert!(host.recovered_call_is_retained_for_test());
assert!(matches!(
host.publish_terminal_for_test(),
Err(DescribeFeaturesHostError::InvalidHandoff)
));
drop((admission, host));
stop_notifier(&mut notifier);
}
#[test]
fn completion_fault_retains_call_until_post_driver_recovery() {
let (mut notifier, ports) =
AdminCompletionNotifier::start().unwrap_or_else(|error| panic!("notifier: {error}"));
let mut host = DescribeFeaturesHost::new(ports.describe_features);
let capture = deadline();
let admission = host
.try_admit(capture.now(), capture.operation_deadline())
.unwrap_or_else(|error| panic!("admit resource query: {error:?}"));
let DescribeFeaturesTurn::Submit(submission) = host
.turn(capture.now())
.unwrap_or_else(|error| panic!("handoff turn: {error}"))
else {
panic!("submission expected");
};
let (operation_id, submitted_deadline, _result_limit) = submission.into_parts();
let driver = DriverOwner::build(&EngineConfig::new(vec!["127.0.0.1:1".to_owned()]))
.unwrap_or_else(|error| panic!("driver owner: {error}"));
let call = DescribeFeaturesCall::submit(&driver, submitted_deadline.transport())
.unwrap_or_else(|_error| panic!("accepted call"));
host.accept_call(operation_id, call)
.unwrap_or_else(|error| panic!("host acceptance: {error}"));
drop(driver);
assert!(matches!(
host.turn(capture.now()),
Err(DescribeFeaturesHostError::CallCompletion)
));
host.recover_after_driver_shutdown()
.unwrap_or_else(|error| panic!("post-driver recovery: {error}"));
let DescribeFeaturesOutcome::Failed(failure) = admission
.observer
.wait()
.unwrap_or_else(|error| panic!("recovery observation: {error}"))
else {
panic!("recovery failure expected");
};
assert_eq!(failure.kind(), DescribeFeaturesFailureKind::Transport);
assert_eq!(
failure.delivery(),
DescribeFeaturesDeliveryStatus::PossiblySent
);
drop(host);
stop_notifier(&mut notifier);
}
fn deadline() -> crate::clock::DeadlineCapture {
Arc::new(MonotonicClock::new())
.capture_deadline_after(std::time::Duration::from_secs(5))
.unwrap_or_else(|error| panic!("deadline: {error}"))
}
fn stop_notifier(notifier: &mut AdminCompletionNotifier) {
notifier
.stop()
.unwrap_or_else(|error| panic!("stop notifier: {error}"))
.join_off_notifier()
.unwrap_or_else(|_| panic!("join notifier"));
}