EjStand

EjStand is a simple and configurable web standings daemon for ejudge contest management system. It's intended to be used in situations when standing contains results from different contests or when standing needs some additional display options not supported by ejudge.

Getting started

Installing

EjStand is written in Haskell and can be easily built with Stack tool.

cd ejstand
stack build

If you wish to install EjStand locally (to ~/.local/bin), you can use

stack install

As for recommended option, you should make a package for your Linux distribution on your own. As an example there is ArchLinux sample package source in dist directory.

Configuration

EjStand has two different types of configuration files: global and local.

Global configuration file is unique and contains options which are applied for all standings served by EjStand. For example, two of the most important options in that file are hostname/IP and port to bind an application web server.

Local configuration files define settings for different standing tables and therefore aren't unique.

Examples with detailed descriptions for each option are presented in the conf directory. You can use these examples as templates for your own EjStand instance.

Personally i'd start my own EjStand configuration with

sudo install -Dm644 conf/global.cfg.example /etc/ejstand.cfg
"${EDITOR}" /etc/ejstand.cfg

Setting Up WebServer

Most of the time it makes sense to set up EjStand next to ejudge, and that means that you're probably want some kind of directory (for example, /ejstand) on your Apache/nginx/whatever-you-use-webserver to be proxied to EjStand.

This article can help you to setup your global server in a proper way.

Bugs & Issues

You must be kiddin'. There are no bugs in this software. But if you think there are, you can write your issue here. Please describe all steps to reproduce your bug, your EjStand version and ejudge files which are parsed (if possible).

Contributing

There are no strict policies about contributing and all your patches are welcomed. Your pull requests must meet only three requirements:

1. the patch is sane and doesn't break any existing features;
2. you agree with project license, and allow to distribute your code under its conditions;
3. the code is well-formatted with utils/restyle_code.sh script or Brittany with the same options.

License

This project is licensed under the GNU AGPL license version 3. See LICENSE file for more details.

EjStand uses a lot of third-party libraries licensed under permissive open source licenses. You can review third-party licenses in third-party/licenses directory.