breath 0.1.1 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50ebd07a8e36d441f618c760f7a5a24fa18d9ac94ddb4a6bdc900cfdb3e359ca
-  data.tar.gz: d260c09a3bee03dc94022e6b579b344c26cc297ccede0dfd858ab12952d67690
+  metadata.gz: 1cf89b5445e113d7198d4a9a9aa4ddfc1af8a09c0faec9eb4af344ad151b2af1
+  data.tar.gz: 3efb2e128154bc6e7c0ecbfad3997d338f15d871f7c898d3ab943d53e7aecd91
 SHA512:
-  metadata.gz: 4714402fea80ecc8cb5f3d1a1462ef7f28a36d8c6b3abea415aca82b71ae460f5537f931441dd80d3c67064313c63c0ab564f069050011d129f39a2ec91e4561
-  data.tar.gz: 24ff2a754e289c97a9953a29f42b88a311e886b80c2f97a7c5a879bb3939c981c2ad432c75d77255b851a11503ac4e9b72b7edb3fef67a8ee3ae7119ecb5021d
+  metadata.gz: 1e267a0b8ec0aee65ad28e47d3c3e58daceddb9f37e019c6ea548e61906af86d413ab266c64b35a444c3bac4876c67cb27578a737984d79b8e9161dfdbc9f4d8
+  data.tar.gz: 1b2d1fbbb58ac30cd6e7a3dd3283ba33f807724cf962e96f1cbc1b0c228bb7fcda18854ee27a368173616fc5bb46b373ab0162e3f3e401ee4e31c32c7ff88efc

data/README.md

@@ -1,8 +1,7 @@
 # Breath
-Short description and motivation.
-
-## Usage
-How to use my plugin.
+Rails authentication plugin with API mode.<br />
+Easy introducing login, logout.<br/>
+Compact features set.
 
 ## Installation
 Add this line to your application's Gemfile:
@@ -21,6 +20,101 @@ Or install it yourself as:
 $ gem install breath
 ```
 
+## Usage
+### Introduce
+
+#### Model
+If you want to introduce a authentication to `User` model.<br/>
+Add these lines to `user.rb` like bellow.
+```ruby
+class User < ApplicationRecord
+  include Breath::Model
+
+  attr_breath :email
+end
+```
+Here, with `attr_breath`, you need to specify the user's attribute with authentication.
+
+#### Migration
+In migration file, you need to add `password_digest`, and `remember_digest` attributes.<br/>
+And if you specify the email attribute within `attr_breath`, you need to add `email` attribute in migration file.
+```ruby
+class CreateUsers < ActiveRecord::Migration[7.0]
+  def change
+    create_table :users do |t|
+      t.string :email
+      t.string :password_digest
+      t.string :remember_digest
+
+      t.timestamps
+    end
+  end
+end
+```
+After these lines you added, excute `bundle exec rails db:migrate`.
+
+
+#### Controller
+You need to construct the directory like bellow.
+```
+/app/controllers
+  - application_controller.rb
+
+  /users
+    - application_controller.rb
+    - sessions_controller.rb
+```
+
+- app/contorllers/users/application_controller.rb
+```ruby
+class Users::ApplicationController < ApplicationController
+  include Breath::ApplicationControllerHelper
+  before_action :authenticate!
+
+  crsf_protect true
+end
+```
+Here, if `csrf_protect` is `true`, CSRF protection is enabled.<br/>
+
+- app/controllers/users/sessions_controller.rb
+```ruby
+class Users::SessionsController < Users::ApplicationController
+  include Breath::SessionsControllerHelper
+end
+```
+
+`Breath::ApplicationControllerHelper` intoroduce the user's authorization.<br/>
+`Breath::SessionsControllerHelper` introduce the actions `login`, and `logout`.
+
+After you added these lines, show `bundle exec rails routes` command.<br/>
+You can see these routes are added.
+```
+GET /users/login
+POST /users/login
+DELETE /users/logout
+```
+
+Then, you don't need write the codes to introduce authorizations.
+
+#### Config
+This plugin need cookie, and you can configure the cookie expires like bellow.<br/>
+```ruby
+module YourApp
+  class Application < Rails::Application
+    ...
+
+    config.breath_expires = 3.days
+  end
+end
+```
+If you don't configure this, cookie is set permanently.
+
+#### Last Work
+You need to create view side.<br/>
+In view side, you have remaining works.<br/>
+if you `csrf_protect true`, you need to introduce `withCredentials: true` option in client side.<br/>
+And, write csrf token into the cookie with `csrf_token` key.
+
 ## Contributing
 Contribution directions go here.
 

data/lib/breath/controller/application_controller_helper.rb

@@ -7,14 +7,14 @@ module Breath
     included do
       target_class = to_s.split("::")[-2].singularize.constantize
       target_name = target_class.to_s.underscore
-      current_target_name = "current_#{target_name}"
+      current_target = "current_#{target_name}"
 
       include ActionController::Cookies
     
       define_method :authenticate! do
         raise AuthenticationError unless cookies.key?("#{target_name}_id".to_sym)
-        raise AuthenticationError if send(current_target_name).nil?
-        raise AuthenticationError unless send(current_target_name).remember?(cookies[:remember_token])
+        raise AuthenticationError if send(current_target).nil?
+        raise AuthenticationError unless send(current_target).remember?(cookies[:remember_token])
 
         target = target_class.enabled.find_by(id: cookies.signed["#{target_name}_id".to_sym])
 

data/lib/breath/controller/sessions_controller_helper.rb

@@ -44,7 +44,7 @@ module Breath
       end
 
       define_method :sessions_params do
-        params.require(:sessions).permit(target_class.auth_attribute.to_sym, :password, :password_confirmation)
+        params.require(:sessions).permit(target_class.auth_attribute.to_sym, :password)
       end
     end
 

data/lib/breath/version.rb

@@ -1,3 +1,3 @@
 module Breath
-  VERSION = "0.1.1"
+  VERSION = "0.1.3"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: breath
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.3
 platform: ruby
 authors:
 - testCodeV01