search

usebruno / bruno

Opensource IDE For Exploring and Testing Api's (lightweight alternative to postman/insomnia)
https://www.usebruno.com/
MIT License
24.59k stars 1.13k forks source link

[Feature Request] CLI For Converting OpenAPI 3 Spec to Bru #1013

Open mjmarrazzo opened 9 months ago

mjmarrazzo commented 9 months ago

Hello,

Our microservice platform team is currently in search of a new API Client App. We've found Bruno to be a promising candidate due to its filesystem-based approach.

Managing our 25+ microservices has proven to be a challenge with other popular API Client apps, particularly in keeping our local apps up-to-date. We believe that a CLI tool to convert our standard API specs into Bruno's format could be integrated into our CI/CD pipeline, significantly improving our workflow.

We propose the addition of a conversion/transformer command to the CLI. This command would take an OpenAPI spec as input, convert it into Bruno's format, and place the output in a specified directory.

We believe this feature would greatly enhance Bruno's usability, especially for teams managing a large number of microservices like ours.

Thank you for considering our proposal.

gianarb commented 8 months ago

Hello

This sounds particularly useful for troubleshooting as well. Currently my openapi spec fails to be imported but the app does not give me insights about why it is failing and I don't know how to proceed from here. If we can expose the engine into a CLI command maybe it can be used to generate a more expressive error reporting that can be help in this scenario since I don't feel great about sharing in a public issue the openapi spec that does not work correctly.

draper-lucid commented 2 months ago

This would be very useful for CI/CD pipelines where bru files could be automatically generated as part of the build process.