jsonapi-swagger 0.5.0 → 0.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92c1984cded48de28c42fc2c6cea1942f17a985a485c0620941a55e8a6d8259c
-  data.tar.gz: 5ecc81a8c945a282346a0f20420be0cd047fcf715abea97986cf374285b780d1
+  metadata.gz: dab83649ba5e56cfa51c621a9fb47add67a4a2ae889d44b6ba4b3bc1e712fea8
+  data.tar.gz: 94a539114d9f3ae6b0da32f79562e319e75219b354e90266986168507d141fa7
 SHA512:
-  metadata.gz: b1918de62437786e214d29396a254693899d34325d3762a20c0327bf8f340b848a36a92ae3815e16b607fbb7b07957e7d2fc7ca3b842b9f991750edcc084f6cc
-  data.tar.gz: 8f93aa0c863bc241859ca952f2d103346552af40882bbfa35d68900561a832e0af3daf4c131c361e0bced923ccf1d35e3347828fe88565bb23663cc3805ebfde
+  metadata.gz: e7625c8893c464aecde1b5987776a8be6a9f4599ef6e2870f27c18d3fe3e82c25dd3eabe523953f5caa43542bcf8897afaf2df4703edf137a2b8d3f37cb26212
+  data.tar.gz: 48ad3673d7335ed35b9fbe132aa2511570760fa22dc817c97b54a75affcccf744606665695b5b28e3de594952cd445d5798913a555bc956dfd9ba487dd1ee39c

data/README.md

@@ -2,7 +2,8 @@
 
 Generate JSONAPI Swagger Doc.
 
-[![Gem Version](https://img.shields.io/gem/v/jsonapi-swagger.svg)](https://rubygems.org/gems/jsonapi-swagger) [![GitHub license](https://img.shields.io/github/license/superiorlu/jsonapi-swagger.svg)](https://github.com/superiorlu/jsonapi-swagger/blob/master/LICENSE)
+[![Gem Version](https://img.shields.io/gem/v/jsonapi-swagger.svg)](https://rubygems.org/gems/jsonapi-swagger)
+[![GitHub license](https://img.shields.io/github/license/superiorlu/jsonapi-swagger.svg)](https://github.com/superiorlu/jsonapi-swagger/blob/master/LICENSE)
 
 [![jsonapi-swagger-4-2-9.gif](https://i.loli.net/2019/05/05/5ccebf5e782b7.gif)](https://i.loli.net/2019/05/05/5ccebf5e782b7.gif)
 
@@ -24,10 +25,40 @@ Or install it yourself as:
 
 ## Usage
 
+ 1. config jsonapi swagger
+```rb
+# config/initializers/swagger.rb
+Jsonapi::Swagger.config do |config|
+  config.use_rswag = false
+  config.version = '2.0'
+  config.info = { title: 'API V1', version: 'V1'}
+  config.file_path = 'v1/swagger.json'
+end
+```
+
+2. generate swagger.json
+
+```sh
+# gen swagger/v1/swagger.json
+bundle exec rails generate jsonapi:swagger User # UserResource < JSONAPI::Resource
+```
+
+3. additional
+
+ use `rswag`, have to run
+
 ```sh
-rails generate jsonapi:swagger User # UserResponse < JSONAPI::Resource
+# gen swagger/v1/swagger.json
+ bundle exec rails rswag:specs:swaggerize
 ```
 
+## RoadMap
+
+- [x] immutable resources
+- [x] filter/sort resources
+- [x] mutable resources
+- [x] generate swagger.json without rswag
+
 ## Resource
 
 - [JSONAPI](https://jsonapi.org/)
@@ -36,4 +67,5 @@ rails generate jsonapi:swagger User # UserResponse < JSONAPI::Resource
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/superiorlu/jsonapi-swagger.
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/superiorlu/jsonapi-swagger.

data/lib/generators/jsonapi/swagger/swagger_generator.rb

@@ -4,15 +4,54 @@ module Jsonapi
     source_root File.expand_path('templates', __dir__)
 
     def create_swagger_file
-      swagger_file = File.join(
+      if Jsonapi::Swagger.use_rswag
+        template 'swagger.rb.erb', spec_file
+      else
+        template 'swagger.json.erb', json_file
+      end
+    end
+
+    private
+
+    def doc
+      @doc ||= swagger_json.parse_doc
+    end
+
+    def spec_file
+      @spec_file ||= File.join(
         'spec/requests',
         class_path,
         spec_file_name
       )
-      template 'swagger.rb.erb', swagger_file
     end
 
-    private
+    def json_file
+      @json_file ||= File.join(
+        'swagger',
+        class_path,
+        swagger_file_path
+      )
+    end
+
+    def swagger_version
+      Jsonapi::Swagger.version
+    end
+
+    def swagger_info
+      JSON.pretty_generate(Jsonapi::Swagger.info)
+    end
+
+    def swagger_base_path
+      Jsonapi::Swagger.base_path
+    end
+
+    def swagger_file_path
+      Jsonapi::Swagger.file_path
+    end
+
+    def swagger_json
+      @swagger_json ||= Jsonapi::Swagger::Json.new(json_file)
+    end
 
     def spec_file_name
       "#{file_name.downcase.pluralize}_spec.rb"
@@ -38,20 +77,24 @@ module Jsonapi
       t(:sortable_fields) + ': (-)' + sortable_fields.join(',')
     end
 
+    def ori_sortable_fields_desc
+      tt(:sortable_fields) + ': (-)' + sortable_fields.join(',')
+    end
+
     def model_klass
-      model_class_name.safe_constantize
+      file_name.camelize.safe_constantize
     end
 
     def resource_klass
-      "#{model_class_name}Resource".safe_constantize
+      @resource_klass ||= Jsonapi::Swagger::Resource.with(model_class_name)
     end
 
     def attributes
-      resource_klass._attributes.except(:id)
+      resource_klass.attributes.except(:id)
     end
 
     def relationships
-      resource_klass._relationships
+      resource_klass.relationships
     end
 
     def sortable_fields
@@ -70,16 +113,34 @@ module Jsonapi
       resource_klass.filters
     end
 
-    def columns_with_comment
+    def mutable?
+      resource_klass.mutable?
+    end
+
+    def attribute_default
+      Jsonapi::Swagger.attribute_default
+    end
+
+    def transform_method
+      @transform_method ||= resource_klass.transform_method if resource_klass.respond_to?(:transform_method)
+    end
+
+    def columns_with_comment(need_encoding: true)
       @columns_with_comment ||= {}.tap do |clos|
+        clos.default_proc = proc do |h, k|
+          h[k] = attribute_default
+        end
         model_klass.columns.each do |col|
-          clos[col.name.to_sym] = { type: swagger_type(col), items_type: col.type, is_array: col.array,  nullable: col.null, comment: safe_encode(col.comment) }
+          col_name = transform_method ? col.name.send(transform_method) : col.name
+          is_array = col.respond_to?(:array) ? col.array : false
+          clos[col_name.to_sym] = { type: swagger_type(col), items_type: col.type, is_array: is_array,  nullable: col.null, comment: col.comment }
+          clos[col_name.to_sym][:comment] = safe_encode(col.comment) if need_encoding
         end
       end
     end
 
     def swagger_type(column)
-      return 'array' if column.array
+      return 'array' if column.respond_to?(:array) && column.array
 
       case column.type
       when :bigint, :integer then 'integer'
@@ -88,15 +149,24 @@ module Jsonapi
       end
     end
 
+    def relation_table_name(relation)
+      return relation.class_name.tableize if relation.respond_to?(:class_name)
+      return relation.name if relation.respond_to?(:name)
+    end
+
     def t(key, options={})
+      content = tt(key, options)
+      safe_encode(content)
+    end
+
+    def tt(key, options={})
       options[:scope] = :jsonapi_swagger
       options[:default] = key.to_s.humanize
-      content = I18n.t(key, options)
-      safe_encode(content)
+      I18n.t(key, options)
     end
 
     def safe_encode(content)
       content&.force_encoding('ASCII-8BIT')
     end
   end
-end
+end

data/lib/generators/jsonapi/swagger/templates/swagger.json.erb

@@ -0,0 +1,319 @@
+{
+  "swagger": "<%= swagger_version %>",
+  "info": <%= swagger_info %>,
+  "basePath" : "<%= swagger_base_path %>",
+  <%-
+    def list_resource_parameters
+      [].tap do |parameters|
+        parameters << { name: 'page[number]', in: :query, type: :string, description: tt(:page_num), required: false }
+        parameters << { name: 'page[size]', in: :query, type: :string, description: tt(:page_size), required: false }
+        if sortable_fields.present?
+          parameters << { name: 'sort', in: :query, type: :string, description: ori_sortable_fields_desc, required: false }
+        end
+        if relationships.present?
+          parameters << { name: :include, in: :query, type: :string, description: tt(:include_related_data), required: false }
+        end
+        filters.each do |filter_attr, filter_config|
+          parameters << { name: :"filter[#{filter_attr}]", in: :query, type: :string, description: tt(:filter_field), required: false}
+        end
+        parameters << { name: :"fields[#{route_resouces}]", in: :query, type: :string, description: tt(:display_field), required: false }
+        relationships.each_value do |relation|
+          parameters << { name: :"fields[#{relation_table_name(relation)}]", in: :query, type: :string, description: tt(:display_field), required: false }
+        end
+      end
+    end
+
+    def show_resource_parameters
+      [].tap do |parameters|
+        parameters << { name: :id, in: :path, type: :integer, description: 'ID', required: true }
+        if relationships.present?
+          parameters << { name: :include, in: :query, type: :string, description: tt(:include_related_data), required: false }
+        end
+        parameters << { name: :"fields[#{route_resouces}]", in: :query, type: :string, description: tt(:display_field), required: false }
+        relationships.each_value do |relation|
+          parameters << { name: :"fields[#{relation_table_name(relation)}]", in: :query, type: :string, description: tt(:display_field), required: false }
+        end
+      end
+    end
+
+    def create_resource_parameters
+      parameters = {
+        name: :data,
+        in: :body,
+        type: :object,
+        properties: {
+          data: {
+            type: :object,
+            properties: {
+              type: { type: :string, default: route_resouces },
+              attributes: {
+                type: :object,
+                properties: properties(attrs: creatable_fields)
+              }
+            }
+          },
+        },
+        description: tt(:request_body)
+     }
+     parameters[:properties][:data][:properties][:relationships] ||= {}
+     parameters[:properties][:data][:properties][:relationships] = { type: :object, properties: create_relationships_properties }
+     parameters
+    end
+
+    def patch_resource_parameters
+      patch_parameters =  create_resource_parameters.dup
+      patch_parameters[:properties][:data][:properties][:id] ||= {}
+      patch_parameters[:properties][:data][:properties][:id].merge!({ type: :integer, description: 'ID' })
+      parameters = [{ name: :id, in: :path, type: :integer, description: 'ID', required: true }]
+      parameters << patch_parameters
+      parameters
+    end
+
+    def delete_resource_parameters
+      [{ name: :id, in: :path, type: :integer, description: 'ID', required: true }]
+    end
+
+    def properties(attrs: [])
+      Hash.new{|h, k| h[k] = {}} .tap do |props|
+        attrs.each do |attr|
+         columns = columns_with_comment(need_encoding: false)
+          props[attr][:type] = columns[attr][:type]
+          props[attr][:items] = { type: columns[attr][:items_type] } if columns[attr][:is_array]
+          props[attr][:'x-nullable'] = columns[attr][:nullable]
+          props[attr][:description] = columns[attr][:comment]
+        end
+      end
+    end
+
+    def relationships_properties
+      {}.tap do |relat_props|
+        relationships.each do |relation_name, relation|
+          relation_name_camelize = relation_name.to_s.camelize
+            relat_props[relation_name] = {
+              type: :object,
+              properties: {
+              links: {
+                type: :object,
+                properties: {
+                  self: { type: :string, description:  tt(:associate_list_link, model: relation_name_camelize) },
+                  related: { type: :string, description: tt(:related_link, model: relation_name_camelize) },
+                },
+                description: tt(:related_link, model: relation_name_camelize)
+              },
+            },
+            description: tt(:related_model, model: relation_name_camelize)
+          }
+        end
+      end
+    end
+
+    def create_relationships_properties
+      {}.tap do |relat_props|
+        relationships.each do |relation_name, relation|
+          relation_name_camelize = relation_name.to_s.camelize
+          relat_props[relation_name] = {
+            type: :object,
+            properties: {
+              data: {
+                type: :array,
+                items: {
+                  type: :object,
+                  properties: {
+                    type: { type: :string, default: relation.table_name },
+                    id: { type: :string, description: "#{relation_name_camelize} ID" },
+                  },
+                },
+                description: tt(:related_ids, model: relation_name_camelize)
+              }
+            },
+            description: tt(:related_ids, model: relation_name_camelize)
+          }
+          if relation.try(:belongs_to?)
+            relat_props[relation_name][:properties][:data] = {
+              type: :object,
+              properties: {
+                type: { type: :string, default: relation.table_name },
+                id: { type: :string, description: "#{relation_name_camelize} ID" },
+              },
+              description: tt(:related_id, model: relation_name_camelize)
+            }
+          end
+        end
+      end
+    end
+
+    def list_resource_responses
+      {
+        '200' => {
+          description: tt(:get_list),
+          schema: {
+            type: :object,
+            properties: {
+              data: {
+                type: :array,
+                items: {
+                  type: :object,
+                  properties: {
+                    id: { type: :string, description: 'ID'},
+                    links: {
+                      type: :object,
+                      properties: {
+                      self: { type: :string, description: tt(:detail_link) },
+                    },
+                    description: tt(:detail_link)
+                  },
+                  attributes: {
+                    type: :object,
+                    properties: properties(attrs: attributes.each_key),
+                    description: tt(:attributes)
+                  },
+                  relationships: {
+                    type: :object,
+                    properties: relationships_properties,
+                    description: tt(:associate_data)
+                  }
+              },
+            },
+            description: tt(:data)
+            },
+            meta: {
+              type: :object,
+              properties: {
+                record_count: { type: :integer, description: tt(:record_count)},
+                page_count: { type: :integer, description: tt(:page_count)},
+              },
+              description: tt(:meta)
+            },
+            links: {
+              type: :object,
+              properties: {
+                first: { type: :string, description: tt(:first_page_link) },
+                next: { type: :string, description: tt(:next_page_link) },
+                last: { type: :string, description: tt(:last_page_link) },
+              },
+              description: tt(:page_links) },
+          },
+          required: [:data]
+          }
+        }
+      }
+    end
+
+    def show_resource_responses
+      {
+        '200' => {
+          description: tt(:get_detail),
+          schema: show_resource_schema
+        }
+      }
+    end
+
+    def create_resource_responses
+      {
+        '201' => {
+          description: tt(:create),
+          schema: show_resource_schema
+        }
+      }
+    end
+
+    def delete_resource_responses
+      {
+        '204' => { description: tt(:delete) }
+      }
+    end
+
+    def show_resource_schema
+      {
+        type: :object,
+        properties: {
+          data: {
+            type: :object,
+            properties: {
+              id: { type: :string, description: 'ID'},
+              type: { type: :string, description: 'Type'},
+              links: {
+                type: :object,
+                properties: {
+                  self: { type: :string, description: tt(:detail_link) },
+                },
+                description: tt(:detail_link)
+              },
+              attributes: {
+                type: :object,
+                properties: properties(attrs: attributes.each_key),
+                description: tt(:attributes)
+              },
+              relationships: {
+                type: :object,
+                properties: relationships_properties,
+                description: tt(:associate_data)
+              }
+            },
+            description: tt(:data)
+          }
+        },
+        required: [:data]
+      }
+    end
+
+    doc['paths']["/#{route_resouces}"] = {
+      get: {
+        summary: "#{route_resouces} #{tt(:list)}",
+        tags: [route_resouces],
+        produces: ['application/vnd.api+json'],
+        parameters: list_resource_parameters,
+        responses: list_resource_responses
+      }
+    }
+
+    doc['paths']["/#{route_resouces}/{id}"] = {
+      get: {
+        summary: "#{route_resouces} #{tt(:detail)}",
+        tags: [route_resouces],
+        produces: ['application/vnd.api+json'],
+        parameters: show_resource_parameters,
+        responses: show_resource_responses
+      }
+    }
+
+if mutable?
+  doc['paths']["/#{route_resouces}"].merge!({
+    post: {
+      summary: "#{route_resouces} #{tt(:create)}",
+      tags: [route_resouces],
+      consumes: ['application/vnd.api+json'],
+      produces: ['application/vnd.api+json'],
+      parameters: [create_resource_parameters],
+      responses: create_resource_responses
+    }
+  })
+
+  doc['paths']["/#{route_resouces}/{id}"].merge!({
+    patch: {
+      summary: "#{route_resouces} #{tt(:patch)}",
+      tags: [route_resouces],
+      consumes: ['application/vnd.api+json'],
+      produces: ['application/vnd.api+json'],
+      parameters: patch_resource_parameters,
+      responses: show_resource_responses
+    }
+  })
+
+  doc['paths']["/#{route_resouces}/{id}"].merge!({
+    delete: {
+      summary: "#{route_resouces} #{tt(:delete)}",
+      tags: [route_resouces],
+      produces: ['application/vnd.api+json'],
+      parameters: delete_resource_parameters,
+      responses: delete_resource_responses
+    }
+  })
+else
+  doc['paths']["/#{route_resouces}"].delete(:post)
+  doc['paths']["/#{route_resouces}/{id}"].delete(:patch)
+  doc['paths']["/#{route_resouces}/{id}"].delete(:delete)
+end
+-%>
+  "paths": <%= JSON.pretty_generate(doc['paths'] ) %>
+}

data/lib/generators/jsonapi/swagger/templates/swagger.rb.erb

@@ -3,7 +3,11 @@ RSpec.describe '<%= resouces_name %>', type: :request do
   let(:include) {''} #see https://github.com/domaindrivendev/rswag/issues/188
 
   before(:each) do
+  <% if defined?(FactoryBot) -%>
     @<%= model_name %> = create :<%= model_name %>
+  <% else -%>
+    @<%= model_name %> = <%= model_class_name %>.create
+  <% end -%>
   end
 
   path '/<%= route_resouces %>' do
@@ -22,7 +26,7 @@ RSpec.describe '<%= resouces_name %>', type: :request do
 <% end -%>
       parameter name: :'fields[<%= route_resouces %>]', in: :query, type: :string, description: '<%= t(:display_field) %>', required: false
 <% relationships.each_value do |relation| -%>
-      parameter name: :'fields[<%= relation.class_name.tableize %>]', in: :query, type: :string, description: '<%= t(:display_field) %>', required: false
+      parameter name: :'fields[<%= relation_table_name(relation) %>]', in: :query, type: :string, description: '<%= t(:display_field) %>', required: false
 <% end -%>
       response '200', '<%= t(:get_list) %>' do
         schema type: :object,
@@ -109,7 +113,7 @@ RSpec.describe '<%= resouces_name %>', type: :request do
 <% end -%>
       parameter name: :'fields[<%= route_resouces %>]', in: :query, type: :string, description: '<%= t(:display_field) %>', required: false
 <% relationships.each_value do |relation| -%>
-      parameter name: :'fields[<%= relation.class_name.tableize %>]', in: :query, type: :string, description: '<%= t(:display_field) %>', required: false
+      parameter name: :'fields[<%= relation_table_name(relation) %>]', in: :query, type: :string, description: '<%= t(:display_field) %>', required: false
 <% end -%>
       response '200', '<%= t(:get_detail) %>' do
         schema type: :object,
@@ -169,7 +173,7 @@ RSpec.describe '<%= resouces_name %>', type: :request do
     end
   end
 
-<% if resource_klass.mutable? -%>
+<% if mutable? -%>
   path '/<%= route_resouces %>' do
     post '<%= route_resouces %> <%= t(:create) %>' do
       tags '<%= route_resouces %>'
@@ -200,7 +204,7 @@ RSpec.describe '<%= resouces_name %>', type: :request do
                         <%= relation_name %>: {
                           type: :object,
                           properties: {
-<% if relation.belongs_to? -%>
+<% if relation.try(:belongs_to?) -%>
                             data: {
                               type: :object,
                               properties: {

data/lib/i18n/en.yml

@@ -1,6 +1,7 @@
 en:
   jsonapi_swagger:
     page_num: 'Page Number'
+    page_size: 'Page Size'
     include_related_data: 'Include Related Data'
     sortable_fields: 'Sortable Fields'
     display_field: 'Display Field'

data/lib/i18n/zh-CN.yml

@@ -1,6 +1,7 @@
 zh-CN:
   jsonapi_swagger:
     page_num: '页码'
+    page_size: '每页条数'
     include_related_data: '包含关联数据'
     sortable_fields: '排序字段'
     display_field: '显示字段'

data/lib/jsonapi/swagger.rb

@@ -2,9 +2,43 @@
 
 require 'jsonapi/swagger/version'
 require 'jsonapi/swagger/railtie' if defined?(Rails)
+require 'jsonapi/swagger/json'
+require 'jsonapi/swagger/resource'
 
 module Jsonapi
   module Swagger
     class Error < StandardError; end
+
+    class << self
+      attr_accessor :version, :info, :file_path, :base_path, :use_rswag
+
+      def config
+        yield self
+      end
+
+      def version
+        @version ||= '2.0'
+      end
+
+      def info
+        @info ||= { title: 'API V1', version: 'V1' }
+      end
+
+      def file_path
+        @file_path ||= 'v1/swagger.json'
+      end
+
+      def base_path
+        @base_path
+      end
+
+      def use_rswag
+        @use_rswag ||= false
+      end
+
+      def attribute_default
+        @attribute_default ||= { type: :string, nullable: true, comment: nil }
+      end
+    end
   end
 end

data/lib/jsonapi/swagger/json.rb

@@ -0,0 +1,31 @@
+module Jsonapi
+  module Swagger
+    class Json
+
+      attr_accessor :path
+
+      def initialize(path = 'swagger/v1/swagger.json')
+        @path = path
+      end
+
+      def parse_doc
+        @doc ||= JSON.parse(load) rescue Hash.new{ |h, k| h[k]= {} }
+      end
+
+      def base_path
+        Jsonapi::Swagger.base_path
+      end
+
+      def load
+        @data ||= if File.exist?(path)
+                  IO.read(path)
+                else
+                  puts "create swagger.json in #{path}"
+                  '{}'
+                end
+      end
+
+
+    end
+  end
+end

data/lib/jsonapi/swagger/resource.rb

@@ -0,0 +1,33 @@
+require 'forwardable'
+module Jsonapi
+  module Swagger
+    class Resource
+      def self.with(model_class_name)
+        if Object.const_defined?("#{model_class_name}Resource")
+          @resource_class = "#{model_class_name}Resource".safe_constantize
+          unless @resource_class < JSONAPI::Resource
+            raise Jsonapi::Swagger::Error, "#{@resource_class.class} is not Subclass of JSONAPI::Resource!"
+          end
+          require 'jsonapi/swagger/resources/jsonapi_resource'
+          return Jsonapi::Swagger::JsonapiResource.new(@resource_class)
+        elsif Object.const_defined?("Serializable#{model_class_name}")
+          @resource_class = "Serializable#{model_class_name}".safe_constantize
+          unless @resource_class < JSONAPI::Serializable::Resource
+            raise Jsonapi::Swagger::Error, "#{@resource_class.class} is not Subclass of JSONAPI::Serializable::Resource!"
+          end
+          require 'jsonapi/swagger/resources/serializable_resource'
+          return Jsonapi::Swagger::SerializableResource.new(@resource_class)
+        elsif Object.const_defined?("#{model_class_name}Serializer")
+          @resource_class = "#{model_class_name}Serializer".safe_constantize
+          unless @resource_class < FastJsonapi::ObjectSerializer
+            raise Jsonapi::Swagger::Error, "#{@resource_class.class} is not Subclass of FastJsonapi::ObjectSerializer!"
+          end
+          require 'jsonapi/swagger/resources/fast_jsonapi_resource'
+          return Jsonapi::Swagger::FastJsonapiResource.new(@resource_class)
+        else
+          raise Jsonapi::Swagger::Error, "#{model_class_name} not support!"
+        end
+      end
+    end
+  end
+end

data/lib/jsonapi/swagger/resources/fast_jsonapi_resource.rb

@@ -0,0 +1,39 @@
+require 'forwardable'
+module Jsonapi
+  module Swagger
+    class FastJsonapiResource
+      extend Forwardable
+
+      def_delegators :@fr, :attributes_to_serialize, :relationships_to_serialize, :sortable_fields,
+                           :creatable_fields, :updatable_fields, :filters, :mutable?, :transform_method
+
+      def initialize(fr)
+        @fr = fr
+      end
+
+      alias attributes attributes_to_serialize
+      alias relationships relationships_to_serialize
+
+      # TODO: fast_jsonapi resource
+      def sortable_fields
+        []
+      end
+
+      def creatable_fields
+        []
+      end
+
+      def updatable_fields
+        []
+      end
+
+      def filters
+        []
+      end
+
+      def mutable?
+        false
+      end
+    end
+  end
+end

data/lib/jsonapi/swagger/resources/jsonapi_resource.rb

@@ -0,0 +1,18 @@
+require 'forwardable'
+module Jsonapi
+  module Swagger
+    class JsonapiResource
+      extend Forwardable
+
+      def_delegators :@jr, :_attributes, :_relationships, :sortable_fields,
+                           :creatable_fields, :updatable_fields, :filters, :mutable?
+
+      def initialize(jr)
+        @jr = jr
+      end
+
+      alias attributes _attributes
+      alias relationships _relationships
+    end
+  end
+end

data/lib/jsonapi/swagger/resources/serializable_resource.rb

@@ -0,0 +1,45 @@
+require 'forwardable'
+module Jsonapi
+  module Swagger
+    class SerializableResource
+      extend Forwardable
+
+      def_delegators :@sr, :type_val, :attribute_blocks, :relationship_blocks, :link_blocks
+
+      def initialize(sr)
+        @sr = sr
+      end
+
+      alias attributes attribute_blocks
+
+      def relationships
+        {}.tap do |relations|
+          relationship_blocks.each do |rel, block|
+            relations[rel] = OpenStruct.new(class_name: rel.to_s)
+          end
+        end
+      end
+
+      # TODO: from jsonapi serializable resource
+      def sortable_fields
+        []
+      end
+
+      def creatable_fields
+        []
+      end
+
+      def updatable_fields
+        []
+      end
+
+      def filters
+        []
+      end
+
+      def mutable?
+        false
+      end
+    end
+  end
+end

data/lib/jsonapi/swagger/version.rb

@@ -2,6 +2,6 @@
 
 module Jsonapi
   module Swagger
-    VERSION = '0.5.0'
+    VERSION = '0.8.1'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jsonapi-swagger
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.8.1
 platform: ruby
 authors:
 - YingRui Lu
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-05-08 00:00:00.000000000 Z
+date: 2020-11-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -28,16 +28,16 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 12.3.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 12.3.3
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -59,7 +59,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
-  type: :runtime
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
@@ -76,17 +76,22 @@ files:
 - README.md
 - lib/generators/jsonapi/swagger/USAGE
 - lib/generators/jsonapi/swagger/swagger_generator.rb
+- lib/generators/jsonapi/swagger/templates/swagger.json.erb
 - lib/generators/jsonapi/swagger/templates/swagger.rb.erb
 - lib/i18n/en.yml
 - lib/i18n/zh-CN.yml
 - lib/jsonapi/swagger.rb
+- lib/jsonapi/swagger/json.rb
 - lib/jsonapi/swagger/railtie.rb
+- lib/jsonapi/swagger/resource.rb
+- lib/jsonapi/swagger/resources/fast_jsonapi_resource.rb
+- lib/jsonapi/swagger/resources/jsonapi_resource.rb
+- lib/jsonapi/swagger/resources/serializable_resource.rb
 - lib/jsonapi/swagger/version.rb
 homepage: https://github.com/superiorlu/jsonapi-swagger
 licenses:
 - MIT
-metadata:
-  allowed_push_host: https://rubygems.org
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -102,7 +107,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: JSON API Swagger Doc Generator