halogenandtoast / oath-generators

Rails generators for the oath authentication library

Oath::Generators

Rails generators for adding in authentication components, using the Oath authentication library.

Installation

Add this line to your application's Gemfile:

gem 'oath-generators'

And then execute:

$ bundle

Generators

Currently these are the generators available:

Scaffold

You can generate a basic starting point for any oath app by running the following:

rails g oath:scaffold

Password Reset

If you'd like to generate basic password reset for your app, you can run:

rails g oath:password_reset

This will generate the necessary files for an implementation of resetting a user's password. It will ask you for host names for development, test and production environments in order to make the mailer work.

Google Oauth 2

If you'd like setup basic google oauth authentication, you can run:

rails g oath:google_oauth2

This will generate the necessary files for an implementation of allowing users to sign in either with an email/password or by using google oauth2.

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

oath-generators's Issues

Deliver being deprecated

Hey there - I noticed when working with the password_reset generator that password_reset_controller.rb is using #deliver which is being deprecated in rails 5. I think that by default this should be changed to using #deliver_now as per the below warning.

Just wanted to flag this in case this wasn't already on your radar.

DEPRECATION WARNING: #deliver is deprecated and will be removed in Rails 5. Use #deliver_now to deliver immediately or #deliver_later to deliver through Active Job. (called from create at app/controllers/password_resets_controller.rb:12)

Please relax the version constraint

This gem depends on monban, ~> 0.0.12, which doesn't allow me to use Monban 0.1.0.

monban generator

When running 'rails g monban:scaffold' there seems to be an error. When running 'rake db:migrate RAILS_ENV=development' afterwards there is an error for 'uninitialized constant CreateUsers'

Presence validations and NOT NULL

I believe Monban should:

• Set email and password_digest columns to NOT NULL (and the timestamps too, for good measure)
• Generate presence validations for those columns in the User model

Maybe validate that the email is email-y, but I'm not 100% sold on that and it feels like another issue.

I can start work on that, I'm mostly filing this issue to remind myself to work on this.