# Chorus

Chorus is a graphical user interface extension for a popular video game World
of Warcraft. It adds a custom raid frame. This is a work in progress.

Features:

  - approximate distance to every raid member in yards;
  - sort debuffs by relevance;
  - generalize raid and party frames;

Supported game version is legacy 3.3.5a (or interface 30300).

The motivation is to create a robust minimalistic raid frame. It must work
out-of-the-box and require no configuration by the user. It must be comparable
in it's features with modern native raid frame that was shipped with the game
since Cataclysm expansion (interface 40000).

This add-on will never feature key binding customization. This feature is
specifically excluded to be the subject of a different add-on.

## Install

The project is installed like any other World of Warcraft add-on. Exit the
game. Unpack the archive that contains the project's sources into
"${gamedir}/Interface/AddOns/" directory, where ${gamedir} is the path to the
game installation directory. In the end it must look something like this.

```
Interface/Addons/chorus/
Interface/Addons/chorus/bin/
Interface/Addons/chorus/etc/
Interface/Addons/chorus/share/
Interface/Addons/chorus/src/
Interface/Addons/chorus/README.md
Interface/Addons/chorus/chorus.toc
```

Experienced users may install the add-on with `git`.

```
git clone --branch master https://rocketgit.com/user/vrtc/chorus "${gamedir}/Interface/AddOns/chorus"
```

## Development

### Build dependencies

The project does not require any building steps to work. It can be freely
distributed as sources only. However, the project was developed using certain
tools that may still be applicable.

Build dependencies:

  - luacheck (static analysis for Lua);
  - xmllint (XML validator);
  - luarocks (packaging and project management for Lua);
  - ldoc (generate technical documentation from Lua sources);

#### Build dependencies for Debian 12

Install build dependencies for Debian 12.

```
apt-get install libxml2-utils lua-check luarocks lua-ldoc
```

#### Build dependencies for Windows

Insalling for Windows is much more tricky. The first step is to install
LuaRocks, then use LuaRocks to install LuaCheck and LDoc. xmllint can be
replaced with any XML parser that understands *.xsd.

### Build package

Validate Lua snippets for sanity.

```
luacheck --config etc/luacheckrc.lua src/
```

Validate Blizzard UI XML snippets for sanity.

```
xmllint --noout --scheme share/xml/FrameXML/UI.xsd
```

Package a *.zip archive for redistribution.

```
luarocks pack chorus-dev-1.rockspec
```

`luarocks` produces a source "rock" package that is a *.zip archive with a
conventional extension *.src.rock. The file can be safely renamed to a normal
*.zip archive.