从 swagger-codegen 生成的 python 服务器存根根本无法在本地工作

Question

I generated python server stub from swagger-codegen at swagger editor online, and I want to run generated python server stub locally but it is not working and endpoint gave me Not Found error. I looked into swagger community, and not find single piece of issue related to this. Basically, I used openapi spec in yaml file to generate python server stub, but generated server stub can't be run locally. I don't know what is going on. Is there anyone experienced with this issue? what's the right way to generate python server stub from swagger-codegen which can be run and test locally? any idea?

openapi spec file

here is how yaml file begins:

openapi: 3.0.2
info:
  title: api
  description: test api
  contact:
    name: python server
    url: /api/v1/
    email: info@gmail.com
  version: 1.0.0
servers:
- url: /api/v1/
  description: SwaggerHub API Auto Mocking
- url: /api/v1/
  description: IMM AWS Server 1

I generated python server stub by using this yaml file but generated python server stub is not working and can't run locally from python console/cmd. any idea to make this work? any possible thought?

update

here is what I tried:

    venv) C:\Users\kim\photoalbum_api>python -m swagger_server
The swagger_ui directory could not be found.
    Please install connexion with extra install: pip install connexion[swagger-ui]
    or provide the path to your local installation by passing swagger_path=<your path>

The swagger_ui directory could not be found.
    Please install connexion with extra install: pip install connexion[swagger-ui]
    or provide the path to your local installation by passing swagger_path=<your path>

 * Serving Flask app "__main__" (lazy loading)
 * Environment: production
   WARNING: This is a development server. Do not use it in a production deployment.
   Use a production WSGI server instead.
 * Debug mode: off
 * Running on http://0.0.0.0:8080/ (Press CTRL+C to quit)

so I did pip install connexion[swagger-ui] and try to run it locally, but endpoint always gave me this:

for reproducible purpose, I also tested this openapi spec file to generate python server stub but it is not working as well. why? any idea to make this work? thanks

new update :

even I tried with http://localhost:8080/ , endpoint always give me this:

(venv) C:\Users\kim\photouser_api>python -m swagger_server
 * Serving Flask app "__main__" (lazy loading)
 * Environment: production
   WARNING: This is a development server. Do not use it in a production deployment.
   Use a production WSGI server instead.
 * Debug mode: on
 * Restarting with stat
 * Debugger is active!
 * Debugger PIN: 198-543-983
 * Running on http://127.0.0.1:8080/ (Press CTRL+C to quit)
127.0.0.1 - - [16/May/2020 12:13:51] "GET / HTTP/1.1" 404 -
127.0.0.1 - - [16/May/2020 12:14:02] "GET / HTTP/1.1" 404 -
127.0.0.1 - - [16/May/2020 12:14:05] "GET /api HTTP/1.1" 404 -
127.0.0.1 - - [16/May/2020 12:14:10] "GET /api/v1 HTTP/1.1" 404 -
127.0.0.1 - - [16/May/2020 12:14:14] "GET /api/v1/ HTTP/1.1" 404 -
127.0.0.1 - - [16/May/2020 12:15:14] "GET / HTTP/1.1" 404 -

Answer 1

To get it working in my machine, I cloned your repo openapi.yaml . Then I modified the url to /api/v1/ in your openapi.yaml, and change the connexion to 2.6.0 in your requirements.txt . I created virtualenv and I followed the instructions in the README.md to install requirements.txt, and ran it. In the browser, I type http://localhost:8080/api/v1/ui and this should show the swagger ui. I also tried the docker build instruction and this also works.