Enum Gender 

pub enum Gender {
    Masculine,
    Feminine,
    Neutral,
    Unknown,
}

Gender classification for NLP tasks.

Used for pronoun resolution, coreference clustering, and bias analysis.

Examples

use anno::Gender;

let gender = Gender::from_pronoun("she");
assert_eq!(gender, Some(Gender::Feminine));

let gender = Gender::from_pronoun("they");
assert_eq!(gender, Some(Gender::Neutral));

Variants

Masculine

Masculine (he/him/his)

Feminine

Feminine (she/her/hers)

Neutral

Neutral or non-binary (they/them/theirs, it/its).

Encompasses both grammatical neutrality (singular “they”/“it” as convenience or for inanimate referents) and personal pronoun choice (they/it as identity, used by some genderqueer individuals).

Unknown

Unknown or unspecified (default).

Absence of information about gender. Compatible with all other genders (acts as a wildcard in coreference). Distinct from Neutral, which is a positive assertion (“uses they/it”).

Implementations

impl Gender

pub fn from_pronoun(pronoun: &str) -> Option<Gender>

Infer gender from a pronoun.

Returns None for non-pronoun inputs.

Examples

use anno::Gender;

assert_eq!(Gender::from_pronoun("he"), Some(Gender::Masculine));
assert_eq!(Gender::from_pronoun("She"), Some(Gender::Feminine));
assert_eq!(Gender::from_pronoun("they"), Some(Gender::Neutral));
assert_eq!(Gender::from_pronoun("it"), Some(Gender::Neutral));
assert_eq!(Gender::from_pronoun("John"), None);

pub fn subject_pronoun(&self) -> &'static str

Get typical subject pronoun for this gender (English only).

Returns English pronouns unconditionally. For other languages, use language-specific pronoun generation (e.g., French il/elle, German er/sie/es).

pub fn object_pronoun(&self) -> &'static str

Get typical object pronoun for this gender (English only).

Returns English pronouns unconditionally. See subject_pronoun.

pub fn possessive_pronoun(&self) -> &'static str

Get typical possessive pronoun for this gender (English only).

Returns English pronouns unconditionally. See subject_pronoun.

pub fn is_compatible(&self, other: &Gender) -> bool

Check if this gender is compatible with another for coreference.

Unknown is compatible with everything. Neutral is compatible with everything (singular they can refer to any gender).

Trait Implementations

impl Clone for Gender

fn clone(&self) -> Gender

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Gender

impl Debug for Gender

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

Formats the value using the given formatter.

impl Default for Gender

fn default() -> Gender

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Gender

fn deserialize<__D>( __deserializer: __D, ) -> Result<Gender, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Gender

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

Formats the value using the given formatter.

impl Eq for Gender

impl FromStr for Gender

type Err = String

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Gender, <Gender as FromStr>::Err>

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

impl Hash for Gender

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 Gender

fn eq(&self, other: &Gender) -> 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 Serialize for Gender

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 StructuralPartialEq for Gender