Next generation update service for Mozilla products
Python JavaScript HTML Other
Pull request Compare This branch is 16 commits behind mozilla:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
agent
api-tests
aus-data-snapshots
auslib
client
docs
scripts
ui
uwsgi
.coveragerc
.dockerignore
.editorconfig
.gitattributes
.gitignore
.gitmodules
.hgignore
.taskcluster.yml
Dockerfile
Dockerfile.dev
LICENSE
MANIFEST.in
README.rst
conftest.py
docker-compose-test.yml
docker-compose.yml
requirements-test.txt
requirements-tox.txt
requirements.txt
run-tests.sh
setup.py
tox.ini
version.json
version.txt

README.rst

Balrog

Coverage

Balrog is the software that runs the server side component of the update system used by Firefox and other Mozilla products.

Download

Clone from git using

$ git clone https://github.com/mozilla/balrog

Installation

To run a development environment you must have Docker and docker-compose installed (if you're on Windows or Mac you need "Docker for Windows" or "Docker for Mac" at least v1.12.0)

Once these prerequisites are installed, run the following command to create and run the necessary images:

$ docker-compose up

Once it completes, you should be able to access

Tests

To execute all tests, run

$ ./run-tests.sh

For executing test only for backend, run

$ ./run-tests.sh backend

For executing test only for frontend, run

$ ./run-tests.sh frontend

Tests can also run by using tox

$ tox

Documentation

Balrog's documentation is hosted at http://mozilla-balrog.readthedocs.io/en/latest/index.html

Getting Involved

If you like to get involved in the development of Balrog there're lots of areas where we could use some help. To start with, it's recommended that you look at a Good First Bug. Once you're more comfortable with Balrog, we've got a long list of other bugs ready to be worked on.

Come talk to us in #balrog if you're interested!

If you find a problem and wish to report it, please file a bug .

License

Balrog is released under Mozilla Public License 2.0.