db419e0bdd
Still not quite right. The IDE wants to remove the 'unused' import, and trying to append the sys.path able the 'import sepa_mm_bot' also makes the IDE unhappy.
Bisq API Reference Doc Generator
Produces Bisq API Reference Doc.
What is bisq-api-reference?
This application script consumes Bisq .proto files (pb.proto and grpc.proto), and produces
index.html.md -- a Slate compatible Markdown file.
The Markdown file is then manually deployed to a developer's or bisq-network's fork of the Slate repository, where the slate fork transforms it to a single html file describing Bisq gRPC API services, with example code.
Usage
-
Run
BisqApiDocMain:
BisqApiDocMain --protosIn=<path-to-bisq-protub-files>/proto
\ --markdownOut=<path-to-slate-home>/source
\ --failOnMissingDocumentation=false
- Commit changes in your local slate/source file (
index.html.md) to your forked slate repo.
git commit -a -m "Update index.html.md"
-
Run slate's
deploy.shscript -
After a few minutes, see changes on in your forked slate's github pages site. For example,
if yourindex.html.mdfile was deployed to bisq-network, the URL will be https://bisq-network.github.io/slate.
Credits
Credit to Juntao Han for making his markdown4j API available for use in this project. His source code is included in this project, modified in ways to make generated markdown blocks compatible with Slate/GitHub style markdown.
Lombok annotations are also replaced by the implementations they would generate if that had worked in my gradle development setup.