bunnybus

KO | EN

gitlite — search

#javascript #hacktoberfest #ai #llm #machine-learning #docker #java #windows #cli #kubernetes #security #ios #mcp #open-source

(★ 45)

Enterprise bus facade for creating a data transit system.

bunnybus Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# bunnybus
BunnyBus is a high level enterprise bus implementation making pub/sub and queue management easy.

Currently supports the following queueing frameworks.

- [RabbitMQ](https://www.rabbitmq.com/)

Lead Maintainer: [Lam Chan](https://github.com/lamchakchan)

## Introduction
BunnyBus abstracts away low level queue driver details such as creating a connection, creating a channel, creating bindings, creating subscribing queues and etc.  BunnyBus provides safe defaults for many setups which can also be configured.  The core of BunnyBus implements native node callbacks providing maximum performance.  BunnyBus provides two flavors of API for callbacks and Promise alike.  The BunnyBus CLI can be found [here](https://github.com/xogroup/bunnybus-cli) implementing this core driver.

**If you require strict FIFO behavior** keep in mind that while your handlers will be called in order, if you yield to the event loop you may resolve out of order. BunnyBus contains an optional setting to enforce strict FIFO behavior, but this comes at significant performance penalty and shouldn't be used by most consumers. You can enable this behavior in your bunnybus config by setting `server.dispatchType` to `'serial'`.

## Installation
```
➜  npm i bunnybus
```

## Usage

### Async / Await
```javascript
const BunnyBus = require('bunnybus');
const bunnyBus = new BunnyBus();

//create a subscription
await bunnyBus.subscribe('queue1', { 
    'create-event' : async (message, ack) => {
        console.log(message.comment);
        await ack();
    }}
);

//publish to the above subscription
await bunnyBus.publish({ event : 'create-event', comment : 'hello world!' });

);
```

## Documentation

### API

See the [API Reference](http://github.com/xogroup/bunnybus/blob/master/API.md).

### Examples

Check out the [Examples](http://github.com/xogroup/bunnybus/blob/master/Example.md).

### Diagrams

[Visual Guide](http://github.com/xogroup/bunnybus/blob/master/Diagram.md) to integrating with `BunnyBus`.

## Articles

* [@Medium](https://medium.com/xo-tech/bunnybus-building-a-data-transit-system-b9647f6283e5#.f9ghb6mzl)

## Contributing

We love community and contributions! Please check out our [guidelines](http://github.com/xogroup/bunnybus/blob/master/.github/CONTRIBUTING.md) before making any PRs.

## Setting up for development

1. Install [Docker](https://docs.docker.com/engine/installation/)
2. Clone this project and `cd` into the project directory
3. Run the commands below

```
npm install
npm run start-docker
npm test
npm run stop-docker
```

For normal development/test iterations, there is no need to stop the docker container.  When the docker container is already running, just run `npm test`.

bunnybus

bunnybus Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

bunnybus

bunnybus Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README