title: How to generate swagger specification file (json) from python using annotations in code?
body: <p><strong>Problem statement</strong>: I want to  automate the generation of machine and human readable specifications for JSON APIs so anyone can visualize and interact with our API. <br>One of the feasible solution is to use <a href="https://github.com/OAI/OpenAPI-Specification" rel="nofollow noreferrer">OpenAPISpecification</a> (fka swagger). I was not able to find a comprehensible guide to use swagger particularly with tornado, so my questions are:</p>
  
  <ol>
  <li>How can I <strong>auto</strong> generate swagger specification file from annotations in python code?</li>
  <li>I'm also using <a href="https://spacetelescope.github.io/understanding-json-schema/" rel="nofollow noreferrer">JSON schemas</a> for input validation, how can I integrate these with swagger specification.</li>
  </ol>
  
  <p>My API is written in python 2.7.11 with tornado 4.3.
  Please do suggest if you have any other suggestion than using swagger too.</p>
  
  <p>Update: <a href="https://github.com/marshmallow-code/apispec" rel="nofollow noreferrer">Apispec</a> is an interesting start but it cannot be used with JSON schemas as of now, so doesn't answer my question <a href="https://github.com/marshmallow-code/apispec/issues/154" rel="nofollow noreferrer">entirely</a>. </p>