Enum InsiderPosition 

#[non_exhaustive]
pub enum InsiderPosition {
    Officer,
    Director,
    Owner,
    Ceo,
    Cfo,
    Coo,
    Cto,
    President,
    VicePresident,
    Secretary,
    Treasurer,
    Other(OtherInsiderPosition),
}

Insider positions in a company with canonical variants and extensible fallback.

This enum provides type-safe handling of insider positions while gracefully handling unknown or provider-specific positions through the Other variant.

Canonical/serde rules:

• Emission uses a single canonical form per variant (UPPERCASE ASCII, no spaces)
• Parser accepts a superset of tokens (aliases, case-insensitive)
• Other(s) serializes to its canonical code() string (no escape prefix)
• Display output matches the canonical code for known variants and the raw s for Other(s)
• Serde round-trips preserve identity for canonical variants; unknown tokens normalize to Other(UPPERCASE)

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Officer

Officer of the company

Director

Director or board member

Owner

Beneficial owner (typically >10% ownership)

Ceo

Chief Executive Officer

Cfo

Chief Financial Officer

Coo

Chief Operating Officer

Cto

Chief Technology Officer

President

President

VicePresident

Vice President

Secretary

Secretary

Treasurer

Treasurer

Other(OtherInsiderPosition)

Unknown or provider-specific position

Implementations

impl InsiderPosition

pub fn try_from_str(input: &str) -> Result<InsiderPosition, FundamentalsError>

Attempts to parse an insider position, uppercasing unknown inputs into Other.

Errors

Returns FundamentalsError::InvalidEnumValue when input is empty/whitespace.

pub fn other(input: &str) -> Result<InsiderPosition, FundamentalsError>

Builds an unknown insider position, rejecting modeled positions and aliases.

Errors

Returns an error if input is empty, cannot be canonicalized, or parses to a modeled InsiderPosition variant.

impl InsiderPosition

pub fn code(&self) -> &str

Returns the canonical string code for this value.

impl InsiderPosition

pub const fn is_canonical(&self) -> bool

Returns true when this value represents a canonical variant.

Trait Implementations

impl AsRef<str> for InsiderPosition

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for InsiderPosition

fn clone(&self) -> InsiderPosition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InsiderPosition

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for InsiderPosition

fn deserialize<D>( deserializer: D, ) -> Result<InsiderPosition, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for InsiderPosition

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

Formats the value using the given formatter.

impl Eq for InsiderPosition

impl FromStr for InsiderPosition

type Err = FundamentalsError

The associated error which can be returned from parsing.

fn from_str( input: &str, ) -> Result<InsiderPosition, <InsiderPosition as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for InsiderPosition

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

where __H: Hasher,

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 InsiderPosition

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for InsiderPosition

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl StringCode for InsiderPosition

fn code(&self) -> &str

Returns the canonical string code for this value.

fn is_canonical(&self) -> bool

Whether this value is a canonical enum variant (not an Other payload).

impl StructuralPartialEq for InsiderPosition

impl TryFrom<String> for InsiderPosition

type Error = FundamentalsError

The type returned in the event of a conversion error.

fn try_from( value: String, ) -> Result<InsiderPosition, <InsiderPosition as TryFrom<String>>::Error>

Performs the conversion.