https://github.com/deadtrickster/amqp_rpc
RPC Client/Server for amqp Elixir library
https://github.com/deadtrickster/amqp_rpc
amqp-rpc elixir fuse monitoring rabbitmq rpc-client
Last synced: 7 months ago
JSON representation
RPC Client/Server for amqp Elixir library
- Host: GitHub
- URL: https://github.com/deadtrickster/amqp_rpc
- Owner: deadtrickster
- License: mit
- Created: 2016-07-30T00:33:02.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2019-09-25T12:17:50.000Z (about 6 years ago)
- Last Synced: 2025-03-24T05:26:59.334Z (7 months ago)
- Topics: amqp-rpc, elixir, fuse, monitoring, rabbitmq, rpc-client
- Language: Elixir
- Size: 21.5 KB
- Stars: 6
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AMQP RPC Client/Server templates [](https://travis-ci.org/deadtrickster/amqp_rpc) [](https://hex.pm/packages/amqp_rpc)
**Warning!** POC quality!
## Goals
- Reduce boilerplate
- Handle reconnects
- Messages housekeeping
- Logging
- Monitoring
- Use [fuse](https://github.com/jlouis/fuse)
- Content negotiation
### Fuse
[Fuse](https://github.com/jlouis/fuse) helps reduce latency when something goes wrong with RabbitMQ or RPC server side by breaking circuit and returning immideately. Fuse can be configured via `fuse_name` and `fuse_opts` keys. We trying to maintain sensible default for those.
### Monitoring/Instrumenting
Clients can be instrumented using built-in metrics plugins. Currenly [implemented](https://github.com/deadtrickster/amqp_rpc/blob/master/lib/amqp/rpc/stat/plugin.ex)
- ETS-backed plugin (default)
- [Prometheus](https://github.com/deadtrickster/prometheus.erl) plugin.
## Example
Below is 'classic' RPC example from [RabbitMQ tutorials](http://www.rabbitmq.com/tutorials/tutorial-six-elixir.html)
rewritten using amqp_rpc:
Client:
```elixir
defmodule Fibonacci do
use AMQP.RPC.Client, [exchange: "",
queue: "rpc_queue"]
def fib(n, timeout \\ @timeout) do
rpc(%{command_name: "fib",
args: n}, timeout)
end
end
```
Server:
```elixir
defmodule FibonacciServer do
use AMQP.RPC.Server, [exchange: "",
queue: "rpc_queue",
commands: [:fib]]
## adapted from https://gist.github.com/stevedowney/2f910bd3d72678b4cf99
def fib(0), do: 0
def fib(n)
when is_number(n) and n > 0,
do: fib(n, 1, 0, 1)
def fib(_), do: [error: "positive integers only"]
def fib(n, m, _prev_fib, current_fib)
when n == m,
do: current_fib
def fib(n, m, prev_fib, current_fib),
do: fib(n, m+1, current_fib, prev_fib + current_fib)
end
```
## Installation
[Available in Hex](https://hex.pm/packages/amqp_rpc), the package can be installed as:
1. Add `amqp_rpc` to your list of dependencies in `mix.exs`:
```elixir
def deps do
[{:amqp_rpc, "~> 0.0.7"}]
end
```
2. Ensure `amqp_rpc` is started before your application:
```elixir
def application do
[applications: [:amqp_rpc]]
end
```