https://github.com/dotunj/pvent

Pvent is a CLI tool for sending messages across different message brokers.
https://github.com/dotunj/pvent

kafka message-brokers pubsub sqs

Last synced: 3 months ago
JSON representation

Pvent is a CLI tool for sending messages across different message brokers.

• Host: GitHub
• URL: https://github.com/dotunj/pvent
• Owner: Dotunj
• License: mit
• Created: 2023-10-15T11:48:43.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2025-02-16T22:47:15.000Z (5 months ago)
• Last Synced: 2025-03-27T13:40:25.775Z (4 months ago)
• Topics: kafka, message-brokers, pubsub, sqs
• Language: Go
• Homepage:
• Size: 41 KB
• Stars: 9
• Watchers: 1
• Forks: 1
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
##  Pvent

Pvent is a powerful and flexible CLI tool designed for sending events seamlessly across multiple message brokers. It simplifies event-driven communication by providing a unified interface for interacting with different messaging systems. Currently, Pvent supports Google Pub/Sub, Kafka, Amazon SQS, and RabbitMQ, making it a valuable tool for developers working with distributed systems and microservices.

With Pvent, users can easily publish and manage events across these platforms without needing to switch between different SDKs or APIs. Whether you are integrating with cloud-based messaging services or on-premise brokers, Pvent offers a streamlined experience for efficient event transmission. Future updates aim to expand support for additional message brokers, enhancing its versatility even further.

### Installation

To install Pvent using homebrew, you can run the following commands:

```bash

brew tap dotunj/tools

brew install dotunj/tools/pvent

```

You can also check the [releases section](https://github.com/Dotunj/pvent/releases) to download the binary for your OS.

### Getting Started

To get started with using Pvent, you need to provide your message brokers credentials in a config file.

An example `pvent.json` config file looks like:

```json

{

  "type": "sqs",

  "sqs": {

    "access_key_id": "",

    "secret_access_key": "",

    "region": "",

    "queue_name": ""

  },

  "kafka": {

    "address": "
",

    "topic": "",

    "auth": {

      "tls": true,

      "type": "scram",

      "hash": "SHA256",

      "username": "",

      "password": ""

    }

  },

  "google": {

    "project_id": "",

    "topic_name": ""

  },

  "rabbitmq": {

    "dsn": "",

    "queue_name": ""

  }

}

```

Using the CLI, you can now run:


```bash

pvent dispatch --target payload.json --rate 1

```

If you're using Google Pub/Sub, you'll need to expose the path to your service account credentials file as an environment variable

```bash

export GOOGLE_APPLICATION_CREDENTIALS="/Users/dotunj/Documents/certs/service.json" 

```

### CLI Usage Manual

```

Usage: pvent  [command flags]

dispatch command:

  - type string

        Message Brokers Type (sqs, google, kafka, rabbitmq)

  - rate int

        Total number of events to send

  - target string

        Path to JSON payload to dispatch

  - config

       Path to Pvent config file

```

### License

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.