Project

genderize

0.01
No commit activity in last 3 years
No release in over 3 years
A helpful class for gender-specific models in Ruby applications. Genderize adds useful helper methods for various pronouns and other written forms of male and female genders.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

>= 3.2.13
 Project Readme

Genderize

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

Example

Feminine

# 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"

Masculine

# 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"

Non-binary

# 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"

Blank (no gender specified)

@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"

Changing these values

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.

Installation

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      

Issues

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

Documentation

Full documentation is available here: http://rubydoc.info/gems/genderize

Contributing

You're welcome to contribute to Genderize.

Legal Stuff

Copyright 2013 Katana Code Ltd.

See LEGAL for full details.

Credits

Developed by Katana

About Katana

Katana are mobile and web app developers based in Edinburgh, Scotland.