Implement complete Go RabbitMQ module with client library and examples

[Copilot]

This PR implements a complete Go RabbitMQ module from scratch, transforming the repository from a basic README into a fully functional RabbitMQ client library.

What's New

Core RabbitMQ Client (rmq.go)

• Connection Management: Automatic connection setup with configurable URLs and proper cleanup
• Message Publishing: Context-aware publishing with persistent delivery mode
• Message Consuming: Non-blocking consumption with custom message handlers
• Queue Management: Automatic queue declaration with durability settings
• Error Handling: Comprehensive error propagation and logging throughout

API Overview

// Create client with default or custom configuration
client, err := rmq.NewClient(rmq.Config{
    URL: "amqp://guest:guest@localhost:5672/",
})

// Publish messages with context support
ctx := context.Background()
err = client.PublishMessage(ctx, "my_queue", []byte("Hello, RabbitMQ!"))

// Consume messages with custom handlers
handler := func(message []byte) error {
    fmt.Printf("Received: %s\n", string(message))
    return nil
}
err = client.ConsumeMessages("my_queue", handler)

Working Examples

• Publisher Example: Demonstrates message publishing with context and error handling
• Consumer Example: Shows message consumption with custom handlers
• Both examples are self-contained with their own go.mod files for easy testing

Testing & Quality

• Unit tests covering client creation, configuration, and connection handling
• Tests gracefully handle environments where RabbitMQ is not available
• Code passes go vet, gofmt, and builds successfully
• Proper .gitignore to exclude build artifacts

Documentation

• Complete README with installation instructions, quick start guide, and API reference
• Inline documentation following Go conventions
• Real-world usage examples for common scenarios

Dependencies

• Built on the official github.com/rabbitmq/amqp091-go library
• Requires Go 1.18+ and a RabbitMQ server for full functionality

The module provides a clean, simple interface for RabbitMQ operations while handling the complexity of connection management, error handling, and message persistence under the hood.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• nonexistent
  • Triggering command: /tmp/go-build909379082/b001/go-rmq.test -test.testlogfile=/tmp/go-build909379082/b001/testlog.txt -test.paniconexit0 -test.timeout=10m0s -test.v=true (dns block)
  • Triggering command: /tmp/go-build240079177/b001/go-rmq.test -test.testlogfile=/tmp/go-build240079177/b001/testlog.txt -test.paniconexit0 -test.timeout=10m0s (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.