Struct ProgramPlacementConstraint 

pub struct ProgramPlacementConstraint { /* private fields */ }

Requested program placement constraints.

An empty engine list means any engine is allowed.

Examples

use tenferro_runtime::ProgramPlacementConstraint;

assert!(ProgramPlacementConstraint::any().allowed_engines().is_empty());

Implementations

impl ProgramPlacementConstraint

pub fn any() -> Self

Return an unconstrained placement request.

Examples

use tenferro_runtime::ProgramPlacementConstraint;

let any = ProgramPlacementConstraint::any();
assert!(any.allowed_engines().is_empty());
assert!(any.storage_class().is_none());

pub fn new( allowed_engines: impl Into<Arc<[EngineId]>>, storage_class: Option<StorageClass>, ) -> Result<Self, PlacementConstraintError>

Build a placement constraint from engine preferences and storage class.

Examples

use tenferro_runtime::{EngineId, ProgramPlacementConstraint, StorageClass};

let engine = EngineId::new("tenferro.cpu")?;
let storage = StorageClass::new("tenferro.storage.host")?;
let constraint = ProgramPlacementConstraint::new(vec![engine.clone()], Some(storage.clone()))?;
assert_eq!(constraint.allowed_engines(), &[engine]);
assert_eq!(constraint.storage_class(), Some(&storage));

Errors

Returns PlacementConstraintError::DuplicateEngine when the same engine appears more than once.

pub fn allowed_engines(&self) -> &[EngineId]

Return the allowed engines in preference order.

Examples

use tenferro_runtime::{EngineId, ProgramPlacementConstraint};

let engine = EngineId::new("tenferro.cpu")?;
let constraint = ProgramPlacementConstraint::new(vec![engine.clone()], None)?;
assert_eq!(constraint.allowed_engines(), &[engine]);

pub fn storage_class(&self) -> Option<&StorageClass>

Return the requested storage class, if one was supplied.

Examples

use tenferro_runtime::{ProgramPlacementConstraint, StorageClass};

let storage = StorageClass::new("tenferro.storage.host")?;
let constraint = ProgramPlacementConstraint::new(Vec::new(), Some(storage.clone()))?;
assert_eq!(constraint.storage_class(), Some(&storage));

Trait Implementations

impl Clone for ProgramPlacementConstraint

fn clone(&self) -> ProgramPlacementConstraint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProgramPlacementConstraint

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

Formats the value using the given formatter.

impl Hash for ProgramPlacementConstraint

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ProgramPlacementConstraint

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ProgramPlacementConstraint

impl StructuralPartialEq for ProgramPlacementConstraint