personal pronoun helper module. fork of pronoun.is.
pronouns.js aims to be an easy way to handle numerous personal pronouns in English. It remains open-ended to allow for myriad use cases. One possible application could be in a social media service in which users can add their pronoun(s) and the interface can refer to them properly.
Play the demo here.
npm i --save pronouns
const pronouns = ;const my = ;console;// ['they', 'them', 'their', 'theirs', 'themself']console;// 'they'console;// [// ["she", "her", "her", "hers", "herself"],// ["he", "him", "his", "his", "himself"],// ["they", "them", "their", "theirs", "themself"],// ["ze", "hir", "hir", "hirs", "hirself"],// ["ze", "zir", "zir", "zirs", "zirself"],// ["xey", "xem", "xyr", "xyrs", "xemself"],// ...// ]
The pronouns "database" is an array of arrays meant to represent a table, located in resources/pronouns.json, with fields and example values as follows:
util.js has most of what was translated from the original Clojure code. These functions are mostly meant for accessing rows in a table or formatting strings and is not needed for typical users, but is exposed nonetheless as
index.js is the main program.
pronouns is both a function you can call with a string parameter, and an object with references to the table and a few methods.
All of the following are valid inputs to the
- ze/hir or they/.../themselves
- she/her, they/them, it/its, or sie/hir
test/ directory contains unit tests for
util.js. Please run the tests and confirm that everything passes before merging changes, and please include tests with any new logic you introduce in a PR!
Issues and pull/merge requests regarding the code are very much welcome! If you would like to request pronouns to be added to the table there is an issue template for doing so. You should also consider doing the same with the original repository.
Autocomplete! Interactive demos and examples
- Parse even shorter multi-pronoun inputs like "they/she" or "she/him"
- Handle "any/all", unknown, or badly formatted inputs better
- Should default to they/them
- Allow modifying an existing object (how would that work?)
- More comprehensive documentation