Genderize is a simple Rails gem for adding gender helper methods to Rails models.
New:
- (0.1.1) options to coerce invalid input to nil or to coerce empty string to nil
- (0.1.0) we now have non-binary as an option
# Setting the gender is simple - just set the attribute value to "m", "n", or "f"
@user = User.new(gender: "f")
# This also works
@user = User.new(gender: "female")
# This gives us a few helper methods to add gender specific text to our views
@user.gender.male? # => false
@user.gender.non_binary? # => false
@user.gender.name # => "female"
@user.gender.to_s # => "f"
@user.gender.abbr # => "f"
# gender pronouns
# As the subject of a sentence
@user.gender.subject # => 'she'
# As the object of a sentence
@user.gender.object # => 'her'
# Showing possession
@user.gender.possessive # => 'her'
# Writing a casual form of the gender
@user.gender.casual # => "girl"
# Setting the gender is simple - just set the attribute value to "m", "n", or "f"
@user = User.new(gender: "m")
# This also works
@user = User.new(gender: "male")
# This gives us a few helper methods to add gender specific text to our views
@user.gender.female? # => false
@user.gender.non_binary? # => false
@user.gender.name # => "male"
@user.gender.to_s # => "m"
@user.gender.abbr # => "m"
# gender pronouns
# As the subject of a sentence
@user.gender.subject # => 'he'
# As the object of a sentence
@user.gender.object # => 'him'
# Showing possession
@user.gender.possessive # => 'his'
# Writing a casual form of the gender
@user.gender.casual # => "guy"
# Setting the gender is simple - just set the attribute value to "m", "n", or "f"
@user = User.new(gender: "n")
# This also works
@user = User.new(gender: "non-binary")
@user = User.new(gender: "non_binary")
@user = User.new(gender: "non binary")
# This gives us a few helper methods to add gender specific text to our views
@user.gender.female? # => false
@user.gender.male? # => false
@user.gender.non_binary? # => true
@user.gender.name # => "non_binary"
@user.gender.to_s # => "n"
@user.gender.abbr # => "n"
# gender pronouns
# As the subject of a sentence
@user.gender.subject # => 'they'
# As the object of a sentence
@user.gender.object # => 'them'
# Showing possession
@user.gender.possessive # => 'their'
# Writing a casual form of the gender
@user.gender.casual # => "person"
@user = User.new(gender: "")
# This gives us a few helper methods to add gender specific text to our views
@user.gender.female? # => false
@user.gender.male? # => false
@user.gender.name # => ""
@user.gender.to_s # => ""
@user.gender.abbr # => ""
# gender pronouns
# As the subject of a sentence
@user.gender.subject # => 'they'
# As the object of a sentence
@user.gender.object # => 'them'
# Showing possession
@user.gender.possessive # => 'their'
# Writing a casual form of the gender
@user.gender.casual # => "person"
You can change the values for each of the methods described above by modifying your locales file. See config/locales/en.yml for more info.
Add this to your Gemfile:
gem "genderize"
...and run bundle install to install the gem.
Next, run:
$ rails g genderize:install
... to install the genderize.en.yml file in your locales directory
Finally, to genderize a model attribute:
class User < ActiveRecord::Base
genderize
# ... or, if your db column isn't named `gender`
genderize(:user_gender)
### New opts (must specify column name to use)
# ... to prevent storing empty strings and store them as nil instead
genderize(:gender, no_empty_string: true)
# ... to coerce invalid arguments to nil rather than throwing ArgumentError
genderize(:gender, set_invalid_to_nil: true)
# ... these can be combined together
genderize(:gender, set_invalid_to_nil: true, no_empty_string: true)
end
If you discover a problem with Genderize, please let us know about it.
Remember to search the issues list first in case your issue has already been raised by another Githuber
Full documentation is available here: http://rubydoc.info/gems/genderize
You're welcome to contribute to Genderize.
Copyright 2013 Katana Code Ltd.
See LEGAL for full details.
Developed by Katana
Katana are mobile and web app developers based in Edinburgh, Scotland.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent