AnWeber / vscode-httpyac

Quickly and easily send REST, Soap, GraphQL, GRPC, MQTT and WebSocket requests directly within Visual Studio Code
https://marketplace.visualstudio.com/items?itemName=anweber.vscode-httpyac
MIT License
222 stars 20 forks source link

[Just some random ideas] Add the option to convert postman collections into .http files (and vice versa) #267

Open ipalfy opened 3 months ago

ipalfy commented 3 months ago

Compared to postman, httpyac (together with httpbook) is a real pain reliever for API developers (using vscode or IntelliJ)

We can easily commit .http files to source control, so everyone can access and modify them and you don’t have to click around to do simple things …

And it would be a huge benefit to migrate some of those huge postman collections into this simple format.

While importing postman might be one step, another step could be exporting .http files to an openAPI (swagger) file, at least partly. OpenAPI has similar issues, you have to click around too much. But it is super helpful to have openAPI files if you want to generate docs or whatever you want, since it’s a widely adopted standard.

Again: These are just ideas, not real „feature requests“.

AnWeber commented 3 months ago

And it would be a huge benefit to migrate some of those huge postman collections into this simple format.

Intellij already provides such a tool, but only for Ultimate if I'm not mistaken. Yes, I agree that it would be helpful. Even more important I would see OpenAPI import, but I can't really get to it right now. I'll add it to my list.

alekdavisintel commented 1 month ago

@ipalfy We are currently migrating our regression tests for a number of REST APIs from Postman to httpYac, so I totally get where you are coming from. My original goal was to find an alternative tool that would automatically convert the existing Postman collections. After I used httpYac for a couple of weeks, I think we'll be better of without the automatic conversion because httpYac uses a somewhat different paradigm. Most things (at least, the ones I tried) are easier to do in httpYac than in Postman, so they would need to be adapted to the httpYac syntax anyway. And it gives us a chance to clean things up and make them better. I guess for simple REST calls, a conversion tool could help, but for complex things with pre- and post-request scripts, I'd rather do it the native httpYac way and for them there may be no simple 1-to-1 conversion.