avocado 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e32ef0766b1e70a3d4946f2d512acc59e5fe7d08e7166a751dbb3e5eacc35b41
-  data.tar.gz: a822265796d94d9e5d4174894f6a7dea7bf7d845d0ac78eb65686a4ecab7f3cd
+  metadata.gz: 9b2bf2a8946882c7f2c799f8f545f34d3d34c6d3a64a932258350e57b32fdabe
+  data.tar.gz: 0f2430fff76f6912de3b1f09d08ab9b12858fa245e278e5542341eddfe116314
 SHA512:
-  metadata.gz: 4f3c42f3873e26eec8f11047b5fd5bbf885ccc4dd350aea52f872b3d869dd19917ff24c71a0989fbf1d7a547388a0ddd578ea0cb05eaacb12b8d6962cfb99af7
-  data.tar.gz: f3b23cc9b7df23daabe61e9143aea880bd4183b47126c5bea515df271896c42498513add9776eff8c73302f95c3f6097f5acbc9ff360f9c77508817bf1cb56c9
+  metadata.gz: 547b8e2c1e35508a75828c4f735b021c1022fe6e9e70f4a41c33dbb2d823592ff86d65732475c72fb3ee5cac0a3bed3f74c1fc12521b4344cc743313b6ed922c
+  data.tar.gz: 016be93303ef00a75c3e7a63e2a1d030f2955eb7eaf92d80ab03fed4704da6fecc5b194d6a73e567e524087063dd2b1e947799fd5f0f338eba20a6f25f585831

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.2.0] - 2023-07-15
+
+- Validate presence, uniqueness, and format on `email` attribute
+- Normalize email value during save
+- Validate password format and length
+- Include a token generator for password recovery
+- Rename `Avocado::UserConcern` to `Avocado::User`
+
 ## [0.1.0] - 2023-07-14
 
 - Initial release

data/README.md

@@ -15,18 +15,24 @@ Without bundler, install the gem by executing:
 ## Usage
 
 If you have a `User` model in your application and are nervous about using Rails
-features directly, preferring to consume the features via a packaged gem, you
-can use the Rails `has_secure_password` feature in a more convoluted way, by
-adding the `Avocado::UserConcern` to your `User` model:
+features directly, preferring to consume the features via a packaged gem, add
+the `Avocado::User` to your `User` model:
 
 ```ruby
 class User < ApplicationRecord
-  include Avocado::UserConcern
+  include Avocado::User
 end
 ```
 
-Note that behind the scenes this is truly just calling `has_secure_password` for
-you and doing nothing else. It's sort of funny to do this.
+This will do a few things behind the scenes:
+
+- Use the built-in `has_secure_password` to generate relevant password methods
+- Add some basic validations for the `email` and `password` fields on `User`
+- Normalize email values when records are saved
+- Provide a token generator for password recovery
+
+It's sort of funny to do this because you genuinely just could have put this
+stuff right in your app, and yet here we are making gems instead!
 
 ## Development
 

data/lib/avocado/{user_concern.rb → user.rb}

@@ -3,11 +3,12 @@
 require "active_support/concern"
 
 module Avocado
-  module UserConcern
+  module User
     extend ActiveSupport::Concern
 
     included do
-      has_secure_password
+      include UserEmailConcern
+      include UserPasswordConcern
     end
   end
 end

data/lib/avocado/user_email_concern.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "active_support/concern"
+
+module Avocado
+  module UserEmailConcern
+    extend ActiveSupport::Concern
+
+    included do
+      validates :email, presence: true, uniqueness: true, format: {with: URI::MailTo::EMAIL_REGEXP}
+
+      normalizes :email, with: ->(email) { email.downcase.strip }
+    end
+  end
+end

data/lib/avocado/user_password_concern.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "active_support/concern"
+
+module Avocado
+  module UserPasswordConcern
+    extend ActiveSupport::Concern
+
+    REQUIRED_FORMAT = /\A(?=.*[a-z])(?=.*[A-Z])(?=.*[0-9]).*\z/x
+    REQUIRED_LENGTH = 8
+    TOKEN_EXPIRATION = 64.minutes
+
+    included do
+      has_secure_password
+
+      validates :password, format: {with: REQUIRED_FORMAT}, length: {minimum: REQUIRED_LENGTH}, allow_nil: true
+
+      generates_token_for :password_recovery, expires_in: TOKEN_EXPIRATION do
+        password_digest_salt
+      end
+    end
+
+    private
+
+    def password_digest_salt
+      BCrypt::Password.new(password_digest).salt[-10..]
+    end
+  end
+end

data/lib/avocado/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Avocado
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/lib/avocado.rb

@@ -1,8 +1,11 @@
 # frozen_string_literal: true
 
 require_relative "avocado/version"
-require_relative "avocado/user_concern"
 
 module Avocado
   class Error < StandardError; end
+
+  autoload :User, "avocado/user"
+  autoload :UserEmailConcern, "avocado/user_email_concern"
+  autoload :UserPasswordConcern, "avocado/user_password_concern"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: avocado
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Matt Jankowski
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-07-14 00:00:00.000000000 Z
+date: 2023-07-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bcrypt
@@ -82,7 +82,9 @@ files:
 - Rakefile
 - config.ru
 - lib/avocado.rb
-- lib/avocado/user_concern.rb
+- lib/avocado/user.rb
+- lib/avocado/user_email_concern.rb
+- lib/avocado/user_password_concern.rb
 - lib/avocado/version.rb
 - sig/avocado.rbs
 homepage: https://github.com/unicorngroomers/avocado