frequently-asked-questions.md

layout	title	subtitle	description
page	Frequently asked questions	What? Why? Where? When? How?	The answers to some things you might be wondering about Gleam!

• Why is it called Gleam?
• What does Gleam compile to?
• Does Gleam have mutable state?
• Does Gleam have side effects?
• Will Gleam have type classes?
• Will Gleam have metaprogramming?
• How is message passing typed?
• Can Gleam use Erlang's hot code reloading?
• Why does division by zero return zero?
• How does Gleam compare to...
  • Alpaca?
  • Caramel?
  • Elixir?
  • Purerl?
  • Rust?
• Can I use Elixir code with Gleam?
• Should I put Gleam in production?
• Why is the compiler written in Rust?
• What are Gleam programmers called?
• Is it good?

Why is it called Gleam?

Gleam rhymes with and is a synonym of "beam", which is the name of the Erlang virtual machine.

It's also a short and cute word that's hopefully easy to spell and pronounce for most people.

What does Gleam compile to?

Gleam compiles to Erlang or JavaScript.

Will Gleam have type classes?

Type classes are fun and enable creation of very nice, concise APIs, but they can make it easy to make challenging to understand code, tend to have confusing error messages, make consuming the code from other languages much harder, have a high compile time cost, and have a runtime cost unless the compiler performs full-program compilation and expensive monomorphization. This is unfortunately not a good fit for Gleam and they are not planned.

Will Gleam have metaprogramming?

We are open interested in some form of metaprogramming in Gleam so long as it is not detrimental to Gleam's readability and fast compilation. If you have proposal for a metaprogramming design please do share them with us via a GitHub discussion.

Does Gleam have mutable state?

All data structures in Gleam are immutable and are implemented using structural sharing so they can be efficiently updated.

If your application needs to hold on to some mutable state then it can be held by an actor (which immutably wraps mutable state using recursion) or you can use ETS, the Erlang in-memory key-value database.

If you are compiling Gleam to JavaScript the javascript_mutable_reference library offers mutable references.

Does Gleam have side effects?

Yes, Gleam is an impure functional language like OCaml or Erlang. Impure actions like writing to files and printing to the console are possible without special handling.

We may later introduce an effects system for identifying and tracking any impure code in a Gleam application, though this is still an area of research.

How is message passing typed?

Type safe message passing is implemented in Gleam as a set of libraries, rather than being part of the core language itself. This allows us to write safe concurrent programs that make use of Erlang's OTP framework while not locking us in to one specific approach to typing message passing. This lack of lock-in is important as typing message passing is an area of active research, we may discover an even better approach at a later date!

If you'd like to see more consider checking out Gleam's OTP library.

Can Gleam use Erlang's hot code reloading?

All the usual Erlang code reloading features work, but it is not possible to type check the upgrades themselves as we have no way knowing the types of the already running code. This means you would have the usual Erlang amount of safety rather than what you might have with Gleam otherwise.

Generally the OTP libraries for Gleam are optimised for type safety rather than upgrades, and use records rather than atom modules so the state upgrade callbacks may be more complex to write.

Why does division by zero return zero?

There are three common approaches to handling division by zero in programming languages:

• Throw an exception and crash the program.
• Return a special Infinity value.
• Return 0.

Gleam does not implicitly throw exceptions, so throwing an exception is not an option. The BEAM VM does not have a Infinity value, so that is not an option. Therefore Gleam returns 0 when dividing by zero.

The standard library provides functions which return a Result type for division by zero which you can use if that is more suitable for your program.

For more information on division by zero from a mathematical perspective, see this article by Hillel Wayne.

How does Gleam compare to...

How does Gleam compare to Alpaca?

Alpaca is similar to Gleam in that it is a statically typed language for the Erlang VM that is inspired by the ML family of languages. It's a wonderful project and it was an early inspiration for Gleam!

Here's a non-exhaustive list of differences:

• Alpaca's functions are auto-curried, Gleam's are not.
• Alpaca's unions can be untagged, with Gleam all variants in a custom type need a name.
• Alpaca's compiler is written in Erlang, Gleam's is written in Rust.
• Alpaca's syntax is closer to ML family languages, Gleam's is closer to C family languages.
• Alpaca compiles to Core Erlang, Gleam compiles to regular Erlang and optionally JavaScript.
• Alpaca uses the Erlang build tool, Gleam has its own build tool.
• Gleam is more actively developed than Alpaca (at time of writing).

How does Gleam compare to Caramel?

Caramel is similar to Gleam in that it is a statically typed language for the Erlang VM. It is very cool, especially because of its OCaml heritage!

Here's a non-exhaustive list of differences:

• Caramel is based off of OCaml and forks the OCaml compiler, Gleam is an entirely new language, syntax, and compiler.
• Caramel's functions are auto-curried, Gleam's are not.
• Caramel's compiler is written in OCaml, Gleam's is written in Rust.
• Caramel uses OCaml syntax, Gleam has its own syntax that is closer to C family languages.
• Gleam is more actively developed than Caramel (at time of writing).

How does Gleam compare to Elixir?

Elixir is another language that runs on the Erlang virtual machine. It is very popular and a great language!

Here's a non-exhaustive list of differences:

• Elixir is dynamically typed, Gleam is statically typed. Elixir is integrating a gradual type system into the language, but it has no user facing features yet.
• Elixir has a powerful macro system, Gleam has no metaprogramming features.
• Elixir's compiler is written in Erlang and Elixir, Gleam's is written in Rust.
• Gleam has a more traditional C family style syntax.
• Elixir has a namespace for module functions and another for variables, Gleam has one unified namespace (so there's no special fun.() syntax).
• Gleam standard library is distributed as Hex packages, which makes interoperability with other BEAM languages easier.
• Elixir is a larger language, featuring numerous language features not present in Gleam.
• Elixir has a robust test framework with excellent support for concurrency, partitioning, parameterized tests, integrated error reports, and more. Gleam does not yet.
• Both languages compile to Erlang but Elixir compiles to Erlang abstract format, while Gleam compiles to Erlang source. Gleam can also compile to JavaScript.
• Elixir has superior BEAM runtime integration, featuring accurate stack traces and full support for tools such as code coverage, profiling, and more. Gleam's support is much weaker due to going via Erlang source.
• Elixir has better support for the OTP actor framework. Gleam has its own version of OTP which is type safe, but has a smaller feature set.
• Elixir has superior deployment tooling, including support for OTP releases and OTP umbrella applications.
• Gleam's editor tooling is superior due to having a more mature official language server, but Elixir has recently announced an official language server project which is in active development.
• Elixir is more mature than Gleam and has a much larger ecosystem.

Most importantly both are BEAM languages! I advise using whichever has the programming style you personally find most enjoyable and productive.

How does Gleam compare to Purerl?

Purerl is a backend for the PureScript compiler that outputs Erlang. Both PureScript and Purerl are fantastic!

Here's a non-exhaustive list of differences:

• Purerl is a backend for the PureScript compiler, Gleam is its own language and compiler.
• PureScript has a more sophisticated type system than Gleam, featuring rows, HKTs, type classes, and more.
• Purerl's compiler is written in Haskell, Gleam's is written in Rust.
• PureScript has an ML family style syntax, Gleam has a C family style syntax.
• Purerl code can be difficult to use from other BEAM languages, Gleam code is designed to be usable from all BEAM languages.
• PureScript is more mature than Gleam and has a much larger ecosystem, though not all of it can be used with the Purerl compiler backend.

How does Gleam compare to Rust?

Rust is a language that compiles to native code and gives you full control of memory use in your program, much like C or C++. Gleam's compiler is written in Rust! We're big fans of the language.

Despite having some syntactic similarities, Gleam and Rust are extremely different language.

• Rust is a low level programming language, Gleam is a very high level language.
• Rust is a hybrid functional and imperative language that makes heavy use of mutable state. Gleam is a functional language where everything is immutable.
• Rust compiles to native code. Gleam runs on the Erlang VM and JavaScript runtimes.
• Rust is a very large language which can be challenging to learn. Gleam is a small language and is designed to be easy to learn.
• Rust uses futures with async/await, Gleam uses the actor model on Erlang.
• Rust features traits and multiple macro systems, Gleam does not.

Can I use Elixir code with Gleam?

Yes! The Gleam build tool has support for Elixir and can compile both Elixir dependencies and Elixir source files in your Gleam project. Elixir has to be installed on your computer for this to work.

Elixir macros cannot be called from outside of Elixir, so some Elixir APIs cannot be used directly from Gleam. To use one of these you can write an Elixir module that uses the macros, and then use that module in your Gleam code.

Should I put Gleam in production?

Yes!

Gleam is a production-ready programming language and the Erlang and JavaScript runtimes it runs on are extremely mature and battle-tested. Gleam is ready for mission critical workloads.

Why is the compiler written in Rust?

Prototype versions of the Gleam compiler were written in Erlang, but a switch was made to Rust as the lack of static types was making refactoring a slow and error prone process. A full Rust rewrite of the prototype resulted in the removal of a lot of tech debt and bugs, and the performance boost is nice too!

The community may one day implement a Gleam compiler written in Gleam, but the core team are focused on developing other areas of the ecosystem such as libraries, tooling, and documentation, as this will provide more value overall.

What are Gleam programmers called?

Gleamlins, according to the Gleam Discord server.

Is it good?

Yes, I think so. :)