spring-restdocsで個々のスニペットを簡単に作成する方法はありますか？

Question

私はちょうどspring-restdocsに飛び込んできました。私は本当にAPIを文書化する方法が好きです。今、私は、生成された例をPythonで拡張したいと思います。私はPython用のカールのようなスニペットを必要としています。

これは私がこれまでに出て見つけたものです：

私はデフォルトのカール・request.snippetのように私の独自のテンプレートを作成する必要があります。 org.springframework.restdocs.snippet.TemplatedSnippetで独自の実装を拡張することは正しいですか？

Answer 1

スニペットを生成するためにテンプレートを使用する場合は、記述したものが適切なアプローチです。

テンプレートを使用する必要はありません。 Snippetインターフェイスを直接実装することができます。そうすれば、好きな方法でスニペットを自由に生成できます。 Here's a snippet implementation from a third-party extensionsこのアプローチをとる。