yaag 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ae888409d5afb7a721b266a6952749b1abc3255a6f3d4671a9204c5b24dd8f4
-  data.tar.gz: 2eb44833be4f5d0d20f6b3318982697ca754fb3b9ce41f4698532557f0635ef1
+  metadata.gz: 9574bdab53be3c4f08a3b5d53a94c13c4112250d508a285ca15a0d2d92eadecb
+  data.tar.gz: '0396903f2a8a2f9995e9cfeedb97714fc712bf91db65f0485bfa9bb81f4f6a75'
 SHA512:
-  metadata.gz: c59715e2e986d0a012abd80f2d7376dbd106c28d2d9ec12c64bf8db2b1a0207e07760953e652cfdc6e259ec3100e025e9fdb516c6caa199bb424ab6127c06245
-  data.tar.gz: f20893f3c65274ab3ea55b41efb76d70132a3765f97155b837b4e6c0e21e5068a0d3a3055cf101b7ef10e46550fc2f5dcf1a64b05edaec011fde9ab168a4d958
+  metadata.gz: 4250c7ab8385ebd4ae19737ad206f5cc7ec4fb24708f88cb50fd44d7b176ed55983028b862580710bb933995bc35366b7470b5fa3669b9a0c132befcb2ef4567
+  data.tar.gz: 4e28c123f2295fe0933b2324ce6add25cd64548570bd0e4434f9ee84fcfb1c148b198e2768b1a1092b268c77c7f211ccaf926e38864b3e2e686473b26204f440

data/README.md

@@ -60,12 +60,48 @@ class MyController < ApplicationController
 end
 ```
 
-To create a copy of the views for customization, run:
+### Generators
+
+Here is a list of generator available in case any of the components of the gem need to be customized to specific application needs.
+
+For views:
 
 ```bash
 rails g authentication:copy:views
 ```
 
+For controllers (including concerns):
+
+```bash
+rails g authentication:copy:controllers
+```
+
+For mailers:
+
+```bash
+rails g authentication:copy:mailers
+```
+
+For models:
+
+```bash
+rails g authentication:copy:models
+```
+
+### Test helper
+
+To be able to perform tasks as an authenticated user, a helper is available to be used in tests. Add `include Yaag::Test::SessionsHelper` to your test class to access the methods `sign_in_as` and `sign_out`:
+
+```
+class MyControllerTest < ActionDispatch::IntegrationTest
+  include Yaag::Test::SessionsHelper
+  setup { sign_in_as(User.take) }
+  ...
+end
+```
+
+Note: the example above requires users fixtures to exist, which are not provided by this gem.
+
 ## Release
 
 ```bash

data/lib/generators/authentication/copy/controllers_generator.rb

@@ -0,0 +1,13 @@
+module Authentication
+  module Copy
+    class ControllersGenerator < Rails::Generators::Base
+      source_root File.expand_path("../../../../", __dir__)
+
+      def copy_controllers
+        copy_file "app/controllers/concerns/authentication.rb"
+        copy_file "app/controllers/sessions_controller.rb"
+        copy_file "app/controllers/signins_controller.rb"
+      end
+    end
+  end
+end

data/lib/generators/authentication/copy/mailers_generator.rb

@@ -0,0 +1,11 @@
+module Authentication
+  module Copy
+    class MailersGenerator < Rails::Generators::Base
+      source_root File.expand_path("../../../../", __dir__)
+
+      def copy_mailers
+        copy_file "app/mailers/signins_mailer.rb"
+      end
+    end
+  end
+end

data/lib/generators/authentication/copy/models_generator.rb

@@ -0,0 +1,13 @@
+module Authentication
+  module Copy
+    class ModelsGenerator < Rails::Generators::Base
+      source_root File.expand_path("../../../../", __dir__)
+
+      def copy_models
+        copy_file "app/models/current.rb"
+        copy_file "app/models/session.rb"
+        copy_file "app/models/user.rb"
+      end
+    end
+  end
+end

data/lib/yaag/test/sessions_helper.rb

@@ -0,0 +1,21 @@
+module Yaag
+  module Test
+    module SessionsHelper
+      def sign_in_as(user)
+        Current.session = user.sessions.create!
+
+        ActionDispatch::TestRequest.create.cookie_jar.tap do |cookie_jar|
+          cookie_jar.signed[:session_id] = Current.session.id
+          cookies["session_id"] = cookie_jar[:session_id]
+        end
+      end
+
+      def sign_out
+        Current.session&.destroy!
+        cookies.delete("session_id")
+      end
+
+      alias :sign_in :sign_in_as
+    end
+  end
+end

data/lib/yaag/version.rb

@@ -1,3 +1,3 @@
 module Yaag
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end

data/lib/yaag.rb

@@ -2,6 +2,10 @@ require "yaag/version"
 require "yaag/engine"
 
 module Yaag
+  module Test
+    autoload :SessionsHelper, "yaag/test/sessions_helper"
+  end
+
   module PasswordlessLogin
     extend ActiveSupport::Concern
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: yaag
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - nu12
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-09 00:00:00.000000000 Z
+date: 2026-01-14 00:00:00.000000000 Z
 dependencies: []
 description: Yet Another Authentication Gem (YAAG) provides passwordless authentication
   for your Ruby on Rails app, all it takes is the user's e-mail address.
@@ -37,12 +37,16 @@ files:
 - db/migrate/20260108164812_create_users.rb
 - db/migrate/20260108165215_create_sessions.rb
 - lib/generators/authentication/USAGE
+- lib/generators/authentication/copy/controllers_generator.rb
+- lib/generators/authentication/copy/mailers_generator.rb
+- lib/generators/authentication/copy/models_generator.rb
 - lib/generators/authentication/copy/views_generator.rb
 - lib/generators/authentication/install_generator.rb
 - lib/generators/authentication/templates/README
 - lib/tasks/yaag_tasks.rake
 - lib/yaag.rb
 - lib/yaag/engine.rb
+- lib/yaag/test/sessions_helper.rb
 - lib/yaag/version.rb
 homepage: https://github.com/nu12/yaag
 licenses: