✨ Shine

A work-in-progress test runner for Gleam and Erlang.

Shine Logo

Installation

Add Shine to project_plugins in your project's rebar.config:

% rebar.config
{project_plugins, [{shine, {git, "https://github.com/jeffkreeftmeijer/shine.git", {branch, "main"}}}]}.

Usage

$ rebar3 shine

Find any differences between running EUnit and Shine in your project? Please open an issue.

Troubleshooting

Due to https://github.com/gleam-lang/otp/issues/21, including Shine as a project_plugin might break compilation:

$ rebar3 shine
===> Fetching shine (from {git,"https://github.com/jeffkreeftmeijer/shine.git",
                 {branch,"main"}})
===> Fetching gleam_otp v0.1.4
===> Fetching gleam_stdlib v0.12.0
===> Skipping gleam_stdlib v0.13.0 as an app of the same name has already been fetched
===> Analyzing applications...
===> Compiling gleam_otp
===> Compiling _build/default/plugins/gleam_otp/src/gleam_otp_external.erl failed
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:14: can't find include file "gen/src/gleam@otp@process_Sender.hrl"
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:15: can't find include file "gen/src/gleam@otp@process_Exit.hrl"
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:16: can't find include file "gen/src/gleam@otp@process_PortDown.hrl"
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:17: can't find include file "gen/src/gleam@otp@process_ProcessDown.hrl"
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:18: can't find include file "gen/src/gleam@otp@process_StatusInfo.hrl"

_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:119: record process_down undefined
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:122: record port_down undefined
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:125: record exit undefined
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:194: record sender undefined
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:207: record status_info undefined
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:210: variable 'Debug' is unbound
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:210: variable 'Mode' is unbound
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:210: variable 'Parent' is unbound
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:212: variable 'Mode' is unbound
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:212: variable 'Parent' is unbound
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:212: variable 'State' is unbound
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:214: variable 'Mod' is unbound

_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:118: Warning: variable 'Pid' is unused
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:118: Warning: variable 'Reason' is unused
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:121: Warning: variable 'Port' is unused
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:121: Warning: variable 'Reason' is unused
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:124: Warning: variable 'Pid' is unused
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:124: Warning: variable 'Reason' is unused
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:192: Warning: variable 'Pid' is unused
_build/default/plugins/gleam_otp/src/gleam_otp_external.erl:193: Warning: variable 'Prepare' is unused

===> Errors loading plugin {shine,
                                   {git,
                                    "https://github.com/jeffkreeftmeijer/shine.git",
                                    {branch,"main"}}}. Run rebar3 with DEBUG=1 set to see errors.
===> Command shine not found

To work around this, copy https://github.com/gleam-lang/otp/blob/main/gleam.toml into _build/default/plugins/gleam_otp, then manually compile gleam_otp before running rebar3 shine:

$ (cd _build/default/plugins/gleam_otp; \
  curl https://raw.githubusercontent.com/gleam-lang/otp/main/gleam.toml -o gleam.toml; \
  rebar3 compile)
$ rebar3 shine