Merge branch 'feature/api-versioning' into develop

* feature/api-versioning:
  rake rswag
  Added api/v1 path in request. routing
  Added api_v1 path in testing
  Added api/v1/ path in spec
  Added Api::V1:: in controller spec
  Changed location: @model to location:  api_v1_model(@model) in spec, testing
  Changed location: @model to location:  api_v1_model(@model)
  Added /api/v1 path in controller path

Author: x1wins

app/controllers/api/v1/authentication_controller.rb

@@ -0,0 +1,26 @@
+module Api
+  module V1
+    class AuthenticationController < ApplicationController
+      before_action :authorize_request, except: :login
+
+      # POST /auth/login
+      def login
+        @user = User.find_by_email(login_params[:email])
+        if @user&.authenticate(login_params[:password])
+          token = JsonWebToken.encode(user_id: @user.id)
+          time = Time.now + 24.hours.to_i
+          render json: { token: token, exp: time.strftime("%m-%d-%Y %H:%M"),
+                         username: @user.username, email: @user.email }, status: :ok
+        else
+          render json: { error: 'unauthorized' }, status: :unauthorized
+        end
+      end
+
+      private
+
+      def login_params
+        params.permit(:email, :password)
+      end
+    end
+  end
+end

app/controllers/api/v1/categories_controller.rb

@@ -0,0 +1,81 @@
+module Api
+  module V1
+    class CategoriesController < ApplicationController
+      include CategoryHelper
+      before_action :authorize_request
+      before_action :post_pagination_params, only: [:index, :show]
+      before_action except: [:index, :show] do
+        is_role :admin
+      end
+      before_action :set_category, only: [:show, :update, :destroy]
+      before_action only: [:edit, :update, :destroy] do
+        is_owner_object @category ##your object
+      end
+
+      # GET /categories
+      def index
+        page = params[:page].present? ? params[:page] : 1
+        per = params[:per].present? ? params[:per] : 10
+        pagaination_param = {
+            category_page: page,
+            category_per: per,
+            post_page: @post_page,
+            post_per: @post_per
+        }
+        @categories = fetch_categories pagaination_param
+        render json: @categories
+      end
+
+      # GET /categories/1
+      def show
+        pagaination_param = {
+            post_page: @post_page,
+            post_per: @post_per
+        }
+        render json: @category, pagaination_param: pagaination_param
+      end
+
+      # POST /categories
+      def create
+        @category = Category.new(category_params)
+
+        if @category.save
+          render json: @category, status: :created, location:  api_v1_category_url(@category)
+        else
+          render json: @category.errors, status: :unprocessable_entity
+        end
+      end
+
+      # PATCH/PUT /categories/1
+      def update
+        if @category.update(category_params)
+          render json: @category
+        else
+          render json: @category.errors, status: :unprocessable_entity
+        end
+      end
+
+      # DELETE /categories/1
+      def destroy
+        @category.published = false
+        @category.save
+      end
+
+      private
+        # Use callbacks to share common setup or constraints between actions.
+        def set_category
+          @category = Category.published.find(params[:id])
+        end
+
+        # Only allow a trusted parameter "white list" through.
+        def category_params
+          params.require(:category).permit(:title, :body).merge(user_id: @current_user.id)
+        end
+
+        def post_pagination_params
+          @post_page = params[:post_page].present? ? params[:post_page] : 1
+          @post_per = params[:post_per].present? ? params[:post_per] : 10
+        end
+    end
+  end
+end

app/controllers/api/v1/comments_controller.rb

@@ -0,0 +1,65 @@
+module Api
+  module V1
+    class CommentsController < ApplicationController
+      before_action :authorize_request
+      before_action :set_comment, only: [:show, :update, :destroy]
+      before_action only: [:edit, :update, :destroy] do
+        is_owner_object @comment ##your object
+      end
+
+      # GET /comments
+      def index
+        post_id = params[:post_id]
+        page = params[:page].present? ? params[:page] : 1
+        per = params[:per].present? ? params[:per] : 10
+        @post = Post.published.find(post_id) if post_id.present?
+        category_id = @post.category_id
+        @category = Category.published.find(category_id)
+        @comments = Comment.post(post_id).published.by_date.page(page).per(per)
+        render json: Pagination.build_json(@comments)
+      end
+
+      # GET /comments/1
+      def show
+        render json: @comment
+      end
+
+      # POST /comments
+      def create
+        @comment = Comment.new(comment_params)
+
+        if @comment.save
+          render json: @comment, status: :created, location: api_v1_comment_url(@comment)
+        else
+          render json: @comment.errors, status: :unprocessable_entity
+        end
+      end
+
+      # PATCH/PUT /comments/1
+      def update
+        if @comment.update(comment_params)
+          render json: @comment
+        else
+          render json: @comment.errors, status: :unprocessable_entity
+        end
+      end
+
+      # DELETE /comments/1
+      def destroy
+        @comment.published = false
+        @comment.save
+      end
+
+      private
+        # Use callbacks to share common setup or constraints between actions.
+        def set_comment
+          @comment = Comment.find(params[:id])
+        end
+
+        # Only allow a trusted parameter "white list" through.
+        def comment_params
+          params.require(:comment).permit(:body, :post_id).merge(user_id: @current_user.id)
+        end
+    end
+  end
+end

app/controllers/api/v1/posts_controller.rb

@@ -0,0 +1,89 @@
+module Api
+  module V1
+    class PostsController < ApplicationController
+      include PostHelper
+      before_action :authorize_request
+      before_action :comment_pagination_params, only: [:index, :show]
+      before_action :set_post, only: [:show, :update, :destroy]
+      before_action only: [:update, :destroy] do
+        is_owner_object @post ##your object
+      end
+
+      # GET /posts
+      def index
+        category_id = params[:category_id]
+        search = params[:search]
+        page = params[:page].present? ? params[:page] : 1
+        per = params[:per].present? ? params[:per] : 10
+        @category = Category.published.find(category_id) if category_id.present?
+        pagaination_param = {
+            category_id: category_id,
+            search: search,
+            post_page: page,
+            post_per: per,
+            comment_page: @comment_page,
+            comment_per: @comment_per
+        }
+        @posts = fetch_posts pagaination_param
+        render json: @posts
+      end
+
+      # GET /posts/1
+      def show
+        pagaination_param = {
+            comment_page: @comment_page,
+            comment_per: @comment_per
+        }
+        render json: @post, pagaination_param: pagaination_param
+      end
+
+      # POST /posts
+      def create
+        @post = Post.new(post_params)
+        set_category @post.category_id
+
+        if @post.save
+          render json: @post, status: :created, location: api_v1_post_url(@post)
+        else
+          render json: @post.errors, status: :unprocessable_entity
+        end
+      end
+
+      # PATCH/PUT /posts/1
+      def update
+        if @post.update(post_params)
+          render json: @post
+        else
+          render json: @post.errors, status: :unprocessable_entity
+        end
+      end
+
+      # DELETE /posts/1
+      def destroy
+        @post.published = false
+        @post.save
+      end
+
+      private
+        # Use callbacks to share common setup or constraints between actions.
+        def comment_pagination_params
+          @comment_page = params[:comment_page].present? ? params[:comment_page] : 1
+          @comment_per = params[:comment_per].present? ? params[:comment_per] : 10
+        end
+
+        def set_post
+          @post = Post.published.find(params[:id])
+          set_category @post.category_id
+        end
+
+        def set_category category_id
+          @category = Category.published.find(category_id)
+        end
+
+        # Only allow a trusted parameter "white list" through.
+        def post_params
+            params.require(:post).permit(:body, :category_id).merge(user_id: @current_user.id)
+        end
+    end
+  end
+end

app/controllers/api/v1/users_controller.rb

@@ -0,0 +1,59 @@
+module Api
+  module V1
+    class UsersController < ApplicationController
+      before_action :authorize_request, except: :create
+      before_action :find_user, except: %i[create index]
+      before_action only: [:show, :update, :destroy] do
+        is_owner @user.id ##your object
+      end
+
+      # GET /users
+      def index
+        @users = User.all
+        render json: @users
+      end
+
+      # GET /users/{username}
+      def show
+        render json: @user
+      end
+
+      # POST /users
+      def create
+        @user = User.new(user_params)
+        if @user.save
+          render json: @user, status: :created, location: api_v1_user_url(@user.username)
+        else
+          render json: { errors: @user.errors.full_messages },
+                 status: :unprocessable_entity
+        end
+      end
+
+      # PUT /users/{username}
+      def update
+        if @user.update(user_params)
+          render json: @user
+        else
+          render json: @user.errors, status: :unprocessable_entity
+        end
+      end
+
+      # DELETE /users/{username}
+      def destroy
+        @user.destroy
+      end
+
+      private
+
+      def find_user
+        @user = User.find_by_username!(params[:_username])
+      rescue ActiveRecord::RecordNotFound
+        render json: { errors: 'User not found' }, status: :not_found
+      end
+
+      def user_params
+        params.require(:user).permit(:name, :username, :email, :password, :password_confirmation)
+      end
+    end
+  end
+end