KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #ai-agent #developer-tools #claude-code #codex #deepseek-harness #ai-agents #cli #react #mcp

aberth

★ 37 Open GitHub ↗

Generic BERT-RPC server in Erlang

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# aberth - generic BERT-RPC server written in Erlang

__Version:__ 0.9

[![Build Status](https://travis-ci.org/a13x/aberth.png?branch=master)](https://travis-ci.org/a13x/aberth)

aberth is a **generic BERT-RPC server** in Erlang. It exposes regular erlang modules and it uses
[ranch](https://github.com/ninenines/ranch) as TCP acceptor pool
which provides low-latency when accepting connections.

The inspiration for the name came from [Abarth](http://en.wikipedia.org/wiki/Abarth) and [BERT](http://bert-rpc.org/).

## Supported BERT-RPC features

Aberth supports call, cast and info BERPs. It is up to you, however, to make use of info packets. Aberth routes call and cast requests to your modules and takes care of encoding and decoding.

### TODO

There's still a bit of thinking left on how to pass the info BERPs to the handler modules in a neat way.
Therefore, at the moment, those are not passed through - if you have an idea on how to elegantly solve this,
feel free to send a pull request!

## Usage

Check the example app - it demonstrates including aberth in your OTP app, with clients in Python and Ruby.

### Create a simple module (or two)

```
-module(some_module).

-export([some_method/3]).

some_method(One, Two, Three) ->
	dict:from_list([{one, One}, {two, Two}, {three, Three}]).
```

```
-module(some_adder).

-export([add/2]).

add(One, Two) ->
	One + Two.
```

### Start aberth server

```
NumberOfAcceptors = 100,
Port = 10001,
Handlers = [some_module, some_adder],
aberth:start_server(NumberOfAcceptors, Port, Handlers).
```

That's about it - aberth will listen to requests on Port number, with set number of acceptors. Scaling aberth is done via [ranch](https://github.com/ninenines/ranch), so all ranch options apply to aberth as well.

Aberth is an OTP app so you can easily make it a part of your own OTP app.

### Test the server (from python)

```
import bertrpc
service = bertrpc.Service('localhost', 10001)
response = service.request('call').some_adder.add(203,302)
assert response == 505
```

### Test the server (from Ruby)

```
require 'bertrpc'
svc = BERTRPC::Service.new('localhost', 10001)
r = svc.call.some_adder.add(1234, 4321)
puts r
```

This code will print 5555.

aberth

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README