Configuring Assemblies

An "assembly" is a group of files and/or directories assembled into an archive and distributed. File system entries are included (or excluded) by setting up the appropriate entries in your configuration. For example, consider the following additions to a standard, top level rebar.config, which will put the entire [rebar generated release](https://github.com/basho/rebar/wiki/Release-handling) into an archive, but exclude the erts subdirectories.

{sub_dirs, ["rel"]}.
{dist, [
    {incl_dirs, ["rel/*"]},
    {excl_dirs, ["**/erts-*"]}
]}.

The plugin will work out the difference between overlapping includes and excludes so as to remove the directory matching the +erts-* + glob pattern from the output prior to archiving.

Assembly Configuration Parameters

These parameters can be given to any assembly tuple, wherever it is sourced from.

Option	Description	Default
format	The output format, one of zip,tar,targz.	targz
outdir	The output directory into which all assemblies should be placed.	./dist
workdir	The directory in which all temporary file system entries should be dealt with.	./dist/.work
incl_dirs	List of glob patterns or literal folder names to include.	No Default
excl_dirs	List of glob patterns or literal folder names to Exclude.	No Default