yaag 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4ae888409d5afb7a721b266a6952749b1abc3255a6f3d4671a9204c5b24dd8f4
-  data.tar.gz: 2eb44833be4f5d0d20f6b3318982697ca754fb3b9ce41f4698532557f0635ef1
+  metadata.gz: d12d4feb11b2bf161940d8925180dc1bf27a57029521197bef08bac48c5a8997
+  data.tar.gz: a26d2996a3aa9fe193a074c0f9f745b977a048f33df2e13d479a5ec5d267a87f
 SHA512:
-  metadata.gz: c59715e2e986d0a012abd80f2d7376dbd106c28d2d9ec12c64bf8db2b1a0207e07760953e652cfdc6e259ec3100e025e9fdb516c6caa199bb424ab6127c06245
-  data.tar.gz: f20893f3c65274ab3ea55b41efb76d70132a3765f97155b837b4e6c0e21e5068a0d3a3055cf101b7ef10e46550fc2f5dcf1a64b05edaec011fde9ab168a4d958
+  metadata.gz: abc264f8d2def0f837f46056fa41811ce8dbf9cdd7cc69cca56153edff8d6eb67e76b721427051a467724945cd21d771fc4dba5b03a143373dfe460735898549
+  data.tar.gz: 1ce0344f09b9c879b0d23f6ba4d055a8fbceabb06a813770033734600e6dac2fff242e3df34c4655cf009bc2fa67e54f1ee30c2e7b532beeb1bff980e3986753

data/README.md

@@ -60,12 +60,34 @@ 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
+```
+
+### 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 access the methods `sign_in_as` and `sign_out`:
+
+```
+class MyControllerTest < ActionDispatch::IntegrationTest
+  include Yaag::Test::SessionsHelper
+  setup { sign_in_as(User.take) }
+  ...
+end
+```
+
 ## 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/yaag/test/sessions_helper.rb

@@ -0,0 +1,19 @@
+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
+    end
+  end
+end

data/lib/yaag/version.rb

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

data/lib/yaag.rb

@@ -2,6 +2,9 @@ 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.2.0
 platform: ruby
 authors:
 - nu12
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-01-09 00:00:00.000000000 Z
+date: 2026-01-13 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,14 @@ 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/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: