# evennia.utils.verb_conjugation.pronouns

English pronoun mapping between 1st/2nd person and 3rd person perspective (and vice-versa).

This file is released under the Evennia regular BSD License. (Griatch 2021)

Pronouns are words you use instead of a proper name, such as ‘him’, ‘herself’, ‘theirs’ etc. These look different depending on who sees the outgoing string. This mapping maps between 1st/2nd case and the 3rd person case and back. In some cases, the mapping is not unique; it is assumed the system can differentiate between the options in some other way.

viewpoint/pronouns | Subject Pronoun | Object Pronoun | Possessive Adjective | Possessive Pronoun | Reflexive Pronoun
--- | --- | --- | --- | --- | ---
1st person | I | me | my | mine | myself
1st person plural | we | us | our | ours | ourselves
2nd person | you | you | your | yours | yourself
2nd person plural | you | you | your | yours | yourselves
3rd person male | he | him | his | his | himself
3rd person female | she | her | her | hers | herself
3rd person neutral | it | it | its | theirs* | itself
3rd person plural | they | them | their | theirs | themselves

> *) Not formally used, we use theirs here as a filler.

`evennia.utils.verb_conjugation.pronouns.``pronoun_to_viewpoints`(pronoun, options=None, pronoun_type='object_pronoun', gender='neutral', viewpoint='2nd person')

  Access function for determining the forms of a pronount from different viewpoints.

  Parameters

    - pronoun (str) – A valid English pronoun, such as ‘you’, ‘his’, ‘themselves’ etc.

    - options (str or list, optional) – A list or space-separated string of options to help the engine when there is no unique mapping to use. This could for example be “2nd female” (alias ‘f’) or “possessive adjective” (alias ‘pa’ or ‘a’).

    - pronoun_type (str, optional) –

      An explicit object pronoun to separate cases where there is no unique mapping. Pronoun types defined in options take precedence. Values are

      - subject pronoun/subject/sp (I, you, he, they)

      - object pronoun/object//op (me, you, him, them)

      - possessive adjective/adjective/pa (my, your, his, their)

      - possessive pronoun/pronoun/pp (mine, yours, his, theirs)

    - gender (str, optional) –

      Specific gender to use (plural counts a gender for this purpose). A gender specified in options takes precedence. Values and aliases are:

      - male/m

      - female/f

      - neutral/n

      - plural/p

    - viewpoint (str, optional) –

      A specified viewpoint of the one talking, to use when there is no unique mapping. A viewpoint given in options take precedence. Values and aliases are:

      - 1st person/1st/1

      - 2nd person/2nd/2

      - 3rd person/3rd/3

  Returns

    tuple – A tuple (1st/2nd_person_pronoun, 3rd_person_pronoun) to show to the one sending the string and others respectively. If pronoun is invalid, the word is returned verbatim.

  Note

  The capitalization of the original word will be retained.