codec-beam: Erlang VM byte code assembler

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

Erlang VM byte code assembler.

[Skip to Readme]


Versions 0.1.0, 0.1.0, 0.1.1, 0.2.0
Change log None available
Dependencies base (>=4.8 && <5), bytestring (>=0.10.6), containers (>=, text (>=1.2.2), zlib (>= [details]
License BSD-3-Clause
Category Language, Codec
Home page
Bug tracker
Source repo head: git clone git://
Uploaded by hkgumbs at 2018-03-16T08:45:39Z




Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Readme for codec-beam-0.1.0

[back to package description]

Build Status Erlant/OTP Release

NOTE: Participation is encouraged! Make issues, ask questions, submit pull requests (even if it’s your first time contributing to open-source — you’ll get lots of help), and give feedback!

Erlang VM byte code assembler for implementing compile-to-beam languages. The goal is to a provide delightful API for generating BEAM instructions from pure Haskell.


This example writes a simple module to a file:

import qualified Data.ByteString.Lazy as LBS

import Codec.Beam.Instructions (func_info, label, move, return')
import qualified Codec.Beam as Beam

main : IO ()
main =
  LBS.writeFile "test_module.beam" $
    Beam.encode "test_module"
      [ Beam.export "tuple_of_one" 0
      [ label 1
      , func_info "tuple_of_one" 0
      , label 2
      , move (Beam.Tuple [Beam.Integer 1]) (Beam.X 0)
      , return'

After you run that program, you can load the resulting module from the Erlang shell!

$ erl
1> test_module:tuple_of_one().

You can find an example project on GitHub.


Use Stack:

stack build --test


Thanks to the following projects, which helped me understand the BEAM file format: