Struct CoherencePolicy 

pub struct CoherencePolicy { /* private fields */ }

Policy configuring how [crate::manager::ProxyManager::acquire_proxy_with_coherence] reacts to a CoherenceVerdict::Mismatch.

The default CoherencePolicy::advisory policy never blocks; every mismatch is logged and the proxy is returned. Operators opt into blocking via CoherencePolicy::hard_fail_on or the CoherencePolicy::with_hard_fail builder step.

Implementations

impl CoherencePolicy

pub const fn advisory() -> Self

Advisory-only policy: every mismatch is logged, none block.

Example

use stygian_proxy::ports::coherence::{CoherencePolicy, MismatchField};
let policy = CoherencePolicy::advisory();
assert!(!policy.is_hard_fail(MismatchField::ProxyGeoVsDns));
assert!(policy.is_advisory_only());

pub fn hard_fail_on(field: MismatchField) -> Self

Build a policy that fails on a single hard-mismatch field.

Example

use stygian_proxy::ports::coherence::{CoherencePolicy, MismatchField, MismatchSeverity};
let policy = CoherencePolicy::hard_fail_on(MismatchField::WebRtcPublicIp);
assert!(policy.is_hard_fail(MismatchField::WebRtcPublicIp));
assert_eq!(policy.severity(MismatchField::WebRtcPublicIp), MismatchSeverity::Hard);
assert!(!policy.is_hard_fail(MismatchField::Timezone));

pub fn with_hard_fail(self, field: MismatchField) -> Self

Builder step: register an additional hard-fail field.

Example

use stygian_proxy::ports::coherence::{CoherencePolicy, MismatchField};
let policy = CoherencePolicy::advisory()
    .with_hard_fail(MismatchField::ProxyGeoVsDns)
    .with_hard_fail(MismatchField::WebRtcPublicIp);
assert!(policy.is_hard_fail(MismatchField::ProxyGeoVsDns));
assert!(policy.is_hard_fail(MismatchField::WebRtcPublicIp));
assert!(!policy.is_hard_fail(MismatchField::Timezone));

pub fn contains(&self, field: MismatchField) -> bool

Returns true when field is registered as a hard-fail vector.

Example

use stygian_proxy::ports::coherence::{CoherencePolicy, MismatchField};
let policy = CoherencePolicy::hard_fail_on(MismatchField::Timezone);
assert!(policy.is_hard_fail(MismatchField::Timezone));
assert!(!policy.is_hard_fail(MismatchField::Locale));

pub fn is_hard_fail(&self, field: MismatchField) -> bool

Alias for CoherencePolicy::contains matching the policy.is_hard_fail(field) shape used in the rustdoc examples above.

pub fn is_advisory_only(&self) -> bool

Returns true when no field is registered for hard-fail.

pub fn severity(&self, field: MismatchField) -> MismatchSeverity

Severity under which the policy blocks a request on field.

Always MismatchSeverity::Hard for registered fields and MismatchSeverity::Advisory otherwise. Used by the manager to decide whether a given CoherenceVerdict::Mismatch should fail the acquisition or just be logged.

pub fn hard_fail_count(&self) -> usize

Number of registered hard-fail fields.

Trait Implementations

impl Clone for CoherencePolicy

fn clone(&self) -> CoherencePolicy

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CoherencePolicy

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CoherencePolicy

fn default() -> CoherencePolicy

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CoherencePolicy

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for CoherencePolicy

impl PartialEq for CoherencePolicy

fn eq(&self, other: &CoherencePolicy) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for CoherencePolicy

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CoherencePolicy