rebar.config.template

% This is a configuration file of rebar3, so that the US-Common application can
% better integrate in the current OTP ecosystem, despite its (more complex,
% probably more flexible) native build based on GNU make.
%
% If the name of this file is 'rebar.config', then it is a generated file,
% otherwise it is a template (located in conf/rebar.config.template), meant to
% be filled by information determined at build time or coming from
% GNUmakevars.inc.
%
% See the Myriad counterpart file (same name) for more explanations.


% Base layout was obtained thanks to: 'rebar3 new app us_common', as US-Common
% is an active OTP application (not a mere library).

% To be taken into account, from the library root, through 'make
%  rebar3-application' or 'make rebar3-release'.


% Settings for the 'default' profile follow.


% Depends on the following applications (Erlang implied):
{deps, [
	{myriad, {git, "https://github.com/Olivier-Boudeville/Ceylan-Myriad.git",
			 {branch, "master"}}},
	{wooper, {git, "https://github.com/Olivier-Boudeville/Ceylan-WOOPER.git",
			 {branch, "master"}}},
	{traces, {git, "https://github.com/Olivier-Boudeville/Ceylan-Traces.git",
			 {branch, "master"}}}
]}.



% Include directories found in INC:
{erl_opts, [ {us_common_version,"VERSION_FOR_OTP"}, {d,myriad_debug_mode}, {d,wooper_debug_mode}, {d,traces_debug_mode}, {d,us_common_debug_mode}, {d,tracing_activated}, debug_info, {debug_info_key,"DEBUG_KEY_FOR_REBAR"}, report_warnings, warn_export_all, warn_export_vars, warn_shadow_vars, warn_obsolete_guards, warn_unused_import, warnings_as_errors, {parse_transform,wooper_parse_transform}, INCS_FOR_REBAR ]}.


% (hooks needed, for example to create the include symlinks and for the build
% itself)
%
% Previously 'MYRIAD_REBAR_PROFILE=${REBAR_PROFILE}' was added, yet
% REBAR_PROFILE is actually not set, so we rely on our default value instead.
%
% Hooks had to be even strengthened, otherwise spurious, ill-configured
% compilations will be wrongly attempted by rebar3, when used as a dependency:
%
%{pre_hooks,  [ {compile, "make -s rebar3-compile-pre-hook"} ]}.
%{post_hooks, [ {compile, "make -s rebar3-compile-post-hook"} ]}.

% Used now for homogeneity:
{pre_hooks,  [ {compile, "make -s rebar3-bulletproof-compile-pre-hook"} ]}.
{post_hooks, [ {compile, "make -s rebar3-bulletproof-compile-post-hook"} ]}.



% For release generation:
%
% (defaults are for the development mode)
%
% With relx, only direct dependencies need to be listed, and version constraints
% can be used, instead of exact, specific versions.
%
{relx, [

  % Not 'us_common_release', otherwise plenty of paths will be cluttered:
  {release, {us_common, "VERSION_FOR_OTP"},

	% Listing an application here seems necessary (otherwise its .app file will
	% not be found), however it will also result in its automatic starting with
	% no specfied arguments, whereas at least for some (e.g. simple_bridge) we
	% need to specify them (e.g. which backend to be used).
	%
	% Listing 'traces' here implies its prerequisites (namely Myriad and WOOPER)
	% and is needed, otherwise their respective modules will not be in the
	% code path:
	%
	[ traces, us_common ] },

	{sys_config, "conf/sys.config"},

	% We need specified VM arguments (notably: long node names wanted):
	{vm_args, "conf/vm.args"},

	{dev_mode, true},
	{include_erts, false},

	{extended_start_script, true},
	{include_src, false}

] }.


{profiles, [

  % Production mode (the default one when used as a dependency):
  {prod, [

	% Like for the default profile, except for removed {d,myriad_debug_mode},
	% {d,wooper_debug_mode}, {d,traces_debug_mode}, {d,us_common_debug_mode} and
	% {d,tracing_activated}, and added {d,exec_target_is_production}:
	%
	{erl_opts, [ {us_common_version,"VERSION_FOR_OTP"}, {d,exec_target_is_production}, debug_info, {debug_info_key,"DEBUG_KEY_FOR_REBAR"}, report_warnings, warn_export_all, warn_export_vars, warn_shadow_vars, warn_obsolete_guards, warn_unused_import, warnings_as_errors, {parse_transform,wooper_parse_transform}, INCS_FOR_REBAR ]},

	% For the build makefiles:
	{env, [ { 'REBAR_PROFILE', "prod" } ] },

	{relx, [

	  % Not wanting the release to contain symlinks to applications:
	  {dev_mode, false},

	  % Creating a full target system:
	  %{include_erts, true},

	  % Or sharing a local Erlang environment (then the OTP versions must
	  % precisely match):
	  %
	  {include_erts, false},

	  {extended_start_script, true},
	  {include_src, false}

  ]} ] }

  % No test profile currently needed.

]}.

% No Hex package wanted with this version.