mirbuild is the build system used for almost all projects in Last.fm's MIR team. It makes it extremely easy to build, test, install and package
- C++ libraries and services,
- Thrift interfaces and
- Python libraries.
It takes care of
- handling dependencies between projects,
- doing debug, release and code-coverage builds,
- running code coverage tools and
- creating debian packages.
mirbuild is written in Python and needs the setuptools, dateutil, debian and pytest libraries. It also needs cmake for building C++ projects and for running the test suite.
You can build and test mirbuild with
./build.py test
and install it using:
sudo ./build.py install
Have a look at mirbuild/init.py for some usage examples. There's no need to install mirbuild to be able to use it,
export PYTHONPATH=/path/to/python-mirbuild
is sufficient.
It helps to stick to a certain structure when building projects with dependencies. Ideally, all projects are either in the same directory or at least below a certain common directory. To automatically build a project and its dependencies, you can run:
python -m mirbuild.walk -p project build
To build a single project when you know that all dependencies are up-to-date and in the directory above, run:
./build.py --with-deps=.. build