grape-app-doc 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 13cedc518a306358ab83dce425f647ded45942a68ff4324b664f0dda0bd8b8c2
+  data.tar.gz: 297fa97989f91b2bdb714f1218e49be18d15a2683b9c65622ceef0502de925f2
+SHA512:
+  metadata.gz: d3523de7c20d0c066952e09e913380ad38a2777aa8a80f032e6e4b8cb4b312cd18355ae8055886535ba9f4cf144a986ac770a4aec5862d7450162e618e766faf
+  data.tar.gz: 7e805df0a668c0995ae7103f43971182424651d753b1a26f4651d2993eb2e8a87fc1a3256cdea2b9bda30d70eab162f6a6c3348fac3fd7ec61219e417394c4b9

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,95 @@
+PATH
+  remote: .
+  specs:
+    grape-app-doc (0.1.0)
+      grape-app (>= 0.5.3)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (5.2.1)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 0.7, < 2)
+      minitest (~> 5.1)
+      tzinfo (~> 1.1)
+    axiom-types (0.1.1)
+      descendants_tracker (~> 0.0.4)
+      ice_nine (~> 0.11.0)
+      thread_safe (~> 0.3, >= 0.3.1)
+    builder (3.2.3)
+    coercible (1.0.0)
+      descendants_tracker (~> 0.0.1)
+    concurrent-ruby (1.0.5)
+    descendants_tracker (0.0.4)
+      thread_safe (~> 0.3, >= 0.3.1)
+    diff-lcs (1.3)
+    equalizer (0.0.11)
+    grape (1.1.0)
+      activesupport
+      builder
+      mustermann-grape (~> 1.0.0)
+      rack (>= 1.3.0)
+      rack-accept
+      virtus (>= 1.0.0)
+    grape-app (0.5.3)
+      activesupport
+      grape (>= 1.0.0)
+      grape-entity
+      rack-cors
+      rack-ssl-enforcer
+      thor
+    grape-entity (0.7.1)
+      activesupport (>= 4.0)
+      multi_json (>= 1.3.2)
+    i18n (1.1.0)
+      concurrent-ruby (~> 1.0)
+    ice_nine (0.11.2)
+    minitest (5.11.3)
+    multi_json (1.13.1)
+    mustermann (1.0.2)
+    mustermann-grape (1.0.0)
+      mustermann (~> 1.0.0)
+    rack (2.0.5)
+    rack-accept (0.4.5)
+      rack (>= 0.4)
+    rack-cors (1.0.2)
+    rack-ssl-enforcer (0.2.9)
+    rake (12.3.1)
+    rspec (3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-expectations (~> 3.8.0)
+      rspec-mocks (~> 3.8.0)
+    rspec-core (3.8.0)
+      rspec-support (~> 3.8.0)
+    rspec-expectations (3.8.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-its (1.2.0)
+      rspec-core (>= 3.0.0)
+      rspec-expectations (>= 3.0.0)
+    rspec-mocks (3.8.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.8.0)
+    rspec-support (3.8.0)
+    thor (0.20.0)
+    thread_safe (0.3.6)
+    tzinfo (1.2.5)
+      thread_safe (~> 0.1)
+    virtus (1.0.5)
+      axiom-types (~> 0.1)
+      coercible (~> 1.0)
+      descendants_tracker (~> 0.0, >= 0.0.3)
+      equalizer (~> 0.0, >= 0.0.9)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  grape-app-doc!
+  rake
+  rspec
+  rspec-its
+
+BUNDLED WITH
+   1.16.3

data/README.md

@@ -0,0 +1,49 @@
+# Grape::App::Doc
+
+Currently, its experimental work-in-progress. Do not use!
+
+## Documentation Guidelines
+
+1. Each API endpoint must have a `success` description, referencing an entity class. Example:
+  ```ruby
+  desc "List" do
+    success Post::Entity
+  end
+  get '/posts' do
+    present Post.all
+  end
+  ```
+2. Each entity exposure should have documentation
+3. Tntity exposure type must be declared as a class. Example:
+  ```ruby
+  class Post::Entity < Grape::Entity
+    expose :title, documentation: { type: String, desc: "Status update text." }
+  end
+  ```
+4. Entity exposure documentation may contain the following keys: `type`, `desc`, `required`, `is_array`, `values`, `default`
+5. TODO: more
+
+## Licence
+
+```
+Copyright (c) 2015 Black Square Media
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/setup'
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+task default: :spec

data/grape-app-doc.gemspec

@@ -0,0 +1,24 @@
+# encoding: utf-8
+
+Gem::Specification.new do |s|
+  s.name          = 'grape-app-doc'
+  s.version       = '0.1.0'
+  s.authors       = ['Black Square Media Ltd']
+  s.email         = ['info@blacksquaremedia.com']
+  s.summary       = %{Grape app documentation}
+  s.description   = %{EXPERIMENTAL}
+  s.homepage      = 'https://github.com/bsm/grape-app-doc'
+  s.license       = 'MIT'
+
+  s.files         = `git ls-files -z`.split("\x0").reject {|f| f.match(%r{^spec/}) }
+  s.test_files    = `git ls-files -z -- spec/*`.split("\x0")
+  s.require_paths = ['lib']
+  s.required_ruby_version = '>= 2.2.0'
+
+  s.add_dependency 'grape-app', '>= 0.5.3'
+  s.add_development_dependency 'bundler'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'rspec-its'
+  s.add_development_dependency 'rake'
+end
+

data/lib/grape/app/doc.rb

@@ -0,0 +1,45 @@
+require 'grape-app'
+require 'grape-entity'
+require 'active_support/core_ext/module/attribute_accessors'
+require 'rack/utils'
+
+module Grape::App::Doc
+  extend self
+
+  def config
+    Grape::App::Doc::Config
+  end
+
+  def configure(&block)
+    config = Grape::App::Doc::Config
+    block.call(config) if block
+    config
+  end
+
+  def create(api = Grape::App)
+    Grape::App::Doc::Document.new(api)
+  end
+
+  def next_increment!
+    @increment ||= 0
+    @increment += 1
+  end
+
+  def doc_error(message)
+    method = config.fail_on_errors ? :abort : :warn
+    Kernel.send method, " ! #{message}"
+  end
+
+end
+
+%w|
+config
+endpoint
+document
+header
+parameter
+attribute
+entity
+|.each do |name|
+  require "grape/app/doc/#{name}"
+end

data/lib/grape/app/doc/attribute.rb

@@ -0,0 +1,11 @@
+class Grape::App::Doc::Attribute
+  attr_reader :key, :type, :desc, :values, :default
+
+  def initialize(key, opts = {})
+    @key     = key
+    @type    = opts[:type]
+    @desc    = opts[:desc] || opts[:description] || ""
+    @values  = opts[:values] || []
+    @default = opts[:default]
+  end
+end

data/lib/grape/app/doc/config.rb

@@ -0,0 +1,7 @@
+module Grape::App::Doc::Config
+
+  # Fail on documentation errors, instead of just warning. Default: false
+  mattr_accessor :fail_on_errors
+  self.fail_on_errors = false
+
+end

data/lib/grape/app/doc/document.rb

@@ -0,0 +1,20 @@
+class Grape::App::Doc::Document
+
+  attr_reader :entities, :endpoints
+
+  def initialize(api = Grape::App)
+    registry   = Grape::App::Doc::Entity::Registry.new
+    @endpoints = api.routes.map do |route|
+      Grape::App::Doc::Endpoint.new(route, registry)
+    end
+    @entities  = registry.values
+  end
+
+  # @param [String|Symbol] template path
+  # @return [String] output formatted as template
+  def output(template)
+    template = File.expand_path("../templates/#{template}.erb") unless File.exist?(template)
+    ERB.new(File.read(template), nil, '-').result(binding)
+  end
+
+end

data/lib/grape/app/doc/endpoint.rb

@@ -0,0 +1,54 @@
+class Grape::App::Doc::Endpoint
+  Status = Struct.new(:code, :desc, :entity)
+
+  attr_reader :headers, :failure, :success, :version, :params, :request_method,
+              :namespace, :description, :details, :raw_path
+
+  def initialize(route, registry)
+    @request_method = route.request_method || 'GET'
+
+    @version     = route.version || ''
+    @namespace   = route.namespace || ''
+    @description = route.description || ''
+    @details     = route.details || ''
+    @raw_path    = route.path
+
+    @success  = parse_status(route, registry, route.entity || [200, "OK"])
+    @failure  = Array(route.http_codes).map do |item|
+      parse_status(route, registry, item)
+    end.compact
+    @headers  = (route.headers || {}).map do |name, opts|
+      Grape::App::Doc::Header.new(name, opts)
+    end
+    @params   = (route.params || {}).map do |name, opts|
+      Grape::App::Doc::Parameter.new(name, opts) if opts.is_a?(Hash)
+    end.compact
+  end
+
+  # @return [String] friendly path string
+  def path
+    @path ||= raw_path.sub(':version', version).sub(/\(\.[^\)]+$/, '')
+  end
+
+  # @return [String] extracted the resource name
+  def resource
+    namespace.split('/').last ||
+      raw_path.split('/:version').last.match('\/(\w*?)[\.\/\(]').captures.first
+  end
+
+  private
+
+  def parse_status(route, registry, item)
+    if item.is_a?(Array) && item.size > 1
+      code, desc, entity = item
+      code = Rack::Utils::SYMBOL_TO_STATUS_CODE[code] if code.is_a?(Symbol)
+      Status.new(code, desc, registry.register(entity))
+    elsif item.is_a?(Class) && item <= Grape::Entity
+      Status.new(200, "OK", registry.register(item))
+    else
+      Grape::App::Doc.doc_error("route #{route} contains an invalid definition #{item.inspect}")
+      nil
+    end
+  end
+
+end

data/lib/grape/app/doc/entity.rb

@@ -0,0 +1,45 @@
+class Grape::App::Doc::Entity
+  attr_reader :name, :desc, :uid, :attributes
+
+  def initialize(klass, registry)
+    @name = (klass.meta[:type] if klass.respond_to?(:meta)) || klass.name.gsub('::Entity', '')
+    @desc = (klass.meta[:desc] || klass.meta[:description] if klass.respond_to?(:meta)) || ""
+    @uid  = [name.parameterize, Grape::App::Doc.next_increment!].join('-')
+
+    exposures = klass.root_exposures
+    exposures = exposures.map do |key, opts|
+      LegacyExposure.new(key, opts[:using], opts[:documentation])
+    end if klass.root_exposures.is_a?(Hash)
+
+    @attributes = exposures.map do |exp|
+      doc = exp.documentation.try(:dup)
+      unless doc.is_a?(Hash)
+        Grape::App::Doc.doc_error("#{klass}: #{name} exposure does not have documentation")
+        next
+      end
+      unless doc.key?(:type)
+        Grape::App::Doc.doc_error("#{klass}: #{name} exposure does not have :type documentation")
+        next
+      end
+      if exp.respond_to?(:using_class) && exp.using_class
+        registry.register(exp.using_class)
+      end
+      Grape::App::Doc::Attribute.new(exp.key, doc)
+    end.compact
+  end
+
+  def example
+    @example ||= attributes.inject({}) do |acc, attr|
+      acc[attr.key] = attr.type
+      acc
+    end
+  end
+
+  class Registry < Hash
+    def register(klass)
+      self[klass] ||= Grape::App::Doc::Entity.new(klass, self) if klass
+    end
+  end
+  LegacyExposure = Struct.new(:key, :using_class, :documentation)
+
+end

data/lib/grape/app/doc/header.rb

@@ -0,0 +1,9 @@
+class Grape::App::Doc::Header
+  attr_reader :name, :opts, :desc
+
+  def initialize(name, opts = {})
+    @name = name.to_s
+    @opts = opts.dup
+    @desc = opts[:desc] || opts[:description] || ""
+  end
+end

data/lib/grape/app/doc/parameter.rb

@@ -0,0 +1,30 @@
+class Grape::App::Doc::Parameter
+  attr_reader :name, :doc, :values, :default, :type, :desc
+
+  def initialize(name, opts = {})
+    @name     = name.to_s
+    @doc      = opts[:documentation] || {}
+    @desc     = doc[:desc] || doc[:description] || ''
+    @values   = opts[:values] || []
+    @default  = opts[:default]
+    @type     = normalize_type(doc[:type] || opts[:type])
+    @required = opts[:required]
+  end
+
+  def required?
+    @required
+  end
+
+  private
+
+    def normalize_type(str)
+      return 'String' unless str.is_a?(String)
+
+      str = str.dup
+      str.sub! 'Virtus::Attribute::', ''
+      str.sub! 'Axiom::Types::', ''
+      str.sub! 'BigDecimal', 'Decimal'
+      str
+    end
+
+end

data/lib/grape/app/doc/templates/slate.erb

@@ -0,0 +1,17 @@
+<% unless entities.empty? -%>
+# Entities
+
+<% entities.each do |entity| -%>
+<%= entity.name %>
+
+<% end -%>
+<% end -%>
+
+<% endpoints.group_by(&:version).each do |version, endpoints| -%>
+# Endpoints <%= "<sup>#{version}</sup>" if version %>
+
+<% endpoints.each do |endpoint| -%>
+<%= endpoint.path %>
+
+<% end -%>
+<% end -%>

data/spec/doc/document_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+RSpec.describe Grape::App::Doc::Document do
+
+  it 'should parse endpoints' do
+    expect(subject.endpoints.size).to eq(4)
+    expect(subject.endpoints[0]).to be_instance_of(Grape::App::Doc::Endpoint)
+  end
+
+  it 'should parse entities' do
+    expect(subject.entities.size).to eq(4)
+    expect(subject.entities[0]).to be_instance_of(Grape::App::Doc::Entity)
+  end
+
+end

data/spec/doc/endpoint_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+RSpec.describe Grape::App::Doc::Endpoint do
+
+  let :route do
+    Grape::Router::Route.new :get, '/:version/something(.:format)',
+      version: 'v2015',
+      prefix: '/api',
+      namespace: '/',
+      headers: { XAdminToken: { description: 'Valdates your identity', required: true }},
+      params:  {'id'=>'', 'title'=>{:required=>true, :documentation=>{:desc=>'A title'}}}
+  end
+
+  subject { described_class.new route, Grape::App::Doc::Entity::Registry.new }
+
+  it 'should parse routes with defaults' do
+    expect(subject.request_method).to eq('GET')
+  end
+
+  it 'should parse success/failures' do
+    expect(subject.success).to be_instance_of(described_class::Status)
+    expect(subject.success.code).to eq(200)
+    expect(subject.failure).to eq([])
+  end
+
+  it 'should parse headers' do
+    expect(subject.headers.size).to eq(1)
+    expect(subject.headers[0]).to be_instance_of(Grape::App::Doc::Header)
+  end
+
+  it 'should parse params' do
+    expect(subject.params.size).to eq(1)
+    expect(subject.params[0]).to be_instance_of(Grape::App::Doc::Parameter)
+  end
+
+end

data/spec/doc/entity_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+RSpec.describe Grape::App::Doc::Entity do
+
+  subject { described_class.new Post::Entity, described_class::Registry.new }
+
+  its(:name) { is_expected.to eq("Post") }
+  its(:desc) { is_expected.to eq("") }
+  its(:uid) { is_expected.to match(/post-\d+/) }
+
+  it "should parse attributes" do
+    expect(subject.attributes.size).to eq(5)
+    expect(subject.attributes[0]).to be_instance_of(Grape::App::Doc::Attribute)
+  end
+
+end

data/spec/doc/header_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper'
+
+RSpec.describe Grape::App::Doc::Header do
+  subject { described_class.new :name, desc: "DESC", other: "custom" }
+
+  its(:name) { is_expected.to eq("name") }
+  its(:desc) { is_expected.to eq("DESC") }
+  its(:opts) { is_expected.to be_instance_of(Hash) }
+end

data/spec/doc/parameter_spec.rb

@@ -0,0 +1,35 @@
+require 'spec_helper'
+
+RSpec.describe Grape::App::Doc::Parameter do
+  subject { described_class.new :name, type: "String", required: true }
+
+  its(:name) { is_expected.to eq("name") }
+  its(:desc) { is_expected.to eq("") }
+  its(:doc) { is_expected.to eq({}) }
+  its(:type) { is_expected.to eq("String") }
+  its(:values) { is_expected.to eq([]) }
+  its(:default) { is_expected.to be_nil }
+  its(:required?) { is_expected.to be_truthy }
+
+  it "should allow custom type documentation" do
+    pm = described_class.new :name, type: "String", documentation: { type: "[DateTime]" }
+    expect(pm.type).to eq("[DateTime]")
+  end
+
+  it "should normalize types" do
+    pm = described_class.new :name, type: "[Integer]"
+    expect(pm.type).to eq("[Integer]")
+
+    pm = described_class.new :name, type: "BigDecimal"
+    expect(pm.type).to eq("Decimal")
+
+    pm = described_class.new :name, type: "Virtus::Attribute::Boolean"
+    expect(pm.type).to eq("Boolean")
+
+    pm = described_class.new :name, type: "[Axiom::Types::Decimal]"
+    expect(pm.type).to eq("[Decimal]")
+  end
+
+
+
+end

data/spec/doc_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper'
+
+RSpec.describe Grape::App::Doc do
+
+  it 'should parse the API' do
+    expect(described_class.create).to be_instance_of(described_class::Document)
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+require 'rspec'
+require 'rspec/its'
+require 'grape/app/doc'
+
+require 'support/mock_entities'
+require 'support/mock_api'
+
+RSpec.configure do |c|
+
+  c.before :each do
+    allow(Kernel).to receive(:warn) do |m|
+      fail(m)
+    end
+    Grape::App::Doc.class_variable_set(:@@increment, 0)
+  end
+
+end

data/spec/support/mock_api.rb

@@ -0,0 +1,61 @@
+module MockAPI
+  class V1 < Grape::API
+    prefix  '/a'
+    version 'v1'
+
+    desc 'Returns the service status' do
+      success [:no_content, 'Up']
+      failure [[503, 'Down']]
+      headers XAdminToken: { description: 'Valdates your identity', required: true }
+    end
+    get '/status' do
+      status 204
+    end
+
+    resource 'posts' do
+
+      desc 'Returns a list of posts' do
+        success Post::Entity
+      end
+      params do
+        optional :sort, type: Hash, documentation: { desc: "Sort order" } do
+          requires :col, values: ['id', 'title'], documentation: { desc: "Sort column" }
+          optional :dir, values: ['asc', 'desc'], default: 'asc', documentation: { desc: "Sort direction" }
+        end
+        optional :search, type: String, documentation: { desc: "search string" }
+      end
+      get '' do
+        present [Post.new, Post.new]
+      end
+
+      desc 'Returns a post' do
+        success [200, "Found", Post::Entity]
+        failure [[404, 'Not found']]
+      end
+      get ':id' do
+        present Post.new
+      end
+
+      desc 'Creates a post' do
+        success [:created, "Created"]
+        failure [
+          [400, 'Validation failed', ValidationErrors::Entity],
+          [401, 'Bad API token'],
+        ]
+      end
+      params do
+        requires :title, documentation: { desc: "A title" }
+        requires :author, type: Hash, documentation: { desc: "The author attributes" } do
+          requires :name, :email
+        end
+        optional :status, values: ['draft', 'live'], default: 'draft'
+      end
+      post '' do
+        status :created
+      end
+
+    end
+  end
+end
+
+Grape::App.mount MockAPI::V1

data/spec/support/mock_entities.rb

@@ -0,0 +1,69 @@
+class ValidationErrors < Array
+  def errors
+    self
+  end
+
+  class Entity < Grape::Entity
+    expose :errors, documentation: { type: "String[]", desc: "Validation errors" }
+  end
+end
+
+class Author
+  def name
+    "Alice Smith"
+  end
+
+  def email
+    "alice.smith@example.com"
+  end
+
+  class Entity < Grape::Entity
+    expose :name, documentation: { type: "String", desc: "A name" }
+    expose :email, documentation: { type: "String", desc: "The email address" }
+  end
+end
+
+class Comment
+  def comment
+    "A shared opinion"
+  end
+
+  def author
+    Author.new
+  end
+
+  class Entity < Grape::Entity
+    expose :comment, documentation: { type: "String", desc: "The comment" }
+    expose :author, using: Author::Entity, documentation: { type: "Author", desc: "The comment author" }
+  end
+end
+
+class Post
+  def id
+    33
+  end
+
+  def title
+    "A post title"
+  end
+
+  def author
+    Author.new
+  end
+
+  def comments
+    @comments ||= [Comment.new, Comment.new]
+  end
+
+  def status
+    "live"
+  end
+
+  class Entity < Grape::Entity
+    expose :id, documentation: { type: "Integer", desc: "Unique identifier" }
+    expose :title, documentation: { type: "String", desc: "A friendly title" }
+    expose :author, using: Author::Entity, documentation: { type: "Author", desc: "The author" }
+    expose :comments, using: Comment::Entity, documentation: { type: "Comment[]", desc: "Comments associatated with this post" }
+    expose :status, documentation: { type: "String", values: ['draft', 'live'], default: 'draft', description: "The status" }
+  end
+end

metadata

@@ -0,0 +1,146 @@
+--- !ruby/object:Gem::Specification
+name: grape-app-doc
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Black Square Media Ltd
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-08-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: grape-app
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.5.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.5.3
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-its
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: EXPERIMENTAL
+email:
+- info@blacksquaremedia.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- grape-app-doc.gemspec
+- lib/grape/app/doc.rb
+- lib/grape/app/doc/attribute.rb
+- lib/grape/app/doc/config.rb
+- lib/grape/app/doc/document.rb
+- lib/grape/app/doc/endpoint.rb
+- lib/grape/app/doc/entity.rb
+- lib/grape/app/doc/header.rb
+- lib/grape/app/doc/parameter.rb
+- lib/grape/app/doc/templates/slate.erb
+- spec/doc/document_spec.rb
+- spec/doc/endpoint_spec.rb
+- spec/doc/entity_spec.rb
+- spec/doc/header_spec.rb
+- spec/doc/parameter_spec.rb
+- spec/doc_spec.rb
+- spec/spec_helper.rb
+- spec/support/mock_api.rb
+- spec/support/mock_entities.rb
+homepage: https://github.com/bsm/grape-app-doc
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: Grape app documentation
+test_files:
+- spec/doc/document_spec.rb
+- spec/doc/endpoint_spec.rb
+- spec/doc/entity_spec.rb
+- spec/doc/header_spec.rb
+- spec/doc/parameter_spec.rb
+- spec/doc_spec.rb
+- spec/spec_helper.rb
+- spec/support/mock_api.rb
+- spec/support/mock_entities.rb