apiculture 0.1.2 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 22ff31bb7b740ba2994dadcf1e76b10c5e47d5e4
-  data.tar.gz: 7a0f4a80554d338542dd0eb9c1ecd39820218066
+SHA256:
+  metadata.gz: 21e9fada9f8ba88c058f19789d597059bb30b055fe92c10e27953c5df6296758
+  data.tar.gz: 7b3c02a5587b6976a2a1a7b11656834824e32887b9dde3922542687fcbe63c71
 SHA512:
-  metadata.gz: af3e86d8c2b3c1f8a6f42b03f96d4ff904afe5c7874a28d84ecdc41bec3bb0dea2984fa173ac111ba1e32343e7cebc6826af46dca93e17c61e2d94ba307168a3
-  data.tar.gz: 21674f0cd0a3b0ca724724920184210661b7de00f40d834daf74d95c66371938c7408d56401580ded47955d9ba9e240ee95a4778963a5b3c128d7e9cd0eff819
+  metadata.gz: b0818c0fd6c04efa47f0cabcd0927c13516bd293d7486fea8750b7325d260208b3134432ebf43fbc9d7f0321a8ff7b8e5ea07e6f679e59b1df62e0f5f105f1b7
+  data.tar.gz: 853ca12aefe6005ae08432d29f902f6a1584252db87663c08c96a00f47d7b771108e2485f39e7400615e8f54243f68f6abf2e8406a963def5e3821c9ee62a6fc

data/.travis.yml

@@ -2,12 +2,10 @@ gemfile:
   - gemfiles/Gemfile.rack-1.x
   - gemfiles/Gemfile.rack-2.x
 rvm:
-- 2.3.7
-- 2.4.4
-- 2.5.1
-- 2.6.0-preview1
+  - 2.3
+  - 2.4
+  - 2.5
+  - 2.6
+  - 2.7
 sudo: false
 cache: bundler
-matrix:
-  allow_failures:
-    - rvm: 2.6.0-preview1

data/apiculture.gemspec

@@ -36,13 +36,13 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency 'mustermann', '~> 1'
   s.add_runtime_dependency 'builder', '~> 3'
   s.add_runtime_dependency 'rdiscount', '~> 2'
-  s.add_runtime_dependency 'github-markup', '~> 1'
+  s.add_runtime_dependency 'github-markup', '~> 3'
   s.add_runtime_dependency 'mustache', '~> 1'
 
   s.add_development_dependency 'rack-test'
-  s.add_development_dependency "rspec", "~> 3.1", '< 3.2'
+  s.add_development_dependency "rspec", "~> 3"
   s.add_development_dependency "rdoc", "~> 6.0"
-  s.add_development_dependency "rake", "~> 10"
+  s.add_development_dependency "rake"
   s.add_development_dependency "bundler", "~> 1.0"
   s.add_development_dependency "simplecov", ">= 0"
 end

data/gemfiles/Gemfile.rack-1.x

@@ -12,6 +12,6 @@ group :development do
   gem "rspec", "~> 3.1", '< 3.2'
   gem "rdoc", "~> 6.0"
   gem "rake", "~> 10"
-  gem "bundler", "~> 1.0"
   gem "simplecov", ">= 0"
+  gem "bundler"
 end

data/gemfiles/Gemfile.rack-2.x

@@ -12,6 +12,6 @@ group :development do
   gem "rspec", "~> 3.1", '< 3.2'
   gem "rdoc", "~> 6.0"
   gem "rake", "~> 10"
-  gem "bundler", "~> 1.0"
   gem "simplecov", ">= 0"
+  gem "bundler"
 end

data/lib/apiculture.rb

@@ -9,6 +9,7 @@ module Apiculture
   require_relative 'apiculture/markdown_segment'
   require_relative 'apiculture/timestamp_promise'
   require_relative 'apiculture/app_documentation'
+  require_relative 'apiculture/openapi_documentation'
   
   def self.extended(in_class)
     in_class.send(:include, SinatraInstanceMethods)
@@ -205,7 +206,7 @@ module Apiculture
   def api_documentation
     AppDocumentation.new(self, @apiculture_mounted_at.to_s, @apiculture_actions_and_docs || [])
   end
-  
+
   # Define an API method. Under the hood will call the related methods in Sinatra
   # to define the route.
   def api_method(http_verb, path, options={}, &blk)

data/lib/apiculture/app.rb

@@ -102,7 +102,7 @@ class Apiculture::App
   end
 
   def perform_action_block(&blk)
-    # Execut the action in a Sinatra-like fashion - passing the route parameter values as
+    # Executes the action in a Sinatra-like fashion - passing the route parameter values as
     # arguments to the given block/callable. This is where in the future we should ditch
     # the Sinatra calling conventions - Sinatra mandates that the action accept the route parameters
     # as arguments and grab all the useful stuff from instance methods like `params` etc. whereas

data/lib/apiculture/app_documentation.rb

@@ -25,6 +25,10 @@ class Apiculture::AppDocumentation
   # Generates a Markdown string that contains the entire API documentation
   def to_markdown
     (['## %s' % @app_title] + to_markdown_slices).join("\n\n")
+  end 
+
+  def to_openapi
+    OpenApiDocumentation::Base.new(@app_title, @mountpoint, @chunks)
   end
   
   # Generates an HTML fragment string that can be included into another HTML document

data/lib/apiculture/app_documentation_tpl.mustache

@@ -96,8 +96,8 @@
     }
     </style>
   </head>
-  
+
   <body>
     {{& html_fragment }}
   </body>
-</html>
+</html>

data/lib/apiculture/method_documentation.rb

@@ -1,4 +1,6 @@
 require 'builder'
+require 'rdiscount'
+
 # Generates Markdown/HTML documentation about a single API action.
 #
 # Formats route parameters and request/QS parameters as a neat HTML
@@ -26,12 +28,15 @@ class Apiculture::MethodDocumentation
 
   # Compose an HTML string by converting the result of +to_markdown+
   def to_html_fragment
-    require 'rdiscount'
-    RDiscount.new(to_markdown).to_html
+    markdown_string_to_html(to_markdown)
   end
 
   private
 
+  def markdown_string_to_html(str)
+    RDiscount.new(str.to_s).to_html
+  end
+
   class StringBuf #:nodoc:
     def initialize; @blocks = []; end
     def <<(block); @blocks << block.to_s; self; end
@@ -59,7 +64,7 @@ class Apiculture::MethodDocumentation
       @definition.route_parameters.each do | param |
         html.tr do
           html.td { html.tt(':%s' % param.name) }
-          html.td(param.description)
+          html.td { html << markdown_string_to_html(param.description) }
         end
       end
     end
@@ -98,7 +103,7 @@ class Apiculture::MethodDocumentation
       @definition.responses.each do | resp |
         html.tr do
           html.td { html.b(resp.http_status_code) }
-          html.td resp.description
+          html.td { html << markdown_string_to_html(resp.description) }
           html.td { html.pre { html.code(body_example(resp)) }}
         end
       end
@@ -139,7 +144,7 @@ class Apiculture::MethodDocumentation
           html.td { html.tt(param.name.to_s) }
           html.td(param.required ? 'Yes' : 'No')
           html.td(param.matchable.inspect)
-          html.td(param.description.to_s)
+          html.td { html << markdown_string_to_html(param.description) }
         end
       end
     end

data/lib/apiculture/openapi_documentation.rb

@@ -0,0 +1,224 @@
+# frozen_string_literal: true
+require 'yaml'
+require 'base64'
+module OpenApiDocumentation
+  class Base
+    def initialize(app, prefix, chunks)
+      @app, @prefix = app, prefix
+      @paths = chunks.select { |chunk| chunk.respond_to?(:http_verb) }
+      @data = {
+        openapi: '3.0.0',
+        info: { 
+          title: @app.to_s, 
+          version: '0.0.1', 
+          description: @app.to_s + " " + chunks.select { |chunk| chunk.respond_to?(:to_markdown) }.map(&:to_markdown).join("\n")
+        },
+        tags: []
+      }
+      @data[:paths] = build_paths
+    end
+
+    def to_yaml
+      JSON.load(@data.to_json).to_yaml # trickery to get string based yaml
+    end
+
+    def paths
+      @data[:paths]
+    end
+
+    def spec
+      @data      
+    end
+
+    private
+
+    def build_paths
+      paths = {}
+      @paths.each do |path|
+        path = Path.new(path, @prefix, @app)
+        paths = merge_paths(paths, path)
+      end
+      paths
+    end
+
+    # We don't have deep_merge here so this is the poor man's alternative
+    def merge_paths(paths, path)
+      if paths.key?(path.name)
+        paths[path.name].merge!(path.build[path.name])
+      else
+        paths.merge!(path.build)
+      end
+      paths
+    end
+
+  end
+
+  class Path
+    VERBS_WITHOUT_BODY = %w(get head delete options)
+
+    def initialize(path, prefix, app)
+      @path, @prefix, @app = path, prefix, app
+    end
+
+    def build
+      request_body = build_request_body unless VERBS_WITHOUT_BODY.include?(@path.http_verb)
+      {
+        name =>
+        {
+          @path.http_verb.to_sym => {
+            summary: @path.description,
+            description: @path.description,
+            tags: [ @app.to_s ],
+            parameters: build_parameters,
+            requestBody: request_body,
+            responses: build_responses,
+            operationId: operation_id
+          }.delete_if { |_k, v| v.nil? || v.empty? }
+        }
+      }
+    end
+
+    def name
+      full_path = @path.path.to_s
+      @path.route_parameters.each do |parameter|
+        # This is a bit confusing but naming is a little different between
+        # apiculture and openapi
+        full_path.gsub!(":#{parameter.name}", "\{#{parameter.name}\}")
+      end
+      Util.clean_path("#{@prefix}#{full_path}")
+    end
+
+    private
+
+    def operation_id
+      # base64 encoding to make sure these ids are safe to use in an url
+      Base64.urlsafe_encode64("#{@path.http_verb}#{@prefix}#{@path.path}")
+    end
+
+    def build_parameters
+      if VERBS_WITHOUT_BODY.include?(@path.http_verb)
+        build_route_parameters + build_query_parameters
+      else
+        build_route_parameters
+      end
+    end
+
+    def build_route_parameters
+      route_params = @path.route_parameters.map do |parameter|
+        {
+          name: parameter.name,
+          description: parameter.description,
+          required: true,
+          in: :path,
+          schema: {
+            type: Util.map_type(parameter.matchable),
+            example: Util.map_example(parameter.matchable)
+          }
+        }
+      end
+      route_params
+    end
+
+    def build_query_parameters
+      params = @path.parameters.map do |parameter|
+        {
+          name: parameter.name,
+          description: parameter.description,
+          required: true,
+          in: :query,
+          schema: {
+            type: Util.map_type(parameter.matchable),
+            example: parameter.matchable
+          }
+        }
+      end
+      params
+    end
+
+    def build_request_body
+      return nil if VERBS_WITHOUT_BODY.include?(@path.http_verb)
+      
+      body_params = Hash[ @path.parameters.collect do |parameter|
+        [parameter.name, {
+          type: Util.map_type(parameter.matchable),
+          description: parameter.description
+        }]
+      end ]
+
+      return nil if body_params.count == 0
+
+      schema = {
+        type: :object,
+        properties: body_params
+      }
+
+      schema[:required] = @path.parameters.select(&:required).map(&:name) if @path.parameters.select(&:required).map(&:name).count > 0
+      {
+        content: {
+          "application/json": {
+            schema: schema
+          }
+        }
+      }
+    end
+
+    def build_responses
+      responses = Hash[@path.responses.collect do |response|
+        _response = {
+          description: response.description
+        }
+
+        unless response.jsonable_object_example.nil? || response.jsonable_object_example.empty?
+          _response[:content] = {
+            'application/json': {
+                schema: 
+                  { type: 'object',
+                  properties: Util.response_to_schema(response.jsonable_object_example) }
+            }
+          }
+        end
+
+        [response.http_status_code.to_s, _response]
+      end ]
+      responses
+    end
+  end
+
+  class Util
+    TYPES = {
+      String => 'string',
+      Integer => 'integer',
+      TrueClass => 'boolean'
+    }.freeze
+
+    EXAMPLES = {
+      String => 'string',
+      Integer => 1234,
+      TrueClass => true
+    }.freeze
+
+    def self.response_to_schema(response)
+      schema = {}
+      return nil if response.nil? || response.empty? || response.class == String
+      response.each do |key, value|
+        schema[key] = {
+          type: 'string',
+          example: value.to_s
+        }
+      end
+      schema
+    end
+
+    def self.map_type(type)
+      TYPES.fetch(type, 'string')
+    end
+
+    def self.map_example(type)
+      EXAMPLES.fetch(type, 'string')
+    end
+
+    def self.clean_path(path)
+      path.gsub(/\/\?\*\?$/, '')
+    end
+  end
+end

data/lib/apiculture/version.rb

@@ -1,3 +1,3 @@
 module Apiculture
-  VERSION = '0.1.2'
+  VERSION = '0.1.7'
 end

data/spec/apiculture/app_documentation_spec.rb

@@ -1,28 +1,35 @@
 require_relative '../spec_helper'
 
 describe "Apiculture.api_documentation" do
-  let(:app) {
+  let(:app) do
     Class.new(Apiculture::App) do
       extend Apiculture
-      
+
       markdown_string 'This API is very important. Because it has to do with pancakes.'
-      
+
       documentation_build_time!
-      
+
       desc 'Order a pancake'
-      required_param :diameter, "Diameter of the pancake", Integer
+      required_param :diameter, "Diameter of the pancake. The pancake will be **bold**", Integer
       param :topping, 'Type of topping', String
-      responds_with 200, 'When the pancake is created succesfully', {id: 'abdef..c21'}
+      pancake_response_info = <<~EOS
+        When the pancake has been baked successfully
+        The pancake will have the following properties:
+
+        * It is going to be round
+        * It is going to be delicious
+      EOS
+      responds_with 200, pancake_response_info, { id: 'abdef..c21' }
       api_method :post, '/pancakes' do
       end
-      
+
       desc 'Check the pancake status'
       route_param :id, 'Pancake ID to check status on'
-      responds_with 200, 'When the pancake is found', {status: 'Baking'}
-      responds_with 404, 'When no such pancake exists', {status: 'No such pancake'}
+      responds_with 200, 'When the pancake is found', { status: 'Baking' }
+      responds_with 404, 'When no such pancake exists', { status: 'No such pancake' }
       api_method :get, '/pancake/:id' do
       end
-      
+
       desc 'Throw away the pancake'
       route_param :id, 'Pancake ID to delete'
       api_method :delete, '/pancake/:id' do
@@ -33,21 +40,21 @@ describe "Apiculture.api_documentation" do
       api_method :get, '/pancake/with/:topping_id' do |topping_id|
       end
     end
-  }
-  
+  end
+
   it 'generates app documentation as HTML without the body element' do
     docco = app.api_documentation
     generated_html = docco.to_html_fragment
-    
+
     expect(generated_html).not_to include('<body')
     expect(generated_html).to include('Pancake ID to check status on')
     expect(generated_html).to include('Pancake ID to delete')
   end
-  
+
   it 'generates app documentation in HTML' do
     docco = app.api_documentation
     generated_html = docco.to_html
-    
+
     if ENV['SHOW_TEST_DOC']
       File.open('t.html', 'w') do |f|
         f.write(generated_html)
@@ -55,21 +62,22 @@ describe "Apiculture.api_documentation" do
         `open #{f.path}`
       end
     end
-   
+
     expect(generated_html).to include('<body')
     expect(generated_html).to include('Pancake ID to check status on')
-    expect(generated_html).to include('When the pancake is created succesfully')
+    expect(generated_html).to include('When the pancake has been baked successfully')
     expect(generated_html).to include('"id": "abdef..c21"')
+    expect(generated_html).to end_with("\n")
   end
-  
+
   it 'generates app documentation in Markdown' do
     docco = app.api_documentation
     generated_markdown = docco.to_markdown
-    
+
     expect(generated_markdown).not_to include('<body')
     expect(generated_markdown).to include('## POST /pancakes')
   end
-  
+
   it 'generates app documentation honoring the mount point' do
     overridden = Class.new(Apiculture::App) do
       extend Apiculture
@@ -77,11 +85,11 @@ describe "Apiculture.api_documentation" do
       api_method :get, '/pancakes' do
       end
     end
-    
+
     generated_markdown = overridden.api_documentation.to_markdown
     expect(generated_markdown).to include('## GET /api/v2/pancakes')
   end
-  
+
   it 'generates app documentation injecting the inline Markdown strings' do
     app_class = Class.new(Apiculture::App) do
       extend Apiculture
@@ -91,16 +99,16 @@ describe "Apiculture.api_documentation" do
       markdown_string '# This describes even more important stuff'
       markdown_string 'This is a paragraph'
     end
-    
+
     generated_html = app_class.api_documentation.to_html
     expect(generated_html).to include('<h2>GET /pancakes</h2>')
     expect(generated_html).to include('<h1>This describes even more important stuff')
     expect(generated_html).to include('<h1>This describes important stuff')
     expect(generated_html).to include('<p>This is a paragraph')
   end
-  
+
   context 'with a file containing Markdown that has to be spliced into the docs' do
-    before(:each) { File.open('./TEST.md', 'w') {|f| f << "# This is an important header"} }
+    before(:each) { File.open('./TEST.md', 'w') { |f| f << "# This is an important header" } }
     after(:each) { File.unlink('./TEST.md') }
     it 'splices the contents of the file using markdown_file' do
       app_class = Class.new(Apiculture::App) do
@@ -109,7 +117,7 @@ describe "Apiculture.api_documentation" do
         api_method :get, '/pancakes' do
         end
       end
-    
+
       generated_html = app_class.api_documentation.to_html
       expect(generated_html).to include('<h2>GET /pancakes</h2>')
       expect(generated_html).to include('<h1>This is an important header')

data/spec/apiculture/method_documentation_spec.rb

@@ -7,7 +7,7 @@ describe Apiculture::MethodDocumentation do
     
     definition.description = "This action bakes pancakes"
     definition.parameters << Apiculture::Parameter.new(:name, 'Pancake name', true, String, :to_s)
-    definition.parameters << Apiculture::Parameter.new(:thickness, 'Pancake thickness', false, Float, :to_f)
+    definition.parameters << Apiculture::Parameter.new(:thickness, 'Pancake **thick**ness', false, Float, :to_f)
     definition.parameters << Apiculture::Parameter.new(:diameter, 'Pancake diameter', false, Integer, :to_i)
     
     definition.route_parameters << Apiculture::RouteParameter.new(:pan_id, 'ID of the pancake frying pan')
@@ -28,9 +28,9 @@ describe Apiculture::MethodDocumentation do
     expect(generated_html).to include('<h3>URL parameters</h3>')
     expect(generated_html).to include('ID of the pancake frying pan')
     expect(generated_html).to include('<h3>Request parameters</h3>')
-    expect(generated_html).to include('<td>Pancake name</td>')
-    expect(generated_html).to include('<td>Pancake has been baked</td>')
-    expect(generated_html).to include('<td>Frying pan too cold</td>')
+    expect(generated_html).to include('<p>Pancake name</p>')
+    expect(generated_html).to include('<p>Pancake has been baked</p>')
+    expect(generated_html).to include('<p>Frying pan too cold</p>')
   end
   
   it 'generates HTML from an ActionDefinition without route params' do
@@ -38,7 +38,7 @@ describe Apiculture::MethodDocumentation do
     
     definition.description = "This action bakes pancakes"
     definition.parameters << Apiculture::Parameter.new(:name, 'Pancake name', true, String, :to_s)
-    definition.parameters << Apiculture::Parameter.new(:thickness, 'Pancake thickness', false, Float, :to_f)
+    definition.parameters << Apiculture::Parameter.new(:thickness, 'Pancake **thick**ness', false, Float, :to_f)
     definition.parameters << Apiculture::Parameter.new(:diameter, 'Pancake diameter', false, Integer, :to_i)
     
     definition.http_verb = 'get'

data/spec/apiculture/openapi_documentation_spec.rb

@@ -0,0 +1,197 @@
+require_relative '../spec_helper'
+
+describe 'Apiculture.api_documentation' do
+  let!(:test_class) do
+    class PancakeApi < Apiculture::App
+      extend Apiculture
+
+      documentation_build_time!
+
+      desc 'Order a pancake'
+      required_param :diameter, 'Diameter of the pancake. The pancake will be **bold**', Integer
+      param :topping, 'Type of topping', String
+      pancake_response_info = <<~EOS
+        When the pancake has been baked successfully
+        The pancake will have the following properties:
+
+        * It is going to be round
+        * It is going to be delicious
+      EOS
+      responds_with 200, pancake_response_info, { id: 'abdef..c21' }
+      api_method :post, '/pancakes' do
+      end
+
+      desc 'Check the pancake status'
+      route_param :id, 'Pancake ID to check status on'
+      responds_with 200, 'When the pancake is found', { status: 'Baking' }
+      responds_with 404, 'When no such pancake exists', { status: 'No such pancake' }
+      api_method :get, '/pancake/:id' do
+      end
+
+      desc 'Throw away the pancake'
+      route_param :id, 'Pancake ID to delete'
+      api_method :delete, '/pancake/:id' do
+      end
+
+      desc 'Pancake ingredients are in the URL'
+      route_param :topping_id, 'Pancake topping ID', Integer, cast: :to_i
+      api_method :get, '/pancake/with/:topping_id' do |topping_id|
+      end
+    end
+  end
+
+  let(:documentation) { PancakeApi.api_documentation }
+  let(:open_api_map) { documentation.to_openapi.spec }
+
+  describe '.to_openapi' do
+    it 'will have openapi version' do
+      expect(open_api_map).to include(openapi: '3.0.0')
+    end
+
+    describe 'info' do
+      let(:info) { open_api_map.fetch(:info) }
+
+      it 'will not to be empty' do
+        expect(info).not_to be_empty
+      end
+
+      it 'will have title' do
+        expect(info).to include(title: 'PancakeApi')
+      end
+
+      it 'will have version' do
+        expect(info).to include(version: '0.0.1')
+      end
+
+      it 'will have description' do
+        expect(info).to include(:description)
+        expect(info[:description]).to include('PancakeApi Documentation built on')
+      end
+    end
+
+    describe 'paths' do
+      let(:paths) { open_api_map.fetch(:paths) }
+
+      it 'will have paths' do
+        expect(paths).not_to be_empty
+      end
+
+      it 'will have 4 paths' do
+        expect(paths.size).to eq(3)
+      end
+
+      context 'POST /pancakes' do
+        let(:post_pancakes) { paths.dig('/pancakes', :post) }
+
+        it 'will have route' do
+          expect(post_pancakes).not_to be_empty
+        end
+
+        describe 'request body content' do
+          let(:request_content) { post_pancakes.dig(:requestBody, :content) }
+          it 'will have correct JSON content type' do
+            expect(request_content).to have_key(:'application/json')
+          end
+
+          describe 'schema' do
+            let(:schema) { request_content.dig(:'application/json', :schema) }
+            it 'will have type' do
+              expect(schema).to include(type: :object)
+            end
+
+            it 'will have required parameters' do
+              expect(schema).to include(required: [:diameter])
+            end
+
+            describe 'properties' do
+              let(:properties) { schema.fetch(:properties) }
+              it 'will have all properties' do
+                expect(properties).to have_key :diameter
+                expect(properties).to have_key :topping
+              end
+            end
+          end
+        end
+      end
+
+      context 'GET /pancake/:id' do
+        let(:get_pancake_by_id_path) { paths.dig('/pancake/{id}', :get) }
+        it 'will have route' do
+          expect(get_pancake_by_id_path).not_to be_empty
+        end
+
+        it 'will have summary' do
+          expect(get_pancake_by_id_path).to include(summary: 'Check the pancake status')
+        end
+
+        it 'will have a description' do
+          expect(get_pancake_by_id_path).to include(description: 'Check the pancake status')
+        end
+
+        it 'will have operationId' do
+          expect(get_pancake_by_id_path).to have_key :operationId
+        end
+
+        describe 'parameters' do
+          let(:parameter) { get_pancake_by_id_path.fetch(:parameters).first }
+
+          it 'will contain parameter' do
+            expect(parameter).not_to be_empty
+          end
+
+          it 'will have required propertie' do
+            expect(parameter).to include(required: true)
+          end
+
+          it 'will indicate a path parameter' do
+            expect(parameter).to include(in: :path)
+          end
+
+          describe 'schema' do
+            let(:schema) { parameter.fetch(:schema) }
+            it 'will have object type' do
+              expect(schema).to include(type: 'string')
+            end
+
+            it 'will have an example' do
+              expect(schema).to include(example: 'string')
+            end
+          end
+        end
+
+        describe 'responses' do
+          let(:responses) { get_pancake_by_id_path.fetch(:responses) }
+
+          it 'will contain all responses by response code' do
+            expect(responses).to have_key('200')
+            expect(responses).to have_key('404')
+          end
+
+          describe 'response 200' do
+            let(:response_200) { responses.fetch('200') }
+
+            it 'will have description' do
+              expect(response_200).to include(description: 'When the pancake is found')
+            end
+
+            it 'will have correct content type' do
+              expect(response_200.fetch(:content)).to have_key(:'application/json')
+            end
+
+            describe 'schema' do
+              let(:schema) { response_200.dig(:content, :'application/json', :schema) }
+              
+              it 'will have object type' do
+                expect(schema).to include(type: 'object')
+              end
+
+              it 'will have properties' do
+                expect(schema).to have_key :properties
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: apiculture
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.7
 platform: ruby
 authors:
 - Julik Tarkhanov
 - WeTransfer
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-02-15 00:00:00.000000000 Z
+date: 2021-06-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mustermann
@@ -59,14 +59,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1'
+        version: '3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1'
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: mustache
   requirement: !ruby/object:Gem::Requirement
@@ -101,20 +101,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '3.2'
+        version: '3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '3.2'
+        version: '3'
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
@@ -133,16 +127,16 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10'
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -197,12 +191,14 @@ files:
 - lib/apiculture/indifferent_hash.rb
 - lib/apiculture/markdown_segment.rb
 - lib/apiculture/method_documentation.rb
+- lib/apiculture/openapi_documentation.rb
 - lib/apiculture/sinatra_instance_methods.rb
 - lib/apiculture/timestamp_promise.rb
 - lib/apiculture/version.rb
 - spec/apiculture/action_spec.rb
 - spec/apiculture/app_documentation_spec.rb
 - spec/apiculture/method_documentation_spec.rb
+- spec/apiculture/openapi_documentation_spec.rb
 - spec/apiculture_spec.rb
 - spec/spec_helper.rb
 homepage: https://github.com/WeTransfer/apiculture
@@ -210,7 +206,7 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -225,9 +221,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.11
-signing_key: 
+rubygems_version: 3.0.9
+signing_key:
 specification_version: 4
 summary: Sweet API sauce on top of Rack
 test_files: []