feature: move swagger to apress-documentation

https://jira.railsc.ru/browse/PC4-19470

Gemfile

@@ -1,5 +1,7 @@
 source "https://gems.railsc.ru"
 source "https://rubygems.org"
 
+gem 'apress-documentation', git: '[email protected]:abak-press/apress-documentation.git'
+
 # Specify your gem's dependencies in apress-api.gemspec
 gemspec

app/docs/swagger/v1/default_responses/bad_request.rb

@@ -0,0 +1,14 @@
+module Swagger
+  module DefaultResponses
+    module BadRequest
+      def self.extended(base)
+        base.response 400 do
+          key :description, "Переданные параметры не могут быть обработаны"
+          schema do
+            key :'$ref', :'Swagger::V1::::Models::Apress::Api::UnprocessableError'
+          end
+        end
+      end
+    end
+  end
+end

app/docs/swagger/v1/default_responses/not_found.rb

@@ -0,0 +1,14 @@
+module Swagger
+  module DefaultResponses
+    module NotFound
+      def self.extended(base)
+        base.response 404 do
+          key :description, "Запрашиваемый ресурс не найден"
+          schema do
+            key :'$ref', :'Swagger::V1::::Models::Apress::Api::SimpleError'
+          end
+        end
+      end
+    end
+  end
+end

app/docs/swagger/v1/default_responses/unauthenticated.rb

@@ -0,0 +1,14 @@
+module Swagger
+  module DefaultResponses
+    module Unauthenticated
+      def self.extended(base)
+        base.response 401 do
+          key :description, "Запрос не прошел аутентификацию (проблема с подписью запроса)"
+          schema do
+            key :'$ref', :'Swagger::V1::::Models::Apress::Api::SimpleError'
+          end
+        end
+      end
+    end
+  end
+end

app/docs/swagger/v1/default_responses/unauthorized.rb

@@ -0,0 +1,14 @@
+module Swagger
+  module DefaultResponses
+    module Unauthorized
+      def self.extended(base)
+        base.response 403 do
+          key :description, "Нет доступа к ресурсу"
+          schema do
+            key :'$ref', :'Swagger::V1::::Models::Apress::Api::SimpleError'
+          end
+        end
+      end
+    end
+  end
+end

app/docs/swagger/v1/default_responses/unprocessable.rb

@@ -0,0 +1,14 @@
+module Swagger
+  module DefaultResponses
+    module Unprocessable
+      def self.extended(base)
+        base.response 422 do
+          key :description, "Переданные параметры не валидны"
+          schema do
+            key :'$ref', :'Swagger::V1::::Models::Apress::Api::UnprocessableError'
+          end
+        end
+      end
+    end
+  end
+end

app/docs/swagger/v1/default_responses/updates_locked.rb

@@ -0,0 +1,11 @@
+module Swagger
+  module DefaultResponses
+    module UpdatedLocked
+      def self.extended(base)
+        base.response 503 do
+          key :description, "Закрыто редактирование"
+        end
+      end
+    end
+  end
+end

app/docs/swagger/v1/models/apress/api/client.rb

@@ -3,7 +3,7 @@ module V1
     module Models
       module Apress
         module Api
-          class Client < ::Apress::Api::Swagger::Schema
+          class Client < ::Apress::Documentation::Swagger::Schema
             swagger_schema name.to_sym do
               key :required, [
                 :id,

app/docs/swagger/v1/models/apress/api/simple_error.rb

@@ -3,7 +3,7 @@ module V1
     module Models
       module Apress
         module Api
-          class SimpleError < ::Apress::Api::Swagger::Schema
+          class SimpleError < ::Apress::Documentation::Swagger::Schema
             swagger_schema name.to_sym do
               keys = [
                 :status,

app/docs/swagger/v1/models/apress/api/unproccesable_error.rb

@@ -1,10 +1,12 @@
+require_relative 'unprocessable_error'
+
 module Swagger
   module V1
     module Models
       module Apress
         module Api
           # Deprecated: Please use `UnprocessableError` instead
-          class UnproccesableError < ::Apress::Api::Swagger::Schema
+          class UnproccesableError < ::Apress::Documentation::Swagger::Schema
             include UnprocessableError::Schema
           end
         end

app/docs/swagger/v1/models/apress/api/unprocessable_error.rb

@@ -3,7 +3,7 @@ module V1
     module Models
       module Apress
         module Api
-          class UnprocessableError < ::Apress::Api::Swagger::Schema
+          class UnprocessableError < ::Apress::Documentation::Swagger::Schema
             module Schema
               extend ActiveSupport::Concern
 

app/docs/swagger/v1/root.rb

@@ -1,6 +1,6 @@
 module Swagger
   module V1
-    class Root < ::Apress::Api::Swagger::Schema
+    class Root < ::Apress::Documentation::Swagger::Schema
       swagger_root do
         key :swagger, '2.0'
         info do

apress-api.gemspec

@@ -26,7 +26,6 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency "jbuilder", ">= 2.3.1"
   spec.add_runtime_dependency "attr_extras", ">= 4.4.0"
   spec.add_runtime_dependency 'swagger-core', '>= 0.3.0'
-  spec.add_runtime_dependency 'swagger-blocks', '>= 1.3'
 
   spec.add_development_dependency "bundler", "~> 1.7"
   spec.add_development_dependency "rake", "~> 10.0"

lib/apress/api.rb

@@ -6,5 +6,16 @@
 require "api_auth"
 require "attr_extras"
 require 'swagger/blocks'
+require 'apress/documentation'
 require "apress/api/version"
 require "apress/api/engine"
+
+module Apress
+  module Api
+    module Swagger
+      def self.const_missing(name)
+        ::Apress::Documentation::Swagger.const_get(name)
+      end
+    end
+  end
+end

lib/apress/api/engine.rb

@@ -4,16 +4,13 @@ module Apress
   module Api
     class Engine < Rails::Engine
       config.autoload_paths << config.root.join("lib")
-      config.paths.add 'app/docs', :eager_load => true
+      config.paths.add 'app/docs', eager_load: false
+
+      Apress::Documentation.add_load_path(config.root.join('app/docs'))
 
       initializer "apress-api", before: :load_init_rb do |app|
         app.config.paths["db/migrate"].concat(config.paths["db/migrate"].expanded)
 
-        glob = config.root.join('app/docs/**/*.rb')
-        app.config.to_prepare do
-          Dir[glob].each { |file| require_dependency file }
-        end
-
         app.config.api = {
           secret_token_ttl: 1.hour,
           refresh_token_ttl: 1.week,