Pronouns service
Published on , 839 words, 4 minutes to read
On November 28, 2022, Heroku discontinued their free tier. This free tier had been a staple of the Internet and was widely used to host simple apps that don't need to be online 24/7. One of those apps was pronoun.is, a simple service that showed you the usage of third person personal pronouns in English, including some nonstandard/neopronoun sets. If you wanted to know how to use they/them, you could go to pronoun.is/they/.../themselves and see examples right there.
pronoun.is links are very common to see in bios on social media profiles, so it's very sad for me to see this go. I want to make it easy for people to share these usage examples with others for their reference and for your use in bio text, so I created pronouns.within.lgbt as a replacement.
The pronouns service
I created the pronouns service at
pronouns.within.lgbt to give people most of the
functionality of pronoun.is. With a few exceptions, you should be able to
replace pronoun.is with pronouns.within.lgbt in your social media bio. This
is a simple service written in Rust and running on fly.io. I
also added an api so that you can
integrate it with other applications or chatbots.
How it works
The pronouns service has a giant list of pronouns that it knows about. These pronouns were scraped from the data file that powers pronoun.is, as well as an extra set that I really care about. A python script transforms the table into a bunch of dhall files that are then read by the Rust program.
The Rust program will then reformat all of those entries into a hashmap where
the key is all of the pronouns in the group separated by slashes. For example,
the pronoun set for she/her will have a key of she/her/her/hers/herself.
When a user goes to something like
/she/her, the service will loop over the
entire hashmap for pronoun sets that start with she/her. If it finds a match,
it returns that data.
What about the reflexive singular form of they (themself)? That would have the same starting characters as the reflexive plural form of they (themselves).
I added a hack to handle this. If you go to pronouns.within.lgbt/they/.../themselves, it will work as you expect.
Then you can use it like you would use pronoun.is.
DNS
After I moved off of Cloudflare last year, I moved all my DNS management into AWS Route 53 and I manage it with Terraform. I made a small terraform file that points to the fly.io deployment and applied it on stream.
Everything worked as expected.
How many levels of SRE are you on?
I don't know, maybe like 5 or 6?
You are like a little baby. Watch:
Usage guide
Usually you can get away with a link such as pronouns.within.lgbt/she to get the pronouns and usage examples for she/her pronouns. There are a few cases where there are multiple sets that have the same initial pronoun, like xe/xer and xe/xem. If you get inconsistent results, you may want to be more specific.
There are some neopronouns that are not in the database. If this is the case,
then use the full form of /subject/object/determiner/possessive/reflexive to
get a custom page with your pronouns of choice. For example, you can get the
pronouns for ce/cem by going to
pronouns.within.lgbt/ce/cem/cer/cers/cemself.
If you want to watch things like this get coded and deployed live, be sure to follow the Twitch channel and the stream announcement Mastodon account. Streams will usually be on Saturdays around 12-13 EST and go on until they are done. The streams will usually contain things that don't get recorded in the blogposts that result from them.
Facts and circumstances may have changed since publication. Please contact me before jumping to conclusions if something seems wrong or unclear.
Tags: rust, axum, dhall, TransRightsAreHumanRights