AnWeber
commented
1 year ago could be a replacement for something like swagger
I would not replace OpenAPI but maybe just add to it. I think http files are a good way to document and explain your interface for a developer. However OpenAPI with JSON schema is more detailed and better suited for code generation.
Have you explored publishing httpbook's as web apps.
I have already thought about how to adjust the code to support vscode.dev/ github.dev as well. This would require me to replace all uses of NodeJS packages with browser compatible modules. For example, using got for Http requests would not be possible in the browser. For the reason I have already extracted this a separate plugin. Basically the core would already be compatible, but some more steps are necessary.
- You would have to build the runtime that handles the parsing and execution for the plugins and also the plugins as their own independent packages.
- The plugins must be provided to the CLI APP and Vscode extension. The idea is to restructure the project here and build it as a MonoRepo to avoid a publish via NPM.
- For plugins that are only NodeJS compatible, but are actually of central importance (http request, javascript, assert), a browser compatible version must be created
- In the end, it's exciting to see which parts still cause problems after all the conversions. For this reason, you should also increase the test coverage to have sufficient certainty.
So in short, yes, thought of it, but sporty in implementation
mmadson
rngtng
Hi there!
First, fantastic work on httpyac and the surrounding ecosystem. I come from an IJ background and have for a long time enjoyed using their rest client; so when I switched to VSCode I was very glad to stumble on your extension. I'm starting to realize, however, that I can use your http file format for a lot more than just running sample code in my IDE. The extensive testing support and Notebook integration really has me thinking this could be a replacement for something like swagger and or my usual api doc publishing.
At the moment, unless I'm mistaken, the httpbook support is limited to being used from within VSCode. Have you explored publishing httpbook's as web apps.
I'm imagining a markdown or asciidoc file that sits within my code's repo which not only drives out tests using the httpyac cli but is also auto-published to something like github pages as an interactive notebook.
1 readable / diffable document serving multiple purposes, absolutely amazing if possible.
Appreciate your time.