microcks / microcks/microcks

Feature Request: Add native support for Bruno collections in Microcks

Open
#1,744 12 comments 3 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

component/mocks component/tests help wanted keep-open kind/feature kind/question
Dominant language
Java
Stars
2k
Forks
370
Avg merge
1d 22h
Merged PRs (30d)
19

Description

### Reason/Context

Currently, Microcks supports Postman collections but not Bruno collections directly. While Bruno offers an export-to-Postman option, this conversion is incomplete and lacks support for important features such as request/response events or scripts that define dynamic mocking logic.

For example, in Bruno a pre-request event might contain logic for generating payloads, computing signatures, or setting variables dynamically. When exported to Postman, these events are not properly converted into Postman-compatible scripts. This leads to broken or missing functionality in Microcks when working with these collections.

This improvement would help teams who already use Bruno as their primary API client to integrate with Microcks seamlessly, without having to rely on lossy conversions. It would also reduce the overhead of manually rewriting or revalidating event scripts after export, which is time-consuming and error-prone.

The motivation is to extend Microcks’ usability to a broader community of API practitioners who are adopting Bruno as a lightweight, modern alternative to Postman, and to ensure that dynamic mocking scenarios defined in Bruno collections are preserved and respected when imported into Microcks.

### Description

The feature request is to add native support for Bruno collections in Microcks, alongside the existing Postman support.

At the moment, Bruno collections can only be imported into Microcks by first exporting them as Postman collections. However, this process does not handle advanced features such as event blocks, pre-request/post-response scripts, or Bruno-specific variable resolution. For example, Bruno’s event system allows dynamic payload generation and cryptographic signing of requests, but these scripts are either ignored or exported in a format that is not Postman-compatible.

The proposed change would allow Microcks to:

- Import Bruno collections directly, without requiring a Postman export step.
- Preserve event scripts, variables, and dynamic mocking logic defined in Bruno collections.
- Provide parity with Postman support so users can switch between the two tools without losing functionality.

This would not be a breaking change, as existing Postman collection support remains unaffected. Instead, it would broaden the scope of supported tools and reduce friction for teams already using Bruno.

### Implementation ideas

_No response_

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No files, tests, or entry points are named. Start by locating Microcks' existing Postman collection importer and its tests, then compare the Bruno collection format and event behavior against that support. Done means Bruno collections import directly while retaining variables, event scripts, and dynamic mocking logic without affecting Postman support.

Written by the indexing model from the issue text.

Assessment

Domain
api
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.