jdoc 0.4.3 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: bbc21692c07ab9fe470cc9bb20a30396e5305765
-  data.tar.gz: 3c48d113af68dd3e9b4157f005c16619edc7b1ab
+SHA256:
+  metadata.gz: 4ee1b1514622a40fee3e0d8813c610f9f9c0bd31c97367693b2523663028a6f9
+  data.tar.gz: cbea57957aa93be238805ed0e7d6558fbef0405e53cffee35f0140d8a31b7701
 SHA512:
-  metadata.gz: 5a8eae9246f34f5cf66827f490ab48a99abf017597280f39269007c981a54b4dd9e062c513cda93ed098a140e03099e09ef880276a132350accabe4b41b5dbe3
-  data.tar.gz: 5e4cd2d1ef3dd61fb3e4d7617806b0c9c0fcf2eddd9f8e45025721690f59aa41366bbbf09f0efa8fc50835ca0c435d4d7c309e6c13301123279531da00825436
+  metadata.gz: 00b3b964522b6260e4e6da08fc9eebb409ccb9a52a5cac65f1a80b3f1da8ba2ae3cd4a65d64e58f0365bb035bdf494d07874bb342b94f59a439e13e70b44b255
+  data.tar.gz: 69408fbfdddb4e79f76e266aca7cb5992b12e684fb0258c62983040b2a598ec9397ae33a5b838953e5b15d3957664c416eaff24bf1307d11e026c0e3b44f3824

data/.github/release.yml

@@ -0,0 +1,23 @@
+changelog:
+  categories:
+    - title: Added
+      labels:
+        - add
+    - title: Changed
+      labels:
+        - change
+    - title: Deprecated
+      labels:
+        - deprecate
+    - title: Fixed
+      labels:
+        - fix
+    - title: Removed
+      labels:
+        - remove
+    - title: Security
+      labels:
+        - security
+    - title: Others
+      labels:
+        - "*"

data/.github/workflows/bump-request.yml

@@ -0,0 +1,26 @@
+name: bump-request
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: Version to change to.
+        required: true
+        type: string
+
+jobs:
+  run:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.3'
+          bundler-cache: true
+      - uses: r7kamura/bump-request@v0
+        with:
+          command: |
+            sed -i -r 's/([0-9]+\.[0-9]+\.[0-9]+)/${{ inputs.version }}/' lib/*/version.rb
+            bundle install
+          version: ${{ inputs.version }}

data/.github/workflows/ci.yml

@@ -0,0 +1,27 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+
+jobs:
+  rspec:
+    runs-on: ubuntu-latest
+    name: Ruby ${{ matrix.ruby }}
+    strategy:
+      matrix:
+        ruby:
+          - '3.3'
+          - '3.4'
+          - '4.0'
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+        bundler-cache: true
+    - name: Run the default task
+      run: bundle exec rake

data/.github/workflows/github-label-sync.yml

@@ -0,0 +1,18 @@
+name: github-label-sync
+
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - .github/workflows/github-label-sync.yml
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: r7kamura/github-label-sync-action@v0
+        with:
+          source_path: labels-keepachangelog.yml
+          source_repository: r7kamura/github-label-presets

data/.github/workflows/release.yml

@@ -0,0 +1,14 @@
+name: release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: softprops/action-gh-release@v1
+        with:
+          generate_release_notes: true

data/.gitignore

@@ -3,7 +3,6 @@
 .bundle
 .config
 .yardoc
-Gemfile.lock
 InstalledFiles
 _yardoc
 coverage

data/Gemfile.lock

@@ -0,0 +1,83 @@
+PATH
+  remote: .
+  specs:
+    jdoc (0.5.0)
+      activesupport
+      erubi
+      json_schema
+      rack
+      redcarpet
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (7.1.6)
+      base64
+      benchmark (>= 0.3)
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      mutex_m
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0)
+    base64 (0.2.0)
+    benchmark (0.5.0)
+    bigdecimal (3.1.5)
+    coderay (1.1.3)
+    concurrent-ruby (1.2.2)
+    connection_pool (2.4.1)
+    diff-lcs (1.5.0)
+    drb (2.2.0)
+      ruby2_keywords
+    erubi (1.13.1)
+    i18n (1.14.1)
+      concurrent-ruby (~> 1.0)
+    json_schema (0.21.0)
+    logger (1.7.0)
+    method_source (1.0.0)
+    minitest (6.0.5)
+      drb (~> 2.0)
+      prism (~> 1.5)
+    mutex_m (0.2.0)
+    prism (1.9.0)
+    pry (0.14.2)
+      coderay (~> 1.1)
+      method_source (~> 1.0)
+    rack (3.0.8)
+    rake (13.4.2)
+    redcarpet (3.6.0)
+    rspec (3.12.0)
+      rspec-core (~> 3.12.0)
+      rspec-expectations (~> 3.12.0)
+      rspec-mocks (~> 3.12.0)
+    rspec-core (3.12.2)
+      rspec-support (~> 3.12.0)
+    rspec-expectations (3.12.3)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-mocks (3.12.6)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.12.0)
+    rspec-support (3.12.1)
+    ruby2_keywords (0.0.5)
+    securerandom (0.4.1)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  bundler (>= 1.6)
+  jdoc!
+  pry
+  rake (>= 13.2.0)
+  rspec (>= 2.14.1)
+
+BUNDLED WITH
+   2.5.3

data/README.md

@@ -1,4 +1,7 @@
 # Jdoc
+
+[![CI](https://github.com/r7kamura/jdoc/actions/workflows/ci.yml/badge.svg)](https://github.com/r7kamura/jdoc/actions/workflows/ci.yml)
+
 Generate API documentation from JSON Schema.
 
 ## Install

data/Rakefile

@@ -1,2 +1,6 @@
 require "bundler/gem_tasks"
+require "rspec/core/rake_task"
 
+RSpec::Core::RakeTask.new(:spec)
+
+task default: %i[spec]

data/example-api-documentation.html

@@ -0,0 +1,364 @@
+<!DOCTYPE HTML>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <title>API Docs</title>
+  <style>
+    body {
+      width: 920px;
+      margin: 0 auto;
+      font-size: 14px;
+    }
+
+    a {
+      color: #4183C4;
+    }
+
+    pre {
+      color: #393939;
+      background-color: #fafafb;
+      padding: 10px;
+      margin: 2em 0;
+      border: 1px solid #cacaca;
+      border-radius: 3px;
+      font: 12px/1.4em Consolas, 'Liberation Mono', Courier, monospace;
+      overflow: auto;
+    }
+
+    ol code,
+    ul code,
+    p code {
+      font-size: 12px;
+      margin: 0;
+      border: 1px solid #ddd;
+      background-color: #f8f8f8;
+      border-radius: 3px;
+      padding: 0;
+    }
+  </style>
+</head>
+<body>
+<h1 id="example-api">Example API</h1>
+
+<p>A schema for a small example API.</p>
+
+<ul>
+<li><a href="#app">App</a>
+
+<ul>
+<li><a href="#post-apps">POST /apps</a></li>
+<li><a href="#delete-appsid">DELETE /apps/:id</a></li>
+<li><a href="#get-appsid">GET /apps/:id</a></li>
+<li><a href="#get-apps">GET /apps</a></li>
+<li><a href="#patch-appsid">PATCH /apps/:id</a></li>
+<li><a href="#post-appsidfiles">POST /apps/:id/files</a></li>
+</ul></li>
+<li><a href="#recipe">Recipe</a>
+
+<ul>
+<li><a href="#get-recipes">GET /recipes</a></li>
+</ul></li>
+<li><a href="#user">User</a></li>
+</ul>
+
+<h2 id="app">App</h2>
+
+<p>An app is a program to be deployed.</p>
+
+<h3 id="properties">Properties</h3>
+
+<ul>
+<li>id
+
+<ul>
+<li>unique identifier of app</li>
+<li>Example: <code>&quot;01234567-89ab-cdef-0123-456789abcdef&quot;</code></li>
+<li>Type: string</li>
+<li>Format: uuid</li>
+<li>ReadOnly: true</li>
+</ul></li>
+<li>name
+
+<ul>
+<li>unique name of app</li>
+<li>Example: <code>&quot;example&quot;</code></li>
+<li>Type: string</li>
+<li>Pattern: <code>/^[a-z][a-z0-9-]{3,50}$/</code></li>
+</ul></li>
+<li>private
+
+<ul>
+<li>true if this resource is private use</li>
+<li>Example: <code>false</code></li>
+<li>Type: boolean</li>
+</ul></li>
+<li>deleted_at
+
+<ul>
+<li>When this resource was deleted at</li>
+<li>Example: <code>nil</code></li>
+<li>Type: null</li>
+</ul></li>
+<li>user_ids
+
+<ul>
+<li>Type: array</li>
+</ul></li>
+<li>users
+
+<ul>
+<li>Type: array</li>
+</ul></li>
+</ul>
+
+<h3 id="post-apps">POST /apps</h3>
+
+<p>Create a new app.</p>
+
+<ul>
+<li>name
+
+<ul>
+<li>unique name of app</li>
+<li>Example: <code>&quot;example&quot;</code></li>
+<li>Type: string</li>
+<li>Pattern: <code>/^[a-z][a-z0-9-]{3,50}$/</code></li>
+</ul></li>
+</ul>
+
+<pre><code>POST /apps HTTP/1.1
+Content-Type: application/json
+Host: api.example.com
+
+{
+  &quot;name&quot;: &quot;example&quot;
+}
+</code></pre>
+
+<pre><code>HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+  &quot;id&quot;: &quot;01234567-89ab-cdef-0123-456789abcdef&quot;,
+  &quot;name&quot;: &quot;example&quot;,
+  &quot;private&quot;: false,
+  &quot;deleted_at&quot;: null,
+  &quot;user_ids&quot;: [
+    1
+  ],
+  &quot;users&quot;: [
+    {
+      &quot;name&quot;: &quot;alice&quot;
+    }
+  ]
+}
+</code></pre>
+
+<h3 id="delete-apps-id">DELETE /apps/:id</h3>
+
+<p>Delete an existing app.</p>
+
+<pre><code>DELETE /apps/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1
+Host: api.example.com
+</code></pre>
+
+<pre><code>HTTP/1.1 204 No Content
+</code></pre>
+
+<h3 id="get-apps-id">GET /apps/:id</h3>
+
+<p>Info for existing app.</p>
+
+<pre><code>GET /apps/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1
+Host: api.example.com
+</code></pre>
+
+<pre><code>HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+  &quot;id&quot;: &quot;01234567-89ab-cdef-0123-456789abcdef&quot;,
+  &quot;name&quot;: &quot;example&quot;,
+  &quot;private&quot;: false,
+  &quot;deleted_at&quot;: null,
+  &quot;user_ids&quot;: [
+    1
+  ],
+  &quot;users&quot;: [
+    {
+      &quot;name&quot;: &quot;alice&quot;
+    }
+  ]
+}
+</code></pre>
+
+<h3 id="get-apps">GET /apps</h3>
+
+<p>List existing apps.</p>
+
+<pre><code>GET /apps HTTP/1.1
+Host: api.example.com
+</code></pre>
+
+<pre><code>HTTP/1.1 200 OK
+Content-Type: application/json
+
+[
+  {
+    &quot;id&quot;: &quot;01234567-89ab-cdef-0123-456789abcdef&quot;,
+    &quot;name&quot;: &quot;example&quot;,
+    &quot;private&quot;: false,
+    &quot;deleted_at&quot;: null,
+    &quot;user_ids&quot;: [
+      1
+    ],
+    &quot;users&quot;: [
+      {
+        &quot;name&quot;: &quot;alice&quot;
+      }
+    ]
+  }
+]
+</code></pre>
+
+<h3 id="patch-apps-id">PATCH /apps/:id</h3>
+
+<p>Update an existing app.</p>
+
+<ul>
+<li>name
+
+<ul>
+<li>unique name of app</li>
+<li>Example: <code>&quot;example&quot;</code></li>
+<li>Type: string</li>
+<li>Pattern: <code>/^[a-z][a-z0-9-]{3,50}$/</code></li>
+</ul></li>
+</ul>
+
+<pre><code>PATCH /apps/01234567-89ab-cdef-0123-456789abcdef HTTP/1.1
+Content-Type: application/json
+Host: api.example.com
+
+{
+  &quot;name&quot;: &quot;example&quot;
+}
+</code></pre>
+
+<pre><code>HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+  &quot;id&quot;: &quot;01234567-89ab-cdef-0123-456789abcdef&quot;,
+  &quot;name&quot;: &quot;example&quot;,
+  &quot;private&quot;: false,
+  &quot;deleted_at&quot;: null,
+  &quot;user_ids&quot;: [
+    1
+  ],
+  &quot;users&quot;: [
+    {
+      &quot;name&quot;: &quot;alice&quot;
+    }
+  ]
+}
+</code></pre>
+
+<h3 id="post-apps-id-files">POST /apps/:id/files</h3>
+
+<p>Upload an attachment file for an app</p>
+
+<ul>
+<li>file
+
+<ul>
+<li>an attachment of app</li>
+<li>Example: <code>&quot;... contents of file ...&quot;</code></li>
+<li>Type: string</li>
+</ul></li>
+</ul>
+
+<pre><code>POST /apps/01234567-89ab-cdef-0123-456789abcdef/files HTTP/1.1
+Content-Type: multipart/form-data; boundary=---BoundaryX
+Host: api.example.com
+
+-----BoundaryX
+Content-Disposition: form-data; name=&quot;[file]&quot;
+
+... contents of file ...
+
+-----BoundaryX--
+</code></pre>
+
+<pre><code>HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+  &quot;id&quot;: &quot;01234567-89ab-cdef-0123-456789abcdef&quot;,
+  &quot;name&quot;: &quot;example&quot;,
+  &quot;private&quot;: false,
+  &quot;deleted_at&quot;: null,
+  &quot;user_ids&quot;: [
+    1
+  ],
+  &quot;users&quot;: [
+    {
+      &quot;name&quot;: &quot;alice&quot;
+    }
+  ]
+}
+</code></pre>
+
+<h2 id="recipe">Recipe</h2>
+
+<h3 id="properties">Properties</h3>
+
+<ul>
+<li>name
+
+<ul>
+<li>Example: <code>&quot;Sushi&quot;</code></li>
+</ul></li>
+<li>user
+
+<ul>
+<li>Type: object</li>
+</ul></li>
+</ul>
+
+<h3 id="get-recipes">GET /recipes</h3>
+
+<p>List recipes</p>
+
+<pre><code>GET /recipes HTTP/1.1
+Host: api.example.com
+</code></pre>
+
+<pre><code>HTTP/1.1 200 OK
+Content-Type: application/json
+
+[
+  {
+    &quot;name&quot;: &quot;Sushi&quot;,
+    &quot;user&quot;: {
+      &quot;name&quot;: &quot;alice&quot;
+    }
+  }
+]
+</code></pre>
+
+<h2 id="user">User</h2>
+
+<h3 id="properties">Properties</h3>
+
+<ul>
+<li>name
+
+<ul>
+<li>Example: <code>&quot;alice&quot;</code></li>
+<li>Type: string</li>
+</ul></li>
+</ul>
+
+</body>
+</html>

data/jdoc.gemspec

@@ -17,12 +17,12 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "activesupport"
-  spec.add_dependency "erubis"
+  spec.add_dependency "erubi"
   spec.add_dependency "json_schema"
   spec.add_dependency "rack"
   spec.add_dependency "redcarpet"
-  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "bundler", ">= 1.6"
   spec.add_development_dependency "pry"
-  spec.add_development_dependency "rake"
-  spec.add_development_dependency "rspec", "2.14.1"
+  spec.add_development_dependency "rake", ">= 13.2.0"
+  spec.add_development_dependency "rspec", ">= 2.14.1"
 end

data/lib/jdoc/generator.rb

@@ -5,8 +5,8 @@ module Jdoc
 
     # Utility wrapper for Jdoc::Generator#call
     # @return [String]
-    def self.call(*args)
-      new(*args).call
+    def self.call(*args, **kwargs)
+      new(*args, **kwargs).call
     end
 
     # @param schema [Hash] JSON Schema represented as a Hash
@@ -24,10 +24,10 @@ module Jdoc
     # @note Add some fix to adapt to GitHub anchor style
     # @return [String] Generated text
     def call
-      markdown = markdown_renderer.result(schema: schema)
+      markdown = render_erb(markdown_template, schema: schema)
       if @html
         html = markdown_parser.render(markdown)
-        html =  html_renderer.result(body: html)
+        html = render_erb(html_template, body: html)
         html.gsub(/id="(.+)"/) {|text| text.tr("/:", "") }
       else
         markdown
@@ -38,9 +38,11 @@ module Jdoc
 
     private
 
-    # @return [Erubis::Eruby] Renderer to render HTML that takes HTML string
-    def html_renderer
-      Erubis::Eruby.new(html_template)
+    # @return [String]
+    def render_erb(template, **variables)
+      b = binding
+      variables.each { |k, v| b.local_variable_set(k, v) }
+      eval(Erubi::Engine.new(template).src, b)
     end
 
     # @returns [String] Path to ERB template to render HTML
@@ -66,11 +68,6 @@ module Jdoc
       )
     end
 
-    # @return [Erubis::Eruby] Renderer to render Markdown that takes schema data
-    def markdown_renderer
-      Erubis::Eruby.new(markdown_template)
-    end
-
     # @return [String] Content of specified Markdown template
     def markdown_template
       File.read(markdown_template_path)

data/lib/jdoc/version.rb

@@ -1,3 +1,3 @@
 module Jdoc
-  VERSION = "0.4.3"
+  VERSION = "0.5.0"
 end

data/lib/jdoc.rb

@@ -1,7 +1,7 @@
 require "active_support/core_ext/object/to_query"
 require "active_support/core_ext/string/inflections"
 require "cgi"
-require "erubis"
+require "erubi"
 require "json_schema"
 require "redcarpet"
 require "rack"

data/spec/jdoc/generator_spec.rb

@@ -19,5 +19,15 @@ describe Jdoc::Generator do
     it "returns a String of API documentation in Markdown from given JSON Schema" do
       should == File.read(File.expand_path("../../../example-api-documentation.md", __FILE__))
     end
+
+    context "with html: true" do
+      subject do
+        described_class.call(schema, html: true)
+      end
+
+      it "returns a String of API documentation in HTML from given JSON Schema" do
+        should == File.read(File.expand_path("../../../example-api-documentation.html", __FILE__))
+      end
+    end
   end
 end

data/spec/spec_helper.rb

@@ -1,7 +1,6 @@
 require "jdoc"
 
 RSpec.configure do |config|
-  config.treat_symbols_as_metadata_keys_with_true_values = true
   config.run_all_when_everything_filtered = true
   config.filter_run :focus
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: jdoc
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.5.0
 platform: ruby
 authors:
 - Ryo Nakamura
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-05-12 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -25,7 +24,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
-  name: erubis
+  name: erubi
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -84,14 +83,14 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
         version: '1.6'
 - !ruby/object:Gem::Dependency
@@ -114,29 +113,28 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 13.2.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 13.2.0
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.14.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 2.14.1
-description: 
 email:
 - r7kamura@gmail.com
 executables:
@@ -144,13 +142,19 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/release.yml"
+- ".github/workflows/bump-request.yml"
+- ".github/workflows/ci.yml"
+- ".github/workflows/github-label-sync.yml"
+- ".github/workflows/release.yml"
 - ".gitignore"
-- CHANGELOG.md
 - Gemfile
+- Gemfile.lock
 - LICENSE.txt
 - README.md
 - Rakefile
 - bin/jdoc
+- example-api-documentation.html
 - example-api-documentation.md
 - jdoc.gemspec
 - lib/jdoc.rb
@@ -170,7 +174,6 @@ homepage: https://github.com/r7kamura/jdoc
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -185,9 +188,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.2
-signing_key: 
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Generate API documentation from JSON Schema.
 test_files:

data/CHANGELOG.md

@@ -1,123 +0,0 @@
-## 0.4.3
-
-- Add some CLI options (Thx @k1LoW)
-
-## 0.4.2
-
-- Show reason phrase in response example (Thx @minodisk)
-
-## 0.4.1
-
-- Use 204 for `mediaType: "null"`
-
-## 0.4.0
-
-- Recognize `mediaType: 'null'` as "No response body"
-
-## 0.3.4
-
-- Treat empty request parameters as no request body
-
-## 0.3.3
-
-- Improve pattern format in properties section
-
-## 0.3.2
-
-- Add generator options to change template
-- Add request parameters for each endpoint
-
-## 0.3.1
-
-- Add error handling for ExampleNotFound
-
-## 0.3.0
-
-- Change example response status and body to PUT & DELETE requests
-- Improve request path example by resolving variable in path
-
-## 0.2.1
-
-- Support multipart/form-data
-
-## 0.2.0
-
-- Show schema description on docs if exists
-
-## 0.1.9
-
-- Support property that has no type
-
-## 0.1.8
-
-- Support property that is an array of primitive values
-
-## 0.1.7
-
-- Support query string example in GET request
-- Improve the description property visibility
-
-## 0.1.6
-
-- Disable `<em>` feature of Redcarpet
-
-## 0.1.5
-
-- Fix ToC link on HTML docs
-
-## 0.1.4
-
-- Provide :html option to render docs in HTML
-
-## 0.1.3
-
-- Use its pointer name if a resource has no title property
-
-## 0.1.2
-
-- Use .schema property for request body if exists
-- Improve array resource handling
-
-## 0.1.1
-
-- Support has-one relation
-
-## 0.1.0
-
-- Show resources which have no links
-
-## 0.0.9
-
-- Support array property
-
-## 0.0.8
-
-- Fix resource equality
-
-## 0.0.7
-
-- Support `false` & `null` example value
-
-## 0.0.6
-
-- Use root API endpoint at example response
-
-## 0.0.5
-
-- Remove dependency on multi_json
-
-## 0.0.4
-
-- Support whitespace and multiple templates in href
-
-## 0.0.3
-
-- Fix missing gem dependencies
-
-## 0.0.2
-
-- Remove dependency on rack-spec
-
-## 0.0.1
-
-- 1st Release