django-pronouns 0.3.0

Installing

Install via pip:

$ pip install django-pronouns

Add it to your INSTALLED_APPS in Django:

INSTALLED_APPS = (
        # ...
        "django_pronouns",
        # ...
)

And finally, add the default pronoun set, if you want:

$ python manage.py loaddata pronouns

You can edit these pronouns, add more, or remove some later, via the administration area.

Using

Simply add a ForeignKey link to the Pronoun model to add pronouns to any model. Pronouns work very well when coupled with a UserProfile:

from django.db import models
from django.contrib.auth.models import User

from django_pronouns.models import Pronoun

class UserProfile(models.Model):
        user = models.OneToOneField(User)

        name = models.CharField(max_length=255)
        dob = models.DateField()
        pronoun = models.ForeignKey(Pronoun)

Use them like you would any other ForeignKey in forms.

In your templates, you can request any of the pronoun forms:

{{ user.pronoun.subject|title }} is awesome.

It is {{ user.name|pluralize }} birthday today. Go wish {{ user.pronoun.object }} happy birthday!

{{ user.name }} looked at {{ user.pronoun.reflexive }} in the mirror.

{{ user.pronoun.possessive_determiner|title }} stuff is on the table.

This guitar is {{ user.pronoun.possessive_pronoun }}.

A bunch of shortcut have also been provided, as working out which form to use is annoying. Each of the five forms has a number of aliases, consisting of the feminine and masculine forms joined with an underscore, as well as the Spivak forms:

• Subject: he_she, she_he, ey

• Object: him_her, her_him, em

• Reflexive: himself_herself, herself_himself, emself

• Possessive determiner: his_her, her_his, eir

• Possessive pronoun: his_hers, hers_his, eirs

Using them is the same as using the names forms:

{{ user.pronoun.she_he|title }} is awesome.

It is {{ user.name|pluralize }} birthday today. Go wish {{ user.pronoun.him_her }} a happy birthday!

{{ user.name }} looked at {{ user.pronoun.emself }} in the mirror.

{{ user.pronoun.his_her|title }} stuff is on the table.

This guitar is {{ user.pronoun.hers_his }}.