Packages

gleam_otp

0.2.0
1.2.0 1.1.0 1.0.0 1.0.0-rc3 1.0.0-rc2 1.0.0-rc1 0.16.1 0.16.0 0.15.0 0.14.1 0.14.0 0.13.0 0.12.1 0.12.0 0.11.2 0.11.1 0.11.0 0.10.0 0.9.0 0.8.0 0.7.0 0.6.0 0.5.3 0.5.2 0.5.1 0.5.0 0.4.0 0.3.1 0.3.0 0.2.0 0.1.6 0.1.5 0.1.4 0.1.3 0.1.2 0.1.1 0.1.0 0.0.1

Fault tolerant multi-core programs with OTP, the BEAM actor framework.

HexDocs

Current section

Files

Jump to
Readme
38 Versions
2 Dependencies
Dependants
Files
Activity
gleam_otp README.md
Raw

README.md 

# Gleam OTP
<a href="https://github.com/gleam-lang/otp/releases"><img src="https://img.shields.io/github/release/gleam-lang/otp" alt="GitHub release"></a>
<a href="https://discord.gg/Fm8Pwmy"><img src="https://img.shields.io/discord/768594524158427167?color=blue" alt="Discord chat"></a>
![CI](https://github.com/gleam-lang/otp/workflows/test/badge.svg?branch=master)
A Gleam library for building fault tolerant multi-core programs using the
actor model. It is compatible with Erlang's OTP framework.
This library is experimental and will likely have many breaking changes in the
future!
## Actor hierarchy
This library defines several different types of actor that can be used in
Gleam programs.
```
      Process
      ↙    ↘
   Actor   Task
     ↓
Supervisor
```
### Process
The process is the lowest level building block of OTP, all other actors are
built on top of processes either directly or indirectly. Typically this
abstraction would be not be used very often in Gleam applications, favour
other actor types that provide more functionality.
### Actor
The `actor` is the most commonly used process type in Gleam and serves as a good
building block for other abstractions. Like Erlang's `gen_server` it will
automatically handle OTP's debug system messages for you.
### Task
A task is a kind of process that performs a single task and then shuts down.
Commonly tasks are used to convert sequential code into concurrent code by
performing computation in another process.
### Supervisor
Supervisors is a process that starts and then supervises a group of processes,
restarting them if they crash. Supervisors can start other supervisors,
resulting in a hierarchical process structure called a supervision tree,
providing fault tolerance to a Gleam application.
## Limitations and known issues
This library is experimental there are some limitations that not yet been resolved.
- There is no support for named processes.
- Actors do not yet support all OTP system messages. Unsupported messages are dropped.
- Supervisors do not yet support different shutdown period per child. In
  practice this means that children that are supervisors do not get an
  unlimited amount of time to shut down, as is expected in Erlang or Elixir.
- This library has not seen much testing compared to the Erlang OTP
  libraries, both in terms of unit tests and real world testing in
  applications.