Page MenuHomeSoftware Heritage

apidoc: Add support for request data documentation
ClosedPublic

Authored by anlambert on Feb 12 2020, 5:59 PM.

Details

Summary

Some new api endpoints require to send JSON data in HTTP requests but it was currently
not handled by the apidoc module.

So handle corresponding httpdomain directives in our custom rst nodes visitor.

Also add support for documenting JSON array of non object type as httpdomain does
not offer any directive for that type.

And yes I know the code in that module is awful but until we start implementing API v2,
we are stucked with it to display the HTML documentation.

Depends on D2665

Diff Detail

Repository
rDWAPPS Web applications
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

This revision is now accepted and ready to land.Feb 14 2020, 10:20 AM

Rebase on the correct branch