pub enum TargetSource {
Seed,
Resolved,
UserOverride,
}Expand description
Provenance of a resolved identity.
The UserOverride variant serializes with the hyphenated user-override
wire/DB value.
use simbad_resolver::TargetSource;
// A `user-override` row is sticky: nothing lower-precedence may overwrite it.
assert!(TargetSource::UserOverride.may_overwrite(TargetSource::Resolved));
assert!(!TargetSource::Resolved.may_overwrite(TargetSource::UserOverride));
assert_eq!(TargetSource::UserOverride.as_wire(), "user-override");Variants§
Seed
Loaded from a bundled seed index at first run.
Resolved
Resolved live from SIMBAD.
UserOverride
A manual user correction; wins over seed/resolved.
Implementations§
Source§impl TargetSource
impl TargetSource
Sourcepub fn as_wire(self) -> &'static str
pub fn as_wire(self) -> &'static str
The wire/DB string for this source (UserOverride is the hyphenated
user-override).
use simbad_resolver::TargetSource;
assert_eq!(TargetSource::UserOverride.as_wire(), "user-override");
assert_eq!(TargetSource::Seed.as_wire(), "seed");Sourcepub fn from_wire(s: &str) -> Option<Self>
pub fn from_wire(s: &str) -> Option<Self>
Parse a wire/DB string into a TargetSource. Returns None for an
unrecognised value.
use simbad_resolver::TargetSource;
assert_eq!(TargetSource::from_wire("user-override"), Some(TargetSource::UserOverride));
assert_eq!(TargetSource::from_wire("bogus"), None);Sourcepub fn precedence(self) -> u8
pub fn precedence(self) -> u8
Source precedence rank for conflicting writes: higher wins.
user-override (2) > resolved (1) > seed (0).
use simbad_resolver::TargetSource;
assert!(TargetSource::UserOverride.precedence() > TargetSource::Resolved.precedence());
assert!(TargetSource::Resolved.precedence() > TargetSource::Seed.precedence());Sourcepub fn may_overwrite(self, existing: Self) -> bool
pub fn may_overwrite(self, existing: Self) -> bool
Whether a write with self as the incoming source may overwrite an
existing row whose source is existing.
A user-override row is sticky: a later resolved/seed result MUST
NOT overwrite it. An equal-or-higher-precedence incoming source wins
(re-resolving refreshes a resolved row; an override always wins).
This is what crate::Cache::upsert implementations must honour.
use simbad_resolver::TargetSource;
assert!(TargetSource::Resolved.may_overwrite(TargetSource::Seed));
assert!(!TargetSource::Seed.may_overwrite(TargetSource::UserOverride));