ainterface

KO | EN

gitlite — search

#javascript #react #ai #typescript #go #golang #rust #docker #java #cli #awesome-list #security #mcp #open-source

(★ 43)

Runs an Erlang node on an ActorSystem of Akka.

ainterface 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Ainterface

[![Build Status](https://travis-ci.org/ainterface/ainterface.svg?branch=master)](https://travis-ci.org/ainterface/ainterface)

Ainterface provides APIs to communicate with Erlang processes, like [Jinterface](http://www.erlang.org/doc/apps/jinterface/jinterface_users_guide.html).
And APIs of Ainterface are designed to integrate Akka with Erlang seamlessly.

## Notice

Since Ainterface is an experimental project, there is no guarantee that APIs will not be changed.

## TODO

* Published(non hidden) mode support
* Short node names support
* Non distributed mode support
* Provides binary pattern matching for ByteString

## Usage

### Dependency

You should add the following dependency.

```
libraryDependencies += "com.okumin" %% "ainterface" % "0.1"
```

### Configuration

In application.conf,

```
akka {
  ainterface {
    # The name of root actor of ainterface-system.
    root-name = "ainterface-system"

init {
      # -name
      # Makes the Erlang runtime system into a distributed node and configure the name.
      name = "node-name-your-application"

# -setcookie
      # Sets the magic cookie of the node to Cookie.
      # If `setcookie` is not specified, `$HOME/.erlang.cookie` is used.
      #setcookie = ""
    }
  }
}
```

## Example

First, start an Erlang node and EPMD.

```
$ erl -name mofu
Erlang/OTP 17 [erts-6.2.1] [source] [64-bit] [smp:4:4] [async-threads:10] [hipe] [kernel-poll:false] [dtrace]

Eshell V6.2.1  (abort with ^G)
(mofu@okumin-mini.local)1>
```

Set up Ainterface.

```
scala> val config = com.typesafe.config.ConfigFactory.parseString("""
     | akka {
     |   loglevel = "ERROR"
     |   ainterface {
     |     root-name = "ainterface-system"
     |     init.name = "ainterface-sample" // the node name
     |   }
     | }
     | """)
config: com.typesafe.config.Config = Config(SimpleConfigObject({"akka":{"ainterface":{"init":{"name":"ainterface-sample"},"root-name":"ainterface-system"},"loglevel":"ERROR"}}))

scala> val system = akka.actor.ActorSystem("sample", config)
system: akka.actor.ActorSystem = akka://sample

scala> akka.ainterface.AinterfaceSystem.init(system) // initialize
```

Start an [echo server](https://github.com/ainterface/ainterface/blob/master/ainterface-sample/src/main/scala/ainterface/EchoActor.scala) with the registered name `echo`.

```
scala> val echo = system.actorOf(akka.actor.Props[ainterface.EchoActor])
echo: akka.actor.ActorRef = Actor[akka://sample/user/$a#1942167954]
```

You can send messages from the Erlang node to Akka!
The echo server returns his pid and `hello` message.

```
(mofu@okumin-mini.local)1> {echo, 'ainterface-sample@okumin-mini.local'} ! {self(), hello}.
{<0.38.0>,hello}
(mofu@okumin-mini.local)2> flush().
Shell got {<6209.1.0>,hello}
ok
```

The other examples are [here](https://github.com/ainterface/ainterface/tree/master/ainterface-sample/src/main/scala/ainterface).

## License

Apache 2.0

ainterface

ainterface 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ainterface

ainterface 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README