jmcarp / jmcarp/flask-apispec

Usage with docstrings

Open
#67 1 comment 1 reaction 0 assignees View on GitHub
Dominant language
Python
Stars
652
Forks
151
PR merge metrics
No merged PRs in 30d

Description

Hey,
Is there any support for docstrings when using `flask-apispec` / `apispec`? So far I've seen only some random issues somehow related to that (#18?) but I couldn't figure it out, and don't see any examples of this.

It'd be nice to have some sort of integration/compatiblity layer between `apispec` and `sphinxdoc` (`@doc` and other decorators could even generate/extend `__doc__` on decorated methods/functions, but I'd really prefer it the other way around) as right now I end up with duplicated summaries in `@doc(summary="...")` and docstring itself.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.