nixpkgs/pkgs/development/beam-modules/build-rebar3.nix

{
  stdenv,
  writeText,
  erlang,
  rebar3WithPlugins,
  openssl,
  libyaml,
  lib,
}:

{
  name,
  version,
  src,
  setupHook ? null,
  buildInputs ? [ ],
  beamDeps ? [ ],
  buildPlugins ? [ ],
  postPatch ? "",
  installPhase ? null,
  buildPhase ? null,
  configurePhase ? null,
  meta ? { },
  erlangCompilerOptions ? [ ],
  # Deterministic Erlang builds remove full system paths from debug information
  # among other things to keep builds more reproducible. See their docs for more:
  # https://www.erlang.org/doc/man/compile
  erlangDeterministicBuilds ? true,
  ...
}@attrs:

let
  rebar3 = rebar3WithPlugins {
    plugins = buildPlugins;
  };

  shell =
    drv:
    stdenv.mkDerivation {
      name = "interactive-shell-${drv.name}";
      buildInputs = [ drv ];
    };

  customPhases = lib.filterAttrs (_: v: v != null) {
    inherit
      setupHook
      configurePhase
      buildPhase
      installPhase
      ;
  };

  pkg =
    self:
    stdenv.mkDerivation (
      attrs
      // {

        name = "${name}-${version}";
        inherit version;

        buildInputs = buildInputs ++ [
          erlang
          rebar3
          openssl
          libyaml
        ];
        propagatedBuildInputs = lib.unique beamDeps;

        inherit src;

        ERL_COMPILER_OPTIONS =
          let
            options = erlangCompilerOptions ++ lib.optionals erlangDeterministicBuilds [ "deterministic" ];
          in
          "[${lib.concatStringsSep "," options}]";

        # stripping does not have any effect on beam files
        # it is however needed for dependencies with NIFs
        # false is the default but we keep this for readability
        dontStrip = false;

        setupHook = writeText "setupHook.sh" ''
          addToSearchPath ERL_LIBS "$1/lib/erlang/lib/"
        '';

        postPatch = ''
          rm -f rebar rebar3
        ''
        + postPatch;

        buildPhase = ''
          runHook preBuild
          HOME=. rebar3 bare compile --paths "."
          runHook postBuild
        '';

        installPhase = ''
          runHook preInstall
          mkdir -p "$out/lib/erlang/lib/${name}-${version}"
          for reldir in src ebin priv include; do
            [ -d "$reldir" ] || continue
            # $out/lib/erlang/lib is a convention used in nixpkgs for compiled BEAM packages
            cp -Hrt "$out/lib/erlang/lib/${name}-${version}" "$reldir"
          done
          runHook postInstall
        '';

        meta = {
          inherit (erlang.meta) platforms;
        }
        // meta;

        passthru = {
          packageName = name;
          env = shell self;
          inherit beamDeps;
        };
      }
      // customPhases
    );
in
lib.fix pkg