jmcarp / jmcarp/flask-apispec

No request/response information in generated Swagger docs

Open
#18 2 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
652
Forks
151
PR merge metrics
No merged PRs in 30d

Description

Hi,

I run the example code from README and checked the generated swagger docs: https://gist.github.com/henadzit/e17328dc9d46d00cca8d0519355203dc

It doesn't contain information about request and response formats which could be extracted from use_kwargs and marshal_with decorators. Is it expected?

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the README example and inspect the generated Swagger output linked in the issue. Trace how use_kwargs and marshal_with are handled during documentation generation, then determine whether request and response schemas should appear and what the completed generated documentation should contain.

Written by the indexing model from the issue text.

Assessment

Tech stack
flask, python
Domain
api, backend
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
32/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.