# relx

**Repository Path**: imboy-tripartite-deps/relx

## Basic Information

- **Project Name**: relx
- **Description**: 镜像 https://github.com/erlware/relx.git
- **Primary Language**: Erlang
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-11-16
- **Last Updated**: 2025-12-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

![](https://github.com/erlware/relx/workflows/Common%20Test/badge.svg)
![Cirrus CI - Task and Script Build Status](https://img.shields.io/cirrus/github/erlware/relx?label=OSX%20Tests)

Relx
=======

Relx is a library that assembles Erlang/OTP releases. Given a release
specification and a list of directories in which to search for OTP
applications it will generate a release output.

It is generally used through the Erlang/OTP build tool
[rebar3](https://www.rebar3.org/) which provides a cli interface.

Documentation
-----------

`relx` is a library used by [rebar3](https://www.rebar3.org/). Documentation on
using `rebar3` for building releases with `relx` can be found on
[rebar3.org](https://rebar3.org/docs/deployment/releases/).

Also see [Adopting Erlang's Releases
chapter](https://adoptingerlang.org/docs/production/releases/). 


Building and Testing
--------

Common Test suites can be run with `rebar3`:

``` shell
$ rebar3 compile
$ rebar3 ct
```

Tests for the start scripts that are generated by `relx` are tested with
[shelltestrunner](https://github.com/simonmichael/shelltestrunner/).

The script `shelltests/run_tests.sh` will clone `rebar3` main and build it
with the current `relx` as a checkout dependency and then run the tests using
that `rebar3` escript:

``` shell
$ shelltests/run_tests.sh
```